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

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 os dados para o 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 no canto superior direito para navegar até Data Collection.

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

4. Selecionar New Datastream.

5. Insira o nome desejado e selecione Save.

6. Depois que o fluxo de dados for criado, selecione Add Service.

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

8. Verifique se Enable XDM Flattened Fields está desmarcada.

   

Seu fluxo de dados agora está pronto para receber e transmitir dados para o 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 tag, selecione Extensions.

4. Selecionar Catalog próximo à parte superior para ver uma lista de todas as extensões disponíveis.

5. Procure por e selecione o Adobe Experience Platform Web SDK e selecione Install no lado direito.

   

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

   

7. Selecionar Save.

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 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. Selecionar 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 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 Audience Manager pela extensão SDK da Web.

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 de 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, na Data element campo.

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

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

9. Repita essas etapas para cada configuração de ação que usa a extensão de tag 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 do SDK da Web.

2. Selecionar 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: Uso Web Webpagedetails Page Views.
   • Data: selecione o objeto de dados criado na etapa 3.

5. Selecionar Keep Changes.

6. Repita essas etapas para cada configuração de ação que use 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. Selecionar Add Library.

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

4. Selecionar Add All Changed Resources.

5. Selecionar 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 SDK da Web, você poderá desativar a extensão Audience Manager.

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