Atualização para o DIL do Adobe Audience Manager versão 8.0 (ou superior) 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 de DIL do "lado do cliente", não ao encaminhamento do lado do servidor de dados da Adobe Analytics, e cobrirá o DTM, o Launch by Adobe e as implementações sem a solução de gerenciador de tags Adobe.

Visão geral overview

O código Data Integration Library (DIL) do Audience Manager permite implementar o AAM em seu site*. Ao implementar as versões anteriores do DIL, não era necessário ter o Experience Cloud ID Service (ECID) do 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 a UUID (ID de usuário exclusiva anônima) no computador 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 ao AAM Data Source com a ID Data Source (também conhecido como "DPID"). Ao atualizar para setCustomerIDs, será necessário usar "Integration Code" do AAM Data Source. Ele ainda aponta para o mesmo Data Source, mas é apenas um identificador diferente. Isso é mostrado no vídeo abaixo.

As seções a seguir listam as etapas e recomendações para atualização para o DIL 8.0 de acordo com seu método de implementação:

Atualização para o DIL 8.0 nas tags 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 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 de DIL para 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 não-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.