DocumentationExperience PlatformTutoriel web

Ajout d’Adobe Experience Platform Identity Service

Last update: Wed Nov 16 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Beginner
  • Intermediate
  • Developer

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

Adobe Experience Platform Identity Service définit un identifiant visiteur commun à toutes les solutions Adobe afin de renforcer 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 Identity Service ;
  • 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 Configuration des balises .

Ajout de l’extension Identity Service

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 Identity Service

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

  2. Cliquez sur Catalogue pour accéder au 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 d’Adobe Experience Platform Identity Service, cliquez sur Installer.

    Installation de l’extension Identity Service

  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 comprend 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.

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 à Identity Service 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 Identity Service

  1. Ouvrez le site Luma.

  2. Assurez-vous que le débogueur mappe la propriété de balise à your Environnement de développement, comme décrit dans la section 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 Adobe Experience Platform Identity Service est mise en œuvre.

  5. La demande initiale de récupération de l’identifiant visiteur peut apparaître dans l’onglet Identity Service 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 à Identity Service 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 d’Identity Service, consultez la documentation.

Envoi des ID de client

Ensuite, vous enverrez un ID de client à Identity Service. Cela vous permet d’intégrer votre CRM à Experience Cloud et de suivre les visiteurs sur différents périphériques.

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 champ 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 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 à Identity Service. 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 champ Type d’élément de données, sélectionnez Variable JavaScript.

  4. Pour le champ Nom de variable JavaScript, utilisez le pointeur suivant pour indiquer 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 enregistrement de l’élément de données

    Enregistrez l’élément de données

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

Adobe Experience Platform Identity Service 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 Événements, cliquez sur Ajouter.

    Ajout d’un événement

    1. Dans le champ Type d’événement, sélectionnez Chargé par bibliothèque, haut de page.
    2. Développez l’objet Options avancées et pour la section Commande enter 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 champ Type de condition, sélectionnez Comparaison des 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 État d’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 le Extension select Service d’ID Experience Cloud

    2. Pour le champ Type d’action, sélectionnez Définition des ID de client.

    3. Pour le champ Code d’intégration, saisissez crm_id.

    4. Pour le champ Valeur, saisissez l’option d’ouverture du modal du sélecteur d’élément de données et sélectionnez Email (Hashed).

    5. Pour le champ É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 à your Environnement de développement, comme décrit dans la section leçon précédente

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

  3. Cliquez sur CONNEXION 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 Connexion.

    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 qu’Identity Service 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 Adobe Experience Platform Identity Service.

  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 au Outils dans le débogueur et activez l’option Journalisation de la console des balises bascule.

Activation de 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