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

Étant donné que le contenu connecté repose sur la réception de données provenant d’API, une API peut être temporairement indisponible au moment où Braze effectue l’appel. Dans ce cas, Braze prend en charge une logique de nouvelles tentatives pour relancer la requête en utilisant des délais exponentiels.

Remarque

La fonctionnalité :retry du contenu connecté n’est pas disponible pour les messages in-app ni les Banners.

Comportement des nouvelles tentatives dans les étapes du Canvas

Les appels de contenu connecté dans un Canvas ne font l’objet de nouvelles tentatives que lorsque l’appel inclut :retry. Le comportement diffère selon le type d’étape :

Étapes de message : Le contenu connecté avec :retry utilise toujours le pipeline de communication. 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 abandonné et l’utilisateur passe à l’étape suivante. Pour plus de détails, consultez Lorsque l’appel API échoue et que les nouvelles tentatives sont activées.
Étapes Contexte et Mise à jour de l’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 de l’utilisateur, certaines erreurs d’étape pouvant faire l’objet de nouvelles tentatives — comme l’échec de la récupération d’un code promotionnel ou une erreur d’étape inattendue — peuvent déclencher des nouvelles 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 en savoir plus, consultez Comportement des nouvelles tentatives.

Utiliser la logique de nouvelle tentative

Pour utiliser la logique de nouvelle tentative, ajoutez la balise :retry à l’appel de contenu connecté, comme illustré 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 %}

Lorsqu’une balise :retry est incluse dans l’appel de contenu connecté, Braze tente de relancer l’appel jusqu’à cinq fois.

Comportement en prévisualisation

La logique de nouvelle tentative s’applique uniquement aux envois en production (y compris les envois de test), et non aux prévisualisations. Si un appel de contenu connecté avec :retry échoue lors de la prévisualisation, celle-ci peut afficher le message « This message would not have been shown because retry functionality was triggered » au lieu de restituer le contenu. Il s’agit d’un comportement attendu qui n’indique pas un problème au sein de Braze.

Résultats des nouvelles tentatives

Lorsqu’une nouvelle tentative réussit

Si une tentative ultérieure aboutit, le message est envoyé et aucune nouvelle tentative supplémentaire 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 fonctionnalité est activée, Braze relance l’appel en respectant la limite de débit que vous avez définie pour chaque renvoi. Braze déplace les messages ayant échoué à la fin de la file d’attente et ajoute des minutes supplémentaires, si nécessaire, au temps total nécessaire pour envoyer votre message.

Si l’appel de contenu connecté échoue plus de cinq fois, le message est abandonné, de manière similaire au déclenchement d’une balise d’abandon de message.

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!