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 nouvelle tentative pour relancer la requête en utilisant des délais exponentiels.

Remarque

Le :retry du contenu connecté n’est pas disponible pour les messages in-app.

Comportement des nouvelles tentatives dans les étapes du Canvas

Les appels de contenu connecté dans un Canvas ne sont retentés 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 retente 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 de contexte et de mise à jour de l’utilisateur : Braze retente l’appel de contenu connecté au niveau de l’étape (jusqu’à cinq fois). Si toutes les tentatives échouent, l’utilisateur sort du Canvas.

Pour les étapes de contexte et de mise à jour de l’utilisateur, certaines erreurs d’étape susceptibles d’être retentées, 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 l’étiquette :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 étiquette :retry est incluse dans l’appel de contenu connecté, Braze tente de relancer l’appel jusqu’à cinq fois.

Comportement de l’aperçu

La logique de nouvelle tentative s’applique uniquement aux envois en production (y compris les envois de test), et non aux aperçus. Si un appel de contenu connecté avec :retry échoue pendant l’aperçu, celui-ci peut afficher le message « This message would not have been shown because retry functionality was triggered » au lieu de rendre 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 relancée 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 limitation du 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 la même manière qu’une étiquette d’abandon 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!