Depurar a coleta de dados do Analytics
Este artigo explica o que verificar quando você depura os dados enviados para o Adobe Analytics. Encontre seu método de implementação na tabela a seguir e siga sua seção. Se você estiver investigando dados de relatório inesperados, comece com Comparar solicitações com relatórios.
Para obter as etapas e ferramentas que se aplicam a toda a coleta de dados do Adobe, como capturar solicitações de rede, habilitar o log de depuração e investigar solicitações canceladas, consulte Depuração e solução de problemas da coleta de dados.
AppMeasurement e a extensão do Analytics appmeasurement
Localizar a solicitação appmeasurement-find
Capturar solicitações de rede e filtrar por /b/ss/. Os depuradores de tag, como o Adobe Experience Platform Debugger, identificam e decodificam essas solicitações para você.
Se nenhuma solicitação /b/ss/ aparecer:
- Verifique se há erros de JavaScript no console do navegador.
- Se você usar a extensão de tag do Analytics, confirme se o código de inserção de tag está dentro do elemento
<head>da página e se sua biblioteca foi publicada no ambiente que você está testando. Modo de depuração da marca mostra se a regra que envia a ocorrência foi acionada. - Se você hospeda o AppMeasurement, abra o URL da biblioteca diretamente para confirmar se o arquivo é carregado e contém o código.
- Desative as extensões do navegador, como bloqueadores de anúncios, que podem impedir o envio de solicitações.
- O depurador não reconhece solicitações enviadas de um iframe. Em vez disso, use as ferramentas de desenvolvedor do navegador. Consulte Usar AppMeasurement com iFrames.
Verificar o que o Analytics recebeu appmeasurement-contents
- Conjuntos de relatórios: o segmento de caminho após
/b/ss/lista as IDs de conjunto de relatórios que recebem a ocorrência. Confirme se eles são os conjuntos de relatórios esperados, como um conjunto de relatórios de desenvolvimento em páginas de desenvolvimento. - Variáveis: solicitações brutas usam nomes de parâmetros de consulta em vez de nomes de variáveis; por exemplo, eVar1 aparece como
v1e prop1 comoc1. Consulte a referência da variável. Quando uma solicitação é muito longa, o AppMeasurement a envia com HTTPPOST, para que as variáveis apareçam no corpo da solicitação em vez da URL. - Tipo de ocorrência: as solicitações enviadas por
tl()incluem o parâmetropee não incrementam as exibições de página. As solicitações enviadas port()não incluempe.
Se os valores estiverem presentes, mas estiverem errados, consulte Solução de problemas de implementação do JavaScript para causas comuns, como aspas, maiúsculas e minúsculas e espaço em branco.
Verifique a resposta appmeasurement-response
Uma resposta de 2xx confirma apenas que o servidor de coleta de dados recebeu a solicitação, não que a ocorrência foi registrada. Com o tipo de resposta padrão, uma solicitação pode retornar sucesso mesmo quando a ocorrência é descartada. Espera-se uma resposta de 302 na primeira solicitação de um novo visitante. Consulte códigos de resposta HTTP.
O AppMeasurement envia solicitações de link de saída e todas as solicitações quando useBeacon está habilitado, com navigator.sendBeacon(). As ferramentas do desenvolvedor podem rotular essas solicitações como canceladas mesmo quando enviadas pelo navegador. Consulte Solicitações canceladas.
SDK da web web-sdk
Localizar a solicitação web-sdk-find
Com o Web SDK, o navegador envia eventos para a Edge Network em vez de diretamente para o Analytics, para que você não veja uma solicitação /b/ss/. Inspecione a solicitação do Edge Network e confirme o seguinte:
- O parâmetro
configIdcorresponde a uma sequência de dados que tem o serviço Adobe Analytics habilitado com os conjuntos de relatórios esperados. - A carga é qualificada como uma exibição de página ou um evento de link. O Analytics ignora cargas que não contêm detalhes de página nem um tipo de interação com a Web. Consulte tipos de evento do Edge Network no Adobe Analytics.
Verificar o que o Analytics recebeu web-sdk-contents
Inicie um Edge Trace e reproduza a ação. Localize a linha que começa com Mapeamento Automático do Analytics e expanda mappedQueryParams e a ID do conjunto de relatórios abaixo dela.
- Variáveis: os valores mapeados usam os mesmos nomes de parâmetro de consulta que as solicitações do AppMeasurement, às vezes em forma abreviada, como
gnpara nome de página eplpara produtos. Consulte mapeamento de campo de objeto XDM e mapeamento de campo de objeto de dados. - Dados de contexto: os campos XDM que não são mapeados para uma variável do Analytics aparecem como dados de contexto com o prefixo
c.a.x.. Use regras de processamento para atribuí-las a variáveis. - Conjuntos de relatórios: se você usar substituições de conjuntos de relatórios, a linha de configuração da sequência de dados no Edge Trace mostrará os conjuntos de relatórios que a Edge Network usou.
Verificar processamento web-sdk-processing
Na sessão do Assurance aberta pelo Edge Trace, pesquise eventos para hitdebugger. Esses eventos usam o fornecedor com.adobe.analytics.hitdebugger e suas cargas mostram valores após o processamento do Analytics, como Experience Cloud ID (mcvisId) e pageName.
Para obter uma apresentação guiada, consulte Configurar o Adobe Analytics com o Adobe Experience Platform Web SDK.
Comparar solicitações com relatórios reports
Uma ocorrência que atinge o Analytics não é exibida nos relatórios imediatamente e os valores relatados podem diferir dos valores na solicitação:
- Latência: dados concluídos normalmente aparecem em relatórios cerca de duas horas após a coleta. Alguns dados, como ocorrências com carimbo de data e hora, podem levar mais tempo. Consulte Disponibilidade e latência de dados.
- Processando: regras de processamento, regras VISTA, regras de bot e outras etapas de processamento podem alterar ou excluir valores após a coleção. Consulte Ordem de processamento dos dados no Adobe Analytics. Os dados pós-processados do Assurance mostram o resultado do processamento de uma ocorrência individual.
- Conjunto de relatórios: confirme se você está visualizando o mesmo conjunto de relatórios ao qual a solicitação ou a sequência de dados se destina.
- Valores inesperados: se uma dimensão mostrar picos ou valores inesperados, consulte Colisões de hash.
Para alterações de tráfego mais amplas, consulte Solução de problemas de picos e quedas nos dados.