Validar implementações do SDK da Web com o Experience Platform Debugger

Saiba como validar a implementação do SDK da web da Adobe Experience Platform com o Adobe Experience Platform Debugger.

O Experience Platform Debugger é uma extensão disponível para os navegadores Chrome e Firefox, que ajuda a visualizar a tecnologia de Adobe implementada nas páginas da Web. Baixe a versão do seu navegador de preferência:

Se você nunca usou o depurador antes, assista a este vídeo de visão geral de cinco minutos:

Nesta lição, você usa o extensão do Adobe Experience Platform Debugger para substituir a propriedade de tag codificada na Site de demonstração Luma com sua própria propriedade.

Essa técnica é chamada de alternação de ambiente e será útil posteriormente, ao trabalhar com tags em seu próprio site. Ele permite carregar o site de produção em seu navegador, mas com seus desenvolvimento biblioteca de tags. Essa capacidade permite fazer e validar de forma segura as alterações nas tags independentemente das suas versões de código normais. Afinal, essa separação das versões de tag de marketing das versões regulares de código é um dos principais motivos pelos quais os clientes usam tags!

Objetivos de aprendizagem

No final desta lição, você poderá usar o depurador para:

  • Carregar uma biblioteca de tags alternativa
  • Validar se o evento XDM do lado do cliente está capturando e enviando dados conforme esperado para o Edge Network da plataforma
  • Habilitar o Edge Trace para exibir solicitações do lado do servidor enviadas pelo Platform Edge Network

Pré-requisitos

Você está familiarizado com as tags de Coleção de dados e a Site de demonstração Luma e concluíram as lições anteriores no tutorial:

Carregar bibliotecas de tags alternativas com o Debugger

O depurador de Experience Platform tem um recurso interessante que permite substituir uma biblioteca de tags existente por outra. Essa técnica é útil para validação e permite ignorar muitas etapas de implementação neste tutorial.

  1. Verifique se você tem o Site de demonstração da Luma abra e selecione o ícone da extensão do Experience Platform Debugger

  2. O Debugger abrirá e mostrará alguns detalhes da implementação codificada (talvez seja necessário recarregar o site Luma depois de abrir o Debugger)

  3. Confirme se o Debugger é "Conectado ao Luma" como mostrado abaixo e selecione o "bloquear" para bloquear o Debugger no site Luma.

  4. Selecione o Conectar e faça logon no Adobe Experience Cloud usando sua ID de Adobe.

  5. Agora, vá para Tags do Experience Platform na navegação à esquerda

    Tela de tag do depurador

  6. Selecione o Configuração guia

  7. À direita de onde ele mostra a Códigos incorporados de página, abra o Ações e selecione Substituir

    Selecione Ações > Substituir

  8. Como você está autenticado, o Debugger extrairá suas propriedades e ambientes de tag disponíveis. Selecione sua propriedade

  9. Selecione o Development ambiente

  10. Selecione o Aplicar botão

    Selecionar a propriedade de tag alternativa

  11. O site Luma será recarregado agora com sua própria propriedade de tag.

    propriedade de tag substituída

À medida que você prossegue no tutorial, usa essa técnica de mapear o site Luma para sua própria propriedade de tag para validar a implementação do SDK da Web da Platform. Ao usar tags em seu próprio site, você pode usar essa mesma técnica para validar bibliotecas de tags de desenvolvimento em seu site de produção.

Validar solicitações de rede do lado do cliente com o Experience Platform Debugger

Você pode usar o Debugger para validar beacons do lado do cliente acionados a partir da implementação do SDK da Web da Platform para exibir os dados enviados para a Rede de borda da Platform:

  1. Ir para Resumo na navegação à esquerda, para ver os detalhes da propriedade da tag

    Guia Resumo

  2. Agora, vá para Experience Platform Web SDK na navegação à esquerda para ver o Solicitações de rede

  3. Abra o events linha

    Solicitação do SDK da Web do Adobe Experience Platform

  4. Observe como você pode ver a web.webpagedetails.pageView tipo de evento que você especificou em seu Atualizar variável e outras variáveis prontas para uso que seguem a AEP Web SDK ExperienceEvent grupo de campos

    Detalhes do evento

  5. Role para baixo até web objeto, selecione para abri-lo e inspecionar o webPageDetails.name, webPageDetails.server, e webPageDetails.siteSection. Eles devem corresponder aos digitalData variáveis de camada de dados na página inicial

TIP
Para visualizar e comparar as digitalData camada de dados na página inicial:
  1. Na página inicial do Luma, abra as ferramentas de desenvolvedor do navegador. No caso do Chrome, selecione o botão F12 no teclado
  2. Selecione o Console guia
  3. Enter digitalData e selecione Enter no teclado para exibir os valores da camada de dados

Guia Rede

Também é possível validar os detalhes do Mapa de identidade:

  1. Faça logon no site Luma usando as credenciais test@adobe.com/test

  2. Retorne à página inicial do Luma

  3. Abra o Experience Platform Web SDK na navegação à esquerda

    SDK da Web no Debugger

  4. Selecione o events linha para abrir detalhes em um pop-up

    SDK da Web no Debugger

  5. Procure por identityMap na janela pop-up. Aqui você deve ver lumaCrmId com três chaves de authenticatedState, id e primary:
    SDK da Web no Debugger

Validar solicitações do lado do cliente com ferramentas de desenvolvimento do navegador

Esses tipos de detalhes da solicitação também estão visíveis nas ferramentas do desenvolvedor da Web do navegador Rede (supondo que o site esteja carregando a biblioteca de tags).

  1. Abra as ferramentas do desenvolvedor da Web do navegador. Rede e recarregue a página. Filtrar chamadas com /ee para localizar a chamada, selecione-a e procure no Cabeçalhos e Carga guia

    Guia Rede

  2. Vá para a Resposta e observe como o valor ECID é incluído na resposta.

    Guia Rede

    note note
    NOTE
    O valor da ECID está visível na resposta da rede. Ela não está incluída no identityMap parte da solicitação de rede, nem é armazenada nesse formato em um cookie.

Validar solicitações de rede do lado do servidor com o Experience Platform Debugger

Como você aprendeu na Configurar um fluxo de dados lição, o SDK da Web da Platform envia primeiro os dados da propriedade digital para o Platform Edge Network. Em seguida, o Platform Edge Network faz solicitações adicionais do lado do servidor para os serviços correspondentes ativados no fluxo de dados. Você pode validar as solicitações do lado do servidor feitas pelo Platform Edge Network usando o Rastreamento de borda no Debugger.

Ativar o Edge Trace

Para ativar o Edge Trace:

  1. Na navegação à esquerda de Experience Platform Debugger selecionar Logs

  2. Selecione o Edge e selecione Conectar

    Connect Edge Trace

  3. Está vazio por enquanto

    Rastreamento de Borda Conectado

  4. Atualize o Página inicial da Luma e verificar Experience Platform Debugger novamente, para ver os dados aparecerem.

    Rastreamento de borda de beacon do Analytics

Nesse ponto, não é possível visualizar solicitações de Edge Network da Platform indo para aplicativos Adobe porque você não ativou nenhuma no fluxo de dados. Em lições futuras, você usa o Edge Trace para visualizar as solicitações do lado do servidor de saída para aplicativos Adobe e encaminhamento de eventos. Mas, primeiro, conheça outra ferramenta para validar as solicitações do lado do servidor feitas pelo Platform Edge Network — Adobe Experience Platform Assurance!

Próximo:

NOTE
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Web SDK. Se você tiver dúvidas, quiser compartilhar feedback geral ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta Publicação de discussão da comunidade do Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4