Usar lógica de nova tentativa para Conteúdo conectado
Esta página explica como adicionar novas tentativas às suas chamadas de Conteúdo conectado.
Como funcionam as novas tentativas
Como o Connected Content depende do recebimento de dados de APIs, uma API pode ficar indisponível de forma intermitente enquanto a Braze faz a chamada. Nesse caso, a Braze oferece uma lógica de novas tentativas, que repete a solicitação usando backoff exponencial.
O :retry do Connected Content não está disponível para mensagens no app nem para Banners.
Comportamento de novas tentativas nas etapas do Canvas
As chamadas de Connected Content em um Canvas só fazem novas tentativas quando a chamada inclui :retry. O comportamento varia conforme o tipo de etapa:
- Etapas de mensagem: O Connected Content com
:retrycontinua usando o pipeline de envio de mensagens. Os destinatários ficam aguardando na fila de envio enquanto a Braze tenta a chamada novamente até cinco vezes. Se todas as tentativas falharem, a mensagem é interrompida e o usuário avança para a próxima etapa. Para saber mais, consulte Quando a chamada de API falha e as novas tentativas estão ativadas. - Etapas de Contexto e de Atualização de Usuário: A Braze tenta a chamada de Connected Content novamente no nível da etapa (até cinco vezes). Se todas as tentativas falharem, o usuário sai do Canvas.
Nas etapas de Contexto e de Atualização de Usuário, alguns erros de etapa que permitem nova tentativa, como uma falha ao buscar um código promocional ou um erro inesperado na etapa, podem disparar novas tentativas adicionais no nível da etapa com backoff exponencial (cerca de 13 vezes). Só depois disso a Braze remove o usuário do Canvas.
Para saber mais, consulte Comportamento de novas tentativas.
Usando a lógica de nova tentativa
Para usar a lógica de nova tentativa, adicione a tag :retry à chamada do Connected Content, como mostrado no snippet de código a seguir:
{% connected_content https://yourwebsite.com/api/endpoint :retry %}
{% connected_content https://www.braze.com :save my_content :basic_auth auth_name :retry %}
Quando você inclui a tag :retry na chamada do Connected Content, a Braze tenta refazer a chamada até cinco vezes.
Comportamento na prévia
A lógica de nova tentativa só se aplica a envios em tempo real (incluindo envios de teste). Ela não se aplica a prévias de mensagens nem à prévia de jornadas do usuário. Se uma chamada do Connected Content com :retry falhar, a Braze não tenta refazer a chamada. Em vez disso:
- Na prévia da mensagem, pode aparecer “This message would not have been shown because retry functionality was triggered” no lugar do conteúdo renderizado.
- Na prévia de jornadas do usuário, uma etapa de Mensagem pode mostrar “Message aborted due to connected content retry failure”.
Esse é o comportamento esperado e não indica um problema na Braze.
Resultados das novas tentativas
Quando uma nova tentativa é bem-sucedida
Se uma nova tentativa for bem-sucedida, a mensagem será enviada e nenhuma outra tentativa será feita para essa mensagem.
Quando a chamada de API falha e as novas tentativas estão ativadas
Se a chamada de API falhar e esse recurso estiver ativado, a Braze tentará refazer a chamada respeitando o limite de frequência que você definiu para cada reenvio. A Braze move as mensagens com falha para o final da fila e, se necessário, adiciona mais minutos ao tempo total de envio da sua mensagem.
Se a chamada do Connected Content apresentar erro mais de cinco vezes, a mensagem será interrompida, de forma semelhante ao disparo de uma tag de interrupção de mensagem.
Chamadas de Conteúdo conectado com lógica de cancelamento e nova tentativa
Se uma chamada de Conteúdo conectado usa lógica de cancelamento para a mesma condição da lógica de nova tentativa, a lógica de cancelamento tem prioridade. Isso impede que qualquer nova tentativa seja feita. A lógica de nova tentativa já reenvia a chamada antes de cancelá-la se o código de status não for bem-sucedido. Como ambas tratam o mesmo comportamento de código de status, você pode remover a lógica de cancelamento e a chamada ainda será cancelada se todas as novas tentativas falharem.