DocumentaçãoExperience PlatformTutorial do SDK da web

Configurar o Adobe Analytics com o SDK da Web da Adobe Experience Platform

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
  • undefined

Saiba como configurar o Adobe Analytics usando o Adobe Experience Platform Web SDK, criar regras de tag para enviar dados ao Adobe Analytics e validar se o Analytics está capturando dados conforme esperado.

O Adobe Analytics é um aplicativo líder do setor que faz você ser capaz de entender seus clientes como pessoas e de orientar seus negócios com informações de inteligência de clientes.

SDK da Web para o diagrama Adobe Analytics

Objetivos de aprendizagem

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

  • Configurar um fluxo de dados para ativar o Adobe Analytics
  • Saber quais campos XDM padrão são mapeados automaticamente para variáveis do Analytics
  • Definir variáveis do Analytics no objeto de dados
  • Enviar dados para outro conjunto de relatórios substituindo o fluxo de dados
  • Validar variáveis do Adobe Analytics usando o Debugger e o Assurance

Pré-requisitos

Para concluir esta lição, primeiro você deve:

  • Estar familiarizado com o Adobe Analytics e ter acesso a ele.

  • Ter pelo menos uma ID de conjunto de relatórios de teste/desenvolvimento. Se você não tiver um conjunto de relatórios de teste/desenvolvimento que pode ser usado para este tutorial, crie um.

  • Conclua as lições anteriores nas seções Configuração inicial e Configuração de tags deste tutorial.

Configurar o fluxo de dados

O SDK da Web da Platform envia dados do seu site para o Platform Edge Network. Seu fluxo de dados informa ao Platform Edge Network para quais conjuntos de relatórios do Adobe Analytics seus dados devem ser enviados.

  1. Ir para a interface Coleção de Dados

  2. Na navegação à esquerda, selecione Datastreams

  3. Selecionar a sequência de dados Luma Web SDK: Development Environment criada anteriormente

    Selecione a sequência de dados do SDK da Web Luma

  4. Selecione Adicionar Serviço
    Adicionar um serviço à sequência de dados

  5. Selecione Adobe Analytics como o Serviço

  6. Digite a ID do Conjunto de relatórios do seu conjunto de relatórios de desenvolvimento

  7. Selecione Salvar

    Análise de salvamento de sequência de dados

    note tip
    TIP
    Adicionar mais conjuntos de relatórios selecionando Adicionar Conjunto de Relatórios é equivalente à marcação de vários conjuntos.
WARNING
Neste tutorial, você só configura o conjunto de relatórios do Adobe Analytics para o seu ambiente de desenvolvimento. Ao criar fluxos de dados para seu próprio site, você deve criar fluxos de dados adicionais e conjuntos de relatórios para seus ambientes de preparo e produção.

Definir variáveis do Analytics

Há várias maneiras de definir variáveis do Analytics em uma implementação do SDK da Web:

  1. Mapeamento automático de campos XDM para variáveis do Analytics (automático).
  2. Definir campos no objeto data (recomendado).
  3. Mapear campos XDM para variáveis do Analytics nas regras de processamento do Analytics (não é mais recomendado).
  4. Mapear para variáveis do Analytics diretamente no esquema XDM (não é mais recomendado).

A partir de maio de 2024, não será mais necessário criar um esquema XDM para implementar o Adobe Analytics com o SDK da Web da plataforma. O objeto data (e o elemento de dados data.variable criado na lição Criar elementos de dados) pode ser usado para definir todas as variáveis personalizadas do Analytics. Definir essas variáveis no objeto de dados será comum aos clientes existentes do Analytics, é mais eficiente do que usar a interface de regras de processamento e impede que dados desnecessários ocupem espaço nos Perfis de clientes em tempo real (importante se você tiver o Real-time Customer Data Platform ou o Journey Optimizer).

Campos mapeados automaticamente

Muitos campos XDM são mapeados automaticamente para variáveis do Analytics. Para obter a lista mais atualizada de mapeamentos, consulte Mapeamento de variáveis do Analytics no Adobe Experience Edge.

Isso ocorre se mesmo que você não tenha definido um esquema personalizado. O SDK da Web do Experience Platform coleta automaticamente alguns dados e os envia para o Edge Network da plataforma como campos XDM. Por exemplo, o SDK da Web lê a URL da página atual e a envia como o campo XDM web.webPageDetails.URL. Esse campo é encaminhado ao Adobe Analytics e preenche automaticamente os relatórios de URL da página no Adobe Analytics.

Se implementar o SDK da Web para Adobe Analytics com um esquema XDM, como você tem neste tutorial, alguns dos campos XDM que você implementou automaticamente são mapeados para variáveis do Analytics, conforme descrito nesta tabela:

Variáveis mapeadas automaticamente do XDM para o Analytics
variável do Adobe Analytics
identitymap.ecid.[0].id
mid
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
Aquisição
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=;nome do produto;;; (principal - consulte a Observação abaixo)
productListItems[].name
s.products=;nome do produto;;;; (fallback - consulte a Observação abaixo)
productListItems[].quantity
s.products=;;quantidade do produto;;;
productListItems[].priceTotal
s.product=;;;preço do produto;;

As seções individuais da cadeia de caracteres do produto Analytics são definidas por meio de diferentes variáveis XDM no objeto productListItems.

NOTE
A partir de 18 de agosto de 2022, o productListItems[].SKU tem prioridade para mapear para o nome do produto na variável s.products.
O valor definido como productListItems[].name é mapeado para o nome do produto apenas se productListItems[].SKU não existir. Caso contrário, ele não será mapeado e estará disponível nos dados de contexto.
Não defina uma cadeia vazia ou nula como productListItems[].SKU. Isso tem o efeito indesejado de mapear para o nome do produto na variável s.products.

Definir variáveis no objeto de dados

Mas e quanto a evars, propriedades e eventos? Definir variáveis no objeto data é a maneira recomendada de definir essas variáveis do Analytics com o SDK da Web. A configuração de variáveis no objeto de dados também pode substituir qualquer variável mapeada automaticamente.

Primeiro, o que é o objeto data? Em qualquer evento SDK da Web, você pode enviar dois objetos com dados personalizados, o objeto xdm e o objeto data. Ambos são enviados para o Edge Network da plataforma, mas somente o objeto xdm é enviado para o conjunto de dados Experience Platform. As propriedades no objeto data podem ser mapeadas no Edge para campos xdm usando o recurso Preparação de Dados para Coleção de Dados, mas não são enviadas para o Experience Platform. Essa é uma maneira ideal de enviar dados para aplicativos como o Analytics, que não são criados nativamente no Experience Platform.

Estes são os dois objetos em uma chamada de SDK da Web genérica:

objetos de dados e xdm

O Adobe Analytics está configurado para procurar quaisquer propriedades no objeto data.__adobe.analytics e usá-las para variáveis do Analytics.

Agora vamos ver como isso funciona. Vamos definir eVar1 e prop1 com nosso nome de página e ver como o valor mapeado para XDM pode ser substituído

  1. Abrir a regra de marca all pages - library loaded - set global variables - 1
  2. Adicionar uma nova Ação
  3. Selecione a extensão Adobe Experience Platform Web SDK
  4. Selecione o Tipo de ação como Atualizar variável
  5. Selecione data.variable como o Elemento de dados
  6. Selecione o objeto analytics
  7. Definir eVar1 como o elemento de dados page.pageInfo.pageName
  8. Defina prop1 para copiar o valor de eVar1
  9. Para testar a substituição de valores mapeados como XDM, na seção Propriedade adicional, defina o nome da página como um valor estático test
  10. Salvar a regra

Agora, precisamos incluir o objeto de dados em nossa regra de evento enviar.

  1. Abrir a regra de marca all pages - library loaded - send event - 50
  2. Abrir a ação Enviar Evento
  3. Selecione data.variable como Dados
  4. Selecione Manter alterações
  5. Selecione Salvar

Enviar dados para um conjunto de relatórios diferente

Talvez você queira alterar para quais dados do conjunto de relatórios do Adobe Analytics são enviados quando os visitantes estão em determinadas páginas. Isso requer uma configuração na sequência de dados e uma regra.

Configurar a sequência de dados para uma substituição do conjunto de relatórios

Para definir a configuração de substituição do conjunto de relatórios do Adobe Analytics na sequência de dados:

  1. Abra a sequência de dados

  2. Edite a configuração do Adobe Analytics abrindo o menu mais e selecionando Editar

    Substituir a sequência de dados

  3. Selecione Opções Avançadas para abrir Substituições do Conjunto de Relatórios

  4. Selecione os conjuntos de relatórios que você deseja substituir. Neste caso, Web SDK Course Dev e Web SDK Course Stg

  5. Selecione Salvar

    Substituir a sequência de dados

Configurar uma regra para substituição do conjunto de relatórios

Vamos criar uma regra para enviar uma chamada de exibição de página adicional para um conjunto de relatórios diferente. Use o recurso de substituição de sequência de dados para alterar o conjunto de relatórios de uma página usando a Ação Enviar Evento.

  1. Crie uma nova regra, nomeie-a como homepage - library loaded - AA report suite override - 51

  2. Selecione o sinal de mais em Evento para adicionar um novo gatilho

  3. Em Extension, selecione Core

  4. Em Tipo de evento, selecione Biblioteca carregada (Início da Página)

  5. Selecione para abrir as Opções Avançadas, digite 51. Isso garante que a regra seja executada após all pages - library loaded - send event - 50, que define o XDM da linha de base com o tipo de ação Atualizar variável.

  6. Selecione Manter alterações

    Substituição do Conjunto de relatórios do Analytics

  7. Em Condições, selecione Adicionar

  8. Deixar Tipo Lógico como Regular

  9. Deixar Extensões como Núcleo

  10. Selecione o Tipo de Condição como Caminho sem a Cadeia de Caracteres de Consulta

  11. À direita, deixe a opção Regex desativada

  12. Em caminho igual a, defina /content/luma/us/en.html. Para o site de demonstração Luma, ele garante que a regra seja acionada somente na página inicial

  13. Selecione Manter alterações

    Condição de substituição do conjunto de relatórios do Analytics

  14. Em Ações, selecione Adicionar

  15. Como a Extensão, selecione o Adobe Experience Platform Web SDK

  16. Como o Tipo de ação, selecione Enviar evento

  17. Como os dados XDM, selecione o xdm.variable.content elemento de dados criado na lição Criar elementos de dados

  18. Como os Dados, selecione o data.variable elemento de dados criado na lição Criar elementos de dados

    Substituição da sequência de dados do Analytics

  19. Role para baixo até a seção Substituições das configurações da sequência de dados

  20. Deixe a guia Desenvolvimento selecionada.

    note tip
    TIP
    Essa guia determina em qual ambiente de tags ocorre a substituição. Para este exercício, você só especifica o ambiente de desenvolvimento, mas quando implantá-lo na produção, lembre-se de também fazê-lo no ambiente de Produção.

  21. Selecione a Sandbox que você está usando para o tutorial

  22. Selecione a Sequência de dados, neste caso Luma Web SDK: Development Environment

  23. Em Conjuntos de relatórios, selecione o site de relatórios para o qual você deseja usar a substituição. Neste caso, tmd-websdk-course-stg.

  24. Selecione Manter alterações

  25. E Salvar sua regra

    Substituição da sequência de dados do Analytics

Criar seu ambiente de desenvolvimento

Adicione as regras atualizadas à biblioteca de tags do Luma Web SDK Tutorial e recrie o ambiente de desenvolvimento.

Parabéns! A próxima etapa é validar a implementação do Adobe Analytics por meio do SDK da Web do Experience Platform.

Validar o Adobe Analytics com o Debugger

Saiba como validar se o Adobe Analytics está capturando a ECID, as exibições de página, a sequência de caracteres do produto e os eventos de comércio eletrônico com o recurso Edge Trace do Experience Platform Debugger.

Na lição Depurador, você aprendeu a inspecionar a solicitação XDM do lado do cliente com o Platform Debugger e o console de desenvolvimento do navegador, que é semelhante à depuração de uma implementação do Analytics AppMeasurement.js. Você também aprendeu a validar solicitações do lado do servidor do Platform Edge Network enviadas para aplicativos Adobe e a visualizar uma carga útil totalmente processada usando o Assurance.

Para validar se o Analytics está capturando dados corretamente por meio do SDK da Web do Experience Platform, você deve seguir duas etapas adicionais para:

  1. Validar como os dados são processados pelo objeto XDM no Edge Network da plataforma usando o recurso Edge Trace do Experience Platform Debugger
  2. Validar como os dados são totalmente processados pelo Analytics usando o Adobe Experience Platform Assurance

Validação da ID do Experience Cloud

  1. Vá para o site de demonstração Luma

  2. Selecione o botão de logon na parte superior direita e use credenciais u: test@adobe.com p: test to authenticate

  3. Abra o Depurador Experience Platform e alterne a propriedade da marca no site para sua própria propriedade de desenvolvimento

  4. Para habilitar o Edge Trace, vá para o Experience Platform Debugger, na navegação à esquerda, selecione Logs, selecione a guia Edge e selecione Conectar

    Conectar ao Edge Trace

  5. Ficará vazio por enquanto

    Edge Trace Conectado

  6. Atualize a página do Luma e verifique o Experience Platform Debugger novamente. Você deve ver os dados aparecerem. A linha que começa com Mapeamento Automático do Analytics é o sinal do Adobe Analytics

  7. Selecione para abrir a lista suspensa mappedQueryParams e a segunda lista suspensa para exibir as variáveis do Analytics

    Rastreamento de Edge de sinal do Analytics

    note tip
    TIP
    A segunda lista suspensa corresponde à ID do conjunto de relatórios do Analytics para a qual você está enviando dados. Ele deve corresponder ao seu próprio conjunto de relatórios, não ao da captura de tela.

  8. Role para baixo para encontrar c.a.x.identitymap.ecid.[0].id. É uma variável de dados de contexto que captura a ECID

  9. Continue rolando para baixo até ver a variável mid do Analytics. Ambas as IDs correspondem à ID de Experience Cloud do dispositivo.

  10. No site Luma,

    ECID do Analytics

    note note
    NOTE
    Como você está conectado, valide também a ID autenticada 112ca06ed53d3db37e4cea49cc45b71e para o usuário test@adobe.com capturada no c.a.x.identitymap.lumacrmid.[0].id

Validação de substituição do conjunto de relatórios

Acima, você configurou uma substituição de sequência de dados para a página inicial do Luma. Para validar essa configuração

  1. Procure uma linha com configuração de sequência de dados após a aplicação da substituição. Aqui você encontra o conjunto de relatórios principal e os conjuntos de relatórios adicionais que foram configurados para substituições do conjunto de relatórios.

    Validação da lista de substituições do conjunto de relatórios do Analytics

  2. Role para baixo até a linha que começa com Mapeamento automático do Analytics e verifique se reportSuiteIds mostra o conjunto de relatórios especificado nas configurações de substituição

    Validação de chamada de substituição do conjunto de relatórios do Analytics

Validação de exibições de página de conteúdo

Vá para uma página de produto como a página de produto do Didi Sport Watch. Validar se as exibições de página de conteúdo são capturadas pelo Analytics.

  1. Procure por c.a.x.web.webpagedetails.pageviews.value=1.

  2. Role para baixo para ver a variável gn. É a sintaxe dinâmica do Analytics para a variável s.pageName. Ele captura o nome da página da camada de dados.

    Cadeia de caracteres de produto do Analytics

Validação de cadeia de caracteres do produto e eventos de comércio eletrônico

Como você já está em uma página de produto, este exercício continua a usar o mesmo Edge Trace para validar se os dados do produto foram capturados pelo Analytics. A sequência de caracteres do produto e os eventos de comércio eletrônico são variáveis XDM mapeadas automaticamente para o Analytics. Desde que você tenha mapeado para a variável XDM productListItem adequada ao configurar um esquema XDM para o Adobe Analytics, o Edge Network da plataforma cuidará do mapeamento dos dados para as variáveis de análise adequadas.

Primeiro, valide se Product String está definido

  1. Procure por c.a.x.productlistitems.[0].sku. A variável captura o valor do elemento de dados que você mapeou para o productListItems.item1.sku anteriormente nesta lição

  2. Procure também por c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1. A variável captura o valor do elemento de dados que você mapeou para productListItems.item1._experience.analytics.customdimensions.evars.evar1

  3. Role para baixo para ver a variável pl. É a sintaxe dinâmica da variável da cadeia de caracteres do produto Analytics

  4. Observe que o nome do produto da camada de dados é mapeado para os parâmetros c.a.x.productlistitems.[0].sku e product da cadeia de caracteres de produtos. Além disso, o título do produto da camada de dados é mapeado para a evar1 de merchandising na string de produtos.

    Cadeia de caracteres de produto do Analytics

    O Edge Trace trata commerce eventos de forma um pouco diferente de productList dimensões. Você não vê uma Variável de dados de contexto mapeada da mesma forma que vê o nome do produto mapeado para c.a.x.productlistitem.[0].name acima. Em vez disso, o Edge Trace mostra o mapeamento automático do evento final na variável event do Analytics. O Platform Edge Network mapeia de acordo, desde que você mapeie para a variável XDM commerce apropriada ao configurar o esquema para o Adobe Analytics; neste caso, o commerce.productViews.value=1.

  5. De volta à janela do Experience Platform Debugger, role para baixo até a variável events, ela está definida como prodView

  6. Além disso, a observação c.a.x.eventType está definida como commerce.productViews, pois você está em uma página de produto.

    note tip
    TIP
    A regra ecommerce - pdp library loaded - AA (order 20) está substituindo o valor de eventType definido pela regra all pages global content variables - library loaded - AA (order 1), pois está definida para disparar posteriormente na sequência

    Exibição de produto do Analytics

Validar se o restante dos eventos de comércio eletrônico e das cadeias de caracteres do produto estão definidos para o Analytics

  1. Adicionar Didi Sport Watch ao carrinho

  2. Vá para a Página de carrinho, verifique o Edge Trace para

    • eventType definido como commerce.productListViews
    • events: "scView" e
    • a cadeia de caracteres do produto está definida

    Exibição de carrinho do Analytics

  3. Prossiga para o check-out, verifique o Edge Trace para

    • eventType definido como commerce.checkouts
    • events: "scCheckout" e
    • a cadeia de caracteres do produto está definida

    Check-out do Analytics

  4. Preencha apenas os campos Nome e Sobrenome do formulário de remessa e selecione Continuar. Na próxima página, selecione Fazer pedido

  5. Na página de confirmação, verifique o Edge Trace para

    • eventType definido como commerce.purchases
    • Evento de compra sendo definido events: "purchase"
    • Variável de código de moeda sendo definida cc: "USD"
    • ID de compra sendo definida em pi
    • Cadeia de caracteres do produto pl definindo nome do produto, quantidade e preço

    Compra do Analytics

Validar o Adobe Analytics usando o Assurance

O Adobe Experience Platform Assurance ajuda a inspecionar, testar, simular e validar a maneira como você coleta dados ou fornece experiências com seu site e aplicativo móvel.

No exercício anterior, você validou que o Adobe Analytics está capturando a ECID, as exibições de página, a string do produto e os eventos de comércio eletrônico com o recurso Edge Trace do Experience Platform Debugger. Em seguida, você valida esses mesmos eventos usando o Adobe Experience Platform Assurance, uma interface alternativa para acessar os mesmos dados no Edge Trace.

Como você aprendeu na lição Garantia, há várias maneiras de iniciar uma sessão de Garantia. Como você já tem o Adobe Experience Platform Debugger aberto com uma sessão do Edge Trace iniciada a partir do último exercício, recomendamos acessar o Assurance por meio do Debugger:
Garantia por meio da coleta de dados da Adobe Experience Platform

No "Tutorial do SDK da Web 3" Sessão de Garantia, digite "hitdebugger" na Barra de Pesquisa de Eventos para filtrar os resultados para os dados processados do Adobe Analytics Post.
Dados processados pelo Adobe Analytics Post do Assurance

Validação da ID do Experience Cloud

Para validar se o Adobe Analytics está capturando a ECID, selecione um beacon e abra a Carga. O Fornecedor deste beacon deve ser com.adobe.analytics.hitdebugger
Validação do Adobe Analytics com Assurance

Em seguida, role para baixo até mcvisId para validar se a ECID foi capturada corretamente
Validação da ID do Experience Cloud com o Assurance

Validação de exibições de página de conteúdo

Usando o mesmo sinal, valide se as exibições de página de conteúdo estão mapeadas para a variável correta do Adobe Analytics.
Role para baixo até pageName para validar se Page Name foi capturado corretamente
Validação do nome da página com Garantia

Validação de cadeia de caracteres do produto e eventos de comércio eletrônico

Após os mesmos casos de uso de validação usados ao validar com o Depurador Experience Platform acima, continue usando o mesmo sinal para validar o Ecommerce Events e o Product String.

  1. Procurar carga na qual os eventos contenham prodView
    Validação da cadeia de caracteres do produto com o Assurance
  2. Role para baixo até cadeia de caracteres do produto para validar o Product String.
    • Anote o Product SKU e Merchandizing eVar1.
  3. Role para baixo e verifique se prop1, que você configurou usando as regras de processamento da seção anterior, contém o Product SKU
    Cadeia de Caracteres de Produto com Validação de Variáveis de Merchandising com Garantia

Continue a validar sua implementação revisando o carrinho, o checkout e os eventos de compra.

  1. Procure a carga em que os eventos contêm scView e valide a cadeia de caracteres do produto.
    Validação da cadeia de caracteres do produto com o Assurance
  2. Procure a carga em que os eventos contêm scCheckout e valide a cadeia de caracteres do produto.
    Validação da cadeia de caracteres do produto com o Assurance
  3. Procurar carga na qual os eventos contenham purchase
    Validação da cadeia de caracteres do produto com o Assurance
  4. Ao validar o evento purchase, observe que Product String deve conter Product SKU, Product Quantity e Product Total Price.
  5. Além disso, para purchase, valide se purchase-id e/ou purchaseId estão definidos

Parabéns! Você conseguiu! Este é o fim da lição e agora você está pronto para implementar o Adobe Analytics com o SDK da Web da plataforma em seu próprio site.

Próximo:

NOTE
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Web SDK. Se você tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta postagem de Discussão da Comunidade Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4