Migração da extensão de tag do Adobe Analytics para a extensão de tag do SDK da Web

Crie um fluxo de dados na Coleção de dados da Adobe Experience Platform. Ao enviar dados para esse fluxo de dados, ele encaminha dados para a Adobe Analytics. No futuro, esse mesmo fluxo de dados encaminha dados para o Customer Journey Analytics.

1. Navegue até experience.adobe.com e faça logon usando suas credenciais.
2. Use a página inicial ou o seletor de produto no canto superior direito para navegar até Coleção de dados.
3. Na navegação à esquerda, selecione Datastreams.
4. Selecione Novo fluxo de dados.
5. Insira o nome desejado e selecione Salvar.
6. Depois que a sequência de dados for criada, selecione Adicionar Serviço.
7. No menu suspenso do serviço, selecione Adobe Analytics.
8. Insira a mesma ID de conjunto de relatórios do site para o qual você envia dados de análise. Clique em Salvar.

Seu fluxo de dados agora está pronto para receber e transmitir dados para a Adobe Analytics.

Esta seção prepara a tag para a maior parte do esforço de migração que ocorrerá na próxima etapa.

1. Clique no ícone de hambúrguer na parte superior esquerda da interface do Adobe Experience Platform e selecione Tags.

2. Selecione a propriedade de tag desejada.

3. Na navegação à esquerda da propriedade da marca, selecione Extensões.

4. Selecione Catálogo próximo à parte superior para ver uma lista de todas as extensões disponíveis.

5. Procure e selecione a extensão Adobe Experience Platform Web SDK e clique em Instalar à direita.

   

6. As definições de configuração de extensão são exibidas. Localize a seção Fluxos de dados e selecione o fluxo de dados criado na etapa anterior.

   

7. Selecione Salvar.

Agora a propriedade da tag tem o SDK da Web instalado.

O elemento de dados do objeto de dados fornece uma estrutura intuitiva para configurar uma carga que o SDK da Web usa para enviar para um fluxo de dados. A maioria das regras que você atualiza na etapa a seguir interage com esse elemento de dados.

1. Na navegação à esquerda da interface de tags, selecione Elementos de Dados.

2. Selecione Adicionar elemento de dados

3. Atribua ao elemento de dados as seguintes configurações:

   • Nome: qualquer item desejado, como "Camada de dados" ou "Objeto de dados"
   • Extensão: Adobe Experience Platform Web SDK
   • Tipo de Elemento de Dados: Variável
   • As caixas de seleção podem permanecer como estão

4. À direita, selecione as seguintes configurações:

   • Botão de opção de propriedade: Dados
   • Solução: Adobe Analytics

5. Selecione Salvar.

Agora, a propriedade da tag tem tudo o que é necessário para atualizar cada regra.

Essa etapa contém a maior parte do esforço necessário para migrar para o SDK da Web e requer conhecimento sobre como a implementação funciona. Um exemplo é fornecido abaixo de como editar uma regra de tag típica. Atualize todas as regras de tag na implementação para substituir todas as referências à extensão do Adobe Analytics pela extensão SDK da Web.

1. Na navegação à esquerda da interface de tags, selecione Regras.

2. Selecione uma regra para editar.

3. Selecione a ação Adobe Analytics - Definir Variáveis

4. Observe todas as variáveis do Analytics definidas nesta regra. Inclua as variáveis definidas nos menus suspensos e as variáveis definidas no código personalizado.

5. Altere a Configuração da ação para as seguintes configurações:

   • Extensão: Adobe Experience Platform Web SDK
   • Tipo de ação: atualizar variável

6. Certifique-se de que o objeto de dados esteja selecionado no menu suspenso à direita.

7. Defina as variáveis do Analytics com os mesmos valores que foram configurados na extensão do Analytics.

   • As variáveis definidas na interface de tags podem ser traduzidas diretamente para os mesmos valores.
   • As variáveis de string definidas no código personalizado exigem ajustes mínimos. Em vez de usar o objeto s, use data.__adobe.analytics. Por exemplo, s.eVar1 seria traduzido para data.__adobe.analytics.eVar1.
   • As variáveis de configuração e chamadas de método do Analytics no código personalizado podem exigir lógica de implementação modificada. Consulte cada variável respectiva para determinar como atingir seu equivalente usando o SDK da Web.

8. Depois que toda a lógica da regra for replicada usando a extensão SDK da Web, selecione Manter alterações.

9. Repita essas etapas para cada configuração de ação que usa a extensão Adobe Analytics para definir valores. Essa etapa inclui as variáveis definidas usando a interface de tags e as definidas usando o código personalizado. Blocos de código personalizados não podem fazer referência ao objeto s em nenhum lugar.

As etapas acima se aplicam apenas às regras que definem valores. As etapas a seguir substituem todas as ações que usam a Configuração de Ação Enviar Beacon.

1. Selecione uma regra que envie um sinal.

2. Selecione a ação Adobe Analytics - Enviar beacon.

3. Anote o valor atual do botão de opção Rastreamento à direita (s.t() ou s.tl()).

4. Altere a Configuração da ação para as seguintes configurações:

   • Extensão: Adobe Experience Platform Web SDK
   • Tipo de ação: Enviar evento

5. À direita, altere as configurações da ação para o seguinte:

   • Tipo: Para s.t(), use Exibições de Página de Detalhes da Página da Web. Para s.tl(), use Cliques de Link de Interação na Web. Se você usar s.tl(), também deverá incluir os seguintes campos no objeto de dados. Estes campos estão listados em Propriedades adicionais ao executar a configuração da ação Atualizar variável:

     • Nome do link
     • Tipo de link
     • URL do link

6. Selecione Manter alterações.

7. Repita essas etapas para cada configuração de ação que usa o Adobe Analytics para enviar um beacon.

A publicação de regras atualizadas segue o mesmo fluxo de trabalho de qualquer outra alteração na configuração de tags.

1. Na navegação à esquerda da interface das tags, selecione Fluxo de Publicação.
2. Selecione Adicionar Biblioteca.
3. Nomeie essa confirmação de tag, como "Atualizar para o SDK da Web".
4. Selecione Adicionar Todos Os Recursos Alterados.
5. Selecione Salvar.
6. O fluxo de trabalho de publicação exibe um ponto laranja, indicando que está sendo criado. Quando o ponto ficar verde, as alterações estarão disponíveis no ambiente de desenvolvimento.
7. Teste as alterações no ambiente de desenvolvimento para garantir que todas as regras sejam acionadas corretamente e que o objeto de dados seja preenchido com os valores esperados.
8. Quando estiver pronto, envie a biblioteca para aprovação, crie para preparo e, em seguida, aprove e publique para produção.

Assim que a implementação de tag estiver totalmente no SDK da Web, você poderá desativar a extensão do Adobe Analytics.

1. Na navegação à esquerda da interface de tags, selecione Extensões.
2. Localize e selecione a extensão Adobe Analytics. À direita, selecione Desativar.
3. Siga o mesmo fluxo de trabalho de publicação acima para publicar a remoção da extensão do Adobe Analytics.
4. Depois que a extensão for desativada na produção, você poderá desinstalá-la totalmente. Selecione a extensão, o menu de três pontos à direita e selecione Desinstalar.
5. Siga o mesmo fluxo de trabalho de publicação acima para publicar essas alterações na produção.