Mettez à jour votre bibliothèque de collecte de données pour l’Audience Manager de l’extension de balise d’Audience Manager vers l’extension de balise du SDK Web.

Audience prévue

Cette page est destinée aux clients d’Audience Manager qui utilisent l’extension de balise d’Audience Manager pour importer des données de collecte web dans Audience Manager. Pour les clients qui utilisent la bibliothèque JavaScript AppMeasurement, veuillez lire le guide sur la mise à jour de votre bibliothèque de collecte de données pour l’Audience Manager de la bibliothèque JavaScript d’AppMeasurement vers la bibliothèque JavaScript SDK Web.

Avantages et inconvénients de ce chemin de mise en oeuvre

L’utilisation de cette approche de migration présente des avantages et des inconvénients. Pesez soigneusement chaque option pour choisir la méthode qui convient le mieux à votre entreprise.

Avantages
Inconvénients
  • Aucune modification du code sur votre site : comme votre implémentation comporte déjà des balises installées, toutes les mises à jour de migration peuvent être effectuées dans l’interface des balises.
  • Utilise votre implémentation existante : cette approche ne nécessite pas de nouvelle implémentation. Bien qu’il nécessite de nouvelles actions de règle, vous pouvez réutiliser vos éléments de données et conditions de règle existants avec des modifications minimales.
  • Ne nécessite pas de schéma : pour cette étape de migration vers le SDK Web, vous n’avez pas besoin d’un schéma XDM. Vous pouvez à la place renseigner l’objet data qui envoie directement des données à Adobe Audience Manager. Une fois la migration vers le SDK Web terminée, vous pouvez créer un schéma pour votre organisation et utiliser le mappage de flux de données pour remplir les champs XDM applicables. Si un schéma était requis à ce stade du processus de migration, votre organisation serait forcée d’utiliser un schéma XDM Adobe Audience Manager. L’utilisation de ce schéma rend plus difficile l’utilisation de votre propre schéma par votre entreprise à l’avenir.
  • Dette technique de mise en oeuvre : comme cette approche utilise une forme modifiée de votre mise en oeuvre existante, il peut être plus difficile de suivre la logique de mise en oeuvre et d’effectuer des modifications si nécessaire. Le code personnalisé peut être particulièrement difficile à déboguer.
  • Nécessite un mappage pour envoyer des données à Platform : lorsque votre organisation est prête à utiliser Real-Time CDP, vous devez envoyer des données à un jeu de données dans Adobe Experience Platform. Cette action nécessite que chaque champ de l’objet data soit une entrée dans l’outil de mappage de flux de données qui l’affecte à un champ de schéma XDM. Le mappage ne doit être effectué qu’une seule fois pour ce workflow, ce qui n’implique pas d’effectuer des modifications de mise en oeuvre. Cependant, il s’agit d’une étape supplémentaire qui n’est pas requise lors de l’envoi de données dans un objet XDM.

Adobe recommande de suivre ce chemin d’implémentation lorsque vous disposez d’une implémentation existante à l’aide de l’extension de balise Adobe Audience Manager.

Procédure de migration vers le SDK Web

Les étapes suivantes contiennent des objectifs concrets. Sélectionnez chaque étape pour obtenir des instructions détaillées sur la manière d’y parvenir.

1. Création et configuration d’un flux de données

Suivez les instructions ci-dessous pour créer un flux de données dans la collecte de données Adobe Experience Platform. Lorsque vous envoyez des données à ce flux de données, elles sont transférées à l’Audience Manager. À l’avenir, ce même flux de données transfère les données vers Real-Time CDP.

  1. Accédez à experience.adobe.com et connectez-vous à l’aide de vos informations d’identification.

  2. Utilisez la page d’accueil ou le sélecteur de produits en haut à droite pour accéder à Data Collection.

  3. Dans le volet de navigation de gauche, sélectionnez Datastreams.

  4. Sélectionnez New Datastream.

  5. Saisissez le nom de votre choix, puis sélectionnez Save.

  6. Une fois le flux de données créé, sélectionnez Add Service.

  7. Dans le menu déroulant du service, sélectionnez Adobe Audience Manager.

  8. Assurez-vous que l'option Enable XDM Flattened Fields n'est pas cochée.

    Ajouter un service d’Audience Manager

Votre flux de données est maintenant prêt à recevoir et à transmettre des données à l’Audience Manager.

2. Ajoutez l’extension SDK Web à la propriété de balise.

Cette section prépare votre balise pour l’essentiel de l’effort de migration qui se déroulera à l’étape suivante.

  1. Sélectionnez l’icône de hamburger en haut à gauche de l’interface de Adobe Experience Platform, puis sélectionnez Tags.

  2. Sélectionnez la propriété de balise de votre choix.

  3. Dans le volet de navigation de gauche de la propriété de balise, sélectionnez Extensions.

  4. Sélectionnez Catalog près de la partie supérieure pour afficher la liste de toutes les extensions disponibles.

  5. Recherchez et sélectionnez l’extension Adobe Experience Platform Web SDK, puis sélectionnez Install sur le côté droit.

    Catalogue

  6. Les paramètres de configuration de l’extension s’affichent. Recherchez la section Datastreams et sélectionnez l’environnement de test que vous utilisez ainsi que le flux de données que vous avez créé à l’étape précédente.

    sélection de flux de données

  7. Sélectionnez Save.

Le SDK Web est désormais installé pour votre propriété de balise.

3. Création d’un élément de données d’objet de données

L’élément de données d’objet de données fournit une structure intuitive pour configurer une charge utile que le SDK Web utilise pour envoyer à un flux de données. La plupart des règles que vous mettez à jour à l’étape suivante interagissent avec cet élément de données.

  1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Data Elements.

  2. Sélectionner Add Data Element

  3. Définissez les paramètres suivants pour l’élément de données :

    • Name : tout ce que vous souhaitez, par exemple "Couche de données" ou "Objet de données"
    • Extension : Adobe Experience Platform Web SDK
    • Data Element Type : Variable
    • Les cases à cocher peuvent rester telles quelles.
  4. Sur le côté droit, sélectionnez les paramètres suivants :

    • Bouton radio Propriété : Data
    • Solution : Adobe Audience Manager
  5. Sélectionnez Save.

    Créer un élément de données

Votre propriété de balise dispose désormais de tous les éléments nécessaires pour mettre à jour chaque règle.

4. Mettez à jour les règles pour utiliser l’extension SDK Web au lieu de l’extension d’Audience Manager

Cette étape représente l’essentiel des efforts nécessaires pour migrer vers le SDK Web et nécessite des connaissances sur le fonctionnement de votre mise en oeuvre. Vous trouverez ci-dessous un exemple de modification d’une règle de balise standard. Mettez à jour toutes les règles de balise dans votre implémentation pour remplacer toutes les références à l’extension d’Audience Manager par l’extension SDK Web.

  1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Rules.

  2. Sélectionnez une règle à modifier.

  3. Sélectionnez l’action Audience Manager - Set Variables

  4. Notez toutes les variables d’Audience Manager définies dans cette règle. Incluez les deux variables définies dans les menus déroulants et les variables définies dans le code personnalisé.

  5. Remplacez Action Configuration par les paramètres suivants :

    • Extension : Adobe Experience Platform Web SDK
    • Action type : Mettre à jour la variable
  6. Assurez-vous que l’objet de données que vous avez créé à l’étape 3 est sélectionné dans la liste déroulante à droite, dans le champ Data element .

  7. Définissez les paires clé-valeur d’Audience Manager sur leurs valeurs respectives telles qu’elles ont été configurées dans l’extension d’Audience Manager.

  8. Une fois que toute la logique de règle est répliquée à l’aide de l’extension SDK Web, sélectionnez Keep Changes.

  9. Répétez ces étapes pour chaque configuration d’action qui utilise l’extension de balise d’Audience Manager pour définir des valeurs.

Les étapes ci-dessus s’appliquent uniquement aux règles qui définissent des valeurs. Les étapes suivantes remplacent toutes les actions qui utilisent Action Configuration Send Event.

  1. Sélectionnez une règle qui envoie un événement SDK Web.

  2. Sélectionnez le type d’action Send Event.

  3. Remplacez Action Configuration par les paramètres suivants :

    • Extension : Adobe Experience Platform Web SDK
    • Action type : Send event
  4. À droite, définissez les paramètres de l’action sur les éléments suivants :

    • Type : utilisez Web Webpagedetails Page Views.
    • Data : sélectionnez l’objet de données créé à l’étape 3.
  5. Sélectionnez Keep Changes.

  6. Répétez ces étapes pour chaque configuration d’action qui utilise l’Audience Manager pour envoyer un événement.

5. Règles mises à jour Publish

La publication des règles mises à jour suit le même processus que toute autre modification apportée à la configuration des balises.

  1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Publishing Flow.

  2. Sélectionnez Add Library.

  3. Donnez à cette balise un nom, par exemple "Mettre à niveau vers le SDK Web".

  4. Sélectionnez Add All Changed Resources.

  5. Sélectionnez Save.

  6. Le processus de publication affiche un point orange, indiquant qu’il est en cours de création. Une fois que le point devient vert, vos modifications sont disponibles dans votre environnement de développement.

  7. Testez vos modifications dans votre environnement de développement pour vous assurer que toutes les règles se déclenchent correctement et que l’objet de données est rempli avec les valeurs attendues.

  8. Une fois prête, envoyez la bibliothèque pour approbation, créez-la pour l’évaluation, puis approuvez et publiez-la pour la production.

    Flux de publication

6. Désactiver l’extension d’Audience Manager

Une fois la mise en oeuvre de votre balise entièrement migrée vers le SDK Web, vous pouvez désactiver l’extension d’Audience Manager.

  1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Extensions.
  2. Recherchez et sélectionnez l’extension Audience Manager. À droite, sélectionnez Disable.
  3. Suivez le même processus de publication ci-dessus pour publier la suppression de l’extension Audience Manager.
  4. Une fois l’extension désactivée en production, vous pouvez la désinstaller entièrement. Sélectionnez l’extension, sélectionnez le menu à trois points à droite, puis sélectionnez Uninstall.
  5. Suivez le même processus de publication ci-dessus pour publier ces modifications en production.

À ce stade, la mise en oeuvre de votre Audience Manager est entièrement migrée vers le SDK Web et est prête à passer à Real-Time CDP à l’avenir.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695