Návod
Spuštění a statistiky automatizací
Sledujte spuštění automatizace, čtěte přehled a statistiky jednotlivých kroků, rušte spuštění, laďte neúspěšná spuštění a načítejte spuštění a statistiky přes API.
Pokaždé, když se aktivuje spouštěč, automatizace vytvoří spuštění. Tato stránka ukazuje, kde najdete spuštění a jejich výsledky, co znamenají statistiky jednotlivých kroků, jak spuštění zrušit, jak zjistit, proč spuštění selhalo, a jak totéž udělat přes API.
Karta Overview
Otevřete automatizaci v Email MarketingAutomations. Karta Overview ukazuje:
- Počty Total executions, Completed, Failed a Running.
- Diagram postupu jen pro čtení. Když vyberete libovolný krok, zobrazí se jeho Stats.
- Tlačítko Edit, které otevře editor, dokud je automatizace koncept nebo je pozastavená.
Dokud automatizace běží, čísla se obnovují každých 10 sekund.
Statistiky kroků
Stats každého kroku počítají, kolik spuštění se ke kroku dostalo a co se v něm stalo. Co uvidíte, závisí na kroku:
| Krok | Statistiky |
|---|---|
| Send email | Trychtýř Accepted, Delivered, Opened a Clicked, každý jako podíl z přijatých e-mailů, a k tomu počty Bounced, Failed, Complained a Unsubscribed. Počty sledují každý e-mail i poté, co ho krok odeslal. |
| Condition (If/Else) | Matched (spuštění pokračovalo větví Yes) a Not matched (pokračovalo větví No). |
| Webhook | 2xx Success, 4xx Client Error, 5xx Server Error, Timeout a Network Error. |
| Random split (API) | Počet spuštění pro každou variantu. |
| Všechny ostatní kroky | Počet spuštění podle stavu, například Completed, Waiting, Skipped a Failed. |
Opened a Clicked se počítají, když odesílací doména měří načtení a prokliky. Marketingové e-maily přeskočené kvůli odhlášeným kontaktům mají výsledek skipped. Výsledky kroku Wait until jsou matched a timeout, výsledky kroku Goal reached a not_reached.
Karta Runs
Karta Runs uvádí všechna spuštění od nejnovějšího. U každého ukazuje sloupec Status, ve sloupci Event událost, která spuštění zahájila, ve sloupci Contact kontakt, ve sloupci Note důvod, proč se zrušené spuštění zastavilo, ve sloupcích Started a Completed časy zahájení a dokončení a ve sloupci Duration dobu trvání. Filtrovat můžete podle stavu, události nebo data vytvoření.
Když vyberete spuštění, zobrazí se jeho detail: stav, čas zahájení a ukončení, na co čeká, a v pořadí všechny kroky, kterými prošlo, se stavem, výsledkem a dobou trvání každého kroku. Když u kroku rozbalíte Output data, uvidíte, co krok vrátil, například ID e-mailu, který odeslal, větev, kterou zvolila podmínka, nebo chybu, kvůli které krok selhal.
| Stav spuštění | Význam |
|---|---|
| Running | Prochází kroky, nebo čeká v kroku Time delay či Wait until. |
| Completed | Došlo na konec své cesty nebo ke kroku End automation, nebo přešlo do jiné automatizace. |
| Failed | Některý krok selhal, nebo workspace neměl dost kreditů na zahájení spuštění. |
| Canceled | Skončilo předčasně. Sloupec Note uvádí proč: Met an exit condition, Left the audience, Canceled by a user, Removed with the API, Removed by another automation, Automation stopped nebo Contact deleted. |
Kroky přeskočené proto, že spuštění přeskočilo k cíli, se zobrazují jako skipped.
Zrušte spuštění
Pokud chcete jeden kontakt z automatizace vyřadit, otevřete jeho spuštění na kartě Runs a vyberte Cancel run. Jeho čekající kroky se zruší a další kroky se už neprovedou. Zrušená spuštění nelze obnovit; nová aktivace spouštěče zahájí nové spuštění.
Přes API:
- Zrušení spuštění:
POST /v2/automations/{id}/runs/{run_id}/cancel, s volitelnýmreason. - Odebrání kontaktu z automatizace:
POST /v2/automations/{id}/exitscontact_idneboemailzruší všechna spuštění daného kontaktu v automatizaci, například když váš e-shop zaznamená zaplacení objednávky. - Výpis spuštění kontaktu:
GET /v2/automations/runs?email=…ukáže, ve kterých automatizacích kontakt je.
Pokud to chcete dělat automaticky, použijte místo toho podmínky ukončení.
Odlaďte neúspěšné spuštění
-
Najděte neúspěšná spuštění. Na kartě Runs vyfiltrujte Status
failed. -
Otevřete spuštění. Krok, který selhal, je označený červeně.
-
Přečtěte si chybu. Rozbalte Output data u kroku, který selhal. Pole
erroruvádí, co se pokazilo, napříkladsend_email: Sending domain is not verified or not found. Časté chyby a jejich řešení najdete v části Když krok selže. -
Odstraňte příčinu. Pokud jde o nastavení kroku, vyberte Pause, opravte krok na kartě Editor, vyberte Save a pak Start. Pokud jde o problém workspace, například chybějící kredity nebo neověřenou doménu, vyřešte ho v sekci Workspace nebo Email API.
Spuštění, které selhalo bez jediného kroku, obvykle selhalo proto, že workspace neměl 3 kredity potřebné k jeho zahájení. V API pak jeho meta obsahuje "failure_reason": "insufficient_credits". Dokupte kredity, nebo zapněte automatické dobíjení, aby spuštění neselhávala.
Neúspěšná spuštění se neopakují. Nové aktivace spouštěčů zahajují nová spuštění jako obvykle. Pokud chcete automatizaci znovu spustit pro kontakt nebo e-mail, u kterého selhala, vyvolejte jeho spouštěč znovu, například tak, že kontakt ze seznamu kontaktů odeberete a znovu ho přidáte.
Spuštění, které zůstává dlouho ve stavu Running, obvykle čeká v kroku Time delay nebo Wait until. Otevřete ho a uvidíte, na kterém kroku je a na co čeká.
Práce s API
Výpis spuštění vrací spuštění automatizace od nejnovějšího. Filtrujte parametry filter[status] (running, completed, failed nebo canceled) a filter[contact_id] a stránkujte parametry page a per_page (až 100):
curl -G "https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/runs" \
--data-urlencode "filter[status]=failed" \
--data-urlencode "per_page=25" \
-H "Authorization: Bearer $EMAILIT_API_KEY"{
"data": [
{
"id": "aur_7Kp2Vx9mQt4Lw",
"automation_id": "aut_3Mv8Xq2nKp5Lt",
"contact_id": "con_2kq8Vt4xLm7Rz",
"email_id": null,
"event_id": null,
"event": "contact.added_to_audience",
"payload": { "object": { "id": "sub_7Rt2vX9kLm3Qp", "object": "subscriber" } },
"meta": { "source_event_id": "evt_2Hn6Wq8rTc3Mz" },
"status": "failed",
"cancel_reason": null,
"started_at": "2026-10-01T09:30:00Z",
"completed_at": "2026-10-01T09:30:02Z",
"created_at": "2026-10-01T09:30:00Z",
"updated_at": "2026-10-01T09:30:02Z"
}
],
"total_records": 1,
"per_page": 25,
"current_page": 1,
"total_pages": 1
}Načtení spuštění navíc vrací run_steps, kde má každý krok pole step_id, step_key, action, status, outcome, data (výstup včetně případného error), started_at a completed_at, a waits, tedy kroky Wait until a Goal, ve kterých spuštění čeká nebo čekalo, s tím, na co čekají (kind, event), jejich stavem status a timeout_at.
Načtení statistik vrací statistiky všech kroků podle klíče kroku. Zúžit je můžete parametry since a until (ISO 8601) nebo run_ids[]. Načtení statistik kroků vrací statistiky jednoho kroku:
{
"data": {
"send_email-1": {
"total": 120,
"by_status": { "completed": 118, "failed": 2 },
"by_outcome": { "accepted": 5, "delivered": 58, "loaded": 43, "clicked": 9, "bounced": 3, "error": 2 },
"funnel": { "accepted": 115, "delivered": 110, "loaded": 52, "clicked": 9, "bounced": 3, "failed": 0, "complained": 0, "unsubscribed": 0 }
}
}
}by_status počítá, jak krok v jednotlivých spuštěních skončil. by_outcome počítá jeho výsledky, například poslední stav e-mailu, který odeslal, nebo matched a not_matched u podmínky. funnel se uvádí u kroků Send email.