Mapování polí a opakování synchronizací
Brevo, webhooky, Google Sheets, HubSpot, Mailchimp, Notion a Airtable sdílejí jeden systém mapování polí: každé cílové pole se namapuje ze zdroje na straně kvízu, volitelně transformuje a před každým pokusem o synchronizaci ověří. Slack mapování polí nepodporuje — místo toho odesílá pevně danou formátovanou zprávu.
Naposledy aktualizováno
Jak funguje mapování polí napříč integracemi FluoTestu?
Každé cílové pole se namapuje ze standardního pole kvízu, konkrétní otázky nebo vypočítané hodnoty, s volitelnou transformací, podmínkou a záložní hodnotou. Cílové schéma se načítá živě z připojeného účtu. Neúspěšné pokusy o synchronizaci se zaznamenávají a automaticky opakují s prodlevou, než jsou označeny jako mrtvé.
Poskytovatelé s podporou mapování polí
Mapování polí podporují následující poskytovatelé. Každý z nich načítá své cílové schéma živě z připojeného účtu nebo zdroje; webhook žádné schéma nemá, takže jeho cílové klíče jsou volně definovatelné.
| Poskytovatel | Zdroj cílového schématu |
|---|---|
| Brevo | Atributy kontaktů v připojeném účtu Brevo. |
| Webhook | Žádné — cílové klíče jsou volně definovatelné. |
| Google Sheets | Záhlaví vybrané tabulky. |
| HubSpot | Vlastnosti kontaktů v připojeném účtu HubSpot. |
| Mailchimp | Sloučená pole (merge fields) vybraného publika. |
| Notion | Vlastnosti vybrané databáze. |
| Airtable | Pole vybrané tabulky. |
Zdrojová pole
Každý kvíz nabízí stejnou sadu standardních zdrojových polí, plus jedno pole za každou otázku.
| Pole | Popis |
|---|---|
| E-mailová adresa respondenta. | |
| name | Celé jméno. |
| first_name | Křestní jméno. |
| last_name | Příjmení. |
| company | Název společnosti, pokud byl sesbírán. |
| score | Celkové skóre. |
| max_score | Maximální možné skóre. |
| score_percent | Skóre v procentech. |
| tier | Popisek odpovídající bodovací úrovně. |
| outcome | Klíč odpovídajícího primárního výsledku (Pro systém výsledků). |
| tags | Popisek úrovně jako jednoprvkový seznam — používá se jako cíl tags u poskytovatelů podporujících štítky. |
| submitted_at | Časové razítko odeslání. |
| quiz_name | Název kvízu. |
| country | V současnosti se nesbírá; vždy prázdné. |
Každá otázka kvízu je také dostupná jako zdrojové pole, označené textem otázky.
Typy transformací
Mapování může na výslednou hodnotu zdroje před odesláním použít jednu z následujících transformací.
| Typ | Popis |
|---|---|
| none | Odešle hodnotu zdroje beze změny. |
| lowercase | Převede textovou hodnotu na malá písmena. |
| uppercase | Převede textovou hodnotu na velká písmena. |
| concat | Spojí více polí a/nebo pevného textu oddělovačem. |
| json_path | Přečte vnořenou hodnotu z objektu answers nebo scores odpovědi podle tečkové cesty. |
| constant | Vždy odešle pevnou hodnotu, bez ohledu na zdrojové pole. |
| computed | Odvodí hodnotu, kterou FluoTest vypočítá: full_name, score_fraction (např. „8/10“), nebo score_percent. |
| custom | Textová šablona se zástupnými symboly {field_key} nahrazenými zdrojovými poli. |
Podmíněné mapování
Mapování může nést jednu podmínku: použije se jen tehdy, když porovnání se zdrojovým polem (rovná se, nerovná se, větší než, menší než nebo obsahuje) vyhodnotí jako pravdivé. Díky tomu se jedno cílové pole může naplňovat jinak — nebo vůbec — podle odpovědí nebo skóre kvízu.
Záložní hodnoty
Pokud je výsledná hodnota mapování prázdná, použije se místo ní záložní hodnota (pokud je nastavena). Mapování se záložní hodnotou a bez zdrojového pole vždy odešle tuto záložní hodnotu.
Povinná pole a validace
Cílové pole, které schéma označuje jako povinné, musí získat neprázdnou hodnotu z nějakého mapování — zdroje, konstanty nebo záložní hodnoty — jinak synchronizace selže na validaci ještě před pokusem o odeslání. Chyby validace se automaticky neopakují, protože opakování bez změny mapování by vedlo ke stejnému výsledku; je potřeba opravit mapování.
Doručení, opakování a selhání
Každý pokus o synchronizaci — ať už uspěje, selže, nebo se opakuje — se zaznamenává. Neúspěšný pokus (kromě chyby validace) se zařadí do fronty k opakování s prodlevou.
| Stav | Význam |
|---|---|
| success | Doručeno bez chyby. |
| failed | Poslední pokus selhal; může se ještě opakovat. |
| retrying | Zařazeno k dalšímu pokusu v naplánovaném čase. |
| dead | Všechny pokusy o opakování jsou vyčerpány, nebo šlo o chybu validace — žádné další automatické pokusy. |
Opakování je naplánováno 1 minutu, 5 minut a 30 minut po každém neúspěšném pokusu (až 3 opakování nad rámec prvního pokusu, celkem 4 pokusy). Úloha na pozadí kontroluje splatná opakování každou minutu. Frontovanou nebo mrtvou synchronizaci lze také ručně opakovat z přehledu integrací daného kvízu.
Často kladené otázky
Které integrace podporují mapování polí?
Brevo, webhooky, Google Sheets, HubSpot, Mailchimp, Notion a Airtable. Slack místo toho odesílá pevně danou formátovanou zprávu a mapování polí nepoužívá.
Odkud pochází seznam cílových polí?
Načítá se živě z připojeného účtu nebo zdroje — například vlastnosti kontaktů v HubSpotu nebo záhlaví Google tabulky — místo pevného seznamu, takže odráží vlastní pole.
Co se stane, když povinné cílové pole nemá mapování?
Synchronizace selže na validaci a neproběhne ani se neopakuje. Namapováním zdrojového pole, konstanty nebo záložní hodnoty na povinné pole se problém vyřeší.
Kolikrát FluoTest opakuje neúspěšnou synchronizaci?
Až 3 další pokusy po prvním, s prodlevou 1, 5 a 30 minut. Poté, nebo okamžitě u chyby validace, je synchronizace označena jako mrtvá a lze ji opakovat ručně.