Este artigo fornecerá etapas e recomendações sobre como atualizar o 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.
Audience Manager's Data Integration Library O código (DIL) 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.
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:
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:
Se você tem usado um desses métodos mais antigos para sincronizar com uma ID do cliente, é altamente recomendável atualizar para o uso da variável setCustomerIDs , que faz parte do serviço ECID. Mais informações sobre setCustomerIDs está disponível no documentação.
Dica Rápida: Ao usar um dos métodos acima, você fez referência ao AAM Data Source com o Data Source ID (também conhecido como "DPID"). Ao atualizar para setCustomerIDs, será necessário usar o AAM Data Source’s "Integration Code" em vez disso. 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:
Etapas básicas para a atualização para o DIL 8.0
Se você estiver usando o DIL pré-8.0, antes de atualizar, acesse a configuração do DIL na extensão AAM e anote quaisquer 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 de AAM anterior ao 8.0 ou no código personalizado do DIL, ative os métodos ECID na extensão ECID.
disableDestinationPublishingIframe
-> (ECID) disableIdSyncs
disableIDSyncs
-> (ECID) disableIdSyncs
iframeAkamaiHTTPS
-> (ECID) dSyncSSLUseAkamai
declaredId
-> (ECID) setCustomerIDs
Publique as alterações.
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 código personalizado DIL code na ferramenta AAM.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.
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).
Instalar 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 o documentação ou fale com um consultor de Adobe.
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:
(DIL) disableDestinationPublishingIframe
-> (ECID) disableIdSyncs
(DIL) disableIDSyncs
-> (ECID) disableIdSyncs
(DIL) iframeAkamaiHTTPS
-> (ECID) idSyncSSLUseAkamai
(DIL) declaredId
-> (ECID) setCustomerIDs