Intégrer le SDK Web Platform pour traiter les données de consentement du client

Le SDK Web de Adobe Experience Platform vous permet de récupérer les signaux de consentement des clients générés par les plateformes de gestion du consentement (CMP) et de les envoyer à Adobe Experience Platform chaque fois qu’un événement de modification du consentement se produit.

Le SDK n’interface pas avec les CMP prêtes à l’emploi.. C’est à vous de déterminer comment intégrer le SDK à votre site web, écouter les modifications apportées au consentement dans la CMP et appeler la commande appropriée. Ce document fournit des instructions générales sur la manière d’intégrer votre CMP au SDK Web de Platform.

Conditions préalables

Ce tutoriel suppose que vous avez déjà déterminé comment générer des données de consentement dans votre CMP et que vous avez créé un jeu de données contenant des champs de consentement conformes à la norme Adobe ou à la norme IAB Transparency and Consent Framework (TCF) 2.0. Si vous n’avez pas encore créé ce jeu de données, reportez-vous aux tutoriels suivants avant de revenir à ce guide :

Ce guide suit le processus de configuration du SDK à l’aide de l’extension de balise dans l’interface utilisateur. Si vous ne souhaitez pas utiliser l’extension et que vous préférez incorporer directement la version autonome du SDK sur votre site, reportez-vous aux documents suivants au lieu de ce guide :

Les étapes d’installation de ce guide nécessitent une compréhension pratique des extensions de balise et de leur installation dans les applications web. Pour plus d’informations, consultez la documentation suivante :

Configuration d’un flux de données

Pour que le SDK envoie des données à l’Experience Platform, vous devez d’abord configurer un flux de données. Dans l’interface utilisateur de la collecte de données ou l’interface utilisateur Experience Platform, sélectionnez Datastreams dans le volet de navigation de gauche.

Après avoir créé un nouveau flux de données ou sélectionné un flux existant à modifier, cliquez sur le bouton de basculement en regard de Adobe Experience Platform. Ensuite, utilisez les valeurs répertoriées ci-dessous pour remplir le formulaire.

Champ de flux de données Valeur
Sandbox Nom de la plateforme sandbox qui contient la connexion en continu et les jeux de données requis pour configurer le flux de données.
Inlet de diffusion en continu Une connexion en continu valide pour l’Experience Platform. Voir le tutoriel sur création d’une connexion en continu si vous n’avez pas d’inlet de diffusion en continu existant.
Jeu de données d’événement Un XDM ExperienceEvent jeu de données que vous prévoyez d’envoyer des données d’événement à à l’aide du SDK. Bien que vous soyez tenu de fournir un jeu de données d’événement pour créer un flux de données Platform, notez que les données de consentement envoyées par le biais d’événements ne sont pas honorées dans les workflows d’application en aval.
Jeu de données de profil Le ProfileJeu de données activé avec les champs de consentement du client que vous avez créés previous.

Lorsque vous avez terminé, sélectionnez Enregistrer en bas de l’écran et continuez à suivre les autres invites pour terminer la configuration.

Installation et configuration du SDK Web de Platform

Une fois que vous avez créé un flux de données comme décrit dans la section précédente, vous devez configurer l’extension SDK Web Platform que vous allez déployer sur votre site. Si l’extension SDK n’est pas installée sur la propriété de balise, sélectionnez Extensions dans le volet de navigation de gauche, suivi de la fonction Catalogue . Sélectionnez ensuite Installer sous l’extension SDK Platform dans la liste des extensions disponibles.

Lors de la configuration du SDK, sous Configurations d’Edge, sélectionnez le flux de données que vous avez créé à l’étape précédente.

Sélectionner Enregistrer pour installer l’extension .

Création d’un élément de données pour définir le consentement par défaut

Une fois l’extension SDK installée, vous avez la possibilité de créer un élément de données représentant la valeur de consentement de collecte de données par défaut (collect.val) pour vos utilisateurs. Cela peut s’avérer utile si vous souhaitez avoir différentes valeurs par défaut en fonction de l’utilisateur, telles que pending pour les utilisateurs de l’Union européenne et in pour les utilisateurs nord-américains.

Dans ce cas d’utilisation, vous pouvez mettre en oeuvre les éléments suivants pour définir le consentement par défaut en fonction de la région de l’utilisateur :

  1. Déterminez la région de l’utilisateur sur le serveur web.
  2. Avant le script (code incorporé) sur la page web, effectue le rendu d’une balise distincte script qui définit une balise adobeDefaultConsent selon la région de l’utilisateur.
  3. Configurez un élément de données qui utilise la variable adobeDefaultConsent et utilisez cet élément de données comme valeur de consentement par défaut pour l’utilisateur.

Si la région de l’utilisateur est déterminée par une CMP, vous pouvez plutôt utiliser les étapes suivantes :

  1. Gérez l’événement "CMP loaded" (Chargé par la CMP) sur la page.
  2. Dans le gestionnaire d’événements, définissez une adobeDefaultConsent selon la région de l’utilisateur, puis chargez le script de bibliothèque de balises à l’aide de JavaScript.
  3. Configurez un élément de données qui utilise la variable adobeDefaultConsent et utilisez cet élément de données comme valeur de consentement par défaut pour l’utilisateur.

Pour créer un élément de données dans l’interface utilisateur, sélectionnez Éléments de données dans le volet de navigation de gauche, puis sélectionnez Ajouter un élément de données pour accéder à la boîte de dialogue de création de l’élément de données.

À partir de là, vous devez créer une Variable JavaScript élément de données basé sur adobeDefaultConsent. Lorsque vous avez terminé, cliquez sur Enregistrer.

Une fois l’élément de données créé, revenez à la page de configuration de l’extension SDK Web. Sous , Confidentialité , sélectionnez Fourni par l’élément de données et utilisez la boîte de dialogue fournie pour sélectionner l’élément de données de consentement par défaut que vous avez créé précédemment.

Déployer l’extension sur votre site web

Une fois que vous avez terminé de configurer l’extension, elle peut être intégrée à votre site web. Reportez-vous à la section guide de publication dans la documentation sur les balises pour obtenir des informations détaillées sur le déploiement de la version de bibliothèque mise à jour.

Exécution de commandes de changement de consentement

Une fois que vous avez intégré l’extension SDK à votre site web, vous pouvez commencer à utiliser le SDK Web Platform. setConsent pour envoyer des données de consentement à Platform.

Le setConsent exécute deux actions :

  1. Met à jour les attributs de profil de l’utilisateur directement dans la banque de profils. Cela n’envoie aucune donnée au lac de données.
  2. Crée une Événement d’expérience qui enregistre un compte horodaté de l’événement de modification du consentement. Ces données sont envoyées directement au lac de données et peuvent être utilisées pour suivre les changements de préférences de consentement au fil du temps.

Quand appeler setConsent

Il existe deux scénarios où setConsent doit être appelé sur votre site :

  1. Lorsque le consentement est chargé sur la page (en d’autres termes, à chaque chargement de page)
  2. Dans le cadre d’un crochet de CMP ou d’un écouteur d’événement qui détecte les modifications apportées aux paramètres de consentement

setConsent syntaxe

REMARQUE

Pour une présentation de la syntaxe commune aux commandes du SDK Platform, consultez le document sur exécution des commandes.

Le setConsent La commande attend deux arguments :

  1. Chaîne indiquant le type de commande (ici : "setConsent")
  2. Objet de payload contenant une seule propriété de type tableau : consent. Le consent Le tableau doit contenir au moins un objet qui fournit les champs de consentement requis pour la norme Adobe.

Les champs de consentement requis pour la norme Adobe sont présentés dans l’exemple suivant : setConsent call:

alloy("setConsent", {
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "2020-10-12T15:52:25+00:00"
      }
    }
  }]
});
Propriété Payload Description
standard La norme de consentement utilisée. Pour la norme Adobe, cette valeur doit être définie sur Adobe.
version Numéro de version de la norme de consentement indiquée sous standard. Cette valeur doit être définie sur 2.0 pour le traitement du consentement standard par Adobe.
value Informations de consentement mises à jour du client, fournies sous la forme d’un objet XDM conforme à la structure des champs de consentement du jeu de données activé par Profile.
REMARQUE

Si vous utilisez d’autres normes de consentement conjointement avec Adobe (par exemple, IAB TCF), vous pouvez ajouter d’autres objets au consent pour chaque standard. Chaque objet doit contenir les valeurs appropriées pour standard, version, et value pour la norme de consentement qu’ils représentent.

Le code JavaScript suivant illustre une fonction qui gère les modifications des préférences de consentement sur un site web, qui peuvent être utilisées comme rappel dans un écouteur d’événement ou un crochet de CMP :

var setConsent = function () {

  // Retrieve the current consent data.
  var categories = getConsentData();

  // If the script is running on a consent change, generate a new timestamp.
  // If the script is running on page load, set the timestamp to when the consent values last changed.
  var now = new Date();
  var collectedAt = consentChanged ? now.toISOString() : categories.collectedAt;

  //  Map the consent values and timestamp to XDM
  var consentXDM = {
    collect: {
      val: categories.collect !== -1 ? "y" : "n"
    },
    personalize: {
      content: {
        val: categories.personalizeContent !== -1 ? "y" : "n"
      }
    },
    share: {
      val: categories.share !== -1 ? "y" : "n"
    },
    metadata: {
      time: collectedAt
    }
  };

  // Pass the XDM object to the Platform Web SDK
  alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: consentXDM
    }]
  });
});

Gestion des réponses du SDK

Tous Platform SDK Les commandes renvoient des promesses indiquant si l’appel a réussi ou échoué. Vous pouvez ensuite utiliser ces réponses pour une logique supplémentaire, telle que l’affichage des messages de confirmation au client. Voir la section sur gestion de la réussite ou de l’échec dans le guide sur l’exécution des commandes du SDK pour des exemples spécifiques.

Une fois que vous avez effectué setConsent avec le SDK, vous pouvez utiliser la visionneuse de profils dans l’interface utilisateur de Platform pour vérifier si les données arrivent dans la banque de profils. Voir la section sur navigation des profils par identité pour plus d’informations.

Étapes suivantes

En suivant ce guide, vous avez configuré l’extension SDK Web Platform pour envoyer des données de consentement à Experience Platform. Pour plus d’informations sur le test de votre mise en oeuvre, reportez-vous à la documentation de la norme de consentement que vous mettez en oeuvre :

Sur cette page