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

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í.

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 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 přepíše výchozí nastavení domény pro danou zprávu:

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

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.

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:

{
  "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ů.

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.
• Analytika. Widgety Loads a Clicks zobrazují zapojení v čase. Viz Analytika.
• Reporty kampaní. Načtení, prokliky a míra prokliků za každou kampaň a k tomu prokliky na jednotlivé odkazy. Viz Reporty kampaní.
• 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