Chcete automaticky reagovat na to, když si zákazník přehraje video, přidá si produkt do oblíbených, nebo dosáhne určité hodnoty v košíku? Sledování vlastních událostí vám umožní zaznamenávat libovolné uživatelské akce přímo z vašeho webu nebo aplikace. Získaná data pak snadno převedete do vysoce personalizované komunikace, která zvyšuje zapojení zákazníků i vaše prodeje.
Vlastní události patří mezi pokročilé funkce a jsou dostupné pouze v tarifech Marketer+ a CDP.
V tomto článku naleznete:
Co jsou vlastní události
Vlastní události jsou specifické akce, které zákazníci provádějí na vašem webu nebo v aplikaci mimo standardní prohlížení stránek a nákupy. Pomocí vlastních událostí můžete sledovat například stažení e-booku, stisknutí konkrétního tlačítka, fázi rozpracované příležitosti nebo třeba sledování videa.
📌 POZNÁMKA: Jedná se o pokročilé technické řešení. Přenos událostí konzultujte s vaším technikem a jejich použití otestujte.
Každá událost se skládá z několika parametrů, které pomáhají akci přesně specifikovat a předat k ní doplňující data:
Název parametru | Povinné? | Popis |
Kategorie (Category) | ANO | Váš název skupiny objektů nebo akcí, které chcete sledovat (např. Videoplayer, Ecomm nebo Formular). |
Akce (Action) | NE | Řetězec popisující konkrétní typ interakce s webovým objektem (např. Prehrat, Pridat-do-kosiku nebo Stazeni). |
Štítek (Label) | NE | Označení konkrétního objektu, kterého se akce týká (např. název videa Svatebni-video.mp4 nebo SKU produktu). |
Vlastnost (Property) | NE | Doplňující popis provedené akce nebo objektu (např. rozlišení videa, datum nebo množství položek). |
Hodnota (Value) | NE | Volitelný text, číslo, pole nebo celý JSON objekt (max. 20 000 znaků) pro kvantifikaci nebo další popis uživatelské akce. Může jít o jednoduchou cenu položky přidané do košíku, ale klidně i o vnořená data z vaší databáze (viz příklady níže).
Při zaslání JSON objektu lze následně kontakt v segmentaci vyhledat pomocí pole Klíč hodnoty, viz kapitola Vyhledání pomocí hodnoty uvnitř JSON.
|
📌 POZNÁMKA: Pokud posíláte datum, je třeba dodržet formát RRRR-MM-DD nebo RRRR-MM-DD HH:MM:SS, aby Ecomail datový typ rozeznal. Zápis v jiném formátu se vyhodnotí jako text.
Jak nastavit přenos a podmínky vlastních událostí
Přenos událostí do Ecomailu vyžaduje technickou přípravu. Výběr a nastavení filtrů v rozhraní Ecomailu je pak již velmi intuitivní.
Přenos přes trackovací kód
Pro přenos vlastních událostí si na web nejdříve nasaďte základní trackovací kód a otestujte jeho funkčnost.
Vlastní událost zašlete do Ecomailu pomocí zavolání funkce po provedení požadované akce návštěvníkem webu:
JavaScript
window.ecotrack('trackStructEvent', 'kategorie', 'akce', 'štítek', 'vlastnost', 'hodnota');
Hodnoty do polí kategorie, akce, štítek, vlastnost a hodnota doplňujte dynamicky dle dané události.
Příklad jednoduché události přehrání videa:
JavaScript
window.ecotrack('trackStructEvent', 'Videoplayer', 'Play', 'Svatebni-video.mp4', 'cas_ukonceni', '17.5');
Příklad události objednávky produktu s JSON v poli Hodnota:
JavaScript
window.ecotrack('trackStructEvent', 'shopping', 'product_bought', 'Nike Air Max 90', 'nike-air-max-90', '{"deal": {"amount": 1500, "currency": "CZK"}}');
Přenos přes API
Události můžete odesílat také pomocí API endpointu Create an event. Do požadavku předáváte stejnou strukturu parametrů (Kategorie, Akce, Štítek, Vlastnost, Hodnota).
Jak pracovat s vlastními událostmi
Jakmile do Ecomailu událost zašlete, zobrazí se v detailu daného kontaktu:
Vlastní události následně využijete v segmentaci (Aktivita na webu -> Vlastní událost). Kontakt z příkladu výše lze např. vyhledat dle hodnoty “formular” v poli Kategorie:
Stejně tak i v podmínkách automatizací:
Samotné zaslání vlastní události může automatizaci také spustit, pokud jako trigger vyberete Nastane vlastní událost.
📌 POZNÁMKA: Pro správné fungování triggeru je potřeba minimálně hodnota v parametru Kategorie.
💡 TIP: Názvy vlastností ani přesné hodnoty si nemusíte pamatovat. Jakmile začnete psát do pole, Ecomail vám díky chytrému našeptávání automaticky nabídne již přijaté klíče a hodnoty. Hodnoty v našeptávači se aktualizují jedenkrát denně v nočních hodinách.
Vyhledání pomocí hodnoty uvnitř JSON
Pokud v parametru Hodnota posíláte celý JSON objekt (viz tabulka v kapitole Co jsou vlastní události), nemusíte se při segmentaci spokojit jen s jeho celým obsahem. Můžete zamířit na konkrétní část dat uvnitř něj pomocí klíče.
Např. odešlete událost ve chvíli, kdy dojde k objednávce:
window.ecotrack('trackStructEvent', 'shopping','product_bought','Nike Air Max 90','nike-air-max-90','{"deal": {"amount": 1500, "currency": "CZK"}}');
Pro vyhledání kontaktu dle hodnoty objednávky do pole Klíč hodnoty zadejte cestu ke klíči pomocí tečkové notace – například deal.amount najde hodnotu “amount” uvnitř objektu “deal”. Ecomail sám pozná, jaký typ dat se v daném klíči skrývá – text, celé číslo, desetinné číslo, true/false, datum nebo datum a čas – a podle toho vám nabídne odpovídající operátory pro pole Hodnota:
Dostupné operátory pro jednotlivé typy dat:
Text (String): Vhodný pro názvy a řetězce (umožňuje filtry typu rovná se, obsahuje, začíná na apod.).
Číslo (Integer / Float): Vhodný pro ceny a počty (umožňuje matematické porovnání jako větší než, menší než nebo v rozmezí apod.).
Datum a čas (Date / Datetime): Vhodný pro časové údaje (umožňuje porovnání před, po nebo v rozmezí apod.).
Pravda / Nepravda (Boolean): Vhodné pro binární hodnoty. Filtr true nebo false.
Pole a objekty (Array / Object): Vhodné pro složitější JSON struktury.
💭 Nenašli jste odpověď?
Napište nám na chat nebo e-mail support@ecomail.cz. 😊


