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

Utilisation de defaultConsent avec setConsent using-consent

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

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.

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

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.

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 :

// 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"
      }
    }
  }]
});

// 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
  }]
});

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