Atualize sua biblioteca de coleta de dados para o Audience Manager da extensão de tag da Audience Manager para a extensão de tag da Web SDK

Siga as instruções abaixo para criar 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 Audience Manager. No futuro, esse mesmo fluxo de dados encaminha dados para o Real-Time CDP.

1. Navegue até experience.adobe.com e faça logon usando suas credenciais.

2. Use a página inicial ou o seletor de produto na parte superior direita para navegar até Data Collection.

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

4. Selecione New Datastream.

5. Insira o nome desejado e selecione Save.

6. Após criar a sequência de dados, selecione Add Service.

7. No menu suspenso de serviço, selecione Adobe Audience Manager.

8. Verifique se a opção Enable XDM Flattened Fields está desmarcada.

   

Seu fluxo de dados agora está pronto para receber e transmitir dados para a Audience Manager.

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

1. Selecione o í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 Extensions.

4. Selecione Catalog 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, em seguida, selecione Install no lado direito.

   

6. As definições de configuração de extensão são exibidas. Localize a seção Datastreams, selecione a sandbox que você está usando e a sequência de dados criada na etapa anterior.

   

7. Selecione Save.

A propriedade da tag agora tem o Web SDK instalado.

O elemento de dados do objeto de dados fornece uma estrutura intuitiva para configurar uma carga que o Web SDK 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 Data Elements.

2. Selecionar Add Data Element

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

   • Name: Qualquer coisa que você desejar, como "Camada de dados" ou "Objeto de dados"
   • Extension: Adobe Experience Platform Web SDK
   • Data Element Type: Variable
   • As caixas de seleção podem permanecer como estão.

4. No lado direito, selecione as seguintes configurações:

   • Botão de opção de propriedade: Data
   • Solution: Adobe Audience Manager

5. Selecione Save.

   

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 Web SDK e requer conhecimento de 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 Audience Manager pela extensão do Web SDK.

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

2. Selecione uma regra para editar.

3. Selecionar a ação Audience Manager - Set Variables

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

5. Altere o Action Configuration para as seguintes configurações:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Atualizar variável

6. Verifique se o objeto de dados criado na etapa 3 está selecionado no menu suspenso à direita, no campo Data element.

7. Defina os pares de valor-chave do Audience Manager com os mesmos valores que foram configurados na extensão do Audience Manager.

8. Depois que toda a lógica da regra for replicada usando a extensão Web SDK, selecione Keep Changes.

9. Repita essas etapas para cada configuração de ação que usa a extensão de tag do Audience Manager para definir valores.

As etapas acima se aplicam apenas às regras que definem valores. As etapas a seguir substituem todas as ações que usam o Action Configuration Send Event.

1. Selecione uma regra que envia um evento Web SDK.

2. Selecione o tipo de ação Send Event.

3. Altere o Action Configuration para as seguintes configurações:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Send event

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

   • Type: Use Web Webpagedetails Page Views.
   • Data: Selecione o objeto de dados criado na etapa 3.

5. Selecione Keep Changes.

6. Repita essas etapas para cada configuração de ação que usa o Audience Manager para enviar um evento.

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 de tags, selecione Publishing Flow.

2. Selecione Add Library.

3. Nomeie essa tag de confirmação, como "Atualizar para o Web SDK".

4. Selecione Add All Changed Resources.

5. Selecione Save.

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.

   

Depois que a implementação de tag for totalmente migrada para o Web SDK, você poderá desativar a extensão do Audience Manager.

1. Na navegação à esquerda da interface de tags, selecione Extensions.
2. Localize e selecione a extensão Audience Manager. À direita, selecione Disable.
3. Siga o mesmo fluxo de trabalho de publicação acima para publicar a remoção da extensão Audience Manager.
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 Uninstall.
5. Siga o mesmo fluxo de trabalho de publicação acima para publicar essas alterações na produção.