DocumentationExperience PlatformTutoriel web

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

Last update: Tue Jul 16 2024 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 service Adobe Experience Platform Identity définit un identifiant visiteur commun à toutes les solutions d’Adobe afin d’alimenter les fonctionnalités 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é 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 :

  • 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 devez avoir 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 de faire.

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. Laissez 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 qui est indiqué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 Identity Service est l’une des rares extensions de balise qui émet une requête sans avoir à utiliser une 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 à l’environnement de développement votre, comme décrit dans la leçon précédente.

  3. Dans l’onglet Résumé du débogueur, la section des balises doit indiquer que l’extension Adobe Experience Platform Identity Service est mise en oeuvre.

  4. En outre, dans l’onglet Résumé, la section Identity Service doit renseigner le même ID d’organisation que celui affiché 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. Vous pouvez en voir plusieurs puisque le site Luma a été chargé à l’aide de sa propriété de balise codée en dur et mappée sur la 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 Data Elements 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 Open Editor

    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 de créer une version tant que nous n’avons pas apporté toutes nos modifications et que nous n’avons pas été prêts à 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. En tant que 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 aura une commande de "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 Events, cliquez sur Add

    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 la 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 le modal d’élément de données, cliquez sur Authentication State , puis sur Select

      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 Experience Cloud ID Service

    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 le Valeur, saisissez l’option modale du sélecteur d’éléments de données et sélectionnez l’ Email (Hashed).

    5. Pour l’ é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 à l’environnement de développement votre, 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 LOGIN dans le coin supérieur droit du site Luma.

    Clic sur Connexion dans le volet de navigation supérieur

  4. Saisissez test@adobe.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 disposent également de fonctions de journalisation de la console enrichies. Pour les activer, accédez à l’onglet Outils dans le débogueur et activez le bouton d’activation/désactivation de la journalisation de la console.

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 : "Ajout d’Adobe Target" >

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