DocumentationExperience PlatformTutoriel du SDK web

Configuration de l’Audience Manager avec le SDK Web Platform

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Débutant
  • Intermédiaire
  • Développeur

Découvrez comment configurer Adobe Audience Manager à l’aide du SDK web Adobe Experience Platform et valider l’implémentation à l’aide d’une destination de cookie.

Adobe Audience Manager est la solution Adobe Experience Cloud qui fournit tout ce qui est nécessaire pour collecter des informations commercialement pertinentes sur les visiteurs du site, créer des segments commercialisables et diffuser de la publicité et du contenu ciblés à la bonne audience.

Diagramme SDK Web et Adobe Audience Manager

Objectifs d'apprentissage

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

  • Configuration d’un flux de données pour activer l’Audience Manager
  • Activation d’une destination de cookie dans Audience Manager
  • Validation de la mise en oeuvre de l’Audience Manager en confirmant la qualification de l’audience avec Adobe Experience Platform Debugger

Conditions préalables

Pour terminer cette leçon, vous devez d’abord :

  • Suivez les leçons des sections Configuration initiale et Configuration des balises de ce tutoriel.
  • Avoir accès à Adobe Audience Manager et aux autorisations appropriées pour créer, lire et écrire des caractéristiques, des segments et des destinations. Pour plus d’informations, consultez le contrôle d’accès en fonction du rôle de l’Audience Manager.

Configuration du flux de données

L’implémentation de l’Audience Manager à l’aide du SDK Web de Platform diffère de l’implémentation à l’aide du transfert côté serveur (SSF). Le transfert côté serveur transmet les données de demande Adobe Analytics à l’Audience Manager. Une implémentation du SDK Web Platform transmet les données XDM envoyées à l’Edge Network Platform à Audience Manager. L’Audience Manager est activée dans le flux de données :

  1. Accédez à l’interface Collecte de données

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

  3. Sélectionnez le flux de données Luma Web SDK: Development Environment créé précédemment.

    Sélectionnez la banque de données du SDK Web Luma

  4. Sélectionnez Ajouter un service
    Ajouter un service à la banque de données

  5. Sélectionnez Adobe Audience Manager comme Service

  6. Confirmez que les destinations de cookie activées et destinations d’URL activées sont sélectionnées

  7. Sélectionnez Save
    Confirmez les paramètres du flux de données d’Audience Manager et enregistrez

Création d’une source de données

Créez ensuite un Source de données, un outil fondamental pour organiser les données dans l’Audience Manager :

  1. Accédez à l'interface Audience Manager

  2. Sélectionnez Données d’audience dans la barre de navigation supérieure.

  3. Sélectionnez les sources de données dans le menu déroulant.

  4. Sélectionnez le bouton Ajouter nouveau dans la partie supérieure de la page Sources de données.

    Sources de données d’Audience Manager Adobe Experience Platform

  5. Attribuez un nom et une description conviviaux à Data Source. Pour la configuration initiale, vous pouvez nommer cet Platform Web SDK tutorial.

  6. Définissez Type d’ID sur Cookie

  7. Dans la section Contrôles des exportations de données, sélectionnez Aucune restriction

    Configuration de Source de données d’Audience Manager Adobe Experience Platform

  8. Enregistrer le Source de données

Création d’une caractéristique

Une fois le Source de données enregistré, configurez une caractéristique. Les caractéristiques sont une combinaison d’un ou de plusieurs signaux en Audience Manager. Créez une caractéristique pour les visiteurs de la page d’accueil.

NOTE
Toutes les données XDM sont envoyées à l’Audience Manager si elles sont activées dans le flux de données. Toutefois, les données peuvent prendre 24 heures jusqu’à ce qu’elles soient disponibles dans le rapport Signaux non utilisés. Créez des caractéristiques explicites pour les données XDM que vous souhaitez utiliser immédiatement en Audience Manager, comme décrit dans cet exercice.

  1. Sélectionnez Données d’audience > Caractéristiques

  2. Sélectionnez la caractéristique Add New > Rule-Based

    Caractéristique basée sur des règles d’Audience Manager Adobe Experience Platform

  3. Donnez un nom et une description conviviaux à votre caractéristique, Luma homepage view

  4. Sélectionnez le Source de données que vous avez créé dans la section précédente.

  5. Sélectionnez un dossier dans lequel enregistrer votre caractéristique dans le volet de droite. Vous pouvez créer un dossier en sélectionnant l’icône + en regard d’un dossier parent existant. Vous pouvez nommer ce nouveau dossier Platform Web SDK tutorial.

  6. Développez le signe d’insertion Expression de caractéristique et sélectionnez Générateur d’expression. Vous devez fournir une paire de valeurs de clé qui correspond à une visite de page d’accueil.

  7. Ouvrez la page d’accueil Luma (mappée à la propriété de balise) et l’ Adobe Experience Platform Debugger et actualisez la page.

  8. Consultez les requêtes réseau et les détails de l’événement pour le SDK Web Platform afin de trouver la clé et la valeur de nom de la page d’accueil.
    Adobe Experience Platform Audience Manager XDM Data

  9. Revenez au Générateur d’expression dans l’interface utilisateur d’Audience Manager et saisissez la clé web.webPageDetails.name et la valeur content:luma:us:en. Cette étape vous permet de déclencher une caractéristique chaque fois que vous chargez la page d’accueil.

  10. Enregistrez la caractéristique.

Création d’un segment

Les étapes suivantes consistent à créer un segment et à affecter votre caractéristique nouvellement définie à ce segment.

  1. Sélectionnez Données d’audience dans le volet de navigation supérieur et sélectionnez Segments

  2. Sélectionnez Ajouter nouveau dans le coin supérieur gauche de la page pour ouvrir le créateur de segments.

  3. Attribuez à votre segment un nom et une description conviviaux, tels que Platform Web SDK - Homepage visitors

  4. Sélectionnez un dossier où votre segment est enregistré dans le volet de droite. Vous pouvez créer un dossier en sélectionnant l’icône + en regard d’un dossier parent existant. Vous pouvez nommer ce nouveau dossier Platform Web SDK tutorial.

  5. Ajoutez un code d’intégration, qui dans ce cas est un jeu aléatoire de nombres.

  6. Dans la section Source de données, sélectionnez Audience Manager et la source de données que vous avez créée précédemment

  7. Développez la section Caractéristiques et recherchez la caractéristique que vous avez créée.

  8. Sélectionnez Ajouter une caractéristique.

  9. Sélectionnez Enregistrer au bas de la page.

    Adobe Experience Platform Audience Manager Add Trait

    Adobe Experience Platform Audience Manager Add Trait

Créer une destination

Créez ensuite une destination basée sur un cookie à l’aide du créateur de destinations. Le créateur de destinations vous permet de créer et de gérer des destinations de cookie, d’URL et de serveur à serveur.

  1. Ouvrez le créateur de destinations en sélectionnant Destinations dans le menu Données d’audience dans la barre de navigation supérieure.

  2. Sélectionnez Créer une destination

  3. Saisissez un nom et une description, Platform Web SDK tutorial

  4. En tant que Catégorie, sélectionnez Personnalisé

  5. Comme Type, sélectionnez Cookie

    Adobe Experience Platform Audience Manager Add Trait

  6. Ouvrez la section Configuration pour saisir les détails sur votre destination de cookie.

  7. Attribuez un nom convivial à votre cookie, platform_web_sdk_tutorial

  8. En tant que domaine du cookie, ajoutez le domaine du site sur lequel vous envisagez d’intégrer, pour le tutoriel, saisissez le domaine Luma luma.enablementadobe.com.

  9. En tant qu'option Publish data to , sélectionnez Uniquement les domaines sélectionnés

  10. Sélectionnez votre domaine s’il n’a pas déjà été ajouté

  11. En tant que format de données, sélectionnez clé unique et attribuez une clé à votre cookie. Pour ce tutoriel, utilisez segment comme valeur de clé.

  12. Enfin, sélectionnez Enregistrer pour enregistrer les détails de configuration de destination.

    Section de configuration de la destination de l’Audience Manager

  13. Dans la section Mappages de segments, utilisez la fonction Rechercher et ajouter des segments pour rechercher les Platform Web SDK - Homepage visitors que vous avez créés précédemment et sélectionnez Ajouter.

  14. Une fois que vous avez ajouté votre segment, une fenêtre contextuelle s’ouvre dans laquelle vous devez fournir une valeur attendue pour votre cookie. Pour cet exercice, saisissez la valeur "hpvisitor".

  15. Sélectionnez Save

  16. Sélectionnez Done
    Adobe Experience Platform Audience Manager Add Trait

La période de mappage des segments nécessite quelques heures pour être activée. Une fois l’opération terminée, vous pouvez actualiser l’interface d’Audience Manager et voir la liste Segments mappés mise à jour.

Validation du segment

Quelques heures après la création initiale du segment, vous pouvez vérifier qu’il fonctionne correctement.

Tout d’abord, vérifiez que vous pouvez être admissible pour le segment.

  1. Ouvrez la page d’accueil du site de démonstration Luma avec celle-ci mappée à la propriété de balise pour que le segment que vous venez de créer soit admissible.

  2. Ouvrez l’onglet Outils de développement > Réseau de votre navigateur

  3. Filtrer sur la requête SDK Web Platform en utilisant interact comme filtre de texte

  4. Sélectionnez un appel et ouvrez l’onglet Aperçu pour afficher les détails de la réponse.

  5. Développez la payload pour afficher les détails de cookie attendus, tels que précédemment configurés dans Audience Manager. Dans cet exemple, le nom de cookie attendu est platform_web_sdk_tutorial.

    Adobe Experience Platform Audience Manager Add Trait

  6. Ouvrez l’onglet Application et ouvrez Cookies dans le menu Stockage.

  7. Sélectionnez le domaine https://luma.enablementadobe.com et vérifiez que votre cookie est correctement écrit dans la liste.

    Adobe Experience Platform Audience Manager Add Trait

Enfin, vous devez ouvrir le segment dans l’interface d’Audience Manager et vous assurer que les populations de segments ont été incrémentées :

Adobe Experience Platform Audience Manager Add Trait

Maintenant que vous avez terminé cette leçon, vous devriez être en mesure de voir comment le SDK Web Platform transmet les données à l’Audience Manager et peut définir un cookie propriétaire spécifique au segment avec une destination de cookie.

Suivant :

NOTE
Merci d’avoir consacré du temps à l’apprentissage du SDK Web Adobe Experience Platform. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu à venir, partagez-les sur cet post de discussion de la communauté Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4