Depuração e solução de problemas da coleta de dados
A depuração da coleta de dados envolve verificar como sua implementação se comporta e o que acontece com os dados enviados. Comece com o sintoma e siga o evento em cada estágio da coleção até encontrar onde ele para de se comportar conforme esperado.
O log de depuração expõe comandos do SDK, execução de tags, avisos e erros no navegador ou no tempo de execução do aplicativo. A inspeção de solicitação expõe cargas, respostas e, para fluxos de trabalho compatíveis, processamento no lado do servidor. Essas abordagens geralmente se complementam: um log pode explicar por que um evento foi atrasado, enquanto uma captura de rede pode mostrar se uma solicitação foi enviada.
Acompanhar o evento por meio da coleção diagnostic-workflow
Investigue os estágios a seguir em ordem. A evidência de que uma etapa teve êxito não estabelece que fases posteriores também tiveram êxito.
- Execução da implementação: o comando ou a regra de marca SDK foi executada? Verifique as mensagens e os erros de diagnóstico. Se o consentimento ou o manuseio de identidade atrasar um evento, investigue esse estado antes de procurar uma solicitação de rede. Consulte Habilitar log de depuração.
- Solicitação de saída: a solicitação foi enviada e continha os dados esperados? Inspecione o payload e compare-o com suas entradas de comando ou elementos de dados. Consulte Inspecionar solicitações da Web ou Inspecionar solicitações de dispositivos móveis e servidores.
- Recebimento do servidor: o ponto de extremidade da coleção recebeu a solicitação? Inspecione a resposta onde disponível ou use um rastreamento do lado do servidor compatível. Um log de cliente que diz que uma solicitação foi enviada não é uma confirmação de recebimento.
- Processamento e roteamento do Edge: o evento usou a sequência de dados pretendida e os serviços configurados? Para o Web SDK, o
configIdparâmetro da solicitação mostra qual sequência de dados foi usada, e o Edge Trace mostra como o Edge Network processou o evento. - Processamento downstream: o destino aceitou e processou o evento conforme esperado? Use a orientação de depuração específica do produto do destino. Uma resposta bem-sucedida do Edge Network não prova que os dados estão disponíveis em todos os relatórios ou armazenamentos downstream.
Escolher um ponto inicial choose-a-starting-point
A tabela a seguir identifica evidências úteis para tarefas comuns. Quando ambas as abordagens se aplicam, elas respondem a diferentes partes do inquérito. As mensagens e ferramentas disponíveis dependem do SDK, do tempo de execução e dos serviços configurados.
documentUnloading.Depuração específica do produto product-specific
Os artigos desta seção se aplicam a toda a coleção de dados do Experience Platform. Os aplicativos da Adobe que recebem seus dados podem usar seus próprios endpoints, formatos de solicitação, exibições de validação e processamento. Depois de confirmar que o Edge Network recebeu e roteou um evento ou quando sua implementação envia dados diretamente para um aplicativo, continue com a orientação de depuração desse aplicativo:
- Adobe Analytics: Depurar coleta de dados do Analytics
- Adobe Analytics para streaming de mídia: exibição do Adobe Analytics para streaming de mídia no Assurance
- Adobe Audience Manager: códigos de erro, mensagens e exemplos de DCS
- Conjuntos de dados do Adobe Experience Platform e Perfil do cliente em tempo real: Guia de solução de problemas de assimilação de streaming
- Adobe Journey Optimizer: Testar experiências com base em código, Validar mensagens no aplicativo usando o Assurance e Modo de exibição de validação de decisão
- Adobe Target: Depurar Destino com Web SDK e Testar uma implementação de at.js com Depurador
- Customer Journey Analytics: Exibir, solucionar problemas e modificar configurações de conexão
Continuar sua investigação next-steps
- Habilitar log de depuração: habilitar, inspecionar e desabilitar saída de diagnóstico para Web SDK, marcas, Server SDK e Mobile SDK.
- Inspecionar solicitações de coleta de dados: Capturar solicitações, interpretar evidências de solicitação Edge Network, rastrear processamento Edge e investigar solicitações canceladas.
- Ferramentas de depuração: compare ferramentas do Adobe, depuradores de marcas, ferramentas de desenvolvedor do navegador e proxies HTTP.
- Orientação específica do assunto: mantenha investigações detalhadas próximas à configuração ou referência da API, como consentimento e identidade, descarregamento de documentos e duplicação de eventos.
Antes de compartilhar logs, rastreamentos ou capturas de rede, remova credenciais, identificadores de visitantes e outras informações confidenciais de acordo com as políticas da organização.