# Měření otevření a prokliků

> Jak Emailit měří otevření pixelem a prokliky přepsanými odkazy na vaší vlastní doméně, jak přesná jsou data a jak měření zapnout nebo vypnout.

Emailit umí zaznamenat, kdy příjemci otevřou vaše e-maily a kliknou na odkazy v nich. Měření běží na názvu hostitele na vaší vlastní doméně, například `go.acme.com`, takže příjemci nikdy neuvidí sdílenou doménu pro měření. Tato stránka vysvětluje, jak měření funguje, jaká má omezení a jak ho ovládat.

## Jak to funguje

Měření funguje, jen když má odesílací doména ověřený CNAME záznam pro měření (`go.<domain>` odkazující na `go.emailitmail.com`). Bez něj Emailit vaši poštu odešle také, jen bez měření. Nejdřív si [nastavte vlastní doménu pro měření](/cs/docs/tracking/custom-tracking-domain/).

**Otevření (načtení).** Emailit přidá na konec těla HTML průhledný obrázek 1×1, který se načítá z `https://go.acme.com/<token>`. Když ho poštovní aplikace příjemce načte, Emailit zaznamená načtení a obrázek vrátí. Otevření lze měřit jen u HTML e-mailů.

**Prokliky.** Před odesláním Emailit přepíše všechny odkazy `http` a `https` v části HTML i v části s prostým textem na `https://go.acme.com/<token>`. Když na odkaz někdo klikne, Emailit zaznamená proklik a okamžitě přesměruje na původní URL. Odkazy `mailto:` a `tel:`, relativní odkazy a odkazy na vlastní domény Emailitu ponechá beze změny. Pokud má zpráva HTML, ale nemá část s prostým textem, Emailit ji při přidávání měření prokliků z HTML vygeneruje.

Emailit u otevření mluví o načtení (**loaded**), protože vidí jen to, že se obrázek načetl, ne že e-mail přečetl člověk.

## Přesnost a soukromí

Data o otevřeních a proklicích berte jako signál, ne jako přesný počet. Emailit zaznamená každý požadavek, který dorazí na vaši doménu pro měření, a automatický provoz neodfiltrovává.

- **Apple Mail Privacy Protection** stahuje obrázky včetně pixelu přes proxy servery Applu hned, jak pošta dorazí. Takové zprávy se zobrazí jako načtené, i když je nikdo neotevřel, a IP adresa patří Applu.
- **Proxy servery pro obrázky**, například u Gmailu, stahují obrázky za příjemce a ukládají je do mezipaměti. IP adresa a user agent patří proxy serveru a opakovaná otevření se k Emailitu nemusí dostat.
- **Blokované obrázky** znamenají, že se otevření nezaznamená, ani když příjemce e-mail čte.
- **Bezpečnostní skenery** ve firemních poštovních systémech procházejí odkazy, aby je zkontrolovaly dřív, než zprávu uvidí příjemce. Zobrazí se jako prokliky, často během několika sekund po doručení.

Prokliky jsou spolehlivějším signálem zapojení než otevření. Při rozhodování o doručitelnosti sledujte trendy u mnoha zpráv, ne jednotlivé události.

Měření zaznamenává IP adresu a user agent každého otevření a prokliku. V mnoha regionech vám zákony na ochranu soukromí ukládají příjemce o měření informovat, například v zásadách ochrany osobních údajů, a některé vyžadují souhlas. Pokud data nepotřebujete, nechte měření vypnuté.

## Zapněte měření

### Výchozí nastavení domény

Každá doména má na své stránce v **Email API → Domains** v panelu **Tracking** dva přepínače: **Track loads** a **Track clicks**. U nových domén jsou vypnuté a zůstávají neaktivní, dokud CNAME záznam pro měření neukazuje **OK**.

Přepínače určují výchozí nastavení pro všechny e-maily odeslané z domény přes API a SMTP. Přes SMTP je výchozí nastavení domény jediný způsob, jak měření ovládat.

Přes API zavolejte endpoint [Úprava domény](/cs/docs/api-reference/domains/update/) s poli `track_loads` a `track_clicks`. Pokud kterékoli z nich zapnete dřív, než je CNAME záznam ověřený, API vrátí `422`.

### Přepsání u jednotlivých e-mailů

Pole `tracking` v endpointu [Odeslání e-mailu](/cs/docs/api-reference/emails/send/) přepíše výchozí nastavení domény pro danou zprávu:

| Hodnota | Otevření | Prokliky |
| --- | --- | --- |
| Vynecháno | Výchozí nastavení domény | Výchozí nastavení domény |
| `true` | Zapnuto | Zapnuto |
| `false` | Vypnuto | Vypnuto |
| `{ "loads": true, "clicks": false }` | Zapnuto | Vypnuto |
| `{ "clicks": true }` | Vypnuto | Zapnuto |

V objektovém zápisu se klíč, který vynecháte, počítá jako vypnutý. Výchozí nastavení domény ho nedoplní.

```bash
curl https://api.emailit.com/v2/emails \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "tracking": { "loads": false, "clicks": true }
  }'
```

Pokud CNAME záznam pro měření dané domény není ověřený, Emailit u zprávy měření vypne, místo aby ji odmítl. Objekt `tracking` v odpovědi ukazuje, co se skutečně použilo.

E-maily z kampaní měření otevření a prokliků vždy vyžadují, takže se měří, kdykoli je CNAME záznam pro měření odesílací domény ověřený. Testovací odeslání kampaně se neměří.

## Události

Každé otevření a každý proklik vytvoří událost, nejen ten první. Stav e-mailu se po prvním otevření změní na `loaded` a po prvním prokliku na `clicked`.

| Událost | Kdy nastane |
| --- | --- |
| [`email.loaded`](/cs/docs/webhooks/events/email/loaded/) | Načetl se měřicí pixel. |
| [`email.clicked`](/cs/docs/webhooks/events/email/clicked/) | Někdo klikl na měřený odkaz. |

Obsah obou událostí zahrnuje IP adresu a user agent požadavku, e-mail, ke kterému patří, a odpovídající kontakt, pokud existuje. `email.clicked` navíc obsahuje odkaz. Toto je `data.object` události `email.clicked`:

```json
{
  "id": "click_7Tn4Lp9Kd2Rv",
  "object": "click",
  "email_id": "em_5Vb2Nq8Xc1Jm",
  "email": {
    "id": "em_5Vb2Nq8Xc1Jm",
    "rcpt_to": "ada@example.com",
    "mail_from": "hello@acme.com",
    "subject": "Your receipt",
    "created_at": "2026-10-01T09:12:44Z",
    "campaign": null,
    "meta": { "order_id": "1042" }
  },
  "link": {
    "id": "link_9Wd3Ks6Mf4Ht",
    "url": "https://acme.com/orders/1042"
  },
  "contact": { "id": "con_8Ry5Bv2Lq7Np", "email": "ada@example.com" },
  "ip_address": "203.0.113.24",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15",
  "created_at": "2026-10-01T09:15:02Z"
}
```

`email.loaded` má stejný tvar s `"object": "load"`, ID začínajícím na `load_` a bez `link`. Úplný formát požadavku popisuje stránka [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/).

## Kde data o měření najdete

- **Detail e-mailu.** Karty **Loads** a **Clicks** na stránce e-mailu uvádějí každé otevření a proklik s časem, IP adresou a u prokliků i s URL. Viz [Detail e-mailu](/cs/docs/logs/email-details/).
- **Analytika.** Widgety **Loads** a **Clicks** zobrazují zapojení v čase. Viz [Analytika](/cs/docs/analytics/).
- **Reporty kampaní.** Načtení, prokliky a míra prokliků za každou kampaň a k tomu prokliky na jednotlivé odkazy. Viz [Reporty kampaní](/cs/docs/campaigns/reports/).
- **Události a webhooky.** Každá událost `email.loaded` a `email.clicked` se zobrazí v **Email API → Events** a odešle se webhookům, které ji odebírají.

## Další kroky

  - [Vlastní doména pro měření](/cs/docs/tracking/custom-tracking-domain/): Zveřejněte a ověřte CNAME záznam pro měření.
  - [Nastavte webhooky](/cs/docs/webhooks/set-up/): Přijímejte události email.loaded a email.clicked.

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