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 da DIL do "lado do cliente", não ao encaminhamento pelo lado do servidor dos dados do Adobe Analytics, e abordará o DTM, o Launch da Adobe e as implementações sem a solução do gerenciador de tags da Adobe.
O código Data Integration Library (DIL) do Audience Manager permite implementar o AAM em seu site*. Ao implementar versões anteriores do DIL, não era necessário ter o Serviço da Experience Cloud ID (ECID) da Adobe implementado também (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 você 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 a DIL estão disponíveis na documentação.
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ê 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 do ECID.
Por exemplo:
No AAM, você pode sincronizar sua UUID (ID de usuário exclusiva anônima) na máquina 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 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 (ou seja, o "DPID"). Ao atualizar para setCustomerIDs, você precisará usar o "Data Source" do AAM em vez disso. Integration Code 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:
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 todas as opções avançadas que estiver usando (para ser usadas 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 estivessem em sua extensão AAM anterior a 8.0 ou no código personalizado para DIL, ative os métodos ECID na extensão ECID.
Publicar as alterações
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 de DIL para 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 se aplica aos 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.
Atualize sua biblioteca DIL para a versão mais recente (8.0 ou superior) - Você precisará obter o código DIL mais recente da Adobe Consulting ou do Atendimento ao cliente da Adobe, pois ela não está disponível em um local público no momento. Em seguida, basta substituir o antigo código da biblioteca DIL pelo novo código da biblioteca DIL e seguir para a próxima etapa (não pare agora ou você terá problemas, ha).
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 da Experience Cloud ID em nossa página do GitHub. Se precisar de ajuda com isso, consulte a documentação ou fale com um consultor da Adobe.
Verifique se todos os métodos ou elementos obsoletos do 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) declaradaId -> (ECID) setCustomerIDs