Configurar o Adobe Analytics com o SDK da Web da plataforma

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

Adobe Analytics O é 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.

Objetivos de aprendizagem

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

• Configure um esquema XDM para o Adobe Analytics e entenda a diferença entre variáveis XDM mapeadas automaticamente e manualmente para o Analytics
• Configurar um fluxo de dados para ativar o Adobe Analytics
• Mapear elementos de dados de matriz individuais ou inteiros para o objeto XDM
• Capturar exibições de página no Adobe Analytics com o objeto XDM
• Capturar dados de comércio eletrônico com o objeto XDM para a cadeia de caracteres do produto Adobe Analytics
• Valide se as variáveis do Adobe Analytics são definidas com o objeto XDM usando o Experience Platform Debugger
• Usar as regras de processamento do Adobe Analytics para definir variáveis personalizadas
• A validação de dados é capturada pelo Adobe Analytics usando Relatórios em tempo real

Pré-requisitos

Você está familiarizado com tags, Adobe Analytics e Site de demonstração Luma funcionalidade de logon e compra.

Você precisa de 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.

Você deve ter concluído todas as etapas das seções anteriores no tutorial:

• Configuração inicial
  • Configurar permissões
  • Configurar um esquema XDM
  • Configurar um namespace de identidade
  • Configurar uma sequência de dados
• Configuração de tags
  • Instalação da extensão do SDK da Web
  • Criar elementos de dados
  • Criar uma regra de tag
  • Validar com o Adobe Experience Platform Debugger

Esquemas XDM e variáveis do Analytics

Parabéns! Você já configurou um esquema compatível com o Adobe Analytics no Configurar um esquema lição!

A implementação do SDK da Web da Platform deve ser o mais independente de produto possível. Para o Adobe Analytics, o mapeamento de eVars, props e eventos não ocorre durante a criação do esquema nem durante a configuração das regras de tag, como tem sido feito tradicionalmente. Em vez disso, cada par de valor-chave XDM se torna uma Variável de dados de contexto que mapeia para uma variável do Analytics de uma das duas formas a seguir:

1. Variáveis mapeadas automaticamente usando campos XDM reservados
2. Variáveis mapeadas manualmente usando regras de processamento do Analytics

Para entender quais variáveis XDM são mapeadas automaticamente para o Adobe Analytics, consulte Variáveis mapeadas automaticamente no Analytics. Qualquer variável que não seja mapeada automaticamente deve ser mapeada manualmente.

O esquema criado na variável Configurar um esquema A lição contém algumas variáveis mapeadas automaticamente para o Analytics, conforme descrito nesta tabela:

Configurar o fluxo de dados

O SDK da Web da Platform envia dados do seu site para a Rede de borda da Platform. Seu fluxo de dados informa à Platform Edge Network para onde encaminhar esses dados, neste caso, qual dos seus conjuntos de relatórios do Adobe Analytics.

1. Ir para Coleta de dados interface

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

3. Selecione o criado anteriormente Luma Web SDK sequência de dados

   

4. Selecione Adicionar serviço
   

5. Selecionar Adobe Analytics como o Serviço

6. Insira o ID do conjunto de relatórios do seu conjunto de relatórios de desenvolvimento

7. Selecione Salvar

   

   DICA

   Adicionar mais conjuntos de relatórios selecionando Adicionar conjunto de relatórios é equivalente à marcação de vários conjuntos.

Criar elementos de dados adicionais

Em seguida, capture dados adicionais da camada de dados do Luma e envie-os para a Rede de borda da plataforma. Embora a lição se concentre em requisitos comuns do Adobe Analytics, todos os dados capturados podem ser facilmente enviados para outros destinos com base na configuração do fluxo de dados. Por exemplo, se você concluiu a lição do Adobe Experience Platform, os dados adicionais capturados nesta lição também serão enviados para a Platform.

Criar elementos de dados de comércio eletrônico

Durante a lição Criar elementos de dados, você elementos de dados JavaScript criados que capturou o conteúdo e os detalhes de identidade. Agora você criará elementos de dados adicionais para capturar dados de comércio eletrônico. Como a variável Site de demonstração Luma O usa diferentes estruturas de camada de dados para páginas de detalhes do produto e produtos no carrinho. Você deve criar elementos de dados para cada cenário. Você terá que criar alguns elementos de dados de código personalizado para coletar o que precisa da camada de dados do Luma, que pode ou não ser necessária ao implementar no seu próprio site. Nesse caso, você precisa percorrer uma variedade de itens do carrinho de compras para coletar detalhes específicos de cada produto. Use os trechos de código fornecidos abaixo:

1. Abra a propriedade de tag que você está usando no tutorial

2. Ir para Elementos de dados

3. Selecione Adicionar elemento de dados

4. Nomeie-a como product.productInfo.sku

5. Use o Custom Code Tipo de elemento de dados

6. Deixe caixas de seleção para Forçar valor de minúsculas e Texto limpo desmarcado

7. Sair None como o Duração do armazenamento já que esse valor é diferente em cada página

8. Selecione Abrir editor

   

9. Copie e cole o código a seguir

   var cart = digitalData.product;
   var cartItem;
   cart.forEach(function(item){
   cartItem = item.productInfo.sku;
   });
   return cartItem;
   

10. Selecionar Salvar para salvar o código personalizado

    

11. Selecionar Salvar para salvar o elemento de dados

Siga as mesmas etapas para criar esses elementos de dados adicionais:

• product.productInfo.title

  var cart = digitalData.product;
  var cartItem;
  cart.forEach(function(item){
  cartItem = item.productInfo.title;
  });
  return cartItem;
  

• cart.productInfo

  var cart = digitalData.cart.cartEntries;
  var cartItem = [];
  cart.forEach(function(item, index, array){
  var qty = parseInt(item.qty);
  var price = parseInt(item.price);
  cartItem.push({
  "SKU": item.sku,
  "name":item.title,
  "quantity":qty,
  "priceTotal":price
  });
  });
  return cartItem;
  

Depois de adicionar esses elementos de dados e criar os anteriores no Criar elementos de dados , você deve ter os seguintes elementos de dados:

Incrementar visualizações de página

Na lição Criar elementos de dados, você criou um xdm.content elemento de dados para capturar dimensões de conteúdo. Como agora você está enviando dados para o Adobe Analytics, também deve mapear um campo XDM extra para indicar que um beacon deve ser processado como uma exibição de página do Analytics.

1. Abra o xdm.content elemento de dados

2. Role para baixo e selecione para abrir até web.webPageDetails

3. Selecione para abrir o pageViews objeto

4. Definir value para 1

5. Selecione Salvar

   

Definir a cadeia de caracteres do produto

Antes de mapear para a string do produto, é importante entender que há dois objetos principais no esquema XDM usados para capturar dados de comércio eletrônico que têm relacionamentos especiais com o Adobe Analytics:

1. A variável commerce conjuntos de objetos eventos do Analytics, como prodView, scView, e purchase
2. A variável productListItems conjuntos de objetos dimensões do Analytics, como productID.

Consulte Coletar dados de comércio e produtos para obter mais detalhes.

Também é importante entender que você pode fornecer atributos individuais a campos XDM individuais ou fornecer um array inteiro para um objeto XDM.

Mapear atributos individuais para um objeto XDM

Você pode mapear para variáveis individuais para capturar dados na página de detalhes do produto do site de demonstração Luma:

1. Criar um Objeto XDM Tipo de elemento de dados nomeado xdm.commerce.prodView

2. Selecione a mesma sandbox da Platform e o esquema XDM usados nas lições anteriores

3. Abra o comércio objeto

4. Abra o productViews object e set value para 1

   

   DICA

   Esta etapa é equivalente à configuração prodView evento no Analytics

5. Role para baixo e selecione productListItems matriz

6. Selecionar Fornecer itens individuais

7. Selecionar Adicionar item

   

   ATENÇÃO

   A variável productListItems é um array tipo de dados para que espere que os dados entrem como uma coleção de elementos. Devido à estrutura da camada de dados do site de demonstração Luma e como é possível visualizar apenas um produto de cada vez no site Luma, você adicionará itens individualmente. Ao implementar o em seu próprio site, dependendo da estrutura da camada de dados, talvez você possa fornecer um storage inteiro.

8. Selecione para abrir Item 1

9. Mapear as seguintes variáveis XDM para elementos de dados

   • productListItems.item1.SKU para %product.productInfo.sku%
   • productListItems.item1.name para %product.productInfo.title%

   

   IMPORTANTE

   Antes de salvar esse objeto XDM, defina as variáveis "globais" e o incrementador de exibição de página também:
   

10. Selecione Salvar

Mapear uma matriz inteira para um objeto XDM

Como observado anteriormente, o site de demonstração da Luma usa uma estrutura de camada de dados diferente para os produtos no carrinho. O elemento de dados do código personalizado cart.productInfo o elemento de dados criado anteriormente faz loop pela variável digitalData.cart.cartEntries objeto de camada de dados e traduz no esquema de objeto XDM necessário. O novo formato deve corresponder exatamente o schema definido pelo productListItems objeto do esquema XDM.

Para ilustrar, consulte a comparação abaixo da camada de dados do site Luma (esquerda) com o elemento de dados traduzido (direita):

Compare o elemento de dados com o productListItems estrutura (dica, deve corresponder).

Agora volte a mapear o objeto XDM para uma matriz inteira. Crie um elemento de dados de objeto XDM para capturar produtos na página do carrinho:

1. Criar um Objeto XDM Tipo de elemento de dados nomeado xdm.commerce.cartView

2. Selecione a mesma sandbox da Platform e o esquema XDM que você está usando para este tutorial

3. Abra o comércio objeto

4. Abra o productListViews object e set value para 1

   DICA

   Esta etapa é equivalente à configuração scView evento no Analytics

5. Role para baixo e selecione productListItems matriz

6. Selecionar Fornecer todo o array

7. Mapear para cart.productInfo elemento de dados

   

   IMPORTANTE

   Antes de salvar esse objeto XDM, defina as variáveis "globais" e o incrementador de exibição de página também:
   

8. Selecione Salvar

Criar outro Objeto XDM Tipo de elemento de dados para check-outs chamados xdm.commerce.checkout. Desta vez, defina o commerce.checkouts.value para 1, mapa productListItems para cart.productInfo como você acabou de fazer, e adicione as variáveis "globais" e o contador de visualização de página.

Existem etapas adicionais para capturar a variável purchase evento:

1. Criar outro Objeto XDM Tipo de elemento de dados para compras chamadas xdm.commerce.purchase

2. Abertura comércio objeto

3. Abra o pedido objeto

4. Mapa purchaseID para o cart.orderId elemento de dados

5. Definir currencyCode ao valor codificado USD

   

   DICA

   É equivalente à configuração s.purcahseID e s.currencyCode variáveis no Analytics

6. Selecione para abrir o purchases object e set value para 1

   DICA

   É equivalente à configuração purchase evento no Analytics

   IMPORTANTE

   Antes de salvar esse objeto XDM, defina as variáveis "globais" e o incrementador de exibição de página também:
   

7. Selecione Salvar

Ao final dessas etapas, você deve ter os cinco elementos de dados de objeto XDM a seguir criados:

Criar regras adicionais para o SDK da Web da plataforma

Com vários elementos de dados de objetos XDM criados, você está pronto para definir os sinais usando regras. Neste exercício, você cria regras individuais por evento de comércio eletrônico e usa condições para que as regras sejam acionadas nas páginas certas. Vamos começar com um evento de Exibição de produto.

1. Na navegação à esquerda, selecione Regras e selecione Adicionar regra

2. Nomeie-a como product view - library load - AA

3. Em Eventos, selecione Biblioteca carregada (início da página)

4. Em Condições, selecione para Adicionar

   

5. Sair Tipo de lógica as Regular

6. Sair Extensões as Núcleo

7. Selecionar Tipo de condição as Caminho sem cadeia de caracteres de consulta

8. À direita, ative a opção Regex alternar

9. Em caminho igual a set /products/. Para o site de demonstração Luma, ele garante que a regra seja acionada somente nas páginas do produto

10. Selecione Manter alterações

    

11. Em Ações selecionar Adicionar

12. Selecionar Adobe Experience Platform Web SDK extensão

13. Selecionar Tipo de ação as Enviar evento

14. A variável Tipo O campo tem uma lista suspensa de valores para escolher. Selecione commerce.productViews

    DICA

    O valor selecionado aqui não afeta como os dados são mapeados para o Analytics. No entanto, é recomendável aplicar essa variável cuidadosamente, pois ela é usada na interface do construtor de segmentos do Adobe Experience Platform. O valor selecionado está disponível para uso no c.a.x.eventtype downstream da variável de dados de contexto.

15. Em Dados XDM, selecione o xdm.commerce.prodView Elemento de dados do objeto XDM

16. Selecione Manter alterações

    

17. Sua regra deve ser semelhante ao mostrado abaixo. Selecione Salvar

    

Repita o mesmo processo para todos os outros eventos de comércio eletrônico usando os seguintes parâmetros:

Nome da regra: exibição do carrinho - carregamento da biblioteca - AA

• Tipo de evento: Biblioteca carregada (início da página)
• Condição: /content/luma/us/en/user/cart.html
• Digite o valor no SDK da Web - Enviar ação: commerce.productListViews
• Dados XDM para SDK da Web - Ação de envio: %xdm.commerce.cartView%

Nome da regra: check-out - carregamento da biblioteca - AA

• Tipo de evento: Biblioteca carregada (início da página)
• Condição /content/luma/us/en/user/checkout.html
• Tipo para SDK da Web - Ação Enviar: commerce.checkouts
• Dados XDM para SDK da Web - Ação de envio: %xdm.commerce.checkout%

Nome da regra: compra - carregamento da biblioteca - AA

• Tipo de evento: Biblioteca carregada (início da página)
• Condição /content/luma/us/en/user/checkout/order/thank-you.html
• Tipo para SDK da Web - Ação Enviar: commerce.purchases
• Dados XDM para SDK da Web - Ação de envio: %xdm.commerce.purchase%

Quando terminar, você deverá ver as seguintes regras criadas.

Criar seu ambiente de desenvolvimento

Adicione os novos elementos de dados e regras à Luma Web SDK Tutorial e recriar seu ambiente de desenvolvimento.

Validar o SDK da Web da Adobe Analytics para plataforma

No Depurador lição, você aprendeu a inspecionar o beacon de objeto XDM do lado do cliente com o Platform Debugger e o console de desenvolvimento do navegador, que é semelhante à depuração de um AppMeasurement.js Implementação do Analytics. Para validar se o Analytics está capturando dados corretamente por meio do SDK da Web da plataforma, você deve seguir duas etapas adicionais para:

1. Valide como os dados são processados pelo objeto XDM na Platform Edge Network, usando o recurso Edge Trace do depurador Experience Platform
2. Valide como os dados são processados pelo Analytics usando Regras de processamento e Relatórios em tempo real.

Usar o Edge Trace

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.

Validação da ID do Experience Cloud

1. Vá para a Site de demonstração Luma e use o Experience Platform Debugger para alterne a propriedade da tag no site para sua própria propriedade de desenvolvimento

   AVISO

   Antes de continuar, verifique se você está conectado ao site Luma. Se você não estiver conectado, o site Luma não permitirá que você faça check-out.

   1. No Luma, selecione o botão de logon na parte superior direita e use credenciais u: test@adobe.com p: test para autenticar

   2. Você será redirecionado automaticamente para a Página do produto Didi Sport Watch no carregamento da próxima página

2. Para ativar o Edge Trace, vá para o Experience Platform Debugger, na navegação à esquerda, selecione Logs, em seguida, selecione a Edge e selecione Conectar

   

3. Ficará vazio por enquanto

   

4. Atualize o Página do produto Didi Sport Watch e verifique o Experience Platform Debugger novamente, você deverá ver os dados aparecerem. A linha que começa com RSIDs de mapeamento automático do Analytics é o sinal do Adobe Analytics

5. Selecione para abrir as opções mappedQueryParams e a segunda lista suspensa para exibir as variáveis do Analytics

   

   DICA

   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.

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

7. Continue rolando para baixo até visualizar o Analytics mid variável. Ambas as IDs correspondem à ID de Experience Cloud do dispositivo.

   

   OBSERVAÇÃO

   Depois de fazer logon, valide a ID autenticada 112ca06ed53d3db37e4cea49cc45b71e para o usuário test@adobe.com também é capturado na variável c.a.x.identitymap.lumacrmid.[0].id

Exibições da página de conteúdo

Use o mesmo sinal para validar se as exibições de página de conteúdo são capturadas pelo Analytics.

1. Procure c.a.x.web.webpagedetails.pageviews.value=1. Ele lhe diz: s.t() o sinal de exibição de página está sendo enviado para o Analytics

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

   

Sequência 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. Contanto que você tenha mapeado para o productListItem Variável XDM enquanto configuração de um esquema XDM para o Adobe Analytics, a Platform Edge Network cuida do mapeamento dos dados para as variáveis de análise adequadas.

1. Primeiro, valide se a variável Product String está definido

2. Procure 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

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

4. Ambos os valores correspondem ao nome do produto disponível na camada de dados

   

O Edge Trace trata commerce eventos ligeiramente diferentes 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 no Analytics event variável. A Platform Edge Network a mapeia adequadamente, desde que você mapeie para o XDM adequado commerce enquanto configuração do esquema para o Adobe Analytics; neste caso, o commerce.productViews.value=1.

1. De volta à janela Experience Platform Debugger, role para baixo até a event , está definida como prodView

   

Valide se os demais eventos de comércio eletrônico e cadeias de caracteres de produtos 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 events: "scView" e a string do produto

   

3. Prossiga para o check-out, verifique o Edge Trace para events: "scCheckout" e a string do produto

   

4. Preencha apenas o Nome e Sobrenome no formulário de entrega e selecione Continuar. Na próxima página, selecione Fazer pedido

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

   • 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
   • Sequência de caracteres do produto pl definição do nome do produto, quantidade e preço

   

Regras de processamento e relatórios em tempo real

Agora que você validou os sinais do Analytics com o Edge Trace, também é possível validar se os dados são processados pelo Analytics usando os relatórios em tempo real. Antes de verificar os relatórios em tempo real, é necessário configurar as Regras de processamento do Analytics props conforme necessário.

Regras de processamento para mapeamentos personalizados do Analytics

Neste exercício, você mapeia uma variável XDM para uma prop para que possa visualizá-la nos relatórios em tempo real. Siga estas mesmas etapas para qualquer mapeamento personalizado que precise ser feito para qualquer eVar, prop, eventou variável acessível por meio das Regras de processamento.

1. Na interface do usuário do Analytics, acesse Admin > Ferramentas administrativas > Conjuntos de relatórios

2. Selecione o conjunto de relatórios de desenvolvimento/teste que você está usando para o tutorial > Editar configurações > Geral > Regras de processamento

   

3. Criar uma regra para Substituir valor de Product Name (prop1) para a.x.productlistitems.0.name. Lembre-se de adicionar a observação sobre o motivo de você estar criando a regra e nomear o título da regra. Selecione Salvar

   

   IMPORTANTE

   Na primeira vez que você mapeia para uma regra de processamento, a interface do usuário não mostra as variáveis de dados de contexto do objeto XDM. Para corrigir isso, selecione qualquer valor, Salve e volte para editar. Todas as variáveis XDM agora devem aparecer.

4. Ir para Editar configurações > Tempo real. Configure todos os três com os seguintes parâmetros mostrados abaixo para que você possa validar exibições de página de conteúdo, exibições de produtos e compras

   

5. Repita as etapas de validação e você verá que os relatórios em tempo real preenchem os dados adequadamente.

   Page Views
   

   Visualizações do produto
   

   Compras
   

6. Na interface do usuário do Workspace, crie uma tabela para visualizar o fluxo de comércio eletrônico completo do produto que você comprou

   

Para saber mais sobre como mapear campos XDM para variáveis do Analytics, consulte o vídeo Mapear variáveis do SDK da Web no Adobe Analytics.

Parabéns! 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: