Integrace Brevo
Propojení Brevo s kvízem vytvoří nebo aktualizuje kontakt v seznamu Brevo při každém odeslání kvízu. Tato stránka popisuje, co se synchronizuje ve výchozím stavu, jaké atributy kontaktů FluoTest v účtu Brevo vytváří, a jak mapování polí mění odesílaná data.
Naposledy aktualizováno
Co se stane, když ke kvízu připojím Brevo?
FluoTest v účtu Brevo vytvoří 4 vlastní atributy kontaktů (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) a při každém odeslání vytvoří nebo aktualizuje kontakt v Brevo podle e-mailu se jménem respondenta a těmito atributy skóre — nebo s namapovanými poli, pokud je nastaveno mapování polí.
Konfigurace
Integrace Brevo se konfiguruje API klíčem z účtu Brevo (Account settings → API Keys), volitelným ID seznamu Brevo, do kterého se kontakty přidávají, a volitelnou bodovací úrovní, která omezuje, kteří respondenti se synchronizují. API klíč se ukládá na straně serveru.
Automaticky vytvářené atributy
Připojení API klíče Brevo vytvoří v účtu Brevo následující vlastní atributy kontaktů, pokud ještě neexistují. Stane se to jednou, při připojení klíče — atributy se pak objeví v rozhraní kontaktů Brevo ještě předtím, než je odeslán jakýkoli kvíz.
| Atribut | Typ | Popis |
|---|---|---|
| FLUOTEST_SCORE | float | Celkové skóre respondenta. |
| FLUOTEST_MAX_SCORE | float | Maximální možné skóre kvízu. |
| FLUOTEST_SCORE_PERCENT | float | Skóre vyjádřené v procentech. |
| FLUOTEST_QUIZ | text | Název kvízu, ze kterého kontakt pochází. |
Výchozí synchronizovaná pole (bez mapování polí)
Bez nastaveného mapování polí každé odeslání vytvoří nebo aktualizuje kontakt v Brevo podle e-mailu respondenta jako identifikátoru (existující kontakt s daným e-mailem se aktualizuje, místo aby způsobil chybu) a odešle tyto atributy:
| Pole | Zdroj |
|---|---|
| FIRSTNAME | Křestní jméno respondenta, nebo celé jméno, pokud nebylo sesbíráno samostatné křestní jméno a příjmení. |
| LASTNAME | Příjmení respondenta, pokud bylo sesbíráno. |
| FLUOTEST_SCORE | Celkové skóre. |
| FLUOTEST_MAX_SCORE | Maximální možné skóre. |
| FLUOTEST_SCORE_PERCENT | Skóre v procentech. |
| FLUOTEST_QUIZ | Název kvízu. |
Synchronizovaná pole s mapováním polí
Pokud je pro integraci Brevo nastaveno mapování polí (viz Mapování polí a opakování synchronizací), jako identifikátor kontaktu se místo e-mailu respondenta použije namapované pole EMAIL a každé další namapované pole se odešle jako atribut Brevo místo 4 výchozích polí uvedených výše. Cílové schéma nabízené pro mapování se načítá živě z atributů kontaktů účtu Brevo, takže vlastní atributy již vytvořené v Brevo jsou dostupné jako cíle mapování.
Cílení na seznam
ID seznamu na úrovni kvízu má přednost před výchozím seznamem na úrovni účtu, takže různé kvízy propojené se stejným účtem Brevo mohou přidávat kontakty do různých seznamů.
Chyby autorizace IP
Pokud má účet Brevo v sekci Security zapnuté „Authorised IPs“, Brevo odmítne požadavky na synchronizaci, protože servery FluoTestu používají rotující IP adresy, které nelze přidat na pevný seznam povolených adres. Toto selhání je považováno za trvalé a neopakuje se. Odstranění omezení IP v Brevo (Security → Authorised IPs) problém vyřeší.
Často kladené otázky
Vytvoří připojení Brevo v mém účtu Brevo nová pole?
Ano. Připojení API klíče Brevo vytvoří v účtu Brevo 4 vlastní atributy kontaktů (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ), pokud ještě neexistují.
Jaká e-mailová adresa se použije k vytvoření kontaktu v Brevo?
Ve výchozím stavu e-mail respondenta, nebo pole namapované na cíl EMAIL v Brevo, pokud je nastaveno mapování polí.
Proč mé synchronizace s Brevo selhávají s chybou autorizace IP?
To se stává, když má účet Brevo zapnutá omezení IP v sekci Security → Authorised IPs. Servery FluoTestu používají rotující IP adresy, které nelze přidat na seznam povolených, takže je pro úspěšnou synchronizaci potřeba omezení odstranit.
Můžu ovlivnit, kteří respondenti se synchronizují do Brevo?
Ano. Integraci Brevo lze omezit na konkrétní bodovací úroveň, takže se synchronizují jen respondenti v této úrovni.
Související