REST-API
Rufen Sie Daten aus externen REST APIs zum Sendezeitpunkt direkt in Ihre Nachrichten ab – mit Connected-Content. So können Sie Nachrichten mit Realtime-Informationen von Ihren eigenen Servern, Drittanbieter-Diensten oder jedem öffentlich zugänglichen API-Endpunkt personalisieren.
So funktioniert es
Connected-Content sendet eine HTTP-Anfrage an die von Ihnen angegebene URL und speichert dann die Antwort, sodass Sie mit Liquid darauf verweisen können. Fügen Sie Ihrer Nachricht einen {% connected_content %}-Tag hinzu, und Braze ruft den Endpunkt auf, wenn die Nachricht gesendet wird.
{% connected_content https://api.example.com/user/{{${user_id}}}/recommendations :save recs %}
We think you'll love {{recs.top_pick}}!
Connected-Content unterstützt GET- und POST-Anfragen. Braze erwartet, dass der Server innerhalb von zwei Sekunden antwortet. Gestalten Sie Ihre Endpunkte daher für eine niedrige Latenz.
Häufige Anwendungsfälle
| Anwendungsfall | Beschreibung |
|---|---|
| Produktempfehlungen | Personalisierte Produktvorschläge aus einem Empfehlungssystem abrufen |
| Preise oder Lagerbestand in Realtime | Aktuelle Preise oder Lagerbestände zum Sendezeitpunkt anzeigen |
| Wetterbasierte Inhalte | Lokale Wetterdaten abrufen, um das Messaging anzupassen |
| Punktestände im Kundenbindungsprogramm | Aktuelle Rewards oder Kontostände anzeigen |
| Content-Feeds | Die neuesten Blogbeiträge, Artikel oder Neuigkeiten einfügen |
Authentifizierung
Braze unterstützt für Connected-Content-Anfragen die Basisauthentifizierung, die Token-Authentifizierung und OAuth. Sie können Zugangsdaten sicher im Braze-Dashboard unter Einstellungen > Verwaltung von Zugangsdaten speichern und in Ihren API-Aufrufen darauf verweisen.
Weitere Informationen finden Sie unter Einen Connected-Content-API-Aufruf durchführen.
Fehlerbehandlung
Wenn der Endpunkt einen Fehler zurückgibt oder eine Zeitüberschreitung auftritt, rendert Braze anstelle der Connected-Content-Antwort einen leeren String. Sie können Fehler erkennen, indem Sie prüfen, ob die gespeicherte Variable null ist, und dann die Nachricht bedingt abbrechen oder Fallback-Inhalte anzeigen.
Weitere Informationen finden Sie unter Connected-Content abbrechen.
Überlegungen zur Performance
Da Braze Nachrichten in hohem Volumen zustellt, muss Ihr Server Tausende gleichzeitiger Verbindungen verarbeiten können. Nutzen Sie gegebenenfalls Caching und legen Sie Rate-Limits für Ihre Nachrichten fest, um eine Überlastung externer Endpunkte zu vermeiden.
Die vollständige Referenz zu Connected-Content finden Sie unter Connected-Content.