Sobald deine Trigger-Regeln eingerichtet sind, findet sich alles rund um deren Ausführung im Tab Zustellung. Dieser Artikel behandelt den täglichen Zeitplan, manuelle Läufe und Einzelmitglied-Tests, die Schutzmechanismen Quiet hours und Frequenzobergrenzen, die Funktionsweise der Vorschau sowie die vollständige Referenz des Ausführungsprotokolls einschließlich Spalten, Statuswerten und Backend-Skip-Gründen.
Inhalt
- Zeitplan und Ausführung
- Quiet hours und Frequenzobergrenzen
- Die vollständige Eignungskette
- Vorschau
- Referenz des Ausführungsprotokolls
- Spalten
- Statuswerte
- Backend-Skip-Gründe
Zeitplan und Ausführung
Alles rund um die Ausführung von Triggern findet sich im Tab Zustellung: der tägliche Zeitplan, Quiet hours, Frequenzobergrenzen und das Panel Execute Triggers. Einige Elemente innerhalb des Tabs sind mit Ausführung bezeichnet (zum Beispiel Ergebnisse der Ausführung, Ausführungslauf und Ausgeführt am).
Der Tab Zustellung: täglicher Zeitplan, Quiet hours, Frequenzobergrenzen und manuelle Läufe an einer Stelle.
Täglicher Zeitplan
- Lege eine Uhrzeit und eine Zeitzone an der Konfiguration fest und schalte den Zeitplan ein oder aus.
- Der Zeitplan wird von allen Studios geteilt, die die Konfiguration nutzen.
- Der Scheduler prüft jede Minute auf fällige Konfigurationen und führt alle aktiven Regeln für alle angeschlossenen Studios aus.
- Eine Regel läuft am selben Kalendertag nicht zweimal (in der lokalen Zeitzone des Studios). Wenn eine Regel heute bereits gelaufen ist, ob automatisch oder manuell, wird sie nicht erneut ausgeführt.
Manueller Lauf ("Jetzt ausführen")
- Führt die Regel sofort für das aktuelle Studio aus. Dabei werden echte Nachrichten gesendet. Für eine gesendete Nachricht gibt es kein Rückgängigmachen.
- Ein manueller Lauf steht für sich: Er dedupliziert nicht gegen andere Regeln des täglichen Laufs.
- Wenn die Regel heute bereits gelaufen ist (automatisch oder manuell), wird der manuelle Lauf blockiert, um doppelte Nachrichten zu verhindern.
Test with single member (Test mit einem einzelnen Mitglied)
- Führt die Regel gegen ein bestimmtes, von dir gewähltes Mitglied aus.
- du wählst das Mitglied über dessen Customer ID, nicht über die Mitgliedsnummer. Kopiere diese aus dem Profil des Mitglieds: Öffne das Profil und nehmen du die Nummer aus der Seiten-URL, zum Beispiel bedeutet
.../#/customermanagement/1562839240/overviewCustomer ID 1562839240. - Umgeht den Bedingungsabgleich: Das Mitglied wird verarbeitet, unabhängig davon, ob es auf die Bedingungen passt.
- Versendet stets als Gruppe A, ohne das Mitglied in einen Kontroll-Bucket zu sperren, sodass der Test nie stillschweigend in der Kontrollgruppe landet.
- Nutze dies, um Kanaleinrichtung und Vorlagen vor dem Aktivieren einer Regel durchgängig zu überprüfen.
Quiet hours und Frequenzobergrenzen
Zwei der Nachrichten-Schutzmechanismen sind globale Einstellungen, konfiguriert im Tab Zustellung und geteilt von allen an die Konfiguration angeschlossenen Studios. (Die anderen beiden Schutzmechanismen, der Cooldown pro Regel und der Dedup bei Mehrfachtreffern, werden in Trigger-Regeln erstellen und bearbeiten behandelt.)
Ruhezeiten. Lege eine Start- und eine Endzeit in der Zeitzone des Studios fest. Über-Nacht-Bereiche funktionieren (22:00 bis 07:00 überspannt Mitternacht). Quiet hours sind deaktiviert, wenn nur eine der beiden Zeiten gesetzt ist oder wenn Start und Ende identisch sind.
Was während der Quiet hours passiert. Nachrichten, die fällig werden, während das Fenster geöffnet ist, werden nicht verworfen: du wirst in die Warteschlange gestellt und gesendet, sobald das Quiet-hours-Fenster für den Versand öffnet (das heißt, sobald das Fenster endet). Der Trigger-Editor warnt du, wenn eine konfigurierte Ausführungszeit in ein aktives Quiet-hours-Fenster fällt, und das Panel für den täglichen Zeitplan zeigt dieselbe Warnung für den täglichen Lauf. Ereignisgesteuerte Lead-Trigger (der New-Lead welcome) unterliegen nicht den Quiet hours und werden sofort gesendet.
Reihenfolge der Schutzmechanismen. Für jeden Lauf werden die Schutzmechanismen in einer festen Reihenfolge ausgewertet: Quiet hours, dann die Tagesobergrenze, dann die Wochenobergrenze, dann der Cooldown pro Regel.
Tägliche und wöchentliche Frequenzobergrenzen. Rollierende Limits pro Mitglied: eine maximale Anzahl von Engage-Nachrichten pro Tag (rollierendes 24-Stunden-Fenster) und pro Woche (rollierendes 7-Tage-Fenster). Jede Obergrenze hat ihren eigenen Ein/Aus-Schalter im Tab Zustellung. Wenn ein Mitglied eine Obergrenze bereits erreicht hat, werden weitere Nachrichten übersprungen.
Die Obergrenzen gelten global pro Mitglied über alle Engage-Trigger hinweg, nicht pro Trigger gezählt, sodass ein Mitglied, das früher im Fenster bereits eine Nachricht von einer anderen Regel erhalten hat, aus dieser herausfallen kann. Ein Lauf zählt als eine Nachricht, auch wenn sie auf mehreren Kanälen hinausgeht. Die Fenster sind rollierend (die letzten 24 Stunden und die letzten 7 Tage), nicht Kalendertage oder -wochen.
Siehe auch: Trigger-Regeln erstellen und bearbeiten (Nachrichten-Schutzmechanismen, Priorität und Auflösung mehrfacher Treffer).
Die vollständige Eignungskette
Ein Mitglied kann auf jede von dir geschriebene Bedingung passen und dennoch nichts erhalten, weil Bedingungen nur ein Schritt sind. Für jeden Lauf wendet Engage diese Kette der Reihe nach an:
- Zielgruppe — aktives Mitglied, ehemaliges Mitglied oder Lead.
- Kommunikationsstopp — Mitglieder, die widersprochen haben (keine Newsletter-Einwilligung), werden entfernt.
- Vertragstyp — der Einschluss-/Ausschluss-Filter der Regel nach Vertragstyp.
- deine Bedingungen — die Bedingungsfelder der Regel.
- Erreichbarkeit auf dem ausgewählten Kanal — WhatsApp und SMS brauchen eine Telefonnummer, Email braucht eine E-Mail-Adresse.
Fehlende Kontaktdaten auf dem ausgewählten Kanal sind der häufigste Grund, warum ein passendes Mitglied nichts erhält. Ein Vorbehalt zum Bedingungsschritt: Eine Bedingung passt nur auf Mitglieder, die für dieses Feld tatsächlich einen Wert haben. Ein Mitglied ohne Wert wird von jedem Operator ausgeschlossen, auch von Verneinungen, sodass ein Mitglied ohne Zahlungsmethode nicht auf "Zahlungsmethode ist nicht Lastschrift" passt. Um Mitglieder ohne Wert zu erreichen, verwenden du eine explizite "is empty"-Bedingung, sofern das Feld eine solche anbietet.
Vorschau
Die Vorschau prüft die Reichweite einer Regel, bevor sie irgendetwas sendet.
- Die Vorschau wertet den aktuellen Entwurf der Regel aus, so wie du ihn im Editor hast, nicht die zuletzt gespeicherte Version.
- du liefert die Gesamtzahl der passenden Mitglieder und eine Stichprobenliste mit Name, Churn-Risiko-Band und wichtigen Besuchskennzahlen.
- Die Vorschau ist ein Echtzeit-Snapshot: Sie zeigt nur, wer jetzt gerade auf die Bedingungen passt, basierend auf dem Datenstand des aktuellen Tages (Mitglieder-Kennzahlen werden einmal pro Tag aktualisiert).
- du kannst die vollständige, paginierte Liste der passenden Mitglieder laden, was in großen Studios hilft.
Eine Zählung von 0 ist kein Problem. Wenn die Vorschau 0 Mitglieder zeigt, bedeutet das nur, dass heute niemand passt. Es bedeutet nicht, dass die Regel defekt ist oder dass morgen niemand passen wird: Mitglieder bewegen sich in die Bedingungen hinein und wieder heraus, wenn sich ihre Daten ändern, zum Beispiel wenn über Nacht ein Schwellenwert für den Vertragsablauf überschritten wird oder ein Mitglied die Dormancy-Schwelle überschreitet.
Nutze die Vorschau, um Schwellenwerte vor dem Aktivieren abzustimmen. Wenn eine Dormancy-Regel auf das halbe Studio passt, ist die Schwelle wahrscheinlich zu eng für eine sinnvolle Kampagne; erhöhen du den Wert für Tage seit dem letzten Besuch und rufen du die Vorschau erneut auf.
Die Vorschau zeigt, wer auf die Bedingungen passt. du simuliert keine Schutzmechanismen, daher kann die tatsächliche Anzahl der in einem Lauf gesendeten Nachrichten geringer ausfallen, sobald Cooldowns, Frequenzobergrenzen, Quiet hours, Dedup und die A/B-Kontrollgruppe angewendet werden. Behandeln du die Vorschau als "wer ist geeignet", nicht als "wer wird angeschrieben".
Referenz des Ausführungsprotokolls
Jedes ausgewertete Mitglied erhält eine Zeile, sodass du stets nachvollziehen kannst, warum jemand kontaktiert wurde oder nicht. Der Tab Zustellung zeigt Übersichtskarten (Treffer gesamt, Gruppe A, Gruppe B) und eine Ergebnistabelle pro Mitglied. Die Ergebnisse lassen sich nach Zeitraum, Ausführungslauf, Trigger, Kanal und A/B-Gruppe filtern und nach CSV exportieren.
Zustellung-Ergebnisse: eine Zeile pro ausgewertetem Mitglied, mit Pfad (Einseitig oder Agent), Kanal, A/B-Gruppe und Ergebnis.
Spalten
| Spalte | Was sie zeigt |
|---|---|
| Mitglied | Mitgliedsname, als Snapshot zum Versandzeitpunkt festgehalten. Historische Protokolle bleiben lesbar, auch wenn sich die Daten des Mitglieds später ändern. |
| Auslöser | Die Trigger-Regel, die dieses Mitglied ausgewertet hat. |
| Pfad | Zustellpfad: Einseitig (direkt gesendet) oder Agent (über den MagicAI-Chat-Agenten zugestellt). Leer bei übersprungenen Mitgliedern. |
| Kanal | Der Kanal, auf dem die Nachricht gesendet (oder versucht) wurde. Leer bei Mitgliedern, die vor der Kanalauswahl übersprungen wurden, etwa der Kontrollgruppe. |
| Gruppe | A (Behandlung, angeschrieben) oder B (Kontrolle, nicht angeschrieben). |
| Kündigungsrisiko | Das Churn-Risiko-Band des Mitglieds zum Ausführungszeitpunkt (Sehr gering bis Sehr hoch). Nützlich, um zu prüfen, wer angesprochen wurde. |
| Status | Das Ergebnis dieses Versandversuchs. Siehe die Status-Referenz unten. |
| Datum/Uhrzeit | Wann dieser Protokolleintrag erstellt wurde. |
Statuswerte
Jeder Versandversuch endet in genau einem der unten aufgeführten Ergebnisse, angezeigt in der Spalte Status. Die daneben liegende Spalte Pfad zeigt Agent (über den MagicAI-Chat-Agenten zugestellt) oder Einseitig (direkt gesendet) und ist bei übersprungenen und Control-Zeilen leer.
| Status | Was passiert ist |
|---|---|
| Gesendet | Die Nachricht wurde übergeben und vom Backend als gesendet bestätigt. Die tatsächliche Zustellbestätigung hängt vom nachgelagerten Anbieter ab (zum Beispiel WhatsApp oder dem SMS-Gateway). |
| Fehlgeschlagen | Der Versand ist wegen eines Laufzeitfehlers fehlgeschlagen. |
| Übersprungen (A/B-Kontrolle) | Das Mitglied ist in Kontrollgruppe B und wurde absichtlich nicht kontaktiert, damit die Behandlungsgruppe in der Analyse gegen eine saubere Baseline verglichen werden kann. Es wird eine Zeile pro Mitglied erfasst, ohne Kanal. |
| Ausgelassen (Ruhezeiten) | Das Studio befindet sich innerhalb seines konfigurierten Quiet-hours-Fensters. Die Nachricht wird nicht verworfen: Sie wird in die Warteschlange gestellt und gesendet, sobald das Fenster öffnet. |
| Übersprungen (Abklingzeit) | Das Cooldown-Fenster der Regel ist für dieses Mitglied noch nicht verstrichen. |
| Bereits kontaktiert | Ein Contact-once-Trigger hat diesem Mitglied in einem früheren Lauf bereits eine Nachricht gesendet. |
| Übersprungen (tägliches Limit) | Die rollierende 24-Stunden-Nachrichtenobergrenze des Studios ist erreicht. |
| Übersprungen (wöchentliche Obergrenze) | Die rollierende 7-Tage-Nachrichtenobergrenze des Studios ist erreicht. |
| Übersprungen (Doppeleintrag) | Eine Regel mit höherer Priorität hat dieses Mitglied im selben Scheduler-Durchlauf bereits beansprucht (siehe Priorität und Auflösung mehrfacher Treffer in Trigger-Regeln erstellen und bearbeiten). |
| Übersprungen (kein Kanal) | Das Mitglied ist auf dem Kanal nicht erreichbar (keine Telefonnummer für WhatsApp oder SMS, keine E-Mail-Adresse für Email). |
| Übersprungen (nicht auf der Zulassungsliste) | Das Mitglied steht nicht auf der konfigurierten Versand-Allowlist. |
| Übersprungen (Backend) | Das Backend hat die Nachricht bewusst zurückgehalten. Das Grund-Feld zeigt die konkrete Ursache (siehe Backend-Skip-Gründe unten). |
Dies sind die vom Engineering bestätigten Zustellprotokoll-Status (der ml-backend-Nachrichtenstatus-Satz). Jedes ausgewertete Mitglied erzeugt pro Lauf eine Zeile mit seinem Ergebnis. Der Status "Skipped (backend)" trägt ein zweitrangiges Grund-Feld, das die genaue Ursache benennt (siehe Backend-Skip-Gründe unten). Umfangreichere Zustellberichte pro Sendung (ein Status Succeeded, Failed oder Pending pro Nachricht mit dem Fehlergrund) sind für ein späteres Release geplant, nicht für das Go-live. Der genaue Bildschirmtext für die selteneren Status ist gegen die GA-UI bestätigt.
Backend-Skip-Gründe
Wenn der Status "Skipped (backend)" lautet, erklärt das Grund-Feld, warum das Zustellsystem die Nachricht zurückgehalten hat:
| Grund | Was zu prüfen ist |
|---|---|
| Engage disabled | Die Engage-Funktion ist auf Plattformebene deaktiviert. |
| No channel handler | Für diesen Kanal ist kein Zustell-Handler registriert. Kontaktiere den Support. |
| Channel disabled | Der Kanal ist für dieses Studio deaktiviert. |
| Studio mismatch | Der Studio-Kontext hat nicht übereingestimmt. Kontaktiere den Support. |
| Template not found | Die diesem Kanal zugewiesene Vorlage existiert nicht mehr. Weise eine Vorlage neu zu. |
| Template archived | Die Vorlage wurde archiviert, nachdem die Regel konfiguriert wurde. Weise eine aktive Vorlage neu zu. |
| Template wrong channel | Die Vorlage wurde für einen anderen Kanal erstellt. Weise eine passende Vorlage zu. |
| App not activated | Push-Kanal: Die MySports App ist für dieses Studio nicht aktiviert. |
| No default locale | Für das Mitglied ist keine Standard-Locale gesetzt. |
| No phone number | SMS-Kanal: Das Mitglied hat keine hinterlegte Telefonnummer. |
| No chatbot configuration | Chat-Zustellpfad: Es existiert keine MagicAI-Chat-Konfiguration. Richte eine ein oder entferne den Agenten vom Kanal. |
| MySports unavailable | Push-Kanal: MySports war zum Sendezeitpunkt nicht verfügbar. |
| No WhatsApp Business Account | WhatsApp-Kanal: Mit diesem Studio ist kein Meta WhatsApp Business Account verknüpft. Siehe auch: WhatsApp für Engage einrichten. |
| WhatsApp Business Account mismatch | Der genehmigte Business Account der Vorlage weicht vom verknüpften Konto des Studios ab. WhatsApp-Vorlagen werden pro Konto genehmigt; eine Abweichung bedeutet, dass Meta die Sendung ablehnen würde. Verwende eine Vorlage, die für das verknüpfte Konto des Studios genehmigt ist. |
Siehe auch: WhatsApp für Engage einrichten. Siehe auch: Impact Analysis.