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 :
- Bannières
- É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 ou 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 du 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 de l’appel 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 contient 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 Voir pour consulter 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 selon les besoins. Ensuite, générez un nouvel aperçu pour confirmer la correction.
Si votre modèle contient plusieurs balises {% connected_content %}, le débogueur répertorie chaque appel effectué. Pour les canaux qui génèrent plusieurs corps de message ou variantes de plateforme à partir d’un seul modèle, le débogueur liste chaque appel de contenu connecté pour l’ensemble de ces rendus, et pas uniquement le corps que vous prévisualisez. L’e-mail peut produire des passes de rendu HTML et texte brut distinctes (ainsi que des pages mobiles accélérées (AMP) à l’envoi), de sorte que la même URL peut apparaître plusieurs fois. Quick Push peut effectuer un rendu pour jusqu’à quatre plateformes (iOS, Android, Web et Kindle), ce qui signifie que la même référence de contenu connecté peut apparaître jusqu’à quatre fois.
Ces répétitions correspondent à la manière dont Braze effectue le rendu et envoie le message ; le débogueur ne les regroupe pas. Pour en savoir plus sur les raisons pour lesquelles le volume d’appels peut dépasser le nombre d’envois, consultez Comprendre le volume d’appels de contenu connecté.
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 il constitue 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 compléter la requête, en secondes. La durée n’est affichée que 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 répertorie 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 telles que :content_type et :basic_auth. Braze ajoute également des en-têtes standard à 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. |
Masquage 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 de l’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
Les codes de statut non-2XX dans l’onglet Response ne proviennent pas tous 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 régulièrement des réponses volumineuses, envisagez de réduire le payload de la 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 tag 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 effectuez la prévisualisation.
La réponse semble obsolète
Vérifiez le champ Served from cache dans l’onglet Response. S’il affiche 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 tag, ou attendez l’expiration du cache (selon :cache_max_age), pour confirmer le comportement actuel de l’endpoint.