setConsent

La commande setConsent indique au SDK Web s’il doit envoyer des données (opt-in), ignorer des données (opt-out) ou utiliser defaultConsent (consentement inconnu).

Le SDK Web prend en charge les normes suivantes :

Après avoir utilisé cette commande, le SDK Web écrit les préférences de l’utilisateur dans un cookie. La prochaine fois que l’utilisateur charge votre site web dans le navigateur, le SDK récupère ces préférences persistantes pour déterminer si des événements peuvent être envoyés à Adobe.

Adobe vous recommande de stocker les préférences de boîte de dialogue de consentement séparément de celles du consentement du SDK Web. Le SDK Web ne permet pas de récupérer le consentement. Pour vous assurer que les préférences de l’utilisateur restent synchronisées avec le SDK, vous pouvez appeler la commande setConsent à chaque chargement de page. Le SDK Web effectue uniquement un appel au serveur lorsque le consentement est modifié.

Le SDK Web propose deux commandes de configuration de consentement complémentaires :

  • defaultConsent : cette commande est destinée à capturer les préférences de consentement des clients Adobe utilisant le SDK Web.
  • setConsent : cette commande est destinée à capturer les préférences de consentement des visiteurs de votre site.

Lorsqu’ils sont utilisés ensemble, ces paramètres peuvent donner lieu à différents résultats de collecte de données et de définition des cookies, selon leurs valeurs configurées.

Consultez le tableau ci-dessous pour savoir quand se produit la collecte de données et quand les cookies sont définis, en fonction des paramètres de consentement.

defaultConsent
setConsent
Collecte de données
Le SDK Web définit les cookies de navigateur.
in
in
Oui
Oui
in
out
Non
Oui
in
Non défini
Oui
Oui
pending
in
Oui
Oui
pending
out
Non
Oui
pending
Non défini
Non
Non
out
in
Oui
Oui
out
out
Non
Oui
out
Non défini
Non
Non

Les cookies suivants sont définis lorsque la configuration du consentement permet :

Nom
Âge max.
Description
AMCV_###@AdobeOrg
34128000 (395 jours)
Présent lorsque idMigrationEnabled est activé. Cela s’avère utile lors de la transition vers le SDK Web alors que certaines parties du site utilisent toujours visitor.js.
Cookie Demdex
15552000 (180 jours)
Présent si la synchronisation des identifiants est activée. L’Audience Manager définit ce cookie afin d’affecter un identifiant unique à un visiteur du site. Le cookie demdex permet à Audience Manager d’exécuter des fonctions de base, telles que l’identification des visiteurs, la synchronisation des identifiants, la segmentation, la modélisation, la création de rapports, etc.
kndctr_orgid_cluster
1800 (30 minutes)
Stocke la région de l’Edge Network qui sert les requêtes de l’utilisateur actuel. La région est utilisée dans le chemin de l’URL afin que l’Edge Network puisse acheminer la requête vers la région appropriée. Si un utilisateur se connecte à une autre adresse IP ou lors d’une autre session, la demande est de nouveau acheminée vers la région la plus proche.
kndct_orgid_identity
34128000 (395 jours)
Stocke l’ECID, ainsi que d’autres informations relatives à l’ECID.
kndctr_orgid_consent
15552000 (180 jours)
Stocke les préférences de consentement des utilisateurs pour le site web.
s_ecid
63115200 (2 ans)
Contient une copie de l’ID Experience Cloud (ECID) ou MID. Le MID est stocké dans une paire clé-valeur qui suit la syntaxe suivante, s_ecid=MCMID|<ECID>.

Définition du consentement à l’aide de l’extension de balise SDK Web

La définition du consentement est effectuée en tant qu’action dans une règle dans l’interface des balises de collecte de données Adobe Experience Platform.

  1. Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
  2. Accédez à Collecte de données > Balises.
  3. Sélectionnez la propriété de balise de votre choix.
  4. Accédez à Rules, puis sélectionnez la règle de votre choix.
  5. Sous Actions, sélectionnez une action existante ou créez une action.
  6. Définissez le champ déroulant Extension sur SDK Web Adobe Experience Platform et définissez le Type d’action sur Définir le consentement.
  7. Définissez les champs de votre choix à droite, y compris Standard et Consentement général.
  8. Cliquez sur Conserver les modifications, puis exécutez votre processus de publication.

Vous pouvez inclure plusieurs objets de consentement dans cette action.

Définition du consentement à l’aide de la bibliothèque JavaScript du SDK Web

Exécutez la commande setConsent lors de l’appel de votre instance configurée du SDK Web. Vous pouvez inclure les objets suivants dans cette commande :

  • consent[] : un tableau d’objets consent. L’objet de consentement est formaté différemment selon la norme et la version que vous choisissez. Consultez les onglets ci-dessous pour obtenir des exemples de chaque objet de consentement, selon la norme de consentement.
  • identityMap : objet contrôlant la manière dont un ECID est généré et les informations de consentement des identifiants sont liées. Adobe recommande d’inclure cet objet lorsque setConsent est exécuté avant d’autres commandes, telles que sendEvent.
  • edgeConfigOverrides : un objet qui contient la configuration du flux de données remplace.
Adobe 2.0

Si vous utilisez Adobe Experience Platform, vous devez inclure un groupe de champs de schéma de confidentialité dans votre schéma de profil. Voir Gouvernance, confidentialité et sécurité dans Adobe Experience Platform pour plus d’informations sur la norme Adobe 2.0. Vous pouvez ajouter des données dans l’objet de valeur ci-dessous correspondant au schéma du champ consents du groupe de champs de profil Contenus et Préférences.

  • standard : la norme de consentement que vous choisissez. Définissez cette propriété sur "Adobe" pour la norme Adobe 2.0.

  • version : chaîne représentant la version de la norme de consentement. Définissez cette propriété sur "2.0" pour la norme Adobe 2.0.

  • value : objet contenant des valeurs de consentement.

    • value.collect.val : valeur du consentement. Définissez-le sur "y" lorsque les utilisateurs s’abonnent et sur "n" lorsque les utilisateurs se désabonnent.
    • value.metadata.time : date et heure de la dernière mise à jour des paramètres de consentement des utilisateurs.
code language-js
// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});
IAB TCF 2.0

Pour enregistrer les préférences de consentement de l’utilisateur fournies par le biais de la norme IAB (Interactive Advertising Bureau Europe) Transparency and Consent Framework (TCF), définissez la chaîne de consentement comme illustré ci-dessous.

Lorsque le consentement est défini de cette manière, le profil client en temps réel est mis à jour avec les informations de consentement. Pour que cela fonctionne, le schéma XDM du profil doit contenir le groupe de champs Confidentialité du profil. Lors de l’envoi d’événements, les informations de consentement de l’IAB doivent être ajoutées manuellement à l’objet XDM d’événement. Le SDK Web n’inclut pas automatiquement les informations de consentement dans les événements.

Pour envoyer les informations de consentement dans les événements, vous devez ajouter le groupe de champs Confidentialité des événements d’expérience à votre schéma XDM ExperienceEvent Profile activé. Consultez la section sur la mise à jour du schéma ExperienceEvent dans le guide de préparation du jeu de données pour savoir comment le configurer.

  • standard : la norme de consentement que vous choisissez. Définissez cette propriété sur "IAB TCF" pour la norme IAB TCF 2.0.
  • version : chaîne représentant la version de la norme de consentement. Définissez cette propriété sur "2.0" pour la norme IAB TCF 2.0.
  • value : chaîne contenant la valeur de consentement.
  • gdprApplies : valeur booléenne qui détermine si le RGPD s’applique à cette valeur de consentement. Sa valeur par défaut est true.
  • gdprContainsPersonalData : valeur booléenne qui détermine si les données d’événement associées à cet utilisateur contiennent des données personnelles. Sa valeur par défaut est false.
code language-js
// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});
Adobe 1.0
  • standard : la norme de consentement que vous choisissez. Définissez cette propriété sur "Adobe" pour la norme Adobe 1.0.
  • version : chaîne représentant la version de la norme de consentement. Définissez cette propriété sur "1.0" pour la norme Adobe 1.0.
  • value.general : valeur du consentement. Définissez-le sur "in" lorsque les utilisateurs s’abonnent et sur "out" lorsque les utilisateurs se désabonnent.
code language-js
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

Envoi de plusieurs normes dans une même requête multiple-standards

Le SDK Web prend également en charge l’envoi de plusieurs objets de consentement dans une requête, comme illustré dans l’exemple ci-dessous.

alloy("setConsent", {
    consent: [{
        standard: "Adobe",
        version: "2.0",
        value: {
            collect: {
                val: "y"
            },
            metadata: {
                time: "2021-03-17T15:48:42-07:00"
            }
        }
    }, {
        standard: "IAB TCF",
        version: "2.0",
        value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
        gdprApplies: true
    }]
});

Persistance des préférences de consentement persistence

Après avoir communiqué les préférences de l’utilisateur au SDK Web à l’aide de la commande setConsent, le SDK conserve les préférences de l’utilisateur dans un cookie. La prochaine fois que l’utilisateur charge votre site web dans le navigateur, le SDK Web récupère et utilise ces préférences persistantes pour déterminer si des événements peuvent être envoyés à Adobe.

Vous devrez stocker les préférences de l’utilisateur indépendamment pour pouvoir afficher la boîte de dialogue de consentement avec les préférences actuelles. Il n’est pas possible de récupérer les préférences de l’utilisateur à partir du SDK Web. Pour vous assurer que les préférences de l’utilisateur restent synchronisées avec le SDK, vous pouvez appeler la commande setConsent à chaque chargement de page. Le SDK Web effectue un appel au serveur uniquement si les préférences ont changé.

Synchronisation des identités lors de la définition du consentement sync-identities

Lorsque le consentement par défaut (défini par le biais du paramètre defaultConsent ) est défini sur pending ou out, le paramètre setConsent peut être la première requête qui émet et établit l’identité. Il peut donc être important de synchroniser les identités lors de la première requête. Vous pouvez ajouter le mappage d’identité à la commande setConsent comme sur la commande sendEvent. Voir Utilisation d’identityMap pour obtenir un exemple d’inclusion de identity map dans votre commande.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636