# Durchläufe und Statistiken von Automatisierungen

> Verfolgen Sie die Durchläufe einer Automatisierung, lesen Sie die Übersicht und die Statistiken pro Schritt, debuggen Sie fehlgeschlagene Durchläufe und rufen Sie Durchläufe und Statistiken per API ab.

Jedes Mal, wenn ein Trigger auslöst, erstellt die Automatisierung einen Durchlauf. Diese Seite zeigt, wo Sie Durchläufe und ihre Ergebnisse sehen, was die Statistiken der einzelnen Schritte bedeuten, wie Sie herausfinden, warum ein Durchlauf fehlgeschlagen ist, und wie Sie dieselben Daten per API lesen.

## Tab Overview

Öffnen Sie eine Automatisierung unter **Email Marketing → Automations**. Der Tab **Overview** zeigt:

- Die Zähler **Total executions**, **Completed**, **Failed** und **Running**.
- Ein schreibgeschütztes Diagramm des Ablaufs. Wählen Sie einen beliebigen Schritt aus, um seine **Stats** zu sehen.
- **Edit**, das den Editor öffnet, solange die Automatisierung ein Entwurf oder pausiert ist.

Während die Automatisierung läuft, aktualisieren sich die Zahlen alle 10 Sekunden.

## Schrittstatistiken

Die **Stats** jedes Schritts zählen, wie viele Durchläufe ihn erreicht haben und was dort passiert ist. Was Sie sehen, hängt vom Schritt ab:

| Schritt | Statistiken |
| --- | --- |
| **Send email** | Ein Trichter aus **Accepted**, **Delivered**, **Opened** und **Clicked**, jeweils als Anteil der angenommenen E-Mails, dazu die Anzahl von **Bounced**, **Failed**, **Complained** und **Unsubscribed**. Die Zähler verfolgen jede E-Mail, nachdem der Schritt sie gesendet hat. |
| **Condition (If/Else)** | **Matched** (der Durchlauf nahm **Yes**) und **Not matched** (er nahm **No**). |
| Call webhook (API) | **2xx Success**, **4xx Client Error**, **5xx Server Error**, **Timeout** und **Network Error**. |
| Random split (API) | Durchläufe pro Variante. |
| Alle anderen Schritte | Durchläufe pro Status, etwa **Completed**, **Waiting** und **Failed**. |

Bei E-Mails aus Automatisierungen werden Ladevorgänge und Klicks nicht getrackt, daher bleiben **Opened** und **Clicked** bei ihnen auf 0. Siehe [Send email](/de/docs/automations/steps/#send-email).

## Tab Runs

Der Tab **Runs** listet alle Durchläufe auf, die neuesten zuerst, mit **Status**, dem **Event**, das den Durchlauf gestartet hat, den Zeitpunkten **Started** und **Completed** sowie der **Duration**. Filtern Sie nach Status, Event oder Erstellungsdatum.

Wählen Sie einen Durchlauf aus, um seine Details zu sehen: Status, Start- und Endzeit sowie jeden durchlaufenen Schritt in der Reihenfolge, mit Status und Dauer des Schritts. Klappen Sie bei einem Schritt **Output data** auf, um zu sehen, was er zurückgegeben hat, etwa die ID der gesendeten E-Mail, den Zweig, den eine Bedingung genommen hat, oder den Fehler, an dem er gescheitert ist.

| Status des Durchlaufs | Bedeutung |
| --- | --- |
| **Running** | Arbeitet seine Schritte ab oder wartet in einem Schritt **Wait**. |
| **Completed** | Alle Schritte auf seinem Pfad sind abgeschlossen. |
| **Failed** | Ein Schritt ist fehlgeschlagen, oder der Workspace hatte nicht genug Credits, um den Durchlauf zu starten. |
| **Canceled** | Die Automatisierung wurde per API gestoppt, während der Durchlauf lief. |

## Fehlgeschlagenen Durchlauf debuggen

1. **Fehlgeschlagene Durchläufe finden.** Filtern Sie im Tab **Runs** nach **Status** `failed`.

2. **Durchlauf öffnen.** Der fehlgeschlagene Schritt ist rot markiert.

3. **Fehler lesen.** Klappen Sie beim fehlgeschlagenen Schritt **Output data** auf. Das Feld `error` beschreibt, was schiefgelaufen ist, zum Beispiel `send_email: Sending domain is not verified or not found`. Häufige Fehler und ihre Lösungen finden Sie unter [Wenn ein Schritt fehlschlägt](/de/docs/automations/steps/#when-a-step-fails).

4. **Ursache beheben.** Liegt es an einer Schritteinstellung, wählen Sie **Pause**, korrigieren den Schritt im Tab **Editor** und wählen **Save** und dann **Start**. Liegt es am Workspace, etwa an fehlenden Credits oder einer nicht verifizierten Domain, beheben Sie das Problem unter **Workspace** oder **Email API**.

Ein fehlgeschlagener Durchlauf ohne Schritte ist meist gescheitert, weil der Workspace nicht die 3 Credits hatte, die für den Start nötig sind. Per API zeigt sein `meta` dann `"failure_reason": "insufficient_credits"`. [Laden Sie Credits auf](/de/docs/billing/credits/) oder aktivieren Sie die [automatische Aufladung](/de/docs/billing/auto-refill/), damit Durchläufe nicht fehlschlagen.

Fehlgeschlagene Durchläufe werden nicht wiederholt. Neue Trigger starten wie gewohnt neue Durchläufe. Um die Automatisierung für einen Kontakt oder eine E-Mail erneut auszuführen, deren Durchlauf fehlgeschlagen ist, lösen Sie den Trigger noch einmal aus, zum Beispiel indem Sie den Kontakt aus der Kontaktliste entfernen und wieder hinzufügen.

Ein Durchlauf, der lange im Status **Running** bleibt, steckt meist in einem Schritt **Wait**. Öffnen Sie ihn, um zu sehen, bei welchem Schritt er ist.

## Per API nutzen

[Durchläufe auflisten](/de/docs/api-reference/automations/runs/) gibt die Durchläufe einer Automatisierung zurück, die neuesten zuerst. Filtern Sie mit `filter[status]` (`running`, `completed`, `failed` oder `canceled`) und blättern Sie mit `page` und `per_page` (bis zu 100):

```bash
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"
```

```json
{
  "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
}
```

[Durchlauf abrufen](/de/docs/api-reference/automations/run/) ergänzt `run_steps` mit `step_id`, `status`, `data` (die Ausgabe, einschließlich eines etwaigen `error`), `started_at` und `completed_at` jedes Schritts.

[Statistiken abrufen](/de/docs/api-reference/automations/stats/) gibt die Statistiken aller Schritte zurück, nach Schrittschlüssel gruppiert. Grenzen Sie sie mit `since` und `until` (ISO 8601) oder `run_ids[]` ein. [Schrittstatistiken abrufen](/de/docs/api-reference/automations/step-stats/) gibt die Statistiken eines einzelnen Schritts zurück:

```json
{
  "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` zählt, wie der Schritt in jedem Durchlauf geendet hat. `by_outcome` zählt seine Ergebnisse, etwa den letzten Status der gesendeten E-Mail oder `matched` und `not_matched` bei einer Bedingung. `funnel` erscheint bei Schritten vom Typ **Send email**.

## Siehe auch

  - [Schritte](/de/docs/automations/steps/): Schritteinstellungen und häufige Fehler.
  - [Automatisierungen im Überblick](/de/docs/automations/): Status, Credits und die API.

---
Quelle: https://emailit.com/de/docs/automations/runs/