Usar lógica de reintentos para contenido conectado

Esta página cubre cómo agregar reintentos a tus llamadas de contenido conectado.

Cómo funcionan los reintentos

Dado que el contenido conectado depende de recibir datos de las API, una API puede no estar disponible de forma intermitente mientras Braze realiza la llamada. En este caso, Braze admite lógica de reintentos para volver a intentar la solicitud utilizando retirada exponencial.

Nota

:retry de contenido conectado no está disponible para mensajes dentro de la aplicación ni para Banners.

Comportamiento de reintentos en pasos en Canvas

Las llamadas de contenido conectado en un Canvas solo se reintentan cuando la llamada incluye :retry. El comportamiento difiere según el tipo de paso:

• Pasos de mensaje: El contenido conectado con :retry sigue utilizando el pipeline de mensajería. Los destinatarios se retrasan en la cola de envío mientras Braze reintenta la llamada hasta cinco veces. Si todos los reintentos fallan, el mensaje se cancela y el usuario avanza al siguiente paso. Para más detalles, consulta Cuando la llamada a la API falla y los reintentos están habilitados.
• Pasos de contexto y actualización de usuario: Braze reintenta la llamada de contenido conectado a nivel de paso (hasta cinco veces). Si todos los reintentos fallan, el usuario sale del Canvas.

Para los pasos de contexto y actualización de usuario, ciertos errores reintentables a nivel de paso, como una obtención fallida de código promocional o un error inesperado en el paso, pueden desencadenar reintentos adicionales a nivel de paso con retirada exponencial (aproximadamente 13 veces) antes de que Braze saque al usuario del Canvas.

Para más información, consulta Comportamiento de reintentos.

Uso de la lógica de reintento

Para usar la lógica de reintento, agrega la etiqueta :retry a la llamada de contenido conectado, como se muestra en el siguiente fragmento de código:

1
2

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

Cuando se incluye una etiqueta :retry en la llamada de contenido conectado, Braze intenta reintentar la llamada hasta cinco veces.

Comportamiento de la vista previa

La lógica de reintento solo se aplica a los envíos en vivo (incluidos los envíos de prueba), no a las vistas previas. Si una llamada de contenido conectado con :retry falla durante la vista previa, la vista previa puede mostrar el mensaje “This message would not have been shown because retry functionality was triggered” en lugar de representar el contenido. Este es el comportamiento esperado y no indica un problema dentro de Braze.

Resultados del reintento

Cuando un reintento tiene éxito

Si un intento reintentado tiene éxito, el mensaje se envía y no se realizan más reintentos para ese mensaje.

Cuando la llamada a la API falla y los reintentos están habilitados

Si la llamada a la API falla y esta opción está habilitada, Braze reintenta la llamada respetando el límite de velocidad que estableciste para cada reenvío. Braze mueve los mensajes fallidos al final de la cola y agrega minutos adicionales, si es necesario, al total de minutos que tarda en enviar tu mensaje.

Si la llamada de contenido conectado falla más de cinco veces, el mensaje se cancela, de forma similar a como se desencadena una etiqueta de cancelación de mensaje.

Llamadas de Contenido conectado con lógica de cancelación y reintento

Si una llamada de Contenido conectado utiliza lógica de cancelación para la misma condición que la lógica de reintento, la lógica de cancelación tiene prioridad. Esto impide que se intente cualquier reintento. La lógica de reintento ya reenvía la llamada antes de cancelarla si el código de estado no es correcto. Dado que ambas se dirigen al mismo comportamiento de código de estado, puedes quitar la lógica de cancelación y la llamada seguirá cancelándose si todos los reintentos fallan.