Ajout d’Adobe Audience Manager

Cette leçon vous guidera tout au long des étapes nécessaires à l’activation d’Adobe Audience Manager à l’aide du transfert côté serveur.

Adobe Audience Manager (AAM) fournit des services de pointe pour la gestion des données d’audience en ligne, dotant les publicitaires et les éditeurs en numérique des outils dont ils ont besoin pour contrôler leurs ressources de données et en tirer profit afin de stimuler leurs ventes.

NOTE
Adobe Experience Platform Launch est intégré à Adobe Experience Platform comme une suite de technologies destinées à la collecte de données. Plusieurs modifications terminologiques ont été apportées à l’interface que vous devez connaître lors de l’utilisation de ce contenu :
  • Le platform launch (côté client) est désormais tags
  • Le platform launch côté serveur est désormais event forwarding
  • Les configurations Edge sont désormais datastreams

Objectifs d’apprentissage

À la fin de cette leçon, vous saurez comment :

  1. décrire les deux méthodes principales en vue de mettre en œuvre Audience Manager sur un site web ;
  2. ajouter Audience Manager à l’aide du transfert côté serveur de la balise Analytics ;
  3. valider la mise en œuvre d’Audience Manager.

Conditions préalables

Pour pouvoir suivre cette leçon, vous devez :

  1. avoir terminé les leçons de la rubrique Configuration des balises, Ajouter Adobe Analytics, et Ajout d’Identity Service.

  2. disposer d’un accès à Adobe Analytics pour activer le transfert côté serveur pour la suite de rapports que vous utilisez pour ce tutoriel. Vous pouvez également demander à un administrateur existant de votre organisation de le faire à votre place, en suivant les instructions ci-dessous.

  3. Votre « Sous-domaine Audience Manager » (également appelé « Nom de partenaire », « Identifiant de partenaire » ou « Sous-domaine de partenaire »). Si vous avez déjà mis en œuvre Audience Manager sur votre site web, la méthode la plus simple pour obtenir ce résultat consiste à accéder à votre site web et à ouvrir le débogueur. Le sous-domaine est disponible sur l’onglet Résumé, dans la section Audience Manager :

    Vous pouvez utiliser le débogueur pour trouver le sous-domaine Audience Manager sur votre site web

Si vous n’avez pas encore mis en œuvre Audience Manager, suivez ces instructions pour obtenir votre sous-domaine Audience Manager.

Options de mise en œuvre

Il existe deux méthodes pour mettre en œuvre Audience Manager sur un site web :

  • Transfert côté serveur (SSF) : pour les clients avec Adobe Analytics, il s’agit de la méthode de mise en œuvre la plus simple et recommandée. Adobe Analytics transfère des données vers AAM sur le serveur principal Adobe, ce qui permet une requête de moins sur la page. Cette solution permet également de bénéficier de fonctionnalités d’intégration clés et se conforme à nos bonnes pratiques en matière de mise en œuvre et de déploiement du code Audience Manager.

  • DIL côté client : cette approche est destinée aux clients qui ne disposent pas d’Adobe Analytics. Le code DIL (Code de bibliothèque d’intégration de données, le code de configuration JavaScript d’AAM) envoie directement les données depuis la page web vers Audience Manager.

Comme vous avez déjà déployé Adobe Analytics au cours de ce tutoriel, vous allez déployer Audience Manager à l’aide du transfert côté serveur. Pour obtenir une description complète et une liste des exigences du transfert côté serveur, consultez la documentation de manière à vous familiariser avec son fonctionnement, les exigences et la méthode de validation.

Activation du transfert côté serveur

Voici les deux étapes principales d’une mise en œuvre avec transfert côté serveur :

  1. Cocher une case dans l’Admin Console Analytics pour transférer les données depuis Analytics vers Audience Manager par suite de rapports.
  2. Mettre en place le code, ce qui se fait par le biais de balises. Pour que cela fonctionne, vous devez avoir installé l’extension Adobe Experience Platform Identity Service, ainsi que l’extension Analytics (vous n’aurez pas besoin de l’extension AAM, comme expliqué ci-dessous).

Activation du transfert côté serveur dans l’Admin Console d’Analytics

Il est nécessaire d’effectuer une configuration dans l’Admin Console d’Adobe Analytics pour lancer le transfert de données d’Adobe Analytics vers Adobe Audience Manager. Effectuez cette étape en premier lieu, étant donné que jusqu’à quatre heures peuvent s’avérer nécessaires pour commencer à transférer les données.

Activation du transfert côté serveur dans l’Admin Console d’Analytics

  1. Connectez-vous à Analytics via l’interface utilisateur d’Experience Cloud. Si vous ne disposez pas d’un accès d’administrateur à Analytics, contactez votre administrateur Experience Cloud ou Analytics pour qu’il vous octroie un accès ou qu’il effectue ces étapes pour vous.

    Connexion à Adobe Analytics

  2. Dans le volet de navigation supérieur d’Analytics, choisissez Administration > Suites de rapports, puis, dans la liste déroulante à sélection multiple, sélectionnez la ou les suites de rapports à transférer dans Audience Manager.

    Clic sur l’Admin Console

  3. Sur l’écran Suite de rapports et une fois la/les suite(s) de rapports sélectionnée(s), choisissez Modifier les paramètres > Général > Transfert côté serveur.

    Sélection du menu de transfert côté serveur

    note warning
    WARNING
    Comme indiqué ci-dessus, vous devez disposer de droits d’administrateur pour afficher cet élément de menu.
  4. Une fois sur la page Transfert côté serveur, lisez les informations et cochez la case Activer le transfert côté serveur pour la ou les suite(s) de rapports.

  5. Cliquez sur Enregistrer.

    Fin de la configuration du transfert côté serveur

NOTE
Comme le transfert côté serveur doit être activé par suite de rapports, veillez à répéter cette étape pour vos véritables suites de rapports lorsque vous déploierez le transfert côté serveur sur la suite de rapports de votre véritable site.
De plus, si l’option Transfert côté serveur est grisée, vous devrez mapper la ou les suites de rapports à votre organisation Experience Cloud afin d’activer l’option. Cela est expliqué dans la documentation.

Une fois cette étape effectuée et si Adobe Experience Platform Identity Service est activé, les données sont transférées d’Analytics à AAM. Toutefois, pour terminer le processus de sorte que la réponse soit renvoyée correctement d’AAM à la page (et également à Analytics via la fonction d’Audience Analytics), vous devez également effectuer l’étape suivante dans les balises . C’est très facile.

Activation du transfert côté serveur dans les balises

C’est la seconde étape de l’activation du transfert côté serveur. Vous avez déjà inversé le commutateur dans le Admin Console Analytics. Vous devez maintenant ajouter le code, ce qui est fait pour vous si vous cochez simplement la case appropriée.

NOTE
Pour mettre en oeuvre le transfert côté serveur des données Analytics dans AAM, nous allons modifier/configurer l’extension Analytics dans les balises, not l’extension AAM. L’extension AAM est utilisée exclusivement pour les mises en œuvre DIL côté client, pour les personnes qui ne disposent pas d’Adobe Analytics. Les étapes suivantes ont été correctement réalisées lorsqu’elles vous envoient vers l’extension Analytics pour la configuration.

Pour activer le transfert côté serveur dans les balises

  1. Accédez à Extensions > Installées et cliquez pour configurer l’extension Analytics.

    Configuration de l’extension Analytics

  2. Développez la section Adobe Audience Manager.

  3. Cochez la case pour Partager automatiquement les données Analytics avec Audience Manager. Cette opération ajoute le « module » Audience Manager (code) à la mise en œuvre AppMeasurement.js d’Analytics.

  4. Ajoutez votre « Sous-domaine Audience Manager » (également appelé « Nom de partenaire », « Identifiant de partenaire » ou « Sous-domaine de partenaire »). Suivez ces instructions pour obtenir votre sous-domaine Audience Manager.

  5. Cliquez sur Enregistrer dans la bibliothèque et créer.

    Configuration du transfert côté serveur

Le code de transfert côté serveur a bien été implémenté.

Validation du transfert côté serveur

La principale manière 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. Nous y reviendrons dans quelques instants. En attendant, penchons-nous sur ce qui peut nous aider à vérifier que tout fonctionne comme prévu.

Vérification du chargement correct du code

Le code qui balise l’installation pour gérer le transfert, et en particulier la réponse de l’AAM à la page, est appelé l’Audience Manager "Module". Nous pouvons utiliser l’Experience Cloud Debugger pour nous assurer qu’il a bien été chargé.

  1. Ouvrez le site Luma.

  2. Cliquez sur l’icône Debugger dans votre navigateur pour ouvrir Experience Cloud Debugger.

  3. Toujours dans l’onglet Résumé, faites défiler l’écran jusqu’à la section Analytics.

  4. Vérifiez que AudienceManagement est répertorié sous la section Modules.

    Validation du module AAM dans le débogueur

Vérification de l’identifiant de partenaire dans le débogueur

Ensuite, nous pouvons également vérifier que le débogueur sélectionne le bon « identifiant de partenaire » (ou sous-domaine de partenaire, etc.) dans le code.

  1. Toujours dans le débogueur et toujours dans l’onglet Résumé, faites défiler l’écran jusqu’à la section Audience Manager.

  2. Vérifiez votre identifiant de partenaire/sous-domaine sous « Partner ».

    Validation de l’identifiant de partenaire dans le débogueur

WARNING
Vous remarquerez peut-être que la section Audience Manager du débogueur fait référence à « DIL » la « bibliothèque d’intégration de données », et fait généralement référence à une mise en œuvre côté client, par opposition à l’approche côté serveur que nous avons mise en œuvre ici. Le « module » AAM (utilisé dans cette approche avec transfert côté serveur) utilise en grande partie le même code que la bibliothèque DIL côté client. C’est pourquoi ce débogueur le signale en tant que tel. Si vous avez suivi les étapes de ce tutoriel et que le reste des éléments de cette section de validation est correct, assurez-vous que le transfert côté serveur fonctionne.

Vérification de la requête et de la réponse Analytics

Voilà la partie la plus importante. Si vous n’effectuez pas de transfert côté serveur des données depuis Analytics vers Audience Manager, aucune réponse n’est apportée à la balise Analytics (hormis un pixel 2x2). Toutefois, 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 permettent ensuite de savoir qu’elle fonctionne correctement.
Malheureusement, actuellement, le débogueur Experience Cloud ne prend pas en charge l’affichage de la réponse aux balises. Par conséquent, vous devez utiliser un autre débogueur/renifleur de paquets, comme Charles Proxy ou les outils de développement du navigateur.

  1. Ouvrez les outils de développement dans votre navigateur et sélectionnez l’onglet Réseau.

  2. Dans le champ de filtre, saisissez b/ss. Cela limite ce que vous voyez aux requêtes Adobe Analytics.

  3. Pour afficher la requête Analytics, actualisez la page.

    Ouverture des outils de développement

  4. Dans la balise (requête) Analytics, recherchez un paramètre de « rappel ». Il sera défini sur quelque chose comme : s_c_il[1].doPostbacks.

    Requête AA - Paramètre de rappel

  5. Vous obtiendrez une réponse à la balise Analytics. Elle contiendra des références à doPostbacks, comme dans la requête et surtout, elle doit contenir un objet « stuff ». C’est là que les identifiants de segment AAM sont renvoyés au navigateur. Si vous obtenez l’objet « stuff », c’est que le transfert côté serveur fonctionne.

    Réponse AA - Objet « stuff »

WARNING
Attention au faux « succès » : s’il y a une réponse, et que tout semble fonctionner, assurez-vous d’avoir cet objet « stuff ». Dans le cas contraire, un message peut s’afficher dans la réponse et indiquer « status » : « SUCCESS ». Aussi incroyable que cela puisse paraître, c’est pourtant bien la preuve qu’il ne fonctionne PAS correctement. Si vous voyez cela, cela signifie que vous avez terminé cette deuxième étape (le code dans les balises), mais que le transfert dans le Admin Console Analytics (première étape de cette section) n’est pas encore terminé. Dans ce cas, vous devez vous assurer d’avoir activé le transfert côté serveur dans l’Admin Console d’Analytics. Si tel est le cas, mais que le délai de quatre heures n’est pas encore passé, soyez patient.

Réponse AA - Faux « succès »

Suite : « Intégrations Experience Cloud » >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2