Débogueur de contenu connecté
Utilisez le débogueur de contenu connecté pour visualiser la requête et la réponse en direct de chaque appel de contenu connecté, afin de vérifier votre endpoint, vos en-têtes et vos étiquettes Liquid avant de lancer une Campaign ou un Canvas.
À propos du débogueur
Le contenu connecté vous permet d’enrichir vos messages avec des données en temps réel en effectuant un appel HTTP vers une API externe au moment du rendu, puis en insérant la réponse dans votre message avec Liquid. Étant donné que cet appel se produit en dehors de Braze, il peut être difficile de voir exactement quelle requête Braze a envoyée, ce que l’endpoint a renvoyé, ou pourquoi un appel a échoué, avant qu’une Campaign ou un Canvas ne soit en production.
Le débogueur de contenu connecté vous aide à résoudre ces problèmes avant le lancement. Il vous montre la requête et la réponse en direct pour chaque appel de contenu connecté dans votre message, dans la section Preview & Test. De cette façon, vous pouvez confirmer que votre endpoint, vos en-têtes et vos étiquettes Liquid sont correctement configurés, le tout depuis le tableau de bord de Braze.
Zones prises en charge
Le débogueur de contenu connecté est disponible pour les zones suivantes :
- Étapes de contexte Canvas
- Content Cards
- E-mail
- Inclut les modèles
- Exclut les pieds de page et les pages d’abonnement
- Messages in-app
- Notifications push
- SMS/MMS/RCS
- Webhooks
- Inclut les modèles
Le débogueur est disponible pour la plupart des canaux, mais pas encore pour KakaoTalk, LINE, les bannières, ni les surfaces de composition non spécifiques à un canal (telles que les Content Blocks et l’étape de mise à jour de l’utilisateur dans Canvas). Si vous ne voyez pas le débogueur, le débogage de contenu connecté n’est peut-être pas encore pris en charge pour cette fonctionnalité.
Utiliser le débogueur
Chaque fois que vous exécutez un aperçu, Braze affiche automatiquement les résultats des appels de contenu connecté dans l’onglet Aperçu. Pour utiliser le débogueur :
- Configurez votre message avec la balise
{% connected_content %}. - Accédez à la section Aperçu et test. Si votre message inclut une balise de contenu connecté, vous pouvez voir un résumé indiquant le nombre d’appels de contenu connecté ainsi que les statuts de réussite et d’erreur.
- Sélectionnez Voir les détails pour ouvrir le débogueur à côté de votre aperçu. Le panneau affiche un tableau avec l’URL et le résultat de chaque appel de contenu connecté.
- À côté de chaque URL et résultat, sélectionnez View pour afficher les en-têtes de requête et de réponse, le payload, la méthode, la durée et les informations de mise en cache.
- Examinez les résultats, ajustez votre balise, vos en-têtes ou votre endpoint si nécessaire. Ensuite, générez un nouvel aperçu pour confirmer la correction.
Si votre modèle contient plus d’une balise {% connected_content %}, le débogueur répertorie chaque appel effectué. Pour les canaux qui génèrent plusieurs corps de message à partir d’un seul modèle (par exemple, l’e-mail, qui génère des corps HTML, texte brut et AMP séparés, ou Quick Push, qui génère des corps distincts selon l’appareil), le débogueur affiche chaque appel de contenu connecté effectué dans tous les corps, et pas uniquement celui que vous prévisualisez actuellement.
Comprendre la sortie de débogage
Chaque appel de contenu connecté s’affiche avec ses propres onglets Response et Request. L’onglet Response est affiché par défaut, car c’est généralement le premier indicateur pour confirmer si un appel a réussi.
Détails de l’URL
| Champ | Description |
|---|---|
| URL | L’URL entièrement rendue que Braze a appelée, avec toutes les étiquettes Liquid résolues. |
| Method | La méthode HTTP utilisée (GET ou POST). |
| Status code | Le code de statut HTTP renvoyé par votre endpoint (par exemple, 200, 404, 500). Consultez Codes de réponse pour la résolution des problèmes pour les codes spécifiques à Braze. |
Onglet Response
| Champ | Description |
|---|---|
| Duration | Durée nécessaire pour terminer la requête, en secondes. La durée est affichée uniquement pour les appels en direct (non mis en cache). |
| Served from cache | Indique si cette réponse a été servie depuis le cache de contenu connecté de Braze plutôt que par un appel en direct à votre endpoint (Yes ou No). Un résultat mis en cache reflète une réponse antérieure, pas nécessairement l’état actuel de votre endpoint. |
| Response body | Le corps de la réponse renvoyé par votre endpoint. |
Onglet Request
| Champ | Description |
|---|---|
| Headers | Les en-têtes de votre étiquette de contenu connecté (:headers, identifiants et options telles que :content_type). |
| Body | Le corps de la requête envoyé, le cas échéant (requêtes POST). |
Quels en-têtes de requête apparaissent dans le débogueur
L’onglet Request liste les en-têtes de votre balise de contenu connecté : les :headers personnalisés, les identifiants stockés et les en-têtes définis par les options de la balise comme :content_type et :basic_auth. Braze ajoute également des en-têtes standards à la requête sortante vers votre endpoint (par exemple, User-Agent et Host). Ces en-têtes ajoutés par Braze apparaissent dans le débogueur lorsque vous les définissez dans :headers.
Pour envoyer un User-Agent cohérent, définissez-le dans :headers. Braze utilise votre valeur, et le débogueur affiche cet en-tête.
Braze ajoute les en-têtes suivants aux requêtes de contenu connecté sortantes. La plupart ne sont définis que si vous ne les avez pas déjà fournis dans l’étiquette. Les en-têtes que vous fournissez avec :headers, des identifiants ou des options d’étiquette sont envoyés tels quels.
| En-tête | Quand Braze le définit |
|---|---|
User-Agent |
Si vous ne l’avez pas déjà défini, Braze envoie Braze Sender <version>. La chaîne de version peut changer. Si vous filtrez le trafic par User-Agent, autorisez toutes les valeurs commençant par Braze Sender. Pour envoyer une valeur constante, définissez User-Agent dans :headers. |
X-Braze-Sender-Version |
Toujours défini sur la version de l’expéditeur de contenu connecté. |
Accept-Encoding |
Si vous ne l’avez pas déjà défini, Braze envoie gzip. |
Authorization |
Si l’URL contient un nom d’utilisateur et un mot de passe (user:pass@host), Braze ajoute un en-tête Basic Authorization dérivé de ces identifiants. Un en-tête Authorization explicite le remplace. Préférez :basic_auth ou :headers plutôt que de placer les identifiants dans l’URL. |
Host |
Nom d’hôte extrait de l’URL de la requête (par exemple, www.example.com pour https://www.example.com/abc/123), sauf si vous définissez un en-tête Host. |
Content-Length |
Taille du corps de la requête en octets lorsqu’un corps est présent. |
BrazeToBraze |
Défini sur true uniquement pour les requêtes vers les endpoints REST de Braze. Omis pour les autres destinations. |
Rédaction des identifiants
Si votre balise de contenu connecté utilise :basic_auth, des en-têtes secrets courants, des clés ou d’autres options d’identifiants d’authentification, le débogueur masque ces valeurs dans l’onglet Request et les remplace par une série d’astérisques (*). Cela vous permet de confirmer que les identifiants ont été inclus dans la requête sans exposer les valeurs dans Preview & Test.
Les échecs d’authentification restent visibles même lorsque les identifiants sont masqués : si votre endpoint renvoie un code 401 ou 403, ce code de statut apparaît normalement dans l’onglet Response, ce qui vous permet de savoir que votre requête a été rejetée en raison d’un problème d’authentification, même si l’identifiant lui-même est masqué.
Résolution des problèmes liés aux codes de réponse
Erreurs d’endpoint versus limites imposées par Braze
Tous les codes de statut non 2XX dans l’onglet Response ne proviennent pas de votre endpoint. Braze applique ses propres limites sur les appels de contenu connecté, et celles-ci peuvent produire des réponses qui ressemblent à une erreur d’endpoint.
Si vous voyez des codes de réponse tels que 408, 429, 502, 503, 504 ou 599, le problème se situe généralement du côté de Braze — lié à l’état de l’hôte, au délai d’expiration ou à la taille du payload. Si votre endpoint renvoie systématiquement des réponses volumineuses, envisagez de réduire le payload de réponse aux seuls champs dont votre message a besoin.
L’endpoint a renvoyé un code de statut inattendu
Utilisez l’onglet Request pour vérifier l’URL, les en-têtes de votre étiquette, et le corps de la requête. Une cause fréquente de réponses 4XX inattendues est une étiquette Liquid dans l’URL, les en-têtes ou le corps qui ne s’est pas résolue comme prévu. Vérifiez que toutes les références {{ }} pointent vers des champs qui existent pour l’utilisateur ou le contexte avec lequel vous prévisualisez.
La réponse semble obsolète
Vérifiez Served from cache dans l’onglet Response. Si la valeur est Yes, le débogueur affiche une réponse précédemment mise en cache plutôt qu’un appel en direct. Ajoutez temporairement :no_cache à votre étiquette, ou attendez l’expiration du cache (selon :cache_max_age), pour confirmer le comportement actuel de l’endpoint.