Newsletterové kampaně

Newsletterová kampaň je plánovaná hromadná rozesílka specifického obsahu definované skupině odběratelů. Modul /newsletter-job umožňuje operátorovi kampaň připravit, spustit, sledovat její průběh v reálném čase a následně vyhodnotit její výkon. Na rozdíl od jednorázového transakčního e-mailu se kampaň primárně liší tím, že běží v dávkách s rychlostními limity — za minutu je odeslán pouze určitý počet zpráv — aby se zabránilo blokování poštovními servery a udržela se doručitelnost ostatních zpráv z dané domény. Modul spoléhá na Newsletter jako zdroj odběratelů a E-mailer jako odesílací infrastrukturu; bez obou těchto komponent by kampaň neměla komu doručovat, ani prostředky k doručení.

Přehled kampaní

Tabulka kampaní sdružuje běžící i dokončené rozesílky a poskytuje operátorovi okamžitý přehled o tom, kolik příjemců již bylo obslouženo a kolik jich stále čeká ve frontě. Klíčovým prvkem je vizuální indikátor průběhu ve sloupci Progress, protože velká kampaň s nízkým limitem za minutu může snadno běžet několik dní — a administrátor potřebuje na první pohled vědět, zda má stále smysl zasahovat.Jednotlivé sloupce zobrazují:

• Předmět zprávy — text předmětu e-mailu; odkaz vede na detail kampaně.
• Průběh — vizuální indikátor postupu odesílání (čekající vs. odesláno).
• Zahájení odesílání — čas, kdy byla kampaň skutečně spuštěna.
• Max / min — rychlostní limity, tj. maximální počet zpráv za minutu a za den.
• ID běžce — identifikace procesu aktuálně obsluhujícího kampaň.
• Celkem / Odeslaných / Čekajících kontaktů — rozdělení příjemců podle stavu doručení.
• Data — časová razítka pro vytvoření, poslední aktualizaci a dokončení.

Tabulka se automaticky obnovuje každých 20 sekund. Dokončené kampaně zůstávají v seznamu a lze je kdykoli otevřít pro zobrazení statistik, porovnání s předchozími rozesílkami nebo pro inspiraci při přípravě nových.

Životní cyklus kampaně

Kampaň prochází předvídatelnou sekvencí fází od přípravy obsahu až po finální statistiky. Každá fáze má svůj vizuální identifikátor ve sloupci Progress a v hlavičce detailu, takže operátor na první pohled ví, zda má do kampaně zasahovat nebo ji nechat běžet. Oddělení přípravy, plánování a samotného odesílání umožňuje předem zkontrolovat vše — obsah, publikum a limity — a rozesílku spustit až ve chvíli, kdy je operátor přesvědčen.

1. Příprava — operátor vytváří obsah (předmět, HTML, přílohy) a vybírá publikum.
2. Plánování — nastavuje se čas spuštění a rychlostní limity.
3. Spuštění — systém postupně přidává odběratele do fronty běžce.
4. Odesílání — běžec odesílá jednotlivé e-maily v dávkách, aktualizuje jejich stav a zaznamenává otevření.
5. Dokončení — všichni příjemci byli obslouženi nebo operátor kampaň ručně ukončil.

Rychlostní limity kampaní

Každá kampaň má dva nezávislé limity, které řídí, jak rychle se zprávy dostanou do schránek příjemců. Důvodem jejich existence je ochrana reputace odesílací domény — pokud by systém v několika sekundách rozeslal tisíce zpráv, poštovní servery by to vyhodnotily jako spamovou vlnu a začaly by odmítat nebo filtrovat následné zprávy do spamu. Limity tedy nejsou jen technickým opatřením, ale součástí dlouhodobé strategie doručitelnosti.Konkrétně lze nastavit:

• Maximální počet zpráv za minutu — výchozí hodnota je 30; zabraňuje krátkodobému přetížení odesílacího serveru.
• Maximální počet zpráv za den — volitelný strop, který operátorovi dává kontrolu nad celkovým denním objemem.

Kromě toho systém automaticky upravuje doporučenou rychlost na základě dominantního poskytovatele e-mailu v cílovém publiku: pro Gmail doporučuje až 6 zpráv za minutu (Gmail je nejpřísnější), pro Resend 50 zpráv za minutu a pro ostatní poskytovatele 30 zpráv za minutu.

💡 Při prvním použití nové odchozí domény je vhodné nastavit výrazně nižší limity a postupně je v dalších kampaních zvyšovat. Poštovní servery posuzují nové odesílatele přísněji a rychlé zvýšení objemu může vést k okamžitému zařazení na černou listinu.

Běžec — Proces odesílání

Běžec je interní pracovní proces, který fyzicky obstarává kampaň — to znamená, že načítá jednotlivé příjemce z fronty, odesílá jim zprávy a zaznamenává výsledek. Každá běžící kampaň má přesně jednoho běžce, identifikovaného ID ve sloupci tabulky. Aby se detekovaly situace, kdy běžec spadne nebo zamrzne, posílá běžec pravidelně tzv. signál srdečního tepu (heartbeat) — pokud se signál zastaví, kampaň se automaticky uvolní a může ji převzít jiný běžec (např. po restartu systému). Tím se zabraňuje tomu, aby kampaň uvízla kvůli technické poruše jednoho procesu.Během svého provozu běžec:

• Přebírá kampaň dle dohodnutého ID a pravidelně odesílá heartbeat signály.
• Páruje kontakty do fronty v dávkách dle rychlostního limitu a plánovaného času.
• Odesílá e-maily prostřednictvím nakonfigurovaného SMTP, vkládá sledovací pixel a patičku pro odhlášení.
• Aktualizuje stav každého odběratele (datum odeslání, počet neúspěšných pokusů, případná chybová zpráva).

Maximální počet neúspěšných pokusů u jednoho kontaktu je 5. Po jejich vyčerpání je příjemce přeskočen a označen jako neodeslaný, aby se kampaň nezasekávala na jedné problematické adrese a zbytek seznamu obdržel zprávu včas.

Akce kampaně

V detailu kampaně a v kontextové nabídce řádku jsou pro operátora dostupné akce pro správu kampaně během jejího životního cyklu. Pro většinu situací postačují Spustit a Zastavit; speciální akce jsou navrženy pro řešení chybových stavů nebo pro řízené experimenty. Jejich kombinace umožňuje dočasně zmrazit kampaň, obnovit ji po selhání nebo vyčistit její frontu před novou iterací.

• Spustit — spustí kampaň, nastaví čas spuštění a uvolní ji do fronty běžce; slouží také k obnovení po ručním zastavení.
• Pozastavit — uvolní aktuálního běžce, kampaň zůstává spuštěná, ale nikdo dočasně neodesílá.
• Obnovit — po pozastavení obnoví heartbeat a vymaže příznak „dokončeno“; běžec ji znovu převezme.
• Zastavit / Zrušit — označí kampaň jako dokončenou, uvolní běžce a zastaví další odesílání.
• Opakovat — resetuje všechny již odeslané příjemce a znovu spustí kampaň; každý příjemce tak obdrží zprávu podruhé.
• Zkusit znovu selhané — resetuje počet pokusů u selhaných kontaktů a kampaň se opět nastaví na spuštěnou.
• Vymazat čekající — smaže všechny neodeslané příjemce bez chyby.
• Zobrazit statistiky / Zobrazit log — otevře podrobný přehled doručení a technických událostí.

⚠️ Akce Opakovat je destruktivní z hlediska zákaznické zkušenosti — příjemci obdrží stejnou zprávu znovu. Použijte ji pouze v případě, že víte, že první pokus skutečně selhal. Pro opakování pouze selhaných odeslání se používá cílenější akce Zkusit znovu selhané.

Sledování otevření a geolokace

Systém automaticky vkládá do každé odchozí zprávy malý neviditelný obrázek — takzvaný sledovací pixel. Když příjemce zprávu otevře, jeho e-mailový klient načte pixel ze serveru, a systém tak zaznamená, že došlo k zobrazení. Ze stejného HTTP požadavku získá také přibližnou geolokaci a IP adresu, takže analýzy mohou odhalit, kde a kdy příjemce zprávu přečetl. Tato data pomáhají vyhodnotit nejen celkový dopad kampaně, ale také vhodný čas odeslání pro danou geografickou skupinu.Pro každé otevření se ukládá:

• Datum a čas otevření — přesný okamžik načtení pixelu.
• IP adresa — ze které bylo zobrazení provedeno.
• Geolokace — stát a případně město, odvozené z IP.
• Opakovaná otevření — počet, kolikrát stejný příjemce zprávu otevřel.

Kromě otevření systém sleduje také počet pokusů o doručení, datum úspěšného odeslání a případnou chybovou zprávu SMTP serveru pro každého odběratele kampaně.

ℹ️ Sledovací pixel funguje pouze v e-mailových klientech, které načítají externí obrázky. Někteří příjemci mají tuto funkci zakázanou z důvodů ochrany soukromí (typicky Apple Mail Privacy Protection), takže statistiky otevření jsou orientační — skutečný počet čtenářů je obvykle vyšší než naměřený.

Detail kampaně

Kliknutím na předmět se otevře detail kampaně, rozdělený do funkčních sekcí, jejichž uspořádání odpovídá typickému pracovnímu postupu — od kontroly obsahu přes průběžné sledování až po finální analýzu. Záhlaví zobrazuje barevně odlišený stav a tlačítka pro všechny dostupné akce, takže operátor nemusí přepínat mezi obrazovkami.

• Obsah kampaně — předmět, HTML obsah, přílohy a vložené obrázky.
• Tabulka příjemců — seznam všech kontaktů s počtem pokusů, datem odeslání, IP adresou, geolokací a indikátorem otevření.
• Statistiky doručení — součty odeslaných, doručených, selhaných a otevřených zpráv.
• Log — technický záznam všech událostí od jednotlivých běžců.

Dokončení kampaně

Kampaň se automaticky dokončí, jakmile byli všichni příjemci obslouženi — buď úspěšně odesláni, nebo přeskočeni po vyčerpání pokusů. Systém nastaví datum dokončení a uvolní běžce, čímž se výpočetní kapacita stane dostupnou pro jiné úkoly. Dokončené kampaně zůstávají trvale uloženy pro retrospektivní analýzu a srovnání mezi jednotlivými rozesílkami v průběhu času.

💡 U opakovaných kampaní stejnému publiku se vyplatí sledovat trend v počtu otevření a odhlášení. Prudké zvýšení počtu odhlášení je signálem, že by mohlo být vhodné přehodnotit frekvenci odesílání nebo charakter obsahu — publikum přestává vnímat kampaně jako relevantní.