Atualização para o DIL do Adobe Audience Manager versão 8.0 (ou superior)

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 "no lado do cliente", não ao encaminhamento de dados do Adobe Analytics pelo lado do servidor, e abordará o DTM, o Launch by Adobe e as implementações sem solução de gerenciador de tags do Adobe.

Visão geral

O código Data Integration Library (DIL) do Audience Manager permite implementar AAM em seu site*. Ao implementar versões anteriores do DIL, não era necessário ter o Serviço de ID de Experience Cloud (ECID) do Adobe também implementado (embora fosse uma ótima ideia). A partir do DIL versão 8.0, há uma grande dependência no ECID versão 3.3 ou posterior. Se implementar o DIL 8.0 ou posterior sem a ECID 3.3 ou com uma versão anterior, você receberá um erro e ele 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 detalhadas por plataforma/método de implementação. Mais informações sobre o DIL estão disponíveis na documentação.

• Conforme declarado na descrição desta página, isso só abordará implementações de DIL "do lado do cliente", usadas por clientes do AAM que não têm o Adobe Analytics. Se tiver o Adobe Analytics, você deve usar o método de encaminhamento do lado do servidor para implementar o AAM. Esse método é descrito na documentação.

Elementos e métodos duplicados e obsoletos

Em versões anteriores do DIL e da ECID, havia métodos duplicativos (métodos que fazem a mesma função no DIL e na ECID), o que causou confusão em relação ao que usar. Normalmente, você precisa usar ambos e combiná-los, e essa mensagem não foi bem comunicada para 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 DIL.create, alguns elementos foram descontinuados e você deve usar os elementos ECID em vez disso. Esses elementos são chamados na DIL.create documentação.
• O método de nível de instância idSync também foi preterido, como chamado em documentation do método.

Sincronização de ID com uma ID do cliente

No AAM, você pode sincronizar o UUID (ID de usuário exclusiva anônima) no computador com uma ID do cliente, para fazer upload de dados offline sobre esse cliente e vinculá-los ao comportamento online, a fim de obter uma melhor compreensão dos clientes. No passado, isso foi feito de duas formas:

• 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 o uso do 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 anteriormente um dos métodos acima, você fez referência ao AAM Data Source com a Data Source ID (conhecida como "DPID"). Ao atualizar para setCustomerIDs, será necessário usar o "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 com base no método de implementação:

Atualização para o DIL 8.0 no Adobe Experience Platform Launch

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

1. Se você estiver usando o DIL pré-8.0, antes de atualizar, acesse a configuração do DIL na extensão AAM e anote todas as opções avançadas que estiver usando (para ser usadas em uma etapa subsequente)

2. Atualize sua extensão do AAM para a versão 8.0 ou superior

3. Verifique se a sua extensão do Experience Cloud ID Service é versão 3.3.0 ou superior

4. Para quaisquer métodos/elementos obsoletos (como "disableIDSyncs") que estavam na Extensão de AAM anterior a 8.0 ou no código personalizado para o DIL, ative os métodos ECID na extensão ECID.

   1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
   2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs
   3. (DIL) iframeAkamaiHTTPS -> (ECID) dSyncSSLUseAkamai
   4. (DIL) declaradaId -> (ECID) setCustomerIDs

5. Publicar as alterações

Atualização para o DIL 8.0 no Adobe DTM

1. Atualize sua ferramenta de AAM para a versão 8.0 ou superior. Essa configuração de versão está na seção "Geral" da ferramenta AAM.
2. Para quaisquer métodos/elementos obsoletos (como "disableIDSyncs") que estavam no código personalizado da ferramenta de AAM anterior a 8.0 para o DIL, anote-os (para que você possa adicioná-los à ferramenta ECID) e removê-los do DIL code personalizado na ferramenta de AAM.
3. Atualize sua extensão do Experience Cloud ID Service para a versão 3.3.0 ou superior
4. Adicione as opções avançadas à ferramenta ECID que você removeu do código personalizado da ferramenta de AAM.
5. Publicar as alterações

Atualização para o DIL 8.0 sem solução de gerenciamento de tags do Adobe

Se você estiver atualizando seu código diretamente na página, poderá apenas substituir itens mais antigos por itens mais novos, exceto quando precisar 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 ECID no local da ECID.

O mesmo vale para os gerentes de tags que não sã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.

1. Atualize sua biblioteca do DIL para a versão mais recente (8.0 ou superior) - Você precisará obter o código do DIL da Adobe Consulting ou do Adobe Customer Care, pois ele não está disponível em um local público. Em seguida, basta substituir o antigo código 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).

2. Instale ECID Service ou atualize sua versão existente para 3.3.0 ou superior. Você pode baixar a versão mais recente do Serviço de ID do Experience Cloud em nossa página do GitHub. Se precisar de ajuda com isso, consulte a documentação ou entre em contato com um consultor de Adobe.

3. Verifique se os métodos ou elementos obsoletos que estão em seu código personalizado para o DIL são movidos para os métodos ECID:

   1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs

      Documentação

   2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs

      Documentação

   3. (DIL) iframeAkamaiHTTPS -> (ECID) idSyncSSLUseAkamai

      Documentação

   4. (DIL) declaradaId -> (ECID) setCustomerIDs

      Documentação