Princip
Sledované segmenty
Sledované segmenty zaznamenávají, kdo do nich vstoupí a kdo je opustí, a kdy. Spouštějte automatizace a odesílejte webhooky při vstupech a odchodech a sledujte růst segmentu. Alfaverze: otevřená jen týmu Emailitu.
Sledovaný segment je segment, který si navíc ukládá své členy. Když kontakt začne nebo přestane odpovídat jeho pravidlům, Emailit změnu zaznamená, takže můžete:
- spouštět automatizace, když někdo vstoupí nebo odejde,
- přijímat webhooky o vstupech a odchodech,
- vidět růst segmentu v čase a kdy který kontakt vstoupil.
Počty, výpis kontaktů a kampaně fungují stejně jako u každého segmentu: pravidla vyhodnocují živě a uložené členy nikdy nepoužívají.
Sledované segmenty jsou součástí tarifů Pro, Business a Custom a počítají se do stejného limitu segmentů jako ostatní segmenty.
Vytvořte sledovaný segment
Při vytváření segmentu zvolte v části Type možnost Tracked segment. V tarifu Pay as you go je tato možnost neaktivní a zobrazuje Upgrade. Přes API předejte "tracked": true endpointu Vytvoření segmentu.
Typ už potom nelze změnit, ani jedním směrem. Pokud chcete sledovat existující segment, vytvořte nový sledovaný segment se stejnými pravidly. Duplicate zachová typ původního segmentu.
Hned po vytvoření ukazuje sledovaný segment stav Recording current members, zatímco Emailit ukládá všechny, kdo mu už odpovídají (v API má tracking.status hodnotu syncing). Tento první zápis členů neodesílá události ani nespouští automatizace: jako změny se počítají jen kontakty, které vstoupí nebo odejdou až po něm.
Jak se členové aktualizují
| Co se stane | Kdy se členové aktualizují | reason |
|---|---|---|
| Kontakt se vytvoří, upraví, smaže, přihlásí nebo odhlásí, nebo ho změní krok automatizace | Obvykle do minuty | contact |
| Dokončí se import kontaktů, nebo se smaže seznam kontaktů | Po dokončení, pro celý segment | contact |
| Pravidla, která se posouvají s časem, například Created za posledních 30 dní, a změny, které nevyvolávají události kontaktů | Každý den v 00:30 UTC, pro celý segment | schedule |
| Upravíte zdroj nebo filtry segmentu | Hned po uložení | segment_updated |
Každý vstup a odchod se zaznamená se svým reason. Změny způsobené úpravou segmentu se odešlou webhookům, ale automatizace nespouštějí, takže změna pravidel nespustí automatizaci pro všechny, kterých se týká. Kontakty, které odejdou kvůli smazání, žádnou událost neodesílají.
Spouštějte automatizace
Ze sledovaného segmentu vycházejí dva spouštěče kontaktů:
| Spouštěč | Klíč v API | Spuštění začne, když |
|---|---|---|
| Added to segment | contact.added_to_segment |
Kontakt vstoupí do segmentu. |
| Removed from segment | contact.removed_from_segment |
Kontakt segment opustí. |
Segment vyberte ve spouštěči v poli Tracked segment. Nabízejí se jen sledované segmenty a jen ty lze použít. Spuštění obvykle začnou do minuty od vstupu nebo odchodu.
U Added to segment vyberte Also start for contacts already in the segment when the automation is first started, pokud chcete automatizaci spustit i pro aktuální členy. Stane se to jednou, při prvním zapnutí automatizace, pro členy zaznamenané v tu chvíli. Nastavení spuštění automatizace, například allow_reentry a cooldown_seconds, stále platí. Viz Práce s API.
Vstupy a odchody mohou také ukončit spuštění (Removed from segment jako podmínka ukončení), splnit cíl a posunout dál spuštění čekající v kroku Wait until. Viz Podmínky ukončení a cíle.
Segment, který automatizace používá, nelze smazat, dokud tuto automatizaci nezměníte. Viz Spouštěče automatizací.
Webhooky
Vstupy a odchody odesílají tyto události webhooků:
segment.contact_added, když kontakt vstoupí, sjoined_at.segment.contact_removed, když kontakt odejde, sleft_at.
Obě obsahují id a name segmentu, id, email, jména a vlastní pole kontaktu a reason z tabulky výše. V panelu Activity log kontaktu se také zobrazují záznamy „Joined segment“ a „Left segment“.
Růst a sloupec Joined
Stránka sledovaného segmentu má graf Growth za posledních 30 dní: Members na konci každého dne a počty kontaktů Joined a Left. Historie začíná se zahájením sledování a první zápis členů se jako vstupy nezobrazuje.
Tabulka kontaktů má navíc sloupec Joined s datem, kdy začal aktuální pobyt kontaktu v segmentu. Kontakt, který odejde a vrátí se, dostane nové datum. Dokud sledování kontakt nezaznamená, je sloupec prázdný.
Přes API použijte Načtení růstu segmentu pro období až 365 dní a Výpis kontaktů segmentu pro joined_at.
Když se sledování pozastaví
Pokud workspace přejde na tarif bez sledovaných segmentů, sledování se pozastaví. Stránka segmentu ukazuje Tracking is paused a tracking.status má hodnotu paused:
- Členové se přestanou aktualizovat, neodesílají se žádné události a ze segmentu se nespouštějí žádné automatizace.
- Počty, výpis kontaktů a odesílání segmentu dál fungují živě, jako u každého segmentu.
Po opětovném přechodu na vyšší tarif Emailit při příští aktualizaci znovu zaznamená aktuální členy, aniž by odeslal události nebo spustil automatizace, a sledování pak pokračuje. Vstupy a odchody, ke kterým došlo během pozastavení sledování, se nezaznamenají.
Práce s API
| Úkol | Endpoint |
|---|---|
| Vytvoření sledovaného segmentu | Vytvoření segmentu s "tracked": true |
| Kontrola stavu sledování | tracked a tracking v odpovědi Načtení segmentu |
| Denní počty členů, vstupy a odchody | Načtení růstu segmentu |
| Kdy který člen vstoupil | joined_at v odpovědi Výpis kontaktů segmentu |
V tarifu Pay as you go vrací "tracked": true kód 403 s "error": "plan_required" a "required_plan": "pro". Výpis segmentů vrací usage.tracking_allowed, které říká, jestli tarif zahrnuje sledované segmenty.