Références d’Opt-in

Dernière mise à jour : 17 juillet 2024
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice
  • Administration
  • Leader

API pour la bibliothèque et références des paramètres de configuration d’Opt-in.

Les paramètres de consentement sont fournis aux fonctions d’Opt-in par catégories :

adobe.OptInCategories = {
    "AAM": "aam",
    "ANALYTICS": "aa",
    "ECID": "ecid",
    "TARGET": "target"
}

Paramètres de configuration d’Opt-in

Cette section aborde l’utilisation de l’API pour configurer Opt-in. Une grande partie de la configuration et de la mise en œuvre peut être effectuée avec l’extension Experience Platform Launch.

Les configurations d’Opt-in sont fournies dans la fonction getInstance() du fichier JavaScript Visiteur, qui instancie l’objet adobe global. Vous trouverez ci-après les configurations du fichier JavaScript Visiteur liées au service Opt-in.

doesOptInApply (boolean or function that evaluates to a boolean)  :

« False » indique que les visiteurs n’ont pas besoin de donner leur opt-in. Entraîne la création de cookies par Experience Cloud quelles que soient les catégories pour lesquelles le visiteur donne son accord ou se désinscrit. Cette configuration active ou désactive entièrement Opt-in.

preOptInApprovals (Object <adobe.OptInCategories enum: boolean>)

Définit les catégories approuvées ou refusées lorsqu’aucune préférence n’a encore été définie par le visiteur, considérées comme les autorisations par défaut de la structure.

previousPermissions (Object<adobe.OptInCategories enum: boolean>)

Le visiteur définit ses préférences de façon explicite. Les autorisations de cette configuration remplacent les autorisations par défaut de la structure (previousPermissions remplace preOptInApprovals).

isOptInStorageEnabled (boolean)

Permet à Opt-in de stocker les autorisations dans un cookie propriétaire (dans le domaine actuel du client).

(Facultatif) optInCookiesDomain (string)

Domaine propriétaire ou sous-domaine à utiliser pour le cookie d’Opt-in (si isOptInStorageEnabled est défini sur « true »).

(Facultatif) optInStorageExpiry (integer)

Nombre de secondes nécessaires au remplacement de l’expiration par défaut de 13 mois.

Modification des paramètres de consentement

À tout moment lors de son passage sur votre site, un visiteur peut définir ses préférences pour la première fois ou modifier celles-ci à l’aide de votre CMP. Une fois le fichier JavaScript Visiteur initialisé avec les premiers paramètres, les autorisations du visiteur peuvent être modifiées à lʼaide des fonctions suivantes :

adobe.optIn.approve(categories, shouldWaitForComplete)

Fonction qui approuve ou engage le consentement du visiteur pour l’ensemble des catégories d’une liste. Pour plus dʼinformations sur le paramètre shouldWaitForComplete, voir Processus dʼopt-in.

adobe.optIn.deny(categories, shouldWaitForComplete)

Fonction qui refuse ou désinscrit le visiteur de l’ensemble des catégories spécifiées.

adobe.optIn.approveAll()  :

Si la demande d’autorisation de création de cookies pour votre site est formulée de façon à ce que le visiteur accepte ou refuse de manière globale d’accorder l’autorisation de création, utilisez approveAll() ou denyAll(), selon la réponse donnée par celui-ci.

adobe.optIn.denyAll()  :

Si la demande d’autorisation de création de cookies pour votre site est formulée de façon à ce que le visiteur accepte ou refuse de manière globale d’accorder l’autorisation de création, utilisez approveAll() ou denyAll(), selon la réponse donnée par celui-ci.

Paramètres des workflows d’Opt-in

Opt-in prend en charge un workflow avec lequel des autorisations peuvent être collectées sur plus d’un cycle de requêtes et les préférences sont délivrées une par une. En utilisant les fonctions suivantes et en stipulant true pour le paramètre shouldWaitForComplete, votre solution peut collecter le consentement pour une catégorie ou pour un sous-ensemble de catégories parmi toutes celles qui existent, puis collecter le consentement pour la catégorie suivante ou le sous-ensemble de catégories suivant. La propriété adobe.optIn.status démarre au premier appel et est mise en attente jusqu’à ce que adobe.optIn.complete() soit appelée en fin de flux. Une fois appelée, son état est défini sur Complete.

adobe.optIn.approve(categories, shouldWaitForComplete)

Fonction qui approuve ou engage le consentement du visiteur pour l’ensemble des catégories d’une liste.

adobe.optIn.deny(categories, shouldWaitForComplete)

Fonction qui refuse ou désinscrit le visiteur de l’ensemble des catégories spécifiées.

adobe.optIn.complete()

Fonction qui entraîne l’agrégation des appels faisant partie de la procédure d’approbation [approve()] ou de refus [deny()] en une requête unique pour définir les préférences d’un visiteur. Lorsque vous souscrivez aux modifications d’Opt-in (voir adobe.optIn.fetchPermissions(callback, shouldAutoSubscribe) ci-dessous, votre rappel (callback) se déclenche uniquement lors de l’appel de cette fonction.

Paramètres des autorisations d’Opt-in des visiteurs

Collectez à tout moment les autorisations d’Opt-in d’un visiteur grâce à l’une des fonctions d’autorisation :

adobe.optIn.permissions

Objet qui reprend toutes les solutions d’Experience Cloud, comme les catégories, ayant été acceptées ou refusées par le visiteur.

adobe.optIn.isApproved(categories)

Si l’ensemble des catégories a été approuvé, cette fonction renvoie « true ».

adobe.optIn.fetchPermissions(callback, shouldAutoSubscribe)

Récupère la liste des autorisations de façon asynchrone. Le rappel est effectué avec la liste des autorisations, une fois le processus d’acceptation ou de refus des autorisations terminé. En stipulant la valeur true pour le paramètre shouldAutoSubscribe, le rappel est désormais enregistré pour toute modification d’Opt-in. Les paramètres suivants sont des propriétés d’adobe.OptIn :

permissions

Un objet qui reprend toutes les solutions d’Experience Cloud, comme les catégories, ayant été acceptées ou refusées par le visiteur. Par exemple : { aa: true, ecid: false, aam: true... }

status

  • en attente
  • modifié
  • terminé

doesOptInApply

« True » ou « false », selon la configuration fournie au moment de l’initialisation.

isPending

« True » ou « false », selon l’état. Opt-in signale que cette propriété est vraie pour un visiteur qui nʼa pas encore explicitement accepté ou refusé lʼautorisation.

isComplete

« True » ou « false », selon l’état. Opt-in peut signaler que cette propriété est fausse lorsquʼun consentement de type processus a démarré mais nʼest pas terminé.