Mise à jour vers la version DIL 8.0 (ou ultérieure) de Adobe Audience Manager

Cet article décrit les étapes et recommandations de la mise à jour du code Adobe Audience Manager (AAM) Data Integration Library (DIL) vers la version 8.0 ou ultérieure. Il s’agit de l’implémentation du DIL "côté client", et non du transfert côté serveur des données Adobe Analytics, qui couvrira la gestion dynamique des balises, les Launch by Adobe et les implémentations sans solution Adobe Tag Manager.

Présentation

Le code Data Integration Library (DIL) de l'Audience Manager vous permet de mettre en oeuvre AAM sur votre site Web*. Lors de la mise en oeuvre des versions précédentes d’un DIL, il n’était pas nécessaire que le service d’identification des Experience Cloud (ECID) de l’Adobe soit également mis en oeuvre (même si c’était une très bonne idée). A partir de la version 8.0 du DIL, il existe une dépendance stricte sur ECID version 3.3 ou ultérieure. Si vous implémentez DIL 8.0 ou une version ultérieure sans ECID 3.3, ou avec une version antérieure, vous obtenez une erreur et elle ne fonctionnera pas. Comme il existe plusieurs façons de mettre en oeuvre l'AAM, nous avons créé cette page pour vous donner quelques étapes à suivre, ainsi que quelques recommandations. Vous trouverez ci-dessous les étapes et recommandations ventilées par plateforme/méthode d’implémentation. Pour plus d'informations sur le DIL, consultez la documentation.

• Comme indiqué dans la description de cette page, cela ne couvrira que les implémentations de DIL "côté client", utilisées par AAM clients qui n’ont pas d’Adobe Analytics. Si vous possédez Adobe Analytics, vous devez utiliser la méthode de transfert côté serveur pour implémenter AAM. Cette méthode est décrite dans la documentation.

Duplicata et éléments et méthodes obsolètes

Dans les versions antérieures du DIL et de l'ECID, il y avait des méthodes en double (méthodes qui fonctionnent de la même façon dans le DIL et l'ECID), ce qui entraînait une confusion quant à l'utilisation à utiliser. En général, vous deviez les utiliser et les faire correspondre, et ce message n'était pas bien communiqué à nos clients. A compter de la version 8.0 de DIL, ces méthodes et éléments de duplicata ont été abandonnés dans DIL et il est recommandé d’utiliser la version ECID.

Par exemple :

• Lors de l'utilisation de DIL.create, quelques éléments ont été déconseillés et vous devez utiliser les éléments ECID à la place. Ces éléments sont décrits dans la DIL.create documentation.
• La méthode de niveau instance idSync a également été abandonnée, comme indiqué dans la documentation de la méthode.

Synchronisation des identifiants avec un ID de client

Dans AAM, vous pouvez synchroniser votre UUID (identifiant utilisateur unique anonyme) sur l’ordinateur avec un ID de client, de sorte que vous puissiez télécharger des données hors ligne sur ce client et les lier à leur comportement en ligne, afin de mieux comprendre vos clients. Dans le passé, cela s'est fait de deux manières :

• La méthode de niveau instance idSync
• L'élément declaredId dans DIL.create

Si vous avez utilisé l'une de ces méthodes plus anciennes pour la synchronisation avec un ID de client, il est vivement recommandé de mettre à jour la méthode setCustomerIDs, qui fait partie du service ECID. Pour plus d’informations sur setCustomerIDs, consultez la documentation de la méthode.

Conseil rapide : lorsque vous avez précédemment utilisé l’une des méthodes ci-dessus, vous avez référencé l’AAM Data Source avec l’ Data Source identifiant (AKA, "DPID"). Lors de la mise à jour vers setCustomerIDs, vous devez utiliser plutôt l’AAM Data Source de "Integration Code". Il pointe toujours vers le même Data Source mais n'est qu'un identifiant différent. Ceci est montré dans la vidéo ci-dessous.

Les sections suivantes liste les étapes et les recommandations de mise à jour vers DIL 8.0 en fonction de votre méthode d’implémentation :

Mise à jour vers DIL 8.0 dans Adobe Experience Platform Launch

Étapes de base de la mise à jour vers DIL 8.0

1. Si vous utilisez un DIL antérieur à la version 8.0, avant de procéder à la mise à niveau, accédez à la configuration du DIL dans l’extension AAM et notez les options avancées que vous utilisez (à utiliser dans une étape ultérieure).

2. Mettez à jour votre extension AAM vers la version 8.0 ou ultérieure

3. Vérifiez que l’extension du service d’identification des Experience Cloud est de la version 3.3.0 ou supérieure.

4. Pour toutes les méthodes/éléments obsolètes (tels que "disableIDSyncs") qui se trouvaient dans votre extension AAM antérieure à la version 8.0 ou dans le code personnalisé du DIL, activez les méthodes ECID dans l'extension ECID.

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

5. Publication des modifications

Mise à jour vers DIL 8.0 dans la gestion dynamique des balises Adobe

1. Mettez à jour votre outil AAM vers la version 8.0 ou ultérieure. Ce paramètre de version se trouve sous la section "Général" de l’outil AAM.
2. Pour les méthodes/éléments obsolètes (tels que "disableIDSyncs") qui figuraient dans le code personnalisé de votre DIL de l’outil AAM version antérieure à 8.0, notez-les (afin que vous puissiez les ajouter à l’outil ECID), puis supprimez-les de l’outil personnalisé DIL code de l’outil AAM.
3. Mettez à jour votre extension du service d’identification des Experience Cloud vers la version 3.3.0 ou ultérieure.
4. Ajoutez les options avancées à l'outil ECID que vous avez supprimé du code personnalisé de l'outil AAM.
5. Publication des modifications

Mise à jour vers DIL 8.0 sans solution de gestion des balises d’Adobe

Si vous mettez à jour votre code directement sur la page, vous pouvez simplement remplacer les éléments plus anciens par des éléments plus récents, sauf quand vous devez déplacer les méthodes/éléments du DIL à l'ECID, comme expliqué ci-dessus. Dans ce cas, vous remplacerez simplement l’ancienne méthode/élément de l’emplacement du DIL par la méthode/l’élément ECID de l’emplacement ECID.

Il en va de même pour les gestionnaires de balises non-Adobes. Où que vous disposiez des anciennes versions de cette solution de gestion des balises, remplacez-la par le nouveau code, comme décrit dans les étapes suivantes.

1. Mettez à jour votre bibliothèque de DIL vers la dernière version (8.0 ou ultérieure). Vous devrez obtenir le code de DIL le plus récent auprès du service d’assistance clientèle d’Adobes ou d’Adobes, car il n’est actuellement pas disponible dans un emplacement public. Ensuite, remplacez simplement l’ancien code de bibliothèque du DIL par le nouveau code de bibliothèque du DIL et passez à l’étape suivante (ne vous arrêtez pas maintenant ou vous rencontrerez des problèmes, ha).

2. Installez ECID Service ou mettez à jour votre version existante vers la version 3.3.0 ou ultérieure. Vous pouvez télécharger la dernière version du service d’identification des Experience Cloud à partir de notre page GitHub. Si vous avez besoin d'aide pour cela, consultez la documentation ou contactez un consultant en Adobe.

3. Vérifiez que les méthodes ou éléments déconseillés figurant dans votre code personnalisé pour le DIL sont déplacés vers les méthodes ECID :

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

      Documentation

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

      Documentation

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

      Documentation

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

      Documentation