Depurador de Connected Content
Use o Depurador de Connected Content para visualizar a solicitação e a resposta em tempo real de cada chamada de Connected Content, para que você possa verificar seu endpoint, cabeçalhos e Liquid tags antes de lançar uma Campaign ou um Canvas.
Connected Content Debugger está atualmente em acesso antecipado. Fale com o seu Braze account manager se tiver interesse em participar do acesso antecipado.
Sobre o depurador
O Connected Content permite enriquecer mensagens com dados em tempo real, fazendo uma chamada HTTP para uma API externa no momento da renderização e inserindo a resposta na sua mensagem com Liquid. Como essa chamada acontece fora da Braze, pode ser difícil ver exatamente qual solicitação a Braze enviou, o que o endpoint retornou ou por que uma chamada falhou, antes de uma Campaign ou Canvas estar ativa.
O Depurador de Connected Content ajuda a solucionar esses problemas antes do lançamento. Ele mostra a solicitação e a resposta em tempo real para cada chamada de Connected Content na sua mensagem, na seção Prévia e teste. Dessa forma, você pode confirmar que seu endpoint, cabeçalhos e Liquid tags estão configurados corretamente, tudo dentro do dashboard da Braze.
Canais compatíveis
O Depurador de Connected Content está disponível para os seguintes canais:
- Content Cards
- E-mail
- Inclui modelos
- Exclui rodapés e páginas de inscrição
- Mensagens no app
- Notificações por push
- SMS/MMS/RCS
- Webhooks
- Inclui modelos
Durante o acesso antecipado, o depurador está disponível para a maioria dos canais, mas ainda não para KakaoTalk, LINE, Banners ou superfícies de composição não específicas de canal (como Content Blocks, etapa de atualização de usuário do Canvas e etapa de contexto). Se você não vir o depurador, a depuração de Connected Content pode ainda não ser compatível com esse recurso.
Usar o depurador
Cada vez que você executa uma prévia, a Braze automaticamente renderiza os resultados da chamada de Connected Content na guia Preview. Para usar o depurador:
- Configure sua mensagem com a tag
{% connected_content %}. - Acesse a seção Preview & Test. Se sua mensagem incluir uma tag de Connected Content, você poderá ver um resumo com o número de chamadas de Connected Content e os status de sucesso e erro.
- Selecione View details para abrir o depurador ao lado da sua prévia. O painel exibe uma tabela com a URL e o resultado de cada chamada de Connected Content.
- Ao lado de cada URL e resultado, selecione View para visualizar os cabeçalhos de solicitação e resposta, a carga útil, o método, a duração e as informações de cache.
- Revise os resultados, ajuste sua tag, cabeçalhos ou endpoint conforme necessário. Em seguida, gere uma nova prévia para confirmar a correção.
Se o seu modelo contiver mais de uma tag {% connected_content %}, o depurador lista todas as chamadas realizadas. Para canais que renderizam múltiplos corpos de mensagem a partir de um único modelo (por exemplo, e-mail, que renderiza corpos HTML, texto simples e AMP separados, ou Quick Push, que renderiza corpos separados específicos para cada dispositivo), o depurador mostra todas as chamadas de Connected Content feitas em todos os corpos, não apenas no que você está visualizando no momento.
Entenda a saída de depuração
Cada chamada de Connected Content aparece com suas próprias guias Response e Request. A guia Response é exibida por padrão, pois geralmente é o primeiro indicador para confirmar se uma chamada foi bem-sucedida.
Detalhes da URL
| Campo | Descrição |
|---|---|
| URL | A URL totalmente renderizada que a Braze chamou, com quaisquer Liquid tags resolvidas. |
| Method | O método HTTP utilizado (GET ou POST). |
| Status code | O código de status HTTP retornado pelo seu endpoint (por exemplo, 200, 404, 500). Consulte Solução de problemas de códigos de resposta para códigos específicos da Braze. |
Guia Response
| Campo | Descrição |
|---|---|
| Duration | Quanto tempo a solicitação levou para ser concluída, em segundos. A duração é exibida apenas para chamadas em tempo real (não armazenadas em cache). |
| Served from cache | Indica se essa resposta foi servida a partir do cache de Connected Content da Braze em vez de uma chamada em tempo real ao seu endpoint (Yes ou No). Um resultado em cache reflete uma resposta anterior, não necessariamente o estado atual do seu endpoint. |
| Response body | O corpo retornado pelo seu endpoint. |
Guia Request
| Campo | Descrição |
|---|---|
| Headers | Os cabeçalhos da solicitação enviados pela Braze, incluindo quaisquer definidos com :headers. |
| Body | O corpo da solicitação enviado, se houver (solicitações POST). |
Redação de credenciais
Se a sua tag de Connected Content usar :basic_auth, cabeçalhos secretos comuns, chaves ou outras opções de credenciais de autenticação, o depurador oculta esses valores na guia Request e os substitui por uma série de asteriscos (*). Isso permite que você confirme que as credenciais foram incluídas na solicitação sem expor os valores em Preview & Test.
Falhas de autenticação ainda ficam visíveis mesmo quando as credenciais estão ocultas: se o seu endpoint retornar um 401 ou 403, esse código de status aparece normalmente na guia Response, para que você saiba que a solicitação foi rejeitada por causa da autenticação, mesmo que a credencial em si esteja oculta.
Solução de problemas de códigos de resposta
Erros de endpoint versus limites impostos pela Braze
Nem todo código de status diferente de 2XX na guia Response vem do seu endpoint. A Braze aplica seus próprios limites nas chamadas de Connected Content, e esses limites podem gerar respostas que parecem semelhantes a um erro de endpoint.
Se você encontrar códigos de resposta como 408, 429, 502, 503, 504 ou 599, o problema normalmente está do lado da Braze na chamada — relacionado à integridade do host, tempo limite ou tamanho da carga útil. Se o seu endpoint retorna respostas grandes de forma consistente, considere reduzir a carga útil da resposta para incluir apenas os campos que sua mensagem precisa.
O endpoint retornou um código de status inesperado
Use a guia Request para confirmar a URL exata, os cabeçalhos e o corpo que a Braze enviou. Uma causa comum de respostas 4XX inesperadas é uma Liquid tag dentro da URL, dos cabeçalhos ou do corpo que não foi resolvida da forma esperada. Verifique se todas as referências {{ }} apontam para campos que existem para o usuário ou contexto com o qual você está fazendo a prévia.
A resposta parece desatualizada
Verifique Served from cache na guia Response. Se o valor for Yes, o depurador está exibindo uma resposta previamente armazenada em cache em vez de uma chamada atualizada. Adicione :no_cache à sua tag temporariamente, ou aguarde o cache expirar (conforme :cache_max_age), para confirmar o comportamento atual do endpoint.