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.
- Conforme dito na descrição desta página, serão abordadas apenas implementações de DIL do "lado do cliente", usadas por clientes AAM que não têm Adobe Analytics. Se tiver o Adobe Analytics, você deve usar o método de encaminhamento pelo lado do servidor para implementar o AAM. Este método está descrito 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:
- Ao usar o DIL.create, alguns elementos foram descontinuados e você deve usar os elementos ECID. Estes elementos são chamados na DIL.create documentação.
- O método de nível de instância idSync também foi descontinuado, conforme chamado na documentação do método.
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:
- O método de nível de instância idSync
- O elemento declaredId em DIL.create
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
-
Se você estiver usando DIL anterior a 8.0, antes de atualizar, entre na configuração de DIL na extensão AAM e anote todas as opções avançadas que estiver usando (para ser usada em uma etapa subsequente).
-
Atualize sua extensão do AAM para a versão 8.0 ou superior.
-
Verifique se a sua extensão do Experience Cloud ID Service é versão 3.3.0 ou superior.
-
Para quaisquer métodos/elementos obsoletos (como
disableIDSyncs
) que estavam na extensão para AAM anterior à 8.0 ou no código personalizado para DIL, ative os métodos ECID na extensão ECID.- (DIL)
disableDestinationPublishingIframe
-> (ECID)disableIdSyncs
- (DIL)
disableIDSyncs
-> (ECID)disableIdSyncs
- (DIL)
iframeAkamaiHTTPS
-> (ECID)dSyncSSLUseAkamai
- (DIL)
declaredId
-> (ECID)setCustomerIDs
- (DIL)
-
Publish as alterações.
Atualização para o DIL 8.0 no Adobe DTM updating-to-dil-in-adobe-dtm
- Atualize sua ferramenta AAM para a versão 8.0 ou superior. Essa configuração de versão está na seção "Geral" da ferramenta AAM.
- Para todos os métodos/elementos obsoletos (como
disableIDSyncs
) que estavam no código personalizado da ferramenta AAM anterior ao 8.0 para DIL, anote-os (para que seja possível adicioná-los à ferramenta ECID) e remova-os do DIL code personalizado na ferramenta AAM. - Atualize sua extensão do Experience Cloud ID Service para a versão 3.3.0 ou superior
- Adicione as opções avançadas à ferramenta ECID que você removeu do código personalizado da ferramenta AAM.
- Publish as alterações
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.
-
Atualize sua biblioteca de DIL para a versão mais recente (8.0 ou superior). Você precisará obter o código de DIL mais recente do Adobe Consulting ou do Adobe Customer Care, pois ele não está disponível atualmente em um local público. Em seguida, basta substituir o código antigo da biblioteca de DIL pelo novo código da biblioteca de DIL e seguir para a próxima etapa (não pare agora ou você terá problemas, ha).
-
Instale o ECID Service ou atualize sua versão existente para a 3.3.0 ou posterior. Você pode baixar a versão mais recente do Serviço de ID de Experience Cloud de nossa página do GitHub. Se precisar de ajuda, consulte a documentação ou fale com um consultor da Adobe.
-
Verifique se todos os métodos ou elementos obsoletos que estão no código personalizado para DIL foram movidos para os métodos ECID:
-
(DIL)
disableDestinationPublishingIframe
-> (ECID)disableIdSyncs
-
(DIL)
disableIDSyncs
-> (ECID)disableIdSyncs
-
(DIL)
iframeAkamaiHTTPS
-> (ECID)idSyncSSLUseAkamai
-
(DIL)
declaredId
-> (ECID)setCustomerIDs
-