# Segmenty

> Segmenty jsou uložené filtry nad vašimi kontakty. Sestavte je ze všech kontaktů nebo z vybraných seznamů kontaktů, posílejte jim kampaně nebo je z kampaní vylučte a zjistěte limit segmentů ve vašem tarifu. Alfaverze: otevřená jen týmu Emailitu.

Segment je uložený filtr nad kontakty ve vašem workspace, například „Zákazníci s tarifem Pro“ nebo „Registrovaní za posledních 30 dní“. Lidi do segmentu nepřidáváte: patří do něj každý, kdo odpovídá jeho pravidlům, a nikdo jiný. Segmenty použijte, když chcete [kampaň](/cs/docs/campaigns/) poslat jen části kontaktů, nebo z ní někoho vynechat.

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

## Kdo může segmenty používat

Během alfaverze jsou segmenty dostupné jen administrátorům platformy Emailit. Role **Admin** ve workspace nestačí.

| Kde | Tým Emailitu | Všichni ostatní |
| --- | --- | --- |
| Webové rozhraní | **Email Marketing → Segments**, výběr segmentů v kampaních, spouštěče segmentů v automatizacích a události segmentů ve webhoocích | Položka **Segments** v nabídce má označení **Soon** a nejde otevřít. Pole pro výběr segmentů se nezobrazují, ale kampaň nebo automatizace, která už segment používá, ho dál zobrazuje. |
| API a MCP | API segmentů, segmenty mezi příjemci kampaní, spouštěče segmentů a nástroje MCP pro segmenty | `403` s `error: "segments_alpha"` |
| API klíče | Žádné. API klíče patří workspace, ne konkrétnímu člověku. | `403` s `error: "segments_alpha"` |

Kampaně a automatizace, které už segment používají, dál fungují pro všechny ve workspace a sledované segmenty se dál aktualizují.

## Jak segmenty fungují

Segment má dvě části:

- **Zdroj.** Všechny kontakty ve workspace, nebo jen odběratelé seznamů kontaktů, které vyberete.
- **Filtry.** Skupiny pravidel pro pole kontaktu, [vlastní pole](/cs/docs/contacts/custom-fields/), členství v seznamech kontaktů, [štítky a skóre kontaktu](/cs/docs/contacts/tags-and-score/), například **Email domain** je `acme.com`, **plan** je některá z hodnot `pro`, `enterprise` nebo **Tags** má některý ze štítků `vip`. Každá skupina vyžaduje shodu se všemi svými pravidly, nebo s kterýmkoli z nich, a segment stejně tak se všemi svými skupinami, nebo s kteroukoli z nich. Bez filtrů je v segmentu každý ze zdroje.

Emailit segment vyhodnotí pokaždé, když se počítá, vypisuje nebo se mu odesílá, takže je vždy aktuální. Kampaň naplánovanou na příští týden dostanou ti, kdo segmentu odpovídají v okamžiku odeslání, a pravidla jako „vytvořeno za posledních 30 dní“ se posouvají s datem.

### Koho kampaně zasáhnou

Každý segment ukazuje dva počty: **Contacts**, tedy všechny, kdo mu odpovídají, a **Subscribed**, tedy část, které mohou kampaně odesílat. Kontakt je přihlášený, když není globálně odhlášený a je přihlášený aspoň k jednomu seznamu kontaktů, ke kterémukoli. Kontakty, které nikdy nebyly v žádném seznamu, segmentům odpovídají, ale kampaně nedostávají. Blokované adresy se do počtu stále započítávají a při odeslání kampaně se přeskočí.

Pole **Subscription status** používá stejné pravidlo, takže podmínka **Subscription status** je `subscribed` zúží segment na kontakty, které kampaně zasáhnou.

## Vytvořte segment

1. Otevřete **Email Marketing → Segments** a vyberte **Create segment**.
2. V části **Details** zadejte do pole **Name** název a případně do pole **Description** popis pro svůj tým.
3. V části **Type** zvolte **Segment**, nebo **Tracked segment**. Typ později změnit nelze. Viz [Běžné a sledované segmenty](#plain-and-tracked-segments).
4. V části **Contacts from** zvolte **All contacts**, nebo **Subscribers of specific audiences** a vyberte seznamy v poli **Audiences**.
5. V části **Filters** vyberte **Add condition** a zvolte pole, operátor a hodnotu. Tlačítkem **Add group** přidáte další skupinu podmínek a přepínáním **all** a **any** určíte, jak se podmínky a skupiny kombinují.
6. Zkontrolujte panel **Preview**: počet **Matching contacts**, kolik z nich je přihlášených, a **First matches**. Náhled se při úpravách průběžně aktualizuje.
7. Vyberte **Save segment**.

Segment můžete založit i z jiných stránek:

- **Save as segment** v přehledu kontaktů převede aktuální filtry seznamu na segment. Filtry, které segmenty nepodporují, se vynechají a editor je vypíše.
- **Create segment** v nabídce stránky seznamu kontaktů založí segment s tímto seznamem jako zdrojem.
- **Duplicate** v nabídce řádku segmentu ho zkopíruje jako nový segment.

Úplný přehled polí, operátorů a hodnot najdete v referenci API na stránce [Vytvoření segmentu](/cs/docs/api-reference/segments/create/#conditions).

## Stránka segmentu

Segment otevřete jeho výběrem na stránce **Email Marketing → Segments**. Stránka ukazuje údaje **Contacts**, **Subscribed** a **Updated**, panel **Definition** s definicí segmentu a kontakty, které mu právě odpovídají, s vyhledáváním a filtry. Kontakty se vypisují živě, takže se výpis mění spolu s kontakty.

V záhlaví můžete segment upravit tlačítkem **Edit**, tlačítkem **Create campaign** založit kampaň, která se mu odešle, nebo ho v nabídce smazat volbou **Delete**.

## Odešlete kampaň segmentu

V kroku **Recipients** kampaně vyberte v poli **Segments** jeden nebo více segmentů, samostatně, nebo spolu s **Audiences**. Pokud chcete někoho vynechat, použijte **Exclude audiences** a **Exclude segments**. Viz [Vytvoření kampaně](/cs/docs/campaigns/create/#step-1-recipients).

- **Segmenty se vyhodnotí při odeslání.** Emailit určí příjemce při zahájení odesílání, takže se zahrnou kontakty, které do té doby začaly odpovídat, a vynechají se kontakty, které odpovídat přestaly.
- **Jedna kopie na adresu.** Kontakt, který je v několika vybraných seznamech a segmentech, dostane kampaň jednou.
- **Vyloučení má přednost.** Kontakt ve vyloučeném seznamu nebo segmentu se přeskočí, i když je zároveň ve vybraném.
- **Smazaná vyloučení zastaví odeslání.** Pokud kampaň vylučuje seznam kontaktů nebo segment, který už neexistuje, Emailit ji neodešle: odeslání vrátí chybu a naplánovaná kampaň se vrátí do stavu **Draft**. Upravte její příjemce a pak ji odešlete znovu.

Segment nelze smazat, dokud ho používá naplánovaná nebo právě odesílaná kampaň. Smazání segmentu ho odebere z konceptů kampaní, které mu odesílají. Koncepty, které ho vylučují, si vyloučení ponechají a nelze je odeslat, dokud ho nenahradíte, takže je lidé, které jste chtěli vynechat, nikdy nedostanou.

## Běžné a sledované segmenty

Při vytváření segmentu zvolíte jeho typ:

| | **Segment** | **Tracked segment** |
| --- | --- | --- |
| Počty, výpis kontaktů a kampaně | Živě | Živě |
| Zaznamenává, kdo vstoupí a kdo odejde, a kdy | Ne | Ano |
| Spouští automatizace při vstupech a odchodech | Ne | Ano |
| Odesílá webhooky `segment.contact_added` a `segment.contact_removed` | Ne | Ano |
| Graf **Growth** a sloupec **Joined** | Ne | Ano |
| Tarify | Všechny | Pro, Business a Custom |

Jakmile segment existuje, jeho typ se už nemění. Pokud chcete typ změnit, vytvořte nový segment se stejnými pravidly. Viz [Sledované segmenty](/cs/docs/segments/tracked/).

Automatizace mohou také kontrolovat kterýkoli segment, sledovaný i běžný, v kroku If/Else **Condition**, v cíli, v kroku **Wait until** nebo v podmínce ukončení: **Segment** is in **VIP customers**. Viz [Condition (If/Else)](/cs/docs/automations/steps/#condition-ifelse). Segment, který automatizace používá, nelze smazat, dokud automatizaci nezměníte.

## Limity

Každý tarif zahrnuje určitý počet segmentů na workspace. Sledované i běžné segmenty se počítají do stejného limitu.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Segmenty | 3 | 10 | 100 | Flexibilní |
| Sledované segmenty | — | V ceně | V ceně | V ceně |

Přehled segmentů ukazuje, kolik jich využíváte, například `3/10 used`. Po dosažení limitu jsou **Create segment** a **Duplicate** neaktivní, dokud nesmažete některý segment nebo [nepřejdete na vyšší tarif](/cs/docs/billing/plans/). API vrací `422` s aktuálním `usage`:

```json
{
  "error": "Pay as you go includes 3 segments.",
  "message": "Pay as you go includes 3 segments.",
  "usage": { "used": 3, "limit": 3 }
}
```

Pokud přejdete na nižší tarif, vaše segmenty fungují dál, ale další nepřidáte, dokud nebudete pod novým limitem. V tarifu Pay as you go se sledované segmenty pozastaví. Viz [Když se sledování pozastaví](/cs/docs/segments/tracked/#when-tracking-pauses).

Segment může mít nejvýše 10 skupin a 50 pravidel a čerpat nejvýše ze 100 seznamů kontaktů.

## Práce s API a MCP

[API segmentů](/cs/docs/api-reference/segments/) umožňuje segmenty [vytvářet](/cs/docs/api-reference/segments/create/), [načítat](/cs/docs/api-reference/segments/get/), [upravovat](/cs/docs/api-reference/segments/update/), [vypisovat](/cs/docs/api-reference/segments/list/) a [mazat](/cs/docs/api-reference/segments/delete/), [vypisovat jejich kontakty](/cs/docs/api-reference/segments/contacts/), zobrazit [náhled](/cs/docs/api-reference/segments/preview/) definice před uložením a [vypsat pole](/cs/docs/api-reference/segments/fields/), která mohou pravidla používat. API potřebuje API klíč s oprávněním **Full Access**.

```bash
curl https://api.emailit.com/v2/segments \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme team",
    "conditions": { "rules": [{ "field": "email_domain", "operator": "equals", "value": "acme.com" }] }
  }'
```

Pokud chcete kampaň odeslat segmentu, přidejte do jejích `recipients` přes [Úpravu kampaně](/cs/docs/api-reference/campaigns/update/) objekt `{ "segment_id": "seg_…" }`, nebo `{ "segment_id": "seg_…", "exclude": true }`, pokud ho chcete vyloučit.

Na [MCP serveru](/cs/docs/mcp/) má sada nástrojů `segments` stejné operace, takže AI asistent za vás může segmenty sestavit a zkontrolovat. Viz [Sady nástrojů](/cs/docs/mcp/toolsets/).

## Další kroky

  - [Sledované segmenty](/cs/docs/segments/tracked/): Zaznamenávejte vstupy a odchody a spouštějte automatizace.
  - [Vytvoření kampaně](/cs/docs/campaigns/create/): Odesílejte segmentům a jiné vylučte.
  - [Vlastní pole](/cs/docs/contacts/custom-fields/): Ukládejte data, podle kterých pravidla filtrují.
  - [API segmentů](/cs/docs/api-reference/segments/): Všechny endpointy segmentů.

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