Documentation Audience Manager Tutoriels sur Audience Manager

Migration de l’implémentation de l’Audience Manager de votre site du DIL côté client vers le transfert côté serveur

Dernière mise à jour : 5 mai 2025

Rubriques :
Intégration d’Adobe Analytics

Créé pour :

Intermédiaire
Développeur

Ce tutoriel s’applique à vous si vous disposez à la fois de Adobe Audience Manager (AAM) et d’Adobe Analytics, et que vous envoyez actuellement un accès de la page à AAM à l’aide du code du DIL (Data Integration Library), ainsi qu’un accès de la page à Adobe Analytics. Puisque vous disposez de ces deux solutions et qu’elles font toutes deux partie de Adobe Experience Cloud, vous avez la possibilité de suivre la bonne pratique consistant à activer le transfert côté serveur, ce qui permet aux serveurs de collecte de données Analytics de transférer les données d’analyse de site en temps réel vers l’Audience Manager, au lieu d’avoir un code côté client qui envoie un accès supplémentaire de la page vers AAM. Ce tutoriel vous guide tout au long des étapes permettant de passer de l’ancienne mise en oeuvre du DIL côté client à la nouvelle méthode de transfert côté serveur.

Côté client (DIL) et côté serveur

Lors de la comparaison et de la comparaison de ces deux méthodes pour obtenir des données Adobe Analytics dans AAM, il peut s’avérer utile de visualiser les différences dans l’image suivante :

côté client vers côté serveur

Mise en oeuvre du DIL côté client

Si vous utilisez cette méthode pour obtenir des données Adobe Analytics dans AAM, vous obtenez deux accès provenant de vos pages web : l’un se rend sur Analytics et l’autre sur AAM (après avoir copié les données Analytics sur la page web). Segments sont renvoyés d’AAM à la page, où ils peuvent être utilisés pour la personnalisation, etc. Cette opération est considérée comme une implémentation héritée et n’est plus recommandée.

Outre le fait qu’il ne s’agit pas de suivre les bonnes pratiques, l’utilisation de cette méthode présente les inconvénients suivants :

Deux accès provenant de la page au lieu d’un seul
Le transfert côté serveur est requis pour le partage en temps réel des audiences AAM vers Analytics, de sorte que les mises en oeuvre côté client ne permettent pas cette fonctionnalité (et potentiellement d’autres fonctionnalités à l’avenir).

Il est recommandé de passer à une méthode de transfert côté serveur de mise en oeuvre AAM.

Mise en oeuvre du transfert côté serveur

Comme illustré dans l’image ci-dessus, un accès provient de la page Web vers Adobe Analytics. Analytics transfère ensuite ces données à AAM en temps réel, et les visiteurs sont évalués en caractéristiques AAM et segments, comme si l’accès provenait directement de la page.

Segments sont renvoyés sur le même accès en temps réel à Analytics, qui transfère la réponse sur la page web pour la personnalisation, etc.

Il n’y a aucun inconvénient à ce que le transfert côté serveur soit effectué. Adobe recommande vivement à quiconque possède à la fois une Audience Manager et Analytics d’utiliser cette méthode de mise en oeuvre.

Vous avez deux tâches principales :

Il y a pas mal d'informations sur cette page, et c'est important, bien sûr. Cependant, il se résume à deux tâches principales que vous devez effectuer :

Remplacez le code du DIL côté client par le code de transfert côté serveur.
Retourner le commutateur dans Analytics Admin Console pour lancer le transfert réel des données (par report suite)

Si vous ignorez l’une de ces tâches, le transfert côté serveur ne fonctionnera pas correctement. Des étapes et des données supplémentaires ont été ajoutées à ce document pour vous aider à effectuer ces deux étapes correctement pour votre configuration.

Options de mise en oeuvre

Lorsque vous passez du transfert côté client au transfert côté serveur, l’une des tâches qui s’affiche est de modifier le code en nouveau code de transfert côté serveur. Pour ce faire, utilisez l’une des options suivantes :

Balises Adobe Experience Platform : option d’implémentation recommandée par Adobe pour les propriétés web. Vous verrez que c’est une tâche facile, car les balises Platform ont fait tout le travail pour vous.
Sur la page : vous pouvez également placer le nouveau code SSF directement dans la fonction doPlugins de votre fichier appMeasurement.js, si vous n’utilisez pas (encore) Adobe Launch.
Autres gestionnaires de balises : ils peuvent être traités comme l’option précédente (Sur la page), car vous allez toujours placer le code SSF dans doPlugins, où l’autre gestionnaire de balises stocke le code AppMeasurement.

Nous allons voir chacun de ces éléments ci-dessous dans la section Mise à jour du code .

Etapes de mise en oeuvre

Les étapes suivantes décrivent la mise en oeuvre.

Étape 0 : condition requise : service d’ID Experience Cloud (ECID)

La principale condition préalable au passage au transfert côté serveur consiste à mettre en oeuvre le service d’ID Experience Cloud. Cela est plus facile si vous utilisez Experience Platform Launch, auquel cas vous installez simplement l’extension ECID et cela fera le reste.

Si vous utilisez un TMS non Adobe, ou aucun TMS du tout, implémentez ECID pour exécuter avant toute autre solution d’Adobe. Pour plus d’informations, consultez la documentation ECID . La seule autre condition préalable concerne les versions de code. Par conséquent, comme vous appliquez simplement les versions les plus récentes du code dans les étapes suivantes, tout ira bien.

NOTE

Veuillez lire l’intégralité de ce document avant de procéder à l’implémentation. La section "Minutage" ci-dessous contient des informations importantes sur quand vous devez implémenter chaque élément, y compris l’ECID (s’il n’est pas encore implémenté).

Étape 1 : enregistrer les options actuellement utilisées du code du DIL

Lorsque vous vous préparez à passer du code du DIL côté client au transfert côté serveur, la première étape consiste à identifier tout ce que vous faites avec le code du DIL, y compris les paramètres personnalisés et les données envoyées à AAM. Voici quelques éléments à noter et à prendre en compte :

Variables Analytics normales, utilisant le module de DIL siteCatalyst.init - Vous n’avez pas à vous soucier de celle-ci, car sa tâche consiste simplement à envoyer les variables Analytics normales, et cela se produit simplement en activant le transfert côté serveur.
Partner Subdomain - Dans la fonction DIL.create, prenez note du paramètre partner. Il s’agit de votre "sous-domaine partenaire" ou, parfois, de votre "identifiant partenaire". Il sera nécessaire lorsque vous placez le nouveau code de transfert côté serveur.
Visitor Service Namespace - Également appelé "Org ID" ou "IMS Org ID", vous en aurez également besoin lorsque vous configurerez le nouveau code de transfert côté serveur. Fais-en une note !
containerNSID, uuidCookie et autres options avancées - Notez toutes les options avancées supplémentaires que vous utilisez afin que vous puissiez les définir dans le code de transfert côté serveur.
Variables de page supplémentaires : si d’autres variables sont envoyées à AAM à partir de la page (en plus des variables Analytics normales gérées par siteCatalyst.init), vous devez en prendre note afin qu’elles puissent être envoyées via le transfert côté serveur (alerte de spoiler : via des variables contextData).

Étape 2 : mise à jour du code

Dans Options d’implémentation (ci-dessus), plusieurs options sont données concernant la manière et l’emplacement d’implémentation du transfert côté serveur. Pour que cette section soit efficace, nous devons la diviser en deux sections (deux d’entre elles étant combinées). Accédez à la méthode de cette section qui décrit le mieux vos besoins.

Balises Adobe Experience Platform

Regardez la vidéo ci-dessous pour en savoir plus sur le déplacement des options de mise en oeuvre du code du DIL côté client vers le transfert côté serveur dans Experience Platform Launch.

video poster

https://video.tv.adobe.com/v/26310/?quality=12

"Sur la page" ou gestionnaire de balises non Adobe

Regardez la vidéo ci-dessous pour en savoir plus sur le déplacement des options de mise en oeuvre du code du DIL côté client vers le transfert côté serveur dans le code AppMeasurement, résidant dans un fichier ou dans un système de gestion des balises non Adobe.

video poster

https://video.tv.adobe.com/v/26312/?quality=12

Étape 3 : activation du transfert (par Report Suite)

Jusqu’à présent, dans ce tutoriel, nous avons passé tout notre temps à changer le code du DIL côté client en transfert côté serveur. C'est bien, parce que c'est la partie la plus difficile. Bien que cette section soit très facile à voir, elle est tout aussi importante que la mise à jour du code. Dans cette vidéo, vous allez découvrir comment changer le commutateur qui permet le transfert réel des données d’Analytics vers l’Audience Manager.

video poster

https://video.tv.adobe.com/v/26355/?quality-12

REMARQUE : Comme indiqué dans la vidéo, n’oubliez pas que l’activation du transfert prendra jusqu’à 4 heures pour être entièrement mise en oeuvre sur le serveur principal Experience Cloud.

Minutage

Pour rappel, il existe deux tâches principales pour passer du DIL côté client au transfert côté serveur :

Mise à jour du code
Changement de commutateur dans Analytics Admin Console

Mais la question est, laquelle faites-vous en premier ? Est-ce important ? OK, désolé, c'était deux questions. Mais les réponses sont… ça dépend, et oui, ça peut compter. En quoi est-ce vague ? Faisons une ventilation. Mais d'abord une question supplémentaire qui peut apparaître si vous êtes une grande organisation avec de nombreux sites : Dois-je tout faire en même temps ? Celle-là est un peu plus facile. Non. Vous pouvez le faire morceau par morceau.

Une plongée un peu plus profonde

La raison pour laquelle le timing et la commande sont importants est due au fonctionnement du transfert true, qui peut être résumé dans les quelques faits techniques suivants :

Si le service d’ID d’Experience Cloud (ECID) est mis en oeuvre et que le commutateur dans Analytics Admin Console ("le commutateur") est activé, les données seront transférées de Analytics vers l’AAM, même si vous n’avez pas encore mis à jour le code.
Si ECID n’est pas implémenté, les données ne seront pas transférées, même si le commutateur est activé, et que le code de transfert côté serveur est activé.
Le code de transfert côté serveur (que ce soit dans les balises Platform ou sur la page) gère réellement la réponse et est nécessaire pour terminer la migration.
N’oubliez pas que le commutateur de transfert côté serveur est activé par report suite, mais que le code est géré par la propriété dans les balises Platform, ou par le fichier AppMeasurement si vous n’utilisez pas les balises Platform.

Bonnes pratiques

Sur la base de ces détails techniques, voici les recommandations pour connaître le moment et le moment où :

Si vous n’avez PAS encore implémenté ECID

Retourner le commutateur dans Analytics pour chaque report suite que vous activerez pour le transfert côté serveur.
1. Le transfert ne démarre pas encore car vous ne disposez pas d’ECID.
Par site, mettez à jour votre code du DIL côté client vers le transfert côté serveur (il peut s’agir de balises Platform) ou sur la page, comme expliqué dans une autre section ci-dessus).
1. Le transfert se fait maintenant (comme vous avez ajouté l’ECID) et vous devriez également recevoir une réponse JSON appropriée à votre balise Analytics (voir la section Validation and Troubleshooting (Validation et dépannage) ci-dessous pour plus d’informations).

Si ECID est implémenté

Préparez et planifiez afin que vous soyez prêt à mettre à jour votre code du DIL vers le transfert côté serveur PER report suite que vous activerez pour le transfert côté serveur :
1. Retournez le commutateur dans Analytics pour activer le transfert côté serveur.
  1. Le transfert commencera car ECID est activé.
2. Dans les plus brefs délais, mettez à jour votre code du DIL côté client vers le transfert côté client (il peut s’agir de balises Platform ou de la page, comme expliqué dans une autre section ci-dessus).
  1. Vous devriez recevoir une réponse JSON appropriée à votre balise Analytics (voir la section Validation et dépannage ci-dessous pour plus d’informations).

NOTE

Il est important de réaliser ces deux étapes aussi près que possible, car entre les étapes 1 et 2 ci-dessus, vous aurez une duplication des données en AAM. En d’autres termes, le transfert côté unique a commencé à envoyer des données de Analytics vers AAM. Comme le code du DIL se trouve toujours sur la page, un accès se déplace directement de la page vers AAM, ce qui double les données. Dès que vous mettez à jour le code du transfert DIL vers le transfert côté serveur, cela sera moins important.

NOTE

Si vous préférez une légère incohérence des données plutôt qu’une petite duplication des données, vous pouvez changer l’ordre des étapes 1 et 2 ci-dessus. Le déplacement du code du DIL vers le transfert côté serveur arrête le flux de données vers AAM jusqu’à ce que vous puissiez inverser le commutateur pour activer le transfert côté serveur pour le report suite. En règle générale, les clients préfèrent avoir un petit doublement de données plutôt que de ne pas intégrer les visiteurs aux caractéristiques et segments.

Délai de migration lorsque vous avez de nombreux sites et report suites

Cette rubrique est brièvement abordée dans les sections précédentes, dans la mesure où la stratégie principale peut être résumée comme suit :

Migrez un site/report suite (ou un groupe de sites/report suites) à la fois.

Cependant, cela peut devenir un peu délicat en fonction de quelques scénarios possibles :

Vous avez un site qui contient plusieurs report suites distincts
Vous avez un report suite qui comprend plusieurs sites (comme un report suite global)
Vous utilisez une propriété de balises Platform pour couvrir plusieurs sites.
Vous disposez de différentes équipes de développement pour différents sites.

A cause de ces éléments, ça peut devenir un peu compliqué. Les meilleures choses que je puisse suggérer sont les suivantes :

Prenez le temps d’élaborer une stratégie de migration vers le transfert côté serveur, en fonction des éléments expliqués ci-dessus.
Sur la base du fait qu’une seule propriété des balises Platform (ou un seul fichier AppMeasurement) correspond généralement à 1 ou 2 report suites distincts, vous serez probablement en mesure d’élaborer un plan qui fonctionne sur ces groupes distincts un par un, mettant à jour votre entreprise vers le transfert côté serveur.
Si vous travaillez avec Adobe Consulting, contactez-le au sujet de votre plan de migration, afin qu’il puisse vous aider si nécessaire.

Validation et dépannage

La principale façon de vérifier que le transfert côté serveur est opérationnel consiste à examiner la réponse à l’un de vos accès Adobe Analytics provenant de l’application.

Si vous n’effectuez pas de transfert côté serveur des données de Analytics vers l’Audience Manager, aucune réponse n’est apportée à la balise Analytics (hormis un pixel 2x2). Cependant, si vous effectuez un transfert côté serveur, vous pouvez vérifier certains éléments dans la requête Analytics et la réponse qui vous permettront de savoir que Analytics communique correctement avec l’Audience Manager, de transférer l’accès et d’obtenir une réponse.

video poster

https://video.tv.adobe.com/v/26359/?quality=12

WARNING

Attention au faux “Succès”. S’il existe une réponse et que tout semble fonctionner, assurez-vous que la réponse contient l’objet stuff . Dans le cas contraire, un message indiquant "status":"SUCCESS" peut s’afficher. Aussi fou que cela paraisse, c'est en fait la preuve qu'il ne fonctionne PAS correctement.

Si vous voyez cela, cela signifie que vous avez terminé la mise à jour du code dans les balises Platform ou AppMeasurement, mais que le transfert dans Analytics Admin Console n’est pas encore terminé. Dans ce cas, vous devez vérifier que vous avez activé le transfert côté serveur dans Analytics Admin Console pour votre report suite. Si vous l'avez fait, et que cela n'a pas encore été 4 heures, soyez patient, car cela peut prendre autant de temps pour apporter toutes les modifications nécessaires sur le serveur principal.

false success

Pour plus d’informations sur le transfert côté serveur, consultez la documentation.

recommendation-more-help