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 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.

Visão geral

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.

  • Conforme declarado na descrição desta página, isso só abordará implementações 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 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:

  • 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 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:

  • 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 (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:

Atualização para 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 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.

    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 DIL 8.0 no Adobe DTM

  1. 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.
  2. Para quaisquer métodos/elementos obsoletos (como "disableIDSyncs") que estavam no código personalizado da ferramenta AAM anterior a 8.0 para DIL, anote-os (para que você possa adicioná-los à ferramenta ECID) e removê-los do DIL code personalizado na ferramenta AAM.
  3. Atualizar a 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 AAM.
  5. Publicar as alterações

Atualização para DIL 8.0 sem solução de gerenciamento de tags da 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 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.

  1. 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).

  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 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.

  3. Verifique se todos os métodos ou elementos obsoletos do código personalizado para DIL foram 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

Nesta página