Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Utiliser une logique de nouvelles tentatives pour le contenu connecté

Cette page explique comment ajouter des nouvelles tentatives à vos appels de contenu connecté.

Fonctionnement des nouvelles tentatives

Comme le contenu connecté dépend de données reçues depuis des API, il arrive qu’une API soit temporairement indisponible au moment où Braze effectue l’appel. Dans ce cas, Braze prend en charge une logique de nouvelles tentatives qui relance la requête en appliquant des délais exponentiels.

Remarque

L’option :retry du contenu connecté n’est pas disponible pour les messages in-app ni pour les bannières.

Comportement des nouvelles tentatives dans les étapes du Canvas

Dans un Canvas, les appels de contenu connecté ne font l’objet de nouvelles tentatives que s’ils incluent :retry. Le comportement varie selon le type d’étape :

Étapes Message : Le contenu connecté avec :retry passe toujours par le pipeline d’envoi de messages. Les destinataires sont mis en attente dans la file d’attente d’envoi pendant que Braze relance l’appel jusqu’à cinq fois. Si toutes les tentatives échouent, le message est annulé et l’utilisateur passe à l’étape suivante. Pour plus de détails, consultez la section Lorsque l’appel API échoue et que les nouvelles tentatives sont activées.
Étapes Contexte et Mise à jour utilisateur : Braze relance l’appel de contenu connecté au niveau de l’étape (jusqu’à cinq fois). Si toutes les tentatives échouent, l’utilisateur quitte le Canvas.

Pour les étapes Contexte et Mise à jour utilisateur, certaines erreurs d’étape pouvant faire l’objet d’une nouvelle tentative (par exemple, l’échec de la récupération d’un code promotionnel ou une erreur d’étape inattendue) peuvent déclencher des tentatives supplémentaires au niveau de l’étape, avec des délais exponentiels (environ 13 fois), avant que Braze ne fasse sortir l’utilisateur du Canvas.

Pour plus d’informations, consultez la section Comportement des nouvelles tentatives.

Utiliser la logique de nouvelle tentative

Pour utiliser la logique de nouvelle tentative, ajoutez l’étiquette :retry à l’appel de contenu connecté, comme dans l’extrait de code suivant :

{% connected_content https://yourwebsite.com/api/endpoint :retry %}
{% connected_content https://www.braze.com :save my_content :basic_auth auth_name :retry %}

Lorsque l’appel de contenu connecté contient l’étiquette :retry, Braze retente l’appel jusqu’à cinq fois.

Comportement en prévisualisation

La logique de nouvelle tentative s’applique uniquement aux envois en direct (y compris les envois de test), et non aux prévisualisations de messages ni à la prévisualisation des parcours utilisateur. Si un appel de contenu connecté avec :retry échoue, Braze ne retente pas l’appel. À la place :

Lors de la prévisualisation d’un message, celle-ci peut afficher « This message would not have been shown because retry functionality was triggered » au lieu du contenu.
Lors de la prévisualisation des parcours utilisateur, une étape Message peut afficher « Message aborted due to connected content retry failure ».

Ce comportement est normal et ne signale aucun problème dans Braze.

Résultats des nouvelles tentatives

Lorsqu’une nouvelle tentative réussit

Si une nouvelle tentative réussit, le message est envoyé et aucune autre tentative n’est effectuée pour ce message.

Lorsque l’appel API échoue et que les nouvelles tentatives sont activées

Si l’appel API échoue et que cette option est activée, Braze retente l’appel en respectant la limite de débit que vous avez définie pour chaque renvoi. Braze place les messages en échec à la fin de la file d’attente et ajoute, si nécessaire, des minutes supplémentaires à la durée totale d’envoi de votre message.

Si l’appel de contenu connecté échoue plus de cinq fois, le message est interrompu, de la même manière que lorsqu’une étiquette d’interruption de message est déclenchée.

Appels de Contenu connecté avec logique d’abandon et de nouvelle tentative

Si un appel de Contenu connecté utilise une logique d’abandon pour la même condition que la logique de nouvelle tentative, la logique d’abandon est prioritaire. Cela empêche toute nouvelle tentative d’être effectuée. La logique de nouvelle tentative renvoie déjà l’appel avant de l’abandonner si le code de statut indique un échec. Étant donné que les deux ciblent le même comportement de code de statut, vous pouvez supprimer la logique d’abandon : l’appel sera tout de même abandonné si toutes les nouvelles tentatives échouent.

New Stuff!