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.
Über den Debugger
Mit Connected-Content können Sie Nachrichten mit Echtzeitdaten anreichern, indem beim Rendern ein HTTP-Aufruf an eine externe API erfolgt und die Antwort anschließend mit Liquid in Ihre Nachricht eingefügt wird. Da dieser Aufruf außerhalb von Braze stattfindet, ist vor dem Livegang einer Campaign oder eines Canvas oft nur schwer zu erkennen, welche Anfrage Braze genau gesendet hat, was der Endpunkt zurückgegeben hat oder warum ein Aufruf fehlgeschlagen ist.
Der Connected-Content-Debugger hilft Ihnen, solche Probleme bereits vor dem Launch zu beheben. Im Bereich Vorschau & Test zeigt er Ihnen die Live-Anfrage und -Antwort für jeden Connected-Content-Aufruf in Ihrer Nachricht an. So können Sie direkt im Braze-Dashboard überprüfen, ob Ihr Endpunkt, Ihre Header und Ihre Liquid-Tags korrekt konfiguriert sind.
Unterstützte Bereiche
Der Connected-Content-Debugger ist für die folgenden Bereiche verfügbar:
- Banner
- Canvas-Kontext-Schritte
- Content Blocks
- Content Cards
- E-Mail
- Einschließlich Templates
- Ausgenommen Fußzeilen und Abo-Seiten
- In-App-Nachrichten
- Push-Benachrichtigungen
- SMS, MMS und RCS
- Webhooks
- Einschließlich Templates
Der Debugger ist für die meisten Kanäle verfügbar, jedoch noch nicht für KakaoTalk, LINE oder den Canvas-Schritt „Nutzer-Update“. Wenn Sie den Debugger nicht sehen, wird das Debugging von Connected-Content für dieses Feature möglicherweise noch nicht unterstützt.
Debugger verwenden
Jedes Mal, wenn Sie eine Vorschau ausführen, rendert Braze automatisch die Ergebnisse der Connected-Content-Aufrufe 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 Übersicht mit der Anzahl der Connected-Content-Aufrufe sowie den erfolgreichen und fehlerhaften Status.
- Wählen Sie Details anzeigen, um den Debugger neben Ihrer Vorschau zu öffnen. Das Panel zeigt eine Tabelle mit der URL und dem Ergebnis jedes Connected-Content-Aufrufs.
- Wählen Sie neben jeder URL und jedem Ergebnis Anzeigen, um Anfrage- und Antwort-Header, Payload, Methode, Dauer und Caching-Informationen einzusehen.
- Überprüfen Sie die Ergebnisse und passen Sie bei Bedarf Ihr Tag, Ihre Header oder Ihren Endpunkt an. Erstellen Sie anschließend eine neue Vorschau, um die Korrektur zu bestätigen.
Wenn Ihr Template mehr als ein {% connected_content %}-Tag enthält, listet der Debugger jeden ausgeführten Aufruf auf. Bei Kanälen, die aus einem Template mehrere Nachrichtentexte oder Plattformvarianten rendern, listet der Debugger alle Connected-Content-Aufrufe über diese Renderings hinweg auf – nicht nur den Text, den Sie gerade in der Vorschau sehen. E-Mails können separate Rendering-Durchläufe für HTML und Nur-Text erzeugen (beim Versand zusätzlich Accelerated Mobile Pages (AMP)), sodass dieselbe URL mehrmals erscheinen kann. Quick Push kann für bis zu vier Plattformen rendern (iOS, Android, Web und Kindle), sodass derselbe Connected-Content-Verweis bis zu viermal erscheinen kann.
Diese Wiederholungen entsprechen der Art, wie Braze die Nachricht rendert und versendet; der Debugger fasst sie nicht zusammen. Weitere Informationen dazu, warum die Anzahl der Aufrufe die Anzahl der Sendungen übersteigen kann, finden Sie unter Connected-Content-Aufrufvolumen verstehen.
Debug-Ausgabe verstehen
Jeder Connected-Content-Aufruf hat eigene Tabs für Antwort und Anfrage. Der Tab Antwort wird standardmäßig angezeigt, da er in der Regel als Erstes zeigt, 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. |
| Methode | Die verwendete HTTP-Methode (GET oder POST). |
| Statuscode | Der HTTP-Statuscode, den Ihr Endpunkt zurückgegeben hat (zum Beispiel 200, 404, 500). Informationen zu Braze-spezifischen Codes finden Sie unter Fehlerbehebung bei Antwortcodes. |
Tab „Antwort“
| Feld | Beschreibung |
|---|---|
| Dauer | Wie lange die Anfrage bis zum Abschluss gedauert hat, in Sekunden. Die Dauer wird nur bei Live-Aufrufen (nicht aus dem Cache) angezeigt. |
| Aus Cache bereitgestellt | Gibt an, ob diese Antwort aus dem Connected-Content-Cache von Braze statt über einen Live-Aufruf an Ihren Endpunkt bereitgestellt wurde (Ja oder Nein). Ein Ergebnis aus dem Cache spiegelt eine frühere Antwort wider, nicht unbedingt den aktuellen Zustand Ihres Endpunkts. |
| Antwort-Body | Der von Ihrem Endpunkt zurückgegebene Body. |
Tab „Anfrage“
| Feld | Beschreibung |
|---|---|
| Header | Header aus Ihrem Connected-Content-Tag (:headers, Zugangsdaten und Optionen wie :content_type). |
| Body | Der gesendete Anfrage-Body, falls vorhanden (POST-Anfragen). |
Welche Anfrage-Header im Debugger angezeigt werden
Der Tab Anfrage listet die Header aus Ihrem Connected-Content-Tag auf: angepasste :headers, gespeicherte Zugangsdaten und Header, die über Tag-Optionen wie :content_type und :basic_auth gesetzt werden. Braze fügt der ausgehenden Anfrage an Ihren Endpunkt außerdem Standard-Header hinzu (zum Beispiel User-Agent und Host). Diese von Braze hinzugefügten Header erscheinen im Debugger, wenn Sie sie in :headers setzen.
Um einen einheitlichen User-Agent zu senden, setzen Sie ihn in :headers. Braze verwendet Ihren Wert, und der Debugger zeigt diesen Header an.
Braze fügt ausgehenden Connected-Content-Anfragen die folgenden Header hinzu. Die meisten werden nur gesetzt, wenn Sie sie nicht bereits im Tag angegeben haben. Header, die Sie über :headers, Zugangsdaten oder Tag-Optionen bereitstellen, werden wie angegeben gesendet.
| Header | Wann Braze ihn setzt |
|---|---|
User-Agent |
Wenn Sie ihn nicht bereits gesetzt haben, sendet Braze Braze Sender <version>. Der Versions-String kann sich ändern. Wenn Sie Traffic nach User-Agent filtern, lassen Sie alle Werte zu, die mit Braze Sender beginnen. Um einen konsistenten Wert zu senden, setzen Sie User-Agent in :headers. |
X-Braze-Sender-Version |
Wird immer auf die Connected-Content-Sender-Version gesetzt. |
Accept-Encoding |
Wenn Sie ihn nicht bereits gesetzt haben, sendet Braze gzip. |
Authorization |
Wenn die URL einen Nutzernamen und ein Passwort enthält (user:pass@host), fügt Braze einen Basic-Authorization-Header hinzu, der aus diesen Zugangsdaten abgeleitet wird. Ein expliziter Authorization-Header überschreibt ihn. Bevorzugen Sie :basic_auth oder :headers, anstatt Zugangsdaten in die URL einzufügen. |
Host |
Hostname aus der Anfrage-URL (zum Beispiel www.example.com für https://www.example.com/abc/123), sofern Sie keinen Host-Header gesetzt haben. |
Content-Length |
Größe des Anfrage-Bodys in Bytes, wenn ein Body vorhanden ist. |
BrazeToBraze |
Wird nur für Anfragen an Braze-REST-Endpunkte auf true gesetzt. Wird für andere Ziele weggelassen. |
Schwärzen von Zugangsdaten
Wenn Ihr Connected-Content-Tag :basic_auth, gängige geheime Header, Schlüssel oder andere Optionen für Authentifizierungs-Zugangsdaten verwendet, schwärzt der Debugger diese Werte im Tab Anfrage und ersetzt sie durch eine Reihe von Sternchen (*). So können Sie überprüfen, dass die Zugangsdaten in der Anfrage enthalten waren, ohne die Werte in Vorschau & Test offenzulegen.
Authentifizierungsfehler bleiben auch bei geschwärzten Zugangsdaten sichtbar: Wenn Ihr Endpunkt einen 401 oder 403 zurückgibt, wird dieser Statuscode wie gewohnt im Tab Antwort angezeigt. So erkennen Sie, dass Ihre Anfrage aufgrund der Authentifizierung abgelehnt wurde, auch wenn die Zugangsdaten selbst verborgen sind.
Fehlerbehebung bei Antwortcodes
Endpunkt-Fehler und von Braze festgelegte Limits
Nicht jeder Statuscode außerhalb von 2XX im Tab Antwort stammt von Ihrem Endpunkt. Braze setzt eigene Limits für Connected-Content-Aufrufe durch. Diese können Antworten erzeugen, die wie ein Endpunkt-Fehler aussehen.
Wenn Sie Antwortcodes wie 408, 429, 502, 503, 504 oder 599 sehen, liegt das Problem in der Regel auf der Braze-Seite des Aufrufs. Ursache sind dann meist der Zustand des Hosts, ein Timeout oder die Größe des Payloads. Wenn Ihr Endpunkt durchgehend große Antworten zurückgibt, sollten Sie den Antwort-Payload auf die Felder beschränken, die Ihre Nachricht tatsächlich benötigt.
Endpunkt hat einen unerwarteten Statuscode zurückgegeben
Überprüfen Sie im Tab Anfrage die URL, die Header aus Ihrem Tag und den Body. Eine häufige Ursache für unerwartete 4XX-Antworten ist ein Liquid-Tag in der URL, in den Headern oder im Body, der nicht wie erwartet aufgelöst wurde. Stellen Sie sicher, dass alle {{ }}-Referenzen auf Felder verweisen, die für die Nutzer:in oder den Kontext Ihrer Vorschau existieren.
Antwort scheint veraltet zu sein
Prüfen Sie im Tab Antwort den Wert Aus dem Cache bereitgestellt. Steht dort Ja, zeigt der Debugger eine zuvor zwischengespeicherte Antwort statt 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 Verhalten des Endpunkts zu überprüfen.