API-getriggerte Zustellung
API-getriggerte Campaigns oder servergetriggerte Campaigns sind ideal für fortgeschrittene transaktionale Anwendungsfälle. Mit API-getriggerten Campaigns von Braze können Marketer Kampagnentexte, multivariate Tests und Regeln zur erneuten Berechtigung im Braze-Dashboard verwalten und gleichzeitig die Zustellung dieser Inhalte über ihre eigenen Server und Systeme triggern. Die API-Anfrage zum Triggern der Nachricht kann auch zusätzliche Daten enthalten, die in Realtime in die Nachricht eingebunden werden.
Einrichten einer API-getriggerten Campaign
Das Einrichten einer API-getriggerten Campaign erfordert einige Schritte. Erstellen Sie zunächst eine neue Multichannel- oder Single-Channel-Campaign (mit multivariatem Test).
Konfigurieren Sie als Nächstes Ihren Text und Ihre Benachrichtigungen auf die gleiche Weise wie bei geplanten Benachrichtigungen und wählen Sie API-Triggered Delivery aus. Weitere Informationen zum Triggern dieser Campaigns von Ihrem Server finden Sie in diesem Artikel zum Senden API-getriggerter Campaigns.
Verzögerung zwischen API-Trigger und Versand reduzieren
Wenn Nachrichten nach dem Aufruf des Trigger-Endpunkts länger als erwartet zum Senden brauchen, prüfen Sie, ob das Kundenprofil zum Zeitpunkt des Triggers bereits vorhanden ist.
Standardmäßig ist send_to_existing_only auf true gesetzt bei /campaigns/trigger/send. Braze sendet nur an bestehende Nutzer:innen und erstellt in diesem Aufruf keine komplett neuen Profile. Um eine:n Nutzer:in im selben Request anzulegen oder zu aktualisieren und gleichzeitig zu senden, setzen Sie send_to_existing_only auf false und fügen Sie ein attributes-Objekt für jede:n Empfänger:in hinzu.
Für E-Mail-Campaigns sollten Sie außerdem email (und alle weiteren erforderlichen Zustellfelder) innerhalb von attributes angeben. Wenn das Profil zum Zeitpunkt des Triggers keine E-Mail-Adresse hat, versucht Braze es bis zu etwa 2 Stunden lang erneut, während es auf eingehende Profildaten wartet. Die Angabe von email im selben Aufruf vermeidet diese Verzögerung.
Vollständige Anfrageparameter, Beispiele und Informationen zum Retry-Verhalten finden Sie unter API-getriggerte Campaigns senden und im recipients-Objekt.
Diese Anleitung gilt für API-getriggerte Campaigns (/campaigns/trigger/send). Der Transaktions-E-Mail-Endpunkt verwendet eine andere Anfrage-Struktur (recipient, Singular) und unterstützt send_to_existing_only nicht. Um eine:n Nutzer:in direkt mit Transaktions-E-Mails anzulegen, übergeben Sie attributes im recipient-Objekt.
Verwendung der Template-Inhalte aus einer API-Anfrage
Neben dem Triggern der Nachricht können Sie auch Inhalte in die API-Anfrage einfügen, die im trigger_properties-Objekt als Template in die Nachricht eingefügt werden. Auf diese Inhalte kann im Nachrichtentext verwiesen werden.
Verwenden Sie genau zwei geschweifte Klammern pro Liquid-Tag in trigger_properties und im Nachrichtentext. Ein Beispiel: {{api_trigger_properties.${your_property}}}. Eine zusätzliche { oder } ist eine häufige Ursache für Fehler bei der API-getriggerten Personalisierung.
Sehen Sie sich das folgende Beispiel einer sozialen Benachrichtigung für zusätzlichen Kontext an.
Wiederzulassung bei API-getriggerten Campaigns
Die Häufigkeit, mit der Nutzer:innen eine API-getriggerte Campaign erhalten, kann über die Einstellungen zur Wiederzulassung begrenzt werden. Das bedeutet, dass Nutzer:innen die Campaign nur einmal oder einmal innerhalb eines bestimmten Zeitfensters erhalten, unabhängig davon, wie oft der API-Trigger ausgelöst wird.
Angenommen, Sie verwenden eine API-getriggerte Campaign, um Nutzer:innen eine Campaign über einen kürzlich angesehenen Artikel zu senden. In diesem Fall können Sie die Campaign so begrenzen, dass maximal eine Nachricht pro Tag gesendet wird – unabhängig davon, wie viele Artikel angesehen wurden, während der API-Trigger für jeden Artikel ausgelöst wird. Wenn Ihre API-getriggerte Campaign transaktionsbezogen ist, stellen Sie sicher, dass Nutzer:innen die Campaign jedes Mal erhalten, wenn sie die Transaktion durchführen, indem Sie die Verzögerung auf null Minuten setzen.
