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.
Sobre o depurador
O Connected Content permite enriquecer mensagens com dados em tempo real, fazendo uma chamada HTTP a 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 de cada chamada de Connected Content na sua mensagem, na seção Prévia e Teste. Dessa forma, você pode confirmar se o seu endpoint, cabeçalhos e Liquid tags estão configurados corretamente, tudo dentro do dashboard da Braze.
Áreas compatíveis
O Depurador de Connected Content está disponível para as seguintes áreas:
- Banners
- Etapas de contexto do Canvas
- Content Cards
- E-mail
- Inclui modelos
- Não inclui rodapés e páginas de inscrição
- In-App Messages
- Notificações por push
- SMS/MMS/RCS
- Webhooks
- Inclui modelos
O depurador está disponível para a maioria dos canais, mas ainda não para KakaoTalk, LINE ou superfícies de composição não específicas de canal (como Content Blocks e a etapa de atualização de usuário do Canvas). 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 renderiza automaticamente os resultados da chamada de Connected Content na guia Prévia. Para usar o depurador:
- Configure sua mensagem com a tag
{% connected_content %}. - Acesse a seção Preview & Test. Se a 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 ou variantes de plataforma a partir de um único modelo, o depurador lista todas as chamadas de Connected Content entre essas renderizações — não apenas o corpo que você está visualizando. O e-mail pode produzir passes de renderização separados para HTML e texto simples (e Accelerated Mobile Pages (AMP) no envio), então a mesma URL pode aparecer mais de uma vez. O Quick Push pode renderizar para até quatro plataformas (iOS, Android, web e Kindle), então a mesma referência de Connected Content pode aparecer até quatro vezes.
Essas repetições correspondem à forma como a Braze renderiza e envia a mensagem; o depurador não as consolida. Para saber mais sobre por que o volume de chamadas pode exceder o de envios, consulte Entendendo o volume de chamadas de Connected Content.
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 todas as 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 a 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 | Cabeçalhos da sua tag de Connected Content (:headers, credenciais e opções como :content_type). |
| Body | O corpo da solicitação enviado, se houver (solicitações POST). |
Quais cabeçalhos de solicitação aparecem no depurador
A guia Request lista os cabeçalhos da sua tag de Connected Content: :headers personalizados, credenciais armazenadas e cabeçalhos definidos por opções da tag, como :content_type e :basic_auth. A Braze também adiciona cabeçalhos padrão na solicitação de saída para o seu endpoint (por exemplo, User-Agent e Host). Esses cabeçalhos adicionados pela Braze aparecem no depurador quando você os define em :headers.
Para enviar um User-Agent consistente, defina-o em :headers. A Braze usa o seu valor, e o depurador exibe esse cabeçalho.
A Braze adiciona os seguintes cabeçalhos às solicitações de Connected Content de saída. A maioria é definida apenas quando você ainda não os forneceu na tag. Os cabeçalhos que você fornece com :headers, credenciais ou opções da tag são enviados conforme fornecidos.
| Cabeçalho | Quando a Braze o define |
|---|---|
User-Agent |
Se você ainda não o definiu, a Braze envia Braze Sender <version>. A string de versão pode mudar. Se você filtra tráfego por User-Agent, permita todos os valores que começam com Braze Sender. Para enviar um valor consistente, defina User-Agent em :headers. |
X-Braze-Sender-Version |
Sempre definido como a versão do remetente de Connected Content. |
Accept-Encoding |
Se você ainda não o definiu, a Braze envia gzip. |
Authorization |
Se a URL incluir um nome de usuário e uma senha (user:pass@host), a Braze adiciona um cabeçalho Basic Authorization derivado dessas credenciais. Um cabeçalho Authorization explícito o substitui. Prefira :basic_auth ou :headers em vez de colocar credenciais na URL. |
Host |
Nome do host da URL da solicitação (por exemplo, www.example.com para https://www.example.com/abc/123), a menos que você defina um cabeçalho Host. |
Content-Length |
Tamanho do corpo da solicitação em bytes quando um corpo está presente. |
BrazeToBraze |
Definido como true apenas para solicitações a endpoints REST da Braze. Omitido para outros destinos. |
Redação de credenciais
Se a sua tag de Connected Content usar :basic_auth, cabeçalhos de segredos 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 confirmar que as credenciais foram incluídas na solicitação sem expor os valores em Preview & Test.
Falhas de autenticação continuam visíveis mesmo quando as credenciais são ocultadas: se o seu endpoint retornar um 401 ou 403, esse código de status aparece normalmente na guia Response, permitindo identificar que a solicitação foi rejeitada por problemas de autenticação, mesmo que a credencial em si esteja oculta.
Solução de problemas para códigos de resposta
Erros do 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 do 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 de que sua mensagem precisa.
O endpoint retornou um código de status inesperado
Use a guia Request para confirmar a URL, os cabeçalhos da sua tag e o corpo da requisição. 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 armazenada em cache anteriormente, em vez de uma chamada atualizada. Adicione :no_cache à sua tag temporariamente ou aguarde a expiração do cache (conforme :cache_max_age) para confirmar o comportamento atual do endpoint.