Návod
Instalace formulářů na web
Přidejte skript Emailitu jednou na svůj web, umístěte vložené formuláře, otevírejte formuláře z vlastního kódu a spravujte tokeny formulářů, publikování a odpovědi.
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, jak formulář sdílet jako hostovanou stránku 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
-
Zkopírujte kód. Na stránce Email MarketingForms vyberte Install. Kód najdete také na stránce každého formuláře v panelu Installation & sharing. Vypadá takto, s veřejným klíčem vašeho workspace v cestě:
<script async src="https://js.emailit.com/js/<WORKSPACE_PUBLIC_KEY>/emailit.js"></script> -
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. -
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 https://api.emailit.com v connect-src.
Jak se zobrazují překryvné formuláře
| Typ | Kdy se zobrazí |
|---|---|
| Banner | Hned po načtení stránky. Zobrazí se všechny publikované lišty. |
| Popup, Flyout, Full page | 2,5 sekundy po načtení stránky. Při jednom načtení stránky se zobrazí jen jeden z nich. |
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:
-
Zkopírujte zástupný prvek. Otevřete stránku vloženého formuláře. Panel Installation & sharing ukazuje zástupný prvek s veřejným tokenem formuláře:
<div data-emailit-form="FORM_TOKEN"></div> -
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.
-
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
Přidejte libovolnému tlačítku nebo odkazu atribut data-emailit-open s veřejným tokenem formuláře. Kliknutím se formulář otevře:
<button type="button" data-emailit-open="FORM_TOKEN">
Join the newsletter
</button>Z vlastního JavaScriptu formulář otevřete voláním emailit("show", token) a zavřete voláním emailit("close", token). První řádek ponechte. Skript se načítá asynchronně a tento řádek řadí vaše volání do fronty, dokud skript není připravený. Bez něj volání, které proběhne před načtením skriptu, skončí chybou emailit is not defined.
window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};
emailit("show", "FORM_TOKEN"); // open the form
emailit("close", "FORM_TOKEN"); // close it- Formulář se otevře okamžitě, i když ho návštěvník dřív zavřel nebo odeslal. Cílení a limity četnosti se neuplatní.
- Formulář musí být publikovaný a skript musí být na stránce.
- Vložený formulář se otevře jako vyskakovací okno. Pokud je na stránce jeho zástupný prvek, stránka se místo toho posune k němu.
emailit("close")bez tokenu zavře všechna otevřená vyskakovací okna, boční panely, celostránkové formuláře a lišty.- Formulář otevře i odkaz na stránku vašeho webu, který končí na
#emailit-FORM_TOKEN.
openForm funguje jako alias pro show.
Sdílejte hostovanou stránku
Hostovaná stránka zobrazí jeden formulář na samostatné stránce na adrese https://forms.emailit.com/<public token>, takže se lidé mohou přihlásit, aniž by navštívili váš web: z profilu na sociálních sítích, z e-mailu, z reklamy nebo z vytištěného QR kódu. Hostované stránky jsou součástí tarifů Pay as you goProBusinessCustom.
-
Publikujte formulář. Hostovaná stránka zobrazuje publikovanou verzi formuláře, stejně jako váš web.
-
Otevřete odkaz. Na stránce formuláře otevřete v panelu Installation & sharing kartu Link & QR code. Zkopírujte odkaz, vyberte Open hosted page a stránku si vyzkoušejte, nebo vyberte Download QR a stáhněte si QR kód jako SVG. Open hosted page najdete také v nabídce Actions formuláře.
Stránka zobrazí formulář samostatně, uprostřed, bez tlačítka pro zavření a bez pravidel zobrazení: cílení, spouštěče a omezení četnosti zobrazení platí jen na vašem webu. Odpovědi fungují stejně jako na webu. V editoru najdete stejný odkaz v sekci Share & preview na kartě Settings.
Odkaz obsahuje veřejný token formuláře, takže po obnovení tokenu dostane stránka novou adresu a starý odkaz přestane fungovat. Po stažení formuláře nebo po přechodu workspace na tarif Pay as you go stránka místo formuláře zobrazí v jazyce návštěvníka hlášku „Tento formulář teď není k dispozici.“
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ářů, volání emailit("show", ...) a odkaz na hostovanou stránku. 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, kód a sdílené odkazy 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ěď s e-mailovou adresou také vytvoří nebo aktualizuje kontakt a přidá ho do seznamů kontaktů formuláře. Viz Odpovědi.
Řešení problémů
Formulář se nezobrazuje
Zkontrolujte, že je formulář ve stavu Live a že je na stránce skript s klíčem vašeho workspace v URL. Pokud jste formulář dřív zavřeli nebo odeslali, zůstává ve vašem prohlížeči skrytý: otevřete stránku v anonymním okně, nebo odstraňte položku emailit_forms_v1 z místního úložiště. Nezapomeňte, že při jednom načtení stránky se zobrazí jen jedno vyskakovací okno, boční panel nebo celostránkový formulář.
Vložený formulář se nevykresluje
Zkontrolujte, že má formulář typ Embed, že je publikovaný a že hodnota data-emailit-form v zástupném prvku odpovídá aktuálnímu veřejnému tokenu formuláře. Pokud jste token obnovili, zástupný prvek aktualizujte.