Documentation Experience Platform Tutoriel du SDK web

Configuration de l’Audience Manager avec le SDK Web Platform

Dernière mise à jour : 5 mai 2025

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 :

Accédez à l’interface Collecte de données
Dans le volet de navigation de gauche, sélectionnez Datastreams
Sélectionnez le flux de données Luma Web SDK: Development Environment créé précédemment.
Sélectionnez Ajouter un service
Sélectionnez Adobe Audience Manager comme Service
Confirmez que les destinations de cookie activées et destinations d’URL activées sont sélectionnées
Sélectionnez Save

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 :

Accédez à l'interface Audience Manager
Sélectionnez Données d’audience dans la barre de navigation supérieure.
Sélectionnez les sources de données dans le menu déroulant.
Sélectionnez le bouton Ajouter nouveau dans la partie supérieure de la page Sources de données.
Attribuez un nom et une description conviviaux à Data Source. Pour la configuration initiale, vous pouvez nommer cet Platform Web SDK tutorial.
Définissez Type d’ID sur Cookie
Dans la section Contrôles des exportations de données, sélectionnez Aucune restriction
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.

Sélectionnez Données d’audience > Caractéristiques
Sélectionnez la caractéristique Add New > Rule-Based
Donnez un nom et une description conviviaux à votre caractéristique, Luma homepage view
Sélectionnez le Source de données que vous avez créé dans la section précédente.
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.
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.
Ouvrez la page d’accueil Luma (mappée à la propriété de balise) et l’ Adobe Experience Platform Debugger et actualisez la page.
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.
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.
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.

Sélectionnez Données d’audience dans le volet de navigation supérieur et sélectionnez Segments
Sélectionnez Ajouter nouveau dans le coin supérieur gauche de la page pour ouvrir le créateur de segments.
Attribuez à votre segment un nom et une description conviviaux, tels que Platform Web SDK - Homepage visitors
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.
Ajoutez un code d’intégration, qui dans ce cas est un jeu aléatoire de nombres.
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
Développez la section Caractéristiques et recherchez la caractéristique que vous avez créée.
Sélectionnez Ajouter une caractéristique.
Sélectionnez Enregistrer au bas de la page.

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.

Ouvrez le créateur de destinations en sélectionnant Destinations dans le menu Données d’audience dans la barre de navigation supérieure.
Sélectionnez Créer une destination
Saisissez un nom et une description, Platform Web SDK tutorial
En tant que Catégorie, sélectionnez Personnalisé
Comme Type, sélectionnez Cookie
Ouvrez la section Configuration pour saisir les détails sur votre destination de cookie.
Attribuez un nom convivial à votre cookie, platform_web_sdk_tutorial
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.
En tant qu'option Publish data to , sélectionnez Uniquement les domaines sélectionnés
Sélectionnez votre domaine s’il n’a pas déjà été ajouté
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é.
Enfin, sélectionnez Enregistrer pour enregistrer les détails de configuration de destination.
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.
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".
Sélectionnez Save
Sélectionnez Done

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.

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.
Ouvrez l’onglet Outils de développement > Réseau de votre navigateur
Filtrer sur la requête SDK Web Platform en utilisant interact comme filtre de texte
Sélectionnez un appel et ouvrez l’onglet Aperçu pour afficher les détails de la réponse.
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.
Ouvrez l’onglet Application et ouvrez Cookies dans le menu Stockage.
Sélectionnez le domaine https://luma.enablementadobe.com et vérifiez que votre cookie est correctement écrit dans la liste.

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.

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