Spuštění a statistiky automatizací

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 zjistit, proč spuštění selhalo, a jak stejná data načíst přes API.

Karta Overview

Otevřete automatizaci v Email Marketing›Automations. 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:

U e-mailů z automatizací se načtení a prokliky neměří, takže Opened a Clicked u nich zůstávají na 0. Viz Send email.

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 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í a v pořadí všechny kroky, kterými prošlo, se stavem 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.

Odlaďte neúspěšné spuštění

1. Najděte neúspěšná spuštění. Na kartě Runs vyfiltrujte Status failed.

2. Otevřete spuštění. Krok, který selhal, je označený červeně.

3. Přečtěte si chybu. Rozbalte Output data u kroku, který selhal. Pole error uvádí, co se pokazilo, například send_email: Sending domain is not verified or not found. Časté chyby a jejich řešení najdete v části Když krok selže.

4. 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 Wait. Otevřete ho a uvidíte, na kterém kroku je.

Práce s API

Výpis spuštění vrací spuštění automatizace od nejnovějšího. Filtrujte parametrem filter[status] (running, completed, failed nebo canceled) 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",
      "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, status, data (výstup včetně případného error), started_at a completed_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": { "delivered": 110, "bounced": 3, "accepted": 5, "error": 2 },
      "funnel": { "accepted": 115, "delivered": 110, "loaded": 0, "clicked": 0, "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.

Související