Skip to content

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 temporariamente indisponível enquanto a Braze faz a chamada. Nesse caso, a Braze oferece suporte a uma lógica de novas tentativas para reenviar a requisição usando backoff exponencial.

Usando lógica de nova tentativa

Para usar a lógica de nova tentativa, adicione a tag :retry à chamada de Connected Content, conforme mostrado no trecho de código a seguir:

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

Quando uma tag :retry é incluída na chamada de Connected Content, a Braze tenta repetir a chamada até cinco vezes.

Comportamento da prévia

A lógica de nova tentativa se aplica apenas a envios em tempo real (incluindo envios de teste), não a prévias. Se uma chamada de Connected Content com :retry falhar durante a prévia, ela poderá exibir a mensagem “This message would not have been shown because retry functionality was triggered” em vez de renderizar o conteúdo. Esse é o comportamento esperado e não indica um problema na Braze.

Resultados das novas tentativas

Quando uma nova tentativa é bem-sucedida

Se uma tentativa repetida for bem-sucedida, a mensagem é enviada e nenhuma nova tentativa adicional é feita para essa mensagem.

Quando a chamada de API falha e as novas tentativas estão ativadas

Se a chamada de API falhar e essa funcionalidade estiver ativada, a Braze tentará repetir a chamada respeitando o limite de frequência que você definiu para cada reenvio. A Braze moverá as mensagens com falha para o final da fila e adicionará minutos extras, se necessário, ao tempo total necessário para enviar sua mensagem.

Se a chamada de Connected Content apresentar erro mais de cinco vezes, a mensagem será abortada, de forma semelhante a como uma tag de interrupção de mensagem é disparada.

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.

New Stuff!