Solução de problemas de dados do Adobe Advertising no Customer Journey Analytics
A seguir estão possíveis problemas, suas possíveis causas e soluções.
Lista de todos os problemas em potencial
_experience.adcloud está ausente na carga do Experience Data Model (XDM) para click-throughs.alloy() foi bem-sucedida (com uma resposta 200), mas os dados de conversão do Adobe Advertising estão ausentes nos relatórios._experience.adcloud.Page Views) não estão disponíveis para uma dimensão de relatório (como Campaign) no CJA Customer Journey Analytics Workspace.Problemas de instalação e configuração issues-installation-setup
A extensão WebSDK não inicializa #websdk-extension-doesn’t-initialize
Problemas:
- Nenhuma chamada alloy() está visível na guia Network da ferramenta de inspeção de código do seu navegador.
- Erro do console: liga não definida.
- Nenhuma solicitação de interação ou coleta é feita para edge.adobedc.net.
Possíveis causas e verificação/resolução
<head> para a tag de script //assets.adobedtm.com/....Sequência de dados não configurada ou configurada incorretamente datastream-not-configured-or-misconfigured
Problemas:
- As solicitações chegam ao Adobe Experience Platform Edge Network, mas retornam erros 400 ou 500.
- Nenhum dado é exibido nos relatórios do Adobe Analytics ou do Adobe Advertising.
- Erro na resposta da rede: “sequência de dados não encontrada”
Possíveis causas e verificação/resolução
- Em Tags, abra as configurações da sequência de dados para sua propriedade de marca.
- Confirme se o campo Datastream aponta para o fluxo de dados correto para cada ambiente (desenvolvimento, preparo e produção), bem como para o esquema e o conjunto de dados corretos.
Cada ambiente deve ter sua própria sequência de dados, a menos que você compartilhe explicitamente uma sequência de dados entre os três ambientes.
Abra as configurações da sequência de dados e verifique se os seguintes serviços estão habilitados:
- Adobe Advertising (para conversão/sincronização de público)
- Adobe Experience Platform (para assimilação de perfil)
Advertising problemas de configuração de extensão advertising-extension-setup-issues
Problemas:
-
Nenhuma conversão de view-through ou click-through é registrada para a página da Web.
Para verificar se as conversões são registradas:
- Abra a página da Web com
ef_id=test&s_kwcid=testanexada à URL. - Abra a ferramenta de inspeção de código do seu navegador (geralmente chamada de Inspect), abra a guia Network e procure uma chamada interativa para event_type=“advertising.enrichment_ct” no Adobe Experience Platform.
- Na interface da Coleção de Dados, abra a definição de esquema para os dados de site que deseja coletar e confirme se
xdm->_experience->adcloud->conversionDetails->trackingCodeetrackingIdentitiescontêmef_ides_kwcid.
- Abra a página da Web com
-
_experience.adcloudestá ausente na carga do Experience Data Model (XDM) para click-throughs. -
As conversões são confirmadas em uma ferramenta de depuração, mas não aparecem nos relatórios do Adobe Advertising
Possíveis causas e verificação/resolução
Adobe Advertising não está habilitado para a sequência de dados.-
Em Tags, abra as configurações da sequência de dados para sua propriedade de marca.
-
Ative os seguintes serviços e salve as configurações:
- Adobe Advertising (para conversão/sincronização de público)
- Adobe Experience Platform (para assimilação de perfil)
Adobe Advertising não está habilitado para a extensão WebSDK.O componente Adobe Advertising na extensão WebSDK está desabilitado por padrão e deve ser habilitado explicitamente antes que qualquer rastreamento de click-throughs ou view-throughs do Adobe Advertising seja funcional, independentemente de como o esquema ou as regras XDM são configurados.
- Em Tags, abra as opções de compilação da propriedade nas definições de configuração do Adobe Experience Platform Web SDK.
- Habilite o componente Advertising e salve as configurações.
- Recrie a biblioteca e publique-a novamente.
Adobe Advertising estiver habilitado, o rastreamento de click-through ficará ativo automaticamente usando os parâmetros de consulta de URL s_kwcid e ef_id. O rastreamento de view-through é desativado por padrão e requer configuração adicional — consulte a próxima linha.- Habilitar o serviço Adobe Advertising para a sequência de dados
-
- Vá para Data Collection > Datastreams no Adobe Experience Platform e abra a sequência de dados usada pela propriedade Tags.
- Selecione Adicionar Serviço, Adobe Advertising e Adobe Experience Platform e Salvar. Configurar anunciantes no Adobe Advertising DSP
-
- Em Tags, vá para Extensions > Installed > Adobe Experience Platform Web SDK > Configure.
- Na seção Advertiser, selecione um anunciante na lista suspensa e ative-o. Para configurar vários anunciantes, selecione Adicionar anunciante. Verificar se os pixels de conversão de view-through estão sendo acionados
- Na Adobe Experience Platform Debugger, confirme se a chamada de interação inclui
stitchIdno campoxdm.query. - Na guia Network da ferramenta de inspeção de código do navegador, confirme se um evento do tipo
advertising.enrichmentfoi acionado e incluistitchIdemxdm.query.
As conversões de view-through são acionadas somente a cada 30 minutos, independentemente do número de visitas. Se você não vir uma chamada interativa, limpe o cache do navegador e tente novamente.
Antes de abrir um tíquete de suporte para problemas de configuração de extensão do Advertising, verifique o seguinte:
- Os serviços Adobe Advertising e Adobe Experience Platform são adicionados à sequência de dados.
- O componente Adobe Advertising está habilitado na configuração da extensão WebSDK.
- A biblioteca foi recriada e republicada após a ativação do componente.
- Para rastreamento de click-through, a URL da página de aterrissagem contém
s_kwcideef_idno clique do anúncio. - Para rastreamento view-through, um anunciante é configurado no Adobe Advertising DSP com a ID correta do anunciante.
- A extensão WebSDK é versão 2.36.0 ou posterior.
Problemas de identidade e ECID identity-and-ecid-issues
Problemas:
- A ID de visitante muda entre páginas.
- Os segmentos de público-alvo do Advertising não correspondem.
Possíveis causas e verificação/resolução
idMigrationEnabled está definido como false enquanto um cookie s_ecid herdado está presente.idMigrationEnabled: true na configuração base do SDK da Web para migrar a ECID existente dos cookies s_ecid ou AMCV_.As regras ou os eventos não são acionados #rules-or-events-don’t-fire
Problemas:
- O depurador mostra que as condições da regra não são atendidas.
- A ação Send Event nunca é executada.
Verificação e resolução
Verifique o seguinte:
- A regra foi salva e incluída na build de biblioteca ativa.
- O tipo de evento corresponde ao comportamento real da página (como Library Loaded vs. DOM Ready vs. Window Loaded).
- As condições da regra não são muito restritivas. Teste removendo condições temporariamente para isolar o problema.
- A ordem da regra está correta. Se várias regras compartilharem o mesmo evento, verifique a ordem das regras.
- Nenhum erro do JavaScript exibido anteriormente na página está interrompendo a execução. Verifique se há exceções não detectadas no console do navegador.
Problemas de build e publicação da biblioteca library-build-and-publishing-issues
Problemas:
- As alterações feitas em Tags não são refletidas no site ativo.
- Uma atualização de extensão foi aplicada, mas o comportamento antigo persiste.
Possíveis causas e verificação/resolução
Problemas de validação de esquema para campos do Advertising schema-validation-for-advertising-fields
Problemas:
- A chamada de evento de envio
alloy()foi bem-sucedida (com uma resposta 200), mas os dados de conversão do Adobe Advertising estão ausentes nos relatórios. - A carga XDM no depurador não mostra nenhum objeto
_experience.adcloud.
Possíveis causas e verificação/resolução
- Vá para Adobe Experience Platform > Data Management > Schemas.
- Abra o esquema usado pelo seu fluxo de dados.
- No painel Field Groups, confirme se a Extensão completa do ExperienceEvent da Adobe Advertising Cloud está listada.
- Se estiver ausente, selecione Adicionar, pesquise por Adobe Advertising Cloud, selecione Extensão completa do Adobe Advertising Cloud ExperienceEvent e salve as configurações.
A republicação da biblioteca Tags não é necessária somente para alterações de esquema, mas você deve remapear o elemento de dados XDM em Tags se novos campos forem adicionados.
_experience.adcloud.conversionDetails. Consulte “Referência: campos de esquema obrigatórios”.Se um dos campos estiver ausente, confirme se o grupo de campos Extensão completa do Adobe Advertising Cloud ExperienceEvent foi salvo no esquema e atualize o editor de esquema.
s_kwcid e ef_id, como https://www.example.com/landing-page?s_kwcid=AL!12345!3!abc123&ef_id=abc123xyz:G:s. Consulte “Referência: parâmetros de consulta ausentes” para obter as causas prováveis.edge.adobedc.net e inspecione o corpo da solicitação de interação (consulte a carga de exemplo abaixo).Se
trackingCode ou trackingIdentity estiverem vazios ou ausentes, a) o parâmetro de consulta não estava presente na página quando a regra foi acionada (verifique a URL e o tempo de evento da regra) ou b) o grupo de campos está ausente do esquema (revise a primeira linha acima).Referência: campos de esquema obrigatórios required-schema-fields
_experience.adcloud.conversionDetails.trackingCodes_kwcid na URL da página de aterrissagem._experience.adcloud.conversionDetails.trackingIdentityef_id na URL da página de aterrissagem.Referência: parâmetros de consulta ausentes missing-query-parameters
s_kwcidef_idExemplo de carga de click-through
{
"events": [{
"xdm": {
"eventType": "advertising.clicks",
"_experience": {
"adcloud": {
"conversionDetails": {
"trackingCode": "AL!12345!3!abc123",
"trackingIdentity": "abc123xyz:G:s"
}
}
}
}
}]
}
Relatórios de problemas no Customer Journey Analytics Workspace
Relatório de resumo
- Confirme se o Customer Journey Analytics Workspace está fazendo referência à visualização de dados correta.
- Confirme se o feed do Adobe Advertising para o Customer Journey Analytics está ativado. Verifique com a equipe de conta da Adobe.
- Confirme se a dimensão/classificação/conjunto de dados de pesquisa do Adobe Advertising e o conjunto de dados de resumo estão incluídos na conexão do Customer Journey Analytics.
- Confirme se suas dimensões e métricas de resumo do Adobe Advertising estão incluídas na visualização de dados do Customer Journey Analytics.
Se você verificar todas as configurações acima, mas ainda não visualizar os dados de resumo, abra um tíquete de suporte para sua organização.
- Confirme se o feed do Adobe Advertising para o Customer Journey Analytics está ativado para o Anunciante 2. Verifique com a equipe de conta da Adobe.
- Confirme se a configuração “Backfill all existing data” está habilitada para seus três conjuntos de dados (dimensão/classificação/pesquisa, resumo e métricas de evento) na conexão do Customer Journey Analytics.
Se você verificar todas as condições acima, mas ainda não visualizar os dados de resumo, abra um tíquete de suporte para sua organização.
Se o feed estiver habilitado para uma conta, mas você ainda não visualizar os dados de resumo, abra um tíquete de suporte para a sua organização. Inclua o Account ID para a conta de rede de publicidade.
- Confirme se você está usando os mesmos intervalos de datas no Workspace e no relatório do Adobe Advertising.
- Confirme se os filtros e segmentos aplicados em Workspace e no relatório do Adobe Advertising não estão causando diferenças nos dados.
- Confirme se o Time Zone da sua visualização de dados do Customer Journey Analytics corresponde ao Default Timezone da sua conta do Advertising DSP.
- Confirme se a configuração “Backfill all existing data” está habilitada para seus três conjuntos de dados (dimensão/classificação/pesquisa, resumo e métricas de evento) na conexão do Customer Journey Analytics.
Se tiver certeza de uma discrepância de dados, abra um tíquete de suporte para sua organização. Inclua o Account ID para a conta de rede de publicidade. Para mostrar evidências da discrepância, inclua capturas de tela e planilhas. Sua equipe de conta da Adobe pode corrigir retroativamente o feed de dados para resolver a discrepância, se necessário.
Relatórios no nível do evento
Page Views) não estão disponíveis para uma dimensão de relatório (como Campaign) no Customer Journey Analytics Workspace.Verifique o seguinte, começando pelos itens com menos barreiras de verificação:
- Confirme se você está usando a visualização de dados correta.
- Confirme se as métricas de conversão aplicáveis são eventos da Web/online, que o Adobe Advertising pode atribuir às dimensões.
- Confirme se o Adobe Advertising está rastreando click-throughs e view-throughs no site aplicável.
- Na conexão Customer Journey Analytics do conjunto de dados de classificações, confirme se os valores das configurações Key e Matching Key estão corretos: Key:
Tracking Code(_customername.adLens2.trackingCode), Matching Key:Tracking Code(event._experience.adcloud.conversionDetails.trackingCode). - Confirme se o serviço Adobe Advertising foi adicionado à sequência de dados do Adobe Experience Platform, se o esquema mapeado para a sequência de dados é
XDM ExperienceEvent Schemae se o grupo de camposAdobe Advertising Cloud ExperienceEvent Full Extensionfoi adicionado ao esquemaXDM ExperienceEvent. - Confirme se as configurações do Adobe Advertising estão definidas corretamente na extensão WebSDK e publicadas.
Se você verificar todas as configurações acima, mas ainda não visualizar os dados de conversão, abra um tíquete de suporte para sua organização. Inclua o Account ID para a conta de rede de publicidade.
Ferramentas úteis de validação e depuração
Adobe Experience Platform Debugger
Instalar a extensão Adobe Experience Platform Debugger para Chrome para:
- Uma exibição em tempo real de todas as chamadas
alloy()do SDK da Web - Validação do ambiente e da ID da sequência de dados
- Inspeção de carga XDM
- Detalhes de solicitação e resposta do Edge Network
Verificações de chave no depurador:
advertising.enrichment.Guia Network da ferramenta de inspeção de código do navegador
Use a guia Network da ferramenta de inspeção de código do seu navegador (geralmente chamada de “Inspect”) para fazer o seguinte:
Filtrar por edge.adobedc.net para inspecionar solicitações brutas de Edge Network:
- URL de solicitação:
https://[org-id].data.adobedc.net/ee/v2/interact - Método:
POST - Status:
200(íntegro),400(carga inválida) ou500(erro de servidor ou de sequência de dados)
Verifique a carga da solicitação para:
- O
dataStreamIdcorreto - A presença de um objeto
xdmcom os campos esperados - Um
identityMapcom a ECID preenchida
Validação do console
Verifique a versão do WebSDK instalada:
window.alloy.version
Acionar manualmente um evento de teste:
alloy("sendEvent", {
xdm: {
eventType: "web.webpagedetails.pageViews",
web: {
webPageDetails: { name: "Test Page", URL: window.location.href }
}
}
}).then(result => console.log("Edge response:", result))
.catch(err => console.error("Send event error:", err));
Lista de verificação de referência rápida antes de solicitar suporte
Verifique o seguinte antes de abrir um tíquete de suporte:
- A extensão WebSDK está na versão mais recente.
- A biblioteca é publicada e o código incorporado está correto para o ambiente.
- A ID da sequência de dados está definida corretamente para desenvolvimento, preparo e produção.
- Todos os serviços de sequência de dados necessários estão habilitados.
- O componente Advertising está habilitado na configuração da extensão WebSDK e uma ID de anunciante do DSP está configurada.
- O esquema XDM inclui o grupo de campos Advertising.
- A regra Send Event inclui um mapa de identidade e é acionada no evento correto.
- Nenhuma CSP ou configuração de privacidade do navegador está bloqueando solicitações do Edge Network.
- A Adobe Experience Platform Debugger confirma que os eventos estão chegando à Edge Network.
- Nenhum erro do JavaScript no console do navegador está interrompendo a execução.
- O grupo de campos
Adobe Advertising Cloud ExperienceEvent Full Extensioné adicionado ao esquema. _experience.adcloud.conversionDetails.trackingCodeestá presente no esquema._experience.adcloud.conversionDetails.trackingIdentityestá presente no esquema.- A URL da página de aterrissagem contém os parâmetros
s_kwcideef_idno click-through. - O Adobe Experience Platform Debugger confirma que
conversionDetailsestá preenchido na carga de saída.
Quando escalar um problema
Entre em contato com a equipe de conta da Adobe ou com a equipe de engenharia se:
- As solicitações do Edge Network retornam erros persistentes de
500após a validação da sequência de dados. - Advertising conversões são confirmadas no depurador, mas não aparecem nos relatórios após 24-48 horas.
- Uma atualização de versão do WebSDK apresenta uma regressão que não estava presente na versão anterior. Inclua os números de versão específicos no tíquete de suporte.