8. březen 2021
Zpracování formuláře (kampaně) vložené do stránky
Jak na odeslání dat z formuláře umístěného ve vašich stránkách do Mailocatoru?
V případech, kdy potřebujete do svých stránek vložit formulář a zpracovat ho Mailocatorem se hodí následující řešení, pomocí kterého nejen jednoduše předáte data do ESP ale pomocí jednoduchého javascriptu můžete obsloužit výsledek zpracování dat (duplicity, neplatné zadání, poděkování).
snadná cesta pro odeslání přihlášení k odběru k newsletteru z vlastního webového formuláře bez nutnosti volání API
možnosti obsloužení výsledků validace a odeslání dat
zpracování a předání dat přímo do nástroje pro rozesílku newsletterů
zpracování dotazníků a dalších kampaní
snadná cesta pro odeslání přihlášení k odběru k newsletteru z vlastního webového formuláře bez nutnosti volání API
možnosti obsloužení výsledků validace a odeslání dat
zpracování a předání dat přímo do nástroje pro rozesílku newsletterů
zpracování dotazníků a dalších kampaní
Umístění snippetu
<script>
(function(e,a,d,b,c){a.mlctr={p:"https://app.mailocator.com",cpg:"12345************"};
b=a.createElement(d);c=a.getElementsByTagName(d)[0];b.async=1;
b.src=a.mlctr.p+"/_/s/"+a.mlctr.cpg+"/ml.js";
c.parentNode.insertBefore(b,c)})(window,document,"script");
</script>
Ujistěte se, že máte ve svých stránkách umístěný snippet k vašemu projektu Mailocatoru.
Příklad: Jednoduchý formulář pro přihlášení k newsletteru
<h1>Email static subscription</h1>
<form>
<input type="text" name="email" value="" id="email_address" size="50" />
<button onclick="subscribe()">subscribe</button>
</form>
Minimální požadavek je pole
email
a událost, která formulář odešle.Odeslání dat do Mailocatoru
function subscribe(){
var data = {};
data.email = document.getElementById('email_address').value;
mailocator.action.subscribe( data, callback );
}
Data můžete odeslat přímo pomocí akce Mailocatoru
object data musí obsahovat alespoň vlastnost "email", další vlastnosti lze použít jako custom/systémová pole vašeho ESP
odešlou se data a název funkce (callback), která se má po dokončení procesu na straně Mailocatoru zavolat a obsloužit výsledek
mailocator.action.subscribe
nebo vlastní funkce, pomocí které doplníte (skrytá) data a předáte název funkce, kterou si přejete zavolat po zpracování - callback()
.object data musí obsahovat alespoň vlastnost "email", další vlastnosti lze použít jako custom/systémová pole vašeho ESP
odešlou se data a název funkce (callback), která se má po dokončení procesu na straně Mailocatoru zavolat a obsloužit výsledek
Odeslání dat do Mailocatoru
function callback( result ){
var status = Number( result.status );
switch( status ){
case 1 : { /* subscribed successfully */ break;}
case 0 : { /* contact already subscribed */ break;}
case -1 : { /* email syntax error */ break; }
case -2 : { /* invalid email - AddressCheck not passed */ break; }
case -99: { /* system error */ break; }
}
}
Pokud jste předali Mailocatoru funkci pro zpracování návratu (v tomto případě
1 ... data byla bezchybně zpracována
0 ... předaný kontakt
-1 ... chybná syntaxe e-mailu
-2 ... neplatný e-mail (překlep, neplatná doména atd.)
-99 ... jiná chyba
callback
), je tato funkce zavolána po zpracování dat Mailocatorem. Jako argument obdrží funkce objekt, jehož součástí je vlastnost status
, kterou lze jednoduše použít pro obsloužení výsledku:1 ... data byla bezchybně zpracována
0 ... předaný kontakt
email
již v databázi existuje-1 ... chybná syntaxe e-mailu
-2 ... neplatný e-mail (překlep, neplatná doména atd.)
-99 ... jiná chyba