API-getriggerte und aktionsbasierte Kampagnen

Beim Einrichten von Kampagnen ist es immer empfehlenswert, Ihre Nachrichten vor dem Start zu testen. Dieser Referenzartikel behandelt das Erstellen eines Testsegments für Nutzer:innen, mit dem Sie API-Anfragen und Payloads überprüfen sowie Zustellbarkeits-Protokolle einsehen können.

1. Schritt: Testsegment erstellen

Die einzige Möglichkeit, das Triggern einer Kampagne über die API oder ein angepasstes Event zu testen, besteht darin, die Kampagne live zu schalten. Im Rahmen der Einführung einer neuen Kampagne empfehlen wir dringend, beim Testen der Zustellbarkeit ein Testsegment zu Kampagnen hinzuzufügen. Dies bietet ein Sicherheitsnetz und stellt sicher, dass eine Kampagne, selbst wenn sie versehentlich gesendet wird, nur an interne Nutzer:innen geht.

1. Testnutzer:innen importieren
   Testnutzer:innen können über eine CSV-Datei oder eine einmalige Batch-Anfrage über Postman in Braze importiert werden. Beim Import dieser Nutzer:innen empfehlen wir, ein angepasstes Attribut in deren Profilen zu setzen (z. B. internal_test_user: true), das zum Erstellen eines Testgruppen-Segments verwendet werden kann.
   
   
2. Testnutzer:innen als von Braze erkannte Testnutzer:innen hinzufügen
   Wenn Sie Ihre Testnutzer:innen als von Braze erkannte Testnutzer:innen markieren, erhalten Sie im Dashboard Zugriff auf ausführliche Protokollierung für jede:n Nutzer:in. So können Sie API-Anfragen, deren Payloads überprüfen und Zustellbarkeits-Protokolle einsehen. Diese Protokolle helfen Ihnen festzustellen, ob es Probleme bei der Zustellung von Kampagnen an Endnutzer:innen gab.
   
   
3. Segment erstellen
   Um ein Testsegment zu erstellen, erstellen Sie ein Segment von Nutzer:innen, bei denen das angepasste Attribut internal_test_user auf true gesetzt ist. Dieses Segment kann entfernt werden, wenn die Kampagne live geht.

2. Schritt: Testversand durchführen

Als Nächstes können Sie einen Testversand über das Braze-Dashboard durchführen oder Inbox Vision (nur E-Mail) verwenden, um das Layout zu überprüfen, während sich die Kampagne noch im Entwurfsmodus befindet. Anschließend können Sie die Kampagne an Ihr Testsegment senden, um zu überprüfen, ob sie wie erwartet funktioniert. Unabhängig davon, ob die Kampagne API-getriggert oder aktionsbasiert ist, verwenden Sie Postman, um eine einmalige Anfrage an die Braze-API zu senden und die Kampagne zu triggern.

3. Schritt: Braze-Protokollierung zur Überprüfung eingehender Ergebnisse nutzen

Verwenden Sie die Braze-Protokollierung, um Probleme beim Triggern, Senden und bei Events zu beheben.

• Das Event-Nutzerprotokoll zeigt Ihnen den Roh-Payload der API-Trigger-Anfrage, das angepasste Event, das die Kampagne triggert, sowie alle zugehörigen Trigger- oder Event-Eigenschaften.
• Das Nachrichten-Aktivitätsprotokoll protokolliert alle Fehler und hilft Ihnen zu verstehen, warum eine bestimmte Nachricht möglicherweise nicht zugestellt wurde.

4. Schritt: Testsegment entfernen und Kampagne ausrollen

Sobald die Nachricht korrekt getriggert und gerendert wird und alle angeklickten Links registriert sind, können Sie das Segment entfernen und die Kampagne aktualisieren. Wenn Sie die Kampagne lieber von Grund auf neu starten möchten, damit die wenigen Impressionen der Testnutzer:innen nicht enthalten sind, können Sie die Kampagne duplizieren und ohne das Testsegment neu starten.