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 :

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

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. Connexion à 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 à Règles, puis sélectionnez la règle de votre choix.
  5. Sous Actions, sélectionnez une action existante ou créez-en une.
  6. 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.
  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 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 de consent objets. L’objet de consentement est formaté différemment selon la norme et la version que vous choisissez.
  • 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 la setConsent est exécuté avant d’autres commandes, telles que sendEvent.
  • edgeConfigOverrides: objet qui contient remplacements de la configuration du flux de données.
Adobe 2.0
  • 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. Les valeurs valides sont "y" (inclusion) et "n" (exclusion).
    • value.metadata.time: date et heure auxquelles l’utilisateur a défini la valeur de consentement.
code language-js
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
  • 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
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 de consentement. Les valeurs valides sont "in" (inclusion) et "out" (exclusion).
code language-js
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636