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.
Eine API-getriggerte Campaign einrichten
Das Einrichten einer API-getriggerten Campaign erfordert einige Schritte. Erstellen Sie zunächst eine neue Mehrkanal- oder Einkanal-Campaign (mit multivariaten Tests).
Konfigurieren Sie als Nächstes Ihre Texte und Benachrichtigungen genauso, wie Sie es normalerweise für geplante Benachrichtigungen tun würden, und wählen Sie API-Triggered Delivery aus. Weitere Informationen zum Triggern dieser Campaigns von Ihrem Server aus finden Sie in diesem Artikel zum Senden API-getriggerter Campaigns.
Verzögerung zwischen API-Trigger und Versand reduzieren
Falls Nachrichten nach dem Aufruf des Trigger-Endpunkts länger als erwartet zum Senden brauchen, prüfen Sie, ob das Nutzerprofil zum Zeitpunkt des Triggers bereit 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 in derselben Anfrage Nutzer:innen zu erstellen 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 Empfängerin bzw. jeden Empfänger hinzu.
Für E-Mail-Campaigns fügen Sie außerdem email (und alle weiteren erforderlichen Zustellungsfelder) in attributes ein. Wenn das Profil zum Zeitpunkt des Triggers keine E-Mail-Adresse hat, versucht Braze es bis zu ca. 2 Stunden lang erneut, während auf eingehende Profildaten gewartet wird. Wenn Sie email im selben Aufruf mitgeben, vermeiden Sie diese Verzögerung.
Vollständige Anfrageparameter, Beispiele und Informationen zum Wiederholungsverhalten finden Sie unter API-getriggerte Campaigns senden und im Artikel zum Empfängerobjekt.
Diese Hinweise gelten für API-getriggerte Campaigns (/campaigns/trigger/send). Der Transaktions-E-Mail-Endpunkt verwendet eine andere Anfragestruktur (recipient, Singular) und unterstützt send_to_existing_only nicht. Um bei transaktionalen Sendungen inline Nutzer:innen zu erstellen, übergeben Sie attributes im recipient-Objekt.
Verwendung von Template-Inhalten aus einer API-Anfrage
Zusätzlich zum Triggern der Nachricht können Sie auch Inhalte mit der API-Anfrage einbinden, die über das trigger_properties-Objekt in die Nachricht eingesetzt werden. Auf diese Inhalte kann im Nachrichtentext referenziert 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.
Erneute Berechtigung bei API-getriggerten Campaigns
Die Anzahl, wie oft Nutzer:innen eine API-getriggerte Campaign erhalten, kann mithilfe von Einstellungen zur erneuten Berechtigung 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.
Nehmen wir zum Beispiel an, Sie verwenden eine API-getriggerte Campaign, um Nutzer:innen eine Campaign über einen Artikel zu senden, den sie kürzlich angesehen haben. 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 hingegen transaktional ist, sollten Sie sicherstellen, dass Nutzer:innen die Campaign bei jeder Transaktion erhalten, indem Sie die Verzögerung auf null Minuten setzen.
