Connected-Content-Debugger
Verwenden Sie den Connected-Content-Debugger, um die Live-Anfrage und -Antwort für jeden Connected-Content-Aufruf anzuzeigen. So können Sie Ihren Endpunkt, Ihre Header und Ihre Liquid-Tags überprüfen, bevor Sie eine Campaign oder ein Canvas starten.
Connected Content Debugger befindet sich derzeit im Early Access. Kontaktieren Sie Ihre:n Braze Account Manager:in, wenn Sie an der Teilnahme am Early Access interessiert sind.
Über den Debugger
Connected-Content ermöglicht es Ihnen, Nachrichten mit Echtzeitdaten anzureichern, indem zum Zeitpunkt des Renderns ein HTTP-Aufruf an eine externe API erfolgt und die Antwort dann mithilfe von Liquid in Ihre Nachricht eingefügt wird. Da dieser Aufruf außerhalb von Braze stattfindet, kann es schwierig sein, genau zu sehen, welche Anfrage Braze gesendet hat, was der Endpunkt zurückgegeben hat oder warum ein Aufruf fehlgeschlagen ist – bevor eine Campaign oder ein Canvas live ist.
Der Connected-Content-Debugger hilft bei der Fehlerbehebung dieser Probleme vor dem Start. Er zeigt Ihnen die Live-Anfrage und -Antwort für jeden Connected-Content-Aufruf in Ihrer Nachricht im Bereich Vorschau & Test an. So können Sie bestätigen, dass Ihr Endpunkt, Ihre Header und Ihre Liquid-Tags korrekt konfiguriert sind – alles innerhalb des Braze-Dashboards.
Unterstützte Kanäle
Der Connected-Content-Debugger ist für die folgenden Kanäle verfügbar:
- Content Cards
- E-Mail
- Einschließlich Templates
- Ausgenommen Fußzeilen und Abo-Seiten
- In-App-Nachrichten
- Push-Benachrichtigungen
- SMS/MMS/RCS
- Webhooks
- Einschließlich Templates
Während des Early Access ist der Debugger für die meisten Kanäle verfügbar, jedoch noch nicht für KakaoTalk, LINE, Banner oder nicht kanalspezifische Kompositionsoberflächen (wie Content Blocks, Canvas User-Update-Schritt und Context-Schritt). Wenn Sie den Debugger nicht sehen, wird Connected-Content-Debugging für dieses Feature möglicherweise noch nicht unterstützt.
Den Debugger verwenden
Jedes Mal, wenn Sie eine Vorschau ausführen, rendert Braze automatisch die Connected-Content-Aufrufergebnisse im Tab Vorschau. So verwenden Sie den Debugger:
- Konfigurieren Sie Ihre Nachricht mit dem
{% connected_content %}-Tag. - Gehen Sie zum Abschnitt Vorschau & Test. Wenn Ihre Nachricht ein Connected-Content-Tag enthält, sehen Sie eine Zusammenfassung mit der Anzahl der Connected-Content-Aufrufe sowie den Erfolgs- und Fehlerstatus.
- Wählen Sie Details anzeigen aus, um den Debugger neben Ihrer Vorschau zu öffnen. Das Drawer-Panel zeigt eine Tabelle mit der URL und dem Ergebnis für jeden Connected-Content-Aufruf an.
- Wählen Sie neben jeder URL und jedem Ergebnis Anzeigen aus, um die Anfrage- und Antwort-Header, den Payload, die Methode, die Dauer und Caching-Informationen einzusehen.
- Überprüfen Sie die Ergebnisse und passen Sie Ihr Tag, Ihre Header oder Ihren Endpunkt nach Bedarf an. Generieren Sie dann eine neue Vorschau, um die Korrektur zu bestätigen.
Wenn Ihr Template mehr als ein {% connected_content %}-Tag enthält, listet der Debugger jeden durchgeführten Aufruf auf. Bei Kanälen, die mehrere Nachrichtentexte aus einem Template rendern (zum Beispiel E-Mail, die separate HTML-, Plaintext- und AMP-Texte rendert, oder Quick Push, das separate gerätespezifische Texte rendert), zeigt der Debugger jeden Connected-Content-Aufruf über alle Texte hinweg an – nicht nur den, den Sie gerade in der Vorschau betrachten.
Die Debug-Ausgabe verstehen
Jeder Connected-Content-Aufruf wird mit eigenen Tabs Response und Request angezeigt. Der Tab Response wird standardmäßig angezeigt, da er in der Regel der erste Indikator ist, um zu bestätigen, ob ein Aufruf erfolgreich war.
URL-Details
| Feld | Beschreibung |
|---|---|
| URL | Die vollständig gerenderte URL, die Braze aufgerufen hat, mit allen aufgelösten Liquid-Tags. |
| Method | Die verwendete HTTP-Methode (GET oder POST). |
| Status code | Der HTTP-Statuscode, den Ihr Endpunkt zurückgegeben hat (zum Beispiel 200, 404, 500). Siehe Fehlerbehebung bei Antwortcodes für Braze-spezifische Codes. |
Tab „Response“
| Feld | Beschreibung |
|---|---|
| Duration | Wie lange die Anfrage bis zum Abschluss gedauert hat, in Sekunden. Die Dauer wird nur für Live-Aufrufe (nicht aus dem Cache) angezeigt. |
| Served from cache | Gibt an, ob diese Antwort aus dem Connected-Content-Cache von Braze bereitgestellt wurde, anstatt einen Live-Aufruf an Ihren Endpunkt zu senden (Yes oder No). Ein zwischengespeichertes Ergebnis spiegelt eine frühere Antwort wider, nicht unbedingt den aktuellen Zustand Ihres Endpunkts. |
| Response body | Der von Ihrem Endpunkt zurückgegebene Antworttext. |
Tab „Request“
| Feld | Beschreibung |
|---|---|
| Headers | Die von Braze gesendeten Anfrage-Header, einschließlich aller mit :headers festgelegten Header. |
| Body | Der gesendete Anfragetext, falls vorhanden (POST-Anfragen). |
Schwärzung von Zugangsdaten
Wenn Ihr Connected-Content-Tag :basic_auth, gängige geheime Header, Schlüssel oder andere Optionen für Authentifizierungsdaten verwendet, schwärzt der Debugger diese Werte im Tab Request und ersetzt sie durch eine Reihe von Sternchen (*). So können Sie bestätigen, dass Zugangsdaten in der Anfrage enthalten waren, ohne die Werte in Preview & Test offenzulegen.
Authentifizierungsfehler sind auch bei geschwärzten Zugangsdaten sichtbar: Wenn Ihr Endpunkt einen 401- oder 403-Statuscode zurückgibt, wird dieser im Tab Response normal angezeigt, sodass Sie erkennen können, dass Ihre Anfrage aufgrund der Authentifizierung abgelehnt wurde, obwohl die Zugangsdaten selbst verborgen sind.
Fehlerbehebung bei Antwortcodes
Endpunkt-Fehler versus von Braze auferlegte Limits
Nicht jeder Statuscode, der kein 2XX ist, im Tab Response stammt von Ihrem Endpunkt. Braze erzwingt eigene Limits für Connected-Content-Aufrufe, und diese können Antworten erzeugen, die einem Endpunkt-Fehler ähnlich sehen.
Wenn Sie Antwortcodes wie 408, 429, 502, 503, 504 oder 599 sehen, liegt das Problem in der Regel auf der Braze-Seite des Aufrufs – im Zusammenhang mit Host-Zustand, Timeout oder Payload-Größe. Wenn Ihr Endpunkt regelmäßig große Antworten zurückgibt, sollten Sie den Antwort-Payload auf die Felder reduzieren, die Ihre Nachricht tatsächlich benötigt.
Endpunkt hat einen unerwarteten Statuscode zurückgegeben
Verwenden Sie den Tab Request, um die genaue URL, die Header und den Body zu überprüfen, die Braze gesendet hat. Eine häufige Ursache für unerwartete 4XX-Antworten ist ein Liquid-Tag in der URL, den Headern oder dem Body, der sich nicht wie erwartet aufgelöst hat. Überprüfen Sie, ob alle {{ }}-Referenzen auf Felder verweisen, die für die Nutzer:in oder den Kontext existieren, mit dem Sie die Vorschau anzeigen.
Antwort wirkt veraltet
Überprüfen Sie Served from cache im Tab Response. Wenn dort Yes angezeigt wird, zeigt der Debugger eine zuvor zwischengespeicherte Antwort anstelle eines neuen Aufrufs an. Fügen Sie Ihrem Tag vorübergehend :no_cache hinzu, oder warten Sie, bis der Cache abläuft (gemäß :cache_max_age), um das aktuelle Endpunkt-Verhalten zu bestätigen.