DocumentationExperience PlatformTutoriel web

Ajout du service d’identités d’Adobe Experience Platform

Last update: Thu Jun 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

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

Cette leçon vous guidera tout au long des étapes requises pour mettre en œuvre l’extension Service d’identités d’Adobe Experience Platforme et envoyer des ID de client.

Le Adobe Experience Platform Identity Service définit un identifiant visiteur commun à toutes les solutions Adobe afin d’alimenter les fonctionnalités d’Experience Cloud telles que le partage d’audience entre les solutions. Vous pouvez aussi envoyer vos propres ID de client au service pour permettre un ciblage entre appareils et des intégrations supplémentaires avec votre système de gestion de la relation client (CRM).

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é déployées dans l’interface. Vous devez en être conscient lors de l’utilisation de ce contenu :
  • Platform Launch (côté client) est désormais tags
  • 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 :

  • Ajouter l’extension Service d’identités
  • créer un élément de données pour recueillir vos ID de client ;
  • créer une règle qui utilise l’action « Définition des ID de client » pour envoyer les ID de client à Adobe;
  • utiliser la fonction d’agencement des règles pour séquencer des règles qui se déclenchent sur le même événement.

Conditions préalables

Vous devriez avoir déjà terminé les leçons de la section Configurer les balises.

Ajouter l’extension Service d’identités

Puisqu’il s’agit de la première extension que vous ajoutez, voici un résumé rapide de ce que sont les extensions. Les extensions sont l’une des principales fonctionnalités des balises. Une extension est une intégration construite par Adobe, ses partenaires ou ses clients et qui ajoute un nombre illimité de nouvelles options pour les balises que vous pouvez déployer sur vos sites web. Si vous considérez les balises comme un système d’exploitation, les extensions sont les applications que vous installez afin que les balises puissent faire ce que vous avez besoin qu’elles fassent.

Ajout de l’extension Service d’identités

  1. Dans le volet de navigation de gauche, cliquez sur Extensions

  2. Cliquez sur Catalogue pour accéder à la page Catalogue des extensions

  3. Notez que de nombreuses extensions sont disponibles dans le catalogue.

  4. Dans la partie supérieure, dans les filtres, saisissez « id » pour filtrer les extensions.

  5. Sur la carte du service Adobe Experience Platform Identity, cliquez sur Installer

    Installation de l’extension Service d’identités

  6. Notez que votre ID d’organisation Experience Cloud a été automatiquement détecté.

  7. Conservez tous les paramètres par défaut et cliquez sur Enregistrer dans la bibliothèque et créer

    Enregistrement de l’extension

NOTE
Chaque version de l’extension Identity Service est fournie avec une version spécifique de VisitorAPI.js, mentionnée dans la description de l’extension. La version de VisitorAPI.js est mise à jour en même temps que l’extension Service d’identités.

Validation de l’extension

L’extension Service d’identités est l’une des rares extensions de balise qui effectue une requête sans avoir à utiliser d’action de règle. L’extension émet automatiquement une requête au service dʼidentités lors du premier chargement de page à l’occasion de la première consultation d’un site web. Une fois l’identifiant demandé, il est stocké dans un cookie propriétaire commençant par « AMCV_ ».

Validation de l’extension Service d’identités

  1. Ouvrez le site Luma.

  2. Assurez-vous que le débogueur mappe la propriété de balise sur votre environnement de développement, comme décrit dans la leçon précédente.

  3. Dans l’onglet Résumé de Debugger, la section sur les balises doit indiquer que l’extension du service d’identités Adobe Experience Platform est implémentée.

  4. En outre, dans l’onglet Résumé , la section Service d’identités doit être renseignée avec le même ID d’organisation que celui qui se trouvait sur l’écran de configuration de votre extension dans l’interface de collecte de données :

    Vérifiez que l’extension Service d’identités d’Adobe Experience Platform est mise en œuvre.

  5. La demande initiale de récupération de l’identifiant visiteur peut apparaître dans l’onglet Service dʼidentités du débogueur. Il se peut néanmoins qu’il ait déjà été demandé, donc ne vous inquiétez pas si vous ne le voyez pas :
    Vérifiez s’il existe une demande adressée au service d’identités avec votre ID d’organisation.

  6. Après la demande initiale visant à récupérer l’identifiant visiteur, l’ID est stocké dans un cookie dont le nom commence par AMCV_. Vous pouvez vérifier que le cookie a été défini en procédant comme suit :

    1. Ouvrez les outils de développement de votre navigateur.

    2. Accédez à l’onglet Application.

    3. Développez l’élément Cookies sur la gauche

    4. Cliquez sur le domaine https://luma.enablementadobe.com

    5. Recherchez le cookie AMCV_ sur la droite. Il se peut que vous en voyiez plusieurs depuis avoir chargé le site Luma à l’aide de sa propriété de balise codée en dur et mappé le vôtre.

      Vérifiez le cookie AMCV_

Vous avez terminé. Vous avez ajouté votre première extension ! Pour plus d’informations sur les options de configuration du service d’identités, consultez la documentation.

Envoi des ID de client

Ensuite, vous enverrez un ID de client au service d’identités. Cela vous permet d’intégrer votre CRM à Experience Cloud et de suivre les visiteurs sur différents appareils.

Dans une leçon précédente, Ajout d’éléments de données, de règles et de bibliothèques, vous avez créé un élément de données et vous l’avez utilisé dans une règle. Maintenant, vous allez utiliser ces mêmes techniques pour envoyer un ID de client lorsque le visiteur est authentifié.

Créer des éléments de données pour des ID de client

Commencez par créer deux éléments de données :

  1. Authentication State : pour savoir si le visiteur est connecté ou non.
  2. Email (Hashed) : pour capturer la version hachée de l’adresse e-mail (utilisée comme ID de client) à partir de la couche de données.

Création de l’élément de données pour l’état d’authentification

  1. Cliquez sur Éléments de données dans le volet de navigation de gauche

  2. Cliquez sur le bouton Ajouter un élément de données

    Cliquez sur « Ajouter un élément de données » .

  3. Nommez l’élément de données Authentication State.

  4. Pour le Type d’élément de données, sélectionnez Code personnalisé

  5. Cliquez sur le bouton Ouvrir l’éditeur

    Ouvrez l’éditeur pour ajouter le code personnalisé de l’élément de données.

  6. Dans la fenêtre Modifier le code, utilisez le code suivant pour renvoyer les valeurs de « connecté » ou « déconnecté » en fonction d’un attribut de la couche de données du site Luma :

    code language-javascript 
    if (digitalData.user[0].profile[0].attributes.loggedIn)
    return "logged in"
else
    return "logged out"

  7. Cliquez sur Enregistrer pour enregistrer le code personnalisé

    Enregistrez le code personnalisé

  8. Conservez tous les autres paramètres à leurs valeurs par défaut.

  9. Cliquez sur Enregistrer dans la bibliothèque pour enregistrer l’élément de données et revenir à la page des éléments de données. Nous n’aurons pas besoin d’effectuer une « version » tant que nous n’aurons pas apporté toutes nos modifications et que nous ne serons pas prêts à les valider.

    Enregistrez l’élément de données

En connaissant l’état d’authentification de l’utilisateur, vous savez quand un ID de client doit exister sur la page à envoyer au service d’identités. L’étape suivante consiste à créer un élément de données pour l’ID de client lui-même. Sur le site de démonstration Luma, vous allez utiliser la version hachée de l’adresse e-mail du visiteur.

Ajout de l’élément de données pour le courrier électronique haché

  1. Cliquez sur le bouton Ajouter un élément de données

    Ajouter un élément de données

  2. Nommez l’élément de données Email (Hashed).

  3. Pour le Type d’élément de données, sélectionnez Variable JavaScript ​

  4. Comme nom de variable JavaScript, utilisez le pointeur suivant vers une variable dans la couche de données du site Luma : digitalData.user.0.profile.0.attributes.username

  5. Conservez tous les autres paramètres à leurs valeurs par défaut.

  6. Cliquez sur Enregistrer dans la bibliothèque pour enregistrer l’élément de données

    Enregistrez l’élément de données

Ajout d’une règle pour envoyer des ID de client

Le service d’identités d’Adobe Experience Platform transmet les ID de client dans les règles à l’aide d’une action appelée « Définition des ID de client ». Vous allez maintenant créer une règle pour déclencher cette action lorsque le visiteur est authentifié.

Ajout d’une règle pour envoyer des ID de client

  1. Dans le volet de navigation de gauche, cliquez sur Règles

  2. Cliquez sur Ajouter une règle pour ouvrir le Créateur de règles

    Ajouter une règle

  3. Donnez à la règle le nom All Pages - Library Loaded - Authenticated - 10.

    note tip
    TIP
    Cette convention d’affectation des noms indique que vous déclenchez cette règle en haut de toutes les pages lorsque l’utilisateur est authentifié et qu’elle est classée par « 10 ». L’utilisation d’une convention d’affectation des noms comme celle-ci au lieu de l’affecter aux solutions déclenchées dans les actions vous permettra de minimiser le nombre total de règles nécessaires à votre mise en œuvre.

  4. Sous Événements cliquez sur Ajouter

    Ajout d’un événement

    1. Pour le Type d’événement sélectionnez Bibliothèque chargée (haut de page)
    2. Développez la section Options avancées et, pour le champ Commande, saisissez 10. La commande contrôle la séquence de règles déclenchées par le même événement. Les règles dont la commande est plus faible se déclenchent avant les règles dont la commande est plus élevée. Dans ce cas, vous souhaitez définir l’ID de client avant de déclencher la requête, ce que vous allez faire lors de la leçon suivante avec une règle dont la commande est de 50.
    3. Cliquez sur le bouton Conserver les modifications pour revenir au Créateur de règles

    Enregistrement de l’événement

  5. Sous Conditions cliquez sur Ajouter

    Ajout d’une condition à la règle

    1. Pour le Type de condition sélectionnez Comparaison de valeurs

    2. Cliquez sur l’icône icône d’élément de données pour ouvrir le modal d’élément de données.

      Ouvrir le modal d’élément de données

    3. Dans la boîte de dialogue modale Élément de données, cliquez sur État de l’authentification puis sur Sélectionner

      Définir l’état d’authentification

  6. Assurez-vous que l’opérateur est Equals.

  7. Saisissez « connecté » dans le champ de texte, ce qui entraîne le déclenchement de la règle lorsque l’élément de données « État d’authentification » a la valeur « connecté ».

  8. Cliquez sur Conserver les modifications

    Enregistrement de la condition

  9. Sous Actions cliquez sur Ajouter

    Ajout d’une nouvelle action

    1. Pour l’Extension sélectionnez Service Experience Cloud ID

    2. Pour le Type d’action sélectionnez Définir les ID de client

    3. Pour le code d’intégration saisissez crm_id

    4. Pour la Valeur saisissez la boîte de dialogue modale Ouvrir le sélecteur d’éléments de données et sélectionnez la Email (Hashed)

    5. Pour le État d’authentification sélectionnez Authentifié

    6. Cliquez sur le bouton Conserver les modifications pour enregistrer l’action et revenir au Créateur de règles

      Configuration de l’action et enregistrement des modifications

  10. Cliquez sur le bouton Enregistrer dans la bibliothèque et créer pour enregistrer la règle

    Enregistrement de la règle

Vous avez maintenant créé une règle qui enverra l’ID de client sous forme de variable crm_id lorsque le visiteur est authentifié. Puisque vous avez spécifié une commande de 10, cette règle se déclenchera avant votre règle All Pages - Library Loaded créée dans la leçon Ajout d’éléments de données, de règles et de bibliothèques, qui utilise la commande par défaut de 50.

Validation des ID de client

Pour valider votre travail, vous devez vous connecter au site Luma pour confirmer le comportement de la nouvelle règle.

Connexion au site Luma

  1. Ouvrez le site Luma.

  2. Assurez-vous que le débogueur mappe la propriété de balise sur votre environnement de développement, comme décrit dans la leçon précédente

    Votre environnement de développement de balises affiché dans Debugger

  3. Cliquez sur le lien CONNEXION dans le coin supérieur droit du site Luma

    Clic sur Connexion dans le volet de navigation supérieur

  4. Saisissez test@test.com comme nom d’utilisateur.

  5. Saisissez test comme mot de passe.

  6. Cliquez sur le bouton LOGIN

    Entrez les informations d’identification et cliquez sur le bouton de connexion

  7. Revenez à la page d’accueil.

Vérifiez ensuite que l’ID de client est envoyé au service à l’aide de l’extension Debugger.

Vérifier que le service d’identités transmet l’ID de client

  1. Assurez-vous que l’onglet avec le site Luma est bien ciblé.

  2. Dans Debugger, accédez à l’onglet Service d’identités d’Adobe Experience Platform.

  3. Développez votre ID d’organisation.

  4. Cliquez sur la cellule avec la valeur Customer ID - crm_id.

  5. Dans le modal, notez la valeur de l’ID de client et vérifiez que l’état AUTHENTICATED est reflété :

    Vérification de l’ID de client dans Debugger

  6. Notez que vous pouvez confirmer la valeur de l’e-mail haché en affichant le code source de la page Luma et en observant la propriété username. Elle doit correspondre à la valeur affichée dans Debugger :

    Adresse e-mail hachée dans le code source

Autres conseils de validation

Les balises offrent également de riches fonctionnalités de journalisation de la console. Pour les activer, accédez à l’onglet Outils dans Debugger, puis activez le bouton (bascule) Journalisation de la console des balises.

Activer/désactiver la journalisation de la console des balises

Cela permet d’activer la journalisation de la console, à la fois dans la console de votre navigateur et dans l’onglet Journaux du débogueur. Vous devriez voir la journalisation de toutes les règles que vous avez créées jusqu’à présent. Notez que de nouvelles entrées de journal sont ajoutées dans la partie supérieure de la liste. Dès lors, votre règle « Toutes les pages - Bibliothèque chargée - Authentifiée - 10 » doit se déclencher avant la règle « Toutes les pages - Bibliothèque chargée » et apparaît en dessous de celle-ci dans la journalisation de la console du débogueur :

Onglet Journaux du débogueur

Suite : « Ajouter Adobe Target » >

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