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.
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.
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 :
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 :
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 :
Étapes de base de la mise à jour vers DIL 8.0
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).
Mettez à jour votre extension AAM vers la version 8.0 ou ultérieure
Vérifiez que l’extension du service d’identification des Experience Cloud est de la version 3.3.0 ou supérieure.
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.
Publication des modifications
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.
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).
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.
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 :
(DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
(DIL) disableIDSyncs -> (ECID) disableIdSyncs
(DIL) iframeAkamaiHTTPS -> (ECID) idSyncSSLUseAkamai
(DIL) statementId -> (ECID) setCustomerIDs