Atualização para o DIL versão 8.0 (ou superior) do Adobe Audience Manager updating-to-adobe-audience-manager-s-dil-version-or-greater

Este artigo fornecerá etapas e recomendações sobre como atualizar o código do Adobe Audience Manager (AAM) Data Integration Library (DIL) para a versão 8.0 ou posterior. Isso se refere à implementação do DIL "no lado do cliente", não ao encaminhamento do lado do servidor de dados do Adobe Analytics, e abordará o DTM, o Launch by Adobe e implementações sem uma solução de gerenciador de tags da Adobe.

Visão geral overview

O código Data Integration Library (DIL) da Audience Manager permite implementar o AAM em seu site*. Ao implementar versões anteriores do DIL, não era necessário ter o Experience Cloud ID Service (ECID) da Adobe implementado também (embora fosse uma ótima ideia). A partir do DIL versão 8.0, há uma dependência forte na ECID versão 3.3 ou posterior. Se você implementar o DIL 8.0 ou posterior sem a ECID 3.3 ou com uma versão anterior, ocorrerá um erro e ela não funcionará. Como há várias maneiras de implementar o AAM, criamos esta página para fornecer algumas etapas a serem seguidas, bem como algumas recomendações. Abaixo, você encontrará essas etapas e recomendações divididas por plataforma/método de implementação. Mais informações sobre o DIL estão disponíveis na documentação.

Métodos e elementos duplicados e obsoletos duplicate-and-deprecated-elements-and-methods

Em versões anteriores do DIL e da ECID, havia métodos duplicados (métodos que fazem a mesma função no DIL e na ECID), o que causou confusão em relação a qual usar. Normalmente, você precisava usar os dois e combiná-los, e essa mensagem não era bem comunicada aos nossos clientes. A partir do DIL 8.0, esses métodos e elementos duplicados foram descontinuados no DIL e é recomendável usar a versão ECID.

Por exemplo:

Sincronização de ID com uma ID do cliente id-syncing-with-a-customer-id

No AAM, você pode sincronizar sua UUID (ID de usuário exclusiva anônima) na máquina com uma ID do cliente, para poder carregar dados offline sobre esse cliente e vinculá-los ao comportamento online dele, para obter uma melhor compreensão dos clientes. No passado, isso foi feito de uma das duas seguintes maneiras:

Se você tem usado um desses métodos mais antigos para sincronizar com uma ID do cliente, é altamente recomendável atualizar para usar o método setCustomerIDs, que faz parte do Serviço ECID. Mais informações sobre setCustomerIDs estão disponíveis na documentação do método.

Dica Rápida: Ao usar um dos métodos acima, você fez referência à AAM Data Source com a ID Data Source (também conhecida como "DPID"). Ao atualizar para setCustomerIDs, será necessário usar "Data Source" do AAM Integration Code. Ele ainda aponta para o mesmo Data Source, mas é apenas um identificador diferente. Isso é mostrado no vídeo abaixo.

As seguintes seções listam as etapas e recomendações para atualizar para o DIL 8.0 com base no seu método de implementação:

Atualização para o DIL 8.0 em tags do Adobe Experience Platform updating-to-dil-in-experience-platform-launch

Etapas básicas para atualização para o DIL 8.0

Atualização para o DIL 8.0 no Adobe DTM updating-to-dil-in-adobe-dtm

Atualização para o DIL 8.0 sem solução da Adobe Tag Management additional-resources

Se você estiver atualizando seu código diretamente na página, poderá apenas substituir itens mais antigos por itens mais novos, exceto quando for necessário mover métodos/elementos do DIL para a ECID, conforme discutido acima. Nesse caso, basta substituir o método/elemento antigo no local do DIL pelo método/elemento da ECID no local da ECID.

O mesmo vale para os gerenciadores de tags que não são da Adobe. Sempre que você tiver as versões antigas nessa solução de gerenciamento de tags, substitua-a pelo novo código, conforme descrito nas etapas a seguir.