Instalace formulářů na web

Jeden skript zobrazí na vašem webu všechny publikované formuláře workspace. Tato stránka vysvětluje, kam ho vložit, jak umístit vložené formuláře, jak otevřít formulář z vlastního kódu a jak ověřit, že odpovědi přicházejí.

Než začnete

• Vytvořte a publikujte alespoň jeden formulář. Na webu se zobrazují jen publikované formuláře. Viz Tvorba formuláře.
• Musíte mít možnost upravit HTML svého webu, nebo přidat vlastní HTML tag ve správci tagů.

Přidejte skript

1. Zkopírujte kód. Na stránce Email Marketing›Forms vyberte Install. Kód najdete také na stránce každého formuláře v panelu Installation. Vypadá takto, s veřejným klíčem vašeho workspace v cestě:

   HTML

   <script async src="https://js.emailit.com/js/<WORKSPACE_PUBLIC_KEY>/emailit.js"></script>

2. Přidejte ho na každou stránku. Vložte ho jednou do společného layoutu nebo šablony webu, ideálně těsně před uzavírací tag </body>. Pro všechny formuláře ve workspace je kód stejný, takže ho instalujete jen jednou.

3. Publikujte své formuláře. Publikovaná vyskakovací okna, boční panely, celostránkové formuláře a lišty se teď na webu zobrazí bez dalšího kódu.

Skript se načítá asynchronně a neblokuje stránku. Pokud něco selže, například kvůli chybě sítě, nic nehlásí a stránka funguje dál. Funguje i při vložení přes správce tagů.

Pokud váš web používá Content Security Policy, povolte https://js.emailit.com v script-src a connect-src.

Jak se zobrazují překryvné formuláře

Zpoždění změníte nastavením display_delay_seconds v objektu settings formuláře přes endpoint Úprava formuláře.

Jakmile návštěvník formulář zavře, zůstane v tomto prohlížeči 7 dní skrytý. Po odeslání zůstane skrytý rok. Emailit si to pamatuje v místním úložišti prohlížeče pod klíčem emailit_forms_v1 a nenastavuje žádné cookies. Pokud místní úložiště není dostupné, formuláře se zobrazují při každém načtení stránky.

Vložte formulář do stránky

Vložené formuláře se vykreslují uvnitř obsahu, například v patičce nebo v postranním panelu blogu. Kromě skriptu potřebují zástupný prvek:

1. Zkopírujte zástupný prvek. Otevřete stránku vloženého formuláře. Panel Installation ukazuje zástupný prvek s veřejným tokenem formuláře:

   HTML

   <div data-emailit-form="FORM_TOKEN"></div>

2. Umístěte ho. Vložte zástupný prvek tam, kde se má formulář zobrazit. Stejný formulář můžete použít na více místech.

3. Zkontrolujte skript. Ujistěte se, že je na stránce i skript.

Skript vyplní každý zástupný prvek data-emailit-form, jehož token odpovídá publikovanému vloženému formuláři. Stránku navíc sleduje, takže zástupné prvky přidané později, například jednostránkovou aplikací, se vyplní, jakmile se objeví. Vložené formuláře se zobrazují pokaždé, bez ohledu na to, jestli je návštěvník už dřív odeslal.

Otevřete formulář z kódu

Zavolejte emailit("show", token) a otevřete vyskakovací okno, boční panel, celostránkový formulář nebo lištu, kdy chcete, například z tlačítka:

<button type="button" onclick="emailit('show', 'FORM_TOKEN')">
  Join the newsletter
</button>

• Formulář se otevře okamžitě, i když ho návštěvník dřív zavřel nebo odeslal.
• Formulář musí být publikovaný a skript musí být na stránce.
• Volání provedená ještě během načítání skriptu se zařadí do fronty a provedou se, jakmile je skript připravený.
• U vloženého formuláře show znovu prohledá stránku a najde jeho zástupné prvky.

openForm funguje jako alias pro show.

Spravujte publikovaný formulář

Úprava nebo stažení

Uložené změny publikovaného formuláře nebo jeho stažení se na webu projeví zhruba do minuty. Pokud chcete formulář z webu odstranit, otevřete jeho stránku a vyberte Unpublish. Formulář se vrátí do konceptu a později ho můžete publikovat znovu.

Obnovte veřejný token

Každý formulář má veřejný token, který je na jeho stránce uvedený jako Public token. Používají ho zástupné prvky vložených formulářů a volání emailit("show", ...). Nový token vydáte endpointem Obnovení veřejného tokenu:

curl https://api.emailit.com/v2/forms/frm_8Lq2Wx5nVb3Tk/reset-token \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Starý token okamžitě přestane fungovat, takže zástupné prvky a kód aktualizujte novým token z odpovědi. Překryvných formulářů, které se zobrazují automaticky, se to netýká.

Zkontrolujte odpovědi

Odešlete formulář na svém webu s vlastními údaji a pak ve webovém rozhraní otevřete stránku formuláře. Recent submissions uvádí každou odpověď s časem Created a údajem Payload: odeslané hodnoty pod názvy vlastností jednotlivých polí. Seznam můžete filtrovat podle data vytvoření.

Spolu s hodnotami Emailit u každé odpovědi ukládá URL stránky, odkazující stránku, IP adresu návštěvníka a user agent jeho prohlížeče. Uveďte to ve svých informacích o zpracování osobních údajů.

Odpovědi se zatím nepřidávají do vašich kontaktů ani seznamů kontaktů. Viz Odpovědi.

Řešení problémů

Související