Effectuez la migration de l’implémentation Audience Manager de votre site de DIL côté client vers le transfert côté serveur migrating-your-site-s-aam-implementation-from-client-side-dil-to-server-side-forwarding

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 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 qui consiste à activer le transfert côté serveur, 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 Audience Manager, au lieu de laisser le code côté client envoyer un accès supplémentaire de la page à AAM. Ce tutoriel vous guide tout au long des étapes nécessaires pour passer de l’ancienne implémentation de DIL côté client à la nouvelle méthode de transfert côté serveur.

Côté client (DIL) ou côté serveur client-side-dil-vs-server-side

Lorsque vous comparez ces deux méthodes de transfert de données Adobe Analytics dans AAM, il peut s’avérer utile de visualiser d’abord les différences dans l’image suivante :

Implémentation de DIL côté client client-side-dil-implementation

Si vous utilisez cette méthode pour importer des données Adobe Analytics dans AAM, deux accès proviennent de vos pages web : l’un accède à Analytics, et l’autre à AAM (après avoir copié les données Analytics sur la page web). Segments sont renvoyées d’AAM vers la page, où elles peuvent être utilisées pour la personnalisation, etc. Il s’agit d’une implémentation héritée qui n’est plus recommandée.

Au-delà du fait que cela ne suit pas les bonnes pratiques, l'utilisation de cette méthode présente les inconvénients suivants :

Il est recommandé de passer à une méthode de transfert côté serveur pour l’implémentation d’AAM.

Implémentation du transfert côté serveur server-side-forwarding-implementation

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 termes de caractéristiques et de segments AAM, comme si l’accès provenait directement de la page.

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

Le passage au transfert côté serveur ne présente aucun inconvénient temporel. Adobe recommande vivement à toute personne disposant à la fois d’Audience Manager et de Analytics d’utiliser cette méthode d’implémentation.

Vous avez deux tâches principales you-have-two-main-tasks

Il y a pas mal d'informations sur cette page, et tout est important, bien sûr. Cependant, cela tout se résume à deux choses principales que vous devez faire :

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 correctement ces deux étapes pour votre configuration.

Options de mise en œuvre implementation-options

Lorsque vous passez du transfert côté client au transfert côté serveur, l’une des tâches que vous devez effectuer consiste à remplacer le code par le nouveau code de transfert côté serveur. Pour ce faire, utilisez l’une des options suivantes :

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

Étapes d’implémentation implementation-steps

Les étapes suivantes décrivent la mise en œuvre.

Étape 0 : prérequis : service Experience Cloud ID (ECID) step-prerequisite-experience-cloud-id-service-ecid

La principale condition préalable au transfert côté serveur est de mettre en œuvre le service Experience Cloud ID. Cette opération est plus facile à réaliser si vous utilisez Experience Platform Launch, auquel cas vous installez simplement l’extension ECID, qui fera le reste.

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

Étape 1 : enregistrer les options actuellement utilisées à partir du code DIL step-record-currently-used-options-from-dil-code

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

Étape 2 : mettre à jour le code step-updating-the-code

Dans la section Options d’implémentation (ci-dessus), plusieurs options sont fournies concernant le mode et le lieu d’implémentation du transfert côté serveur. Pour que cette section soit efficace, nous devons la diviser en ces sections (dont deux combinées). Accédez à la méthode de cette section qui décrit le mieux vos besoins.

Balises Adobe Experience Platform launch-by-adobe

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

Gestionnaire de balises « Sur la page » ou autre qu’Adobe on-the-page-or-non-adobe-tag-manager

Regardez la vidéo ci-dessous pour en savoir plus sur le déplacement des options d’implémentation du code 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 autre qu’Adobe.

Étape 3 : activer le transfert (par Report Suite) step-enabling-the-forwarding-per-report-suite

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

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

Timing timing

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

Mais la question est, lequel faites-vous en premier ? Cela a-t-il de l'importance ? OK, désolé, c'était deux questions. Mais les réponses sont… ça dépend, et oui, ça peut important. C'est comment ça ? Faisons une ventilation. Mais d'abord une question supplémentaire qui peut se poser si vous êtes une grande organisation avec de nombreux sites : Dois-je tout faire en même temps ? Celui-là est un peu plus facile. Non. Vous pouvez le faire morceau par morceau.

Exploration plus approfondie a-little-deeper-dive

La raison pour laquelle le timing et l’ordre sont importants tient au fonctionnement réel du transfert __ qui peut être résumé dans les quelques faits techniques suivants :

Bonnes pratiques best-practices

Sur la base de ces détails techniques, voici les recommandations relatives au timing des actions à effectuer et au moment opportun :

Si vous n’avez PAS encore implémenté d’ECID if-you-do-not-have-ecid-yet-implemented

Si l’ECID est implémenté if-you-do-have-ecid-implemented

Moment de la migration lorsque vous disposez de nombreux sites et report suites migration-timing-when-you-have-many-sites-and-report-suites

Ce thème est brièvement abordé 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 s’avérer un peu difficile en fonction de quelques scénarios possibles :

À cause de ces éléments, cela peut devenir un peu compliqué. Les meilleures choses que je peux suggérer sont :

Validation et dépannage validation-and-troubleshooting

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 Audience Manager, il n’y a vraiment aucune réponse à 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 et la réponse Analytics qui vous permettront de savoir que Analytics communique correctement avec Audience Manager, que vous transférez l’accès et que vous obtenez une réponse.

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