# 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](/cs/docs/segments/), 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](#start-automations), když někdo vstoupí nebo odejde,
- přijímat [webhooky](#webhooks) o vstupech a odchodech,
- vidět [růst](#growth-and-the-joined-column) 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í.

> **Segmenty jsou v alfaverzi:** Dokud segmenty testujeme, jsou sledované i nesledované segmenty otevřené jen týmu Emailitu. Viz [Kdo může segmenty používat](/cs/docs/segments/#who-can-use-segments).

Sledované segmenty jsou součástí tarifů Pro, Business a Custom a počítají se do stejného [limitu segmentů](/cs/docs/segments/#limits) 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](/cs/docs/api-reference/segments/create/).

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](/cs/docs/automations/#use-the-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](/cs/docs/automations/exits-and-goals/).

Segment, který automatizace používá, nelze smazat, dokud tuto automatizaci nezměníte. Viz [Spouštěče automatizací](/cs/docs/automations/triggers/#segment-triggers).

## Webhooky

Vstupy a odchody odesílají tyto události [webhooků](/cs/docs/webhooks/):

- [`segment.contact_added`](/cs/docs/webhooks/events/segment/contact-added/), když kontakt vstoupí, s `joined_at`.
- [`segment.contact_removed`](/cs/docs/webhooks/events/segment/contact-removed/), když kontakt odejde, s `left_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](/cs/docs/api-reference/segments/growth/) pro období až 365 dní a [Výpis kontaktů segmentu](/cs/docs/api-reference/segments/contacts/) 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](/cs/docs/api-reference/segments/create/) s `"tracked": true` |
| Kontrola stavu sledování | `tracked` a `tracking` v odpovědi [Načtení segmentu](/cs/docs/api-reference/segments/get/) |
| Denní počty členů, vstupy a odchody | [Načtení růstu segmentu](/cs/docs/api-reference/segments/growth/) |
| Kdy který člen vstoupil | `joined_at` v odpovědi [Výpis kontaktů segmentu](/cs/docs/api-reference/segments/contacts/) |

V tarifu Pay as you go vrací `"tracked": true` kód `403` s `"error": "plan_required"` a `"required_plan": "pro"`. [Výpis segmentů](/cs/docs/api-reference/segments/list/) vrací `usage.tracking_allowed`, které říká, jestli tarif zahrnuje sledované segmenty.

## Související

  - [Spouštěče automatizací](/cs/docs/automations/triggers/): Všechny spouštěče a jejich možnosti.
  - [Typy událostí](/cs/docs/webhooks/event-types/): Všechny webhookové události, které Emailit odesílá.

---
Zdroj: https://emailit.com/cs/docs/segments/tracked/