setConsent
La variable setConsent
indique au SDK Web s’il doit envoyer des données (inclusion), ignorer des données (exclusion) ou utiliser defaultConsent
(consentement inconnu).
Le SDK Web prend en charge les normes suivantes :
-
Adobe standard: les normes 1.0 et 2.0 sont prises en charge.
-
Structure de transparence et de consentement de l’IAB: si vous utilisez cette norme, le profil client en temps réel du visiteur est mis à jour avec les informations de consentement si votre mise en oeuvre est correctement configurée :
- Le schéma de profil individuel XDM contient la variable Groupe de champs de consentement du TCF 2.0 de l’IAB.
- Le schéma Événement d’expérience contient la variable Groupe de champs de consentement du TCF 2.0 de l’IAB.
- Vous incluez les informations de consentement IAB dans l’événement Objet XDM. Le SDK Web n’inclut pas automatiquement les informations de consentement lors de l’envoi de données d’événement.
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 fonction setConsent
à chaque chargement de page. Le SDK Web effectue uniquement un appel au serveur lorsque le consentement est modifié.
Utilisation defaultConsent
ensemble avec setConsent
using-consent
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.
in
in
in
out
in
pending
in
pending
out
pending
out
in
out
out
out
Les cookies suivants sont définis lorsque la configuration du consentement permet :
idMigrationEnabled
est activée. Cela s’avère utile lors de la transition vers le SDK Web alors que certaines parties du site utilisent toujours visitor.js
.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.
- Connexion à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Règles, puis sélectionnez la règle de votre choix.
- Sous Actions, sélectionnez une action existante ou créez-en une.
- Définissez la variable Extension du champ déroulant vers SDK Web Adobe Experience Platform, puis définissez la variable Type d’action to Définition du consentement.
- Définissez les champs de votre choix à droite, y compris Standard et Consentement général.
- Cliquez sur Conserver les modifications, puis exécutez votre workflow 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 variable 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 deconsent
objets. 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 lors de lasetConsent
est exécuté avant d’autres commandes, telles quesendEvent
.edgeConfigOverrides
: objet qui contient remplacements de la configuration du flux de données.
Adobe 2.0 standard consent
objet
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 de la variable consents
du champ Consentements et préférences groupe de champs de profil.
-
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 de consentement. Définissez cette variable sur"y"
lorsque les utilisateurs souscrivent et à"n"
lorsque les utilisateurs se désabonnent.value.metadata.time
: horodatage de la dernière mise à jour des paramètres de consentement des utilisateurs.
code language-js |
---|
|
Norme IAB TCF 2.0 consent
objet
Pour enregistrer les préférences de consentement de l’utilisateur fournies par le biais de la norme Transparency and Consent Framework (TCF) de l’Interactive Advertising Bureau Europe (IAB), 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 de schéma 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 Profile-enabled XDM ExperienceEvent schéma. Voir la section sur mise à jour du schéma ExperienceEvent dans le guide de préparation des jeux de données pour connaître les étapes de configuration.
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 esttrue
.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 estfalse
.
code language-js |
---|
|
Adobe 1.0 standard consent
objet
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 de consentement. Définissez cette variable sur"in"
lorsque les utilisateurs souscrivent et à"out"
lorsque les utilisateurs se désabonnent.
code language-js |
---|
|
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 variable 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 fonction 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 l’intermédiaire de la variable defaultConsent ) est défini sur pending
ou out
, la variable setConsent
peut être la première requête qui établit l’identité. Il peut donc être important de synchroniser les identités lors de la première requête. Vous pouvez ajouter la carte d’identité à la variable setConsent
comme sur la commande sendEvent
. Voir utilisation d’identityMap pour obtenir un exemple d’inclusion de identity map dans votre commande.