Le SDK Web de Adobe Experience Platform prend en charge le Transparency & Consent Framework de l’Interactive Advertising Bureau, version 2.0 (IAB TCF 2.0). Ce guide vous explique comment configurer une propriété de balise pour envoyer des informations de consentement IAB TCF 2.0 à Adobe à l’aide de l’extension de balise du SDK Web Adobe Experience Platform.
Si vous ne souhaitez pas utiliser de balises, reportez-vous au guide sur la utilisation d’IAB TCF 2.0 sans balises.
Pour utiliser IAB TCF 2.0 avec des balises et l’extension SDK Web Platform, vous devez disposer d’un schéma XDM et d’un jeu de données disponibles.
En outre, ce guide nécessite une compréhension pratique du SDK Web de Adobe Experience Platform. Pour une actualisation rapide, veuillez lire le Présentation du SDK Web Adobe Experience Platform et le Questions fréquentes documentation.
Dans la configuration de l’extension, il existe un paramètre pour le consentement par défaut. Cela contrôle le comportement des clients qui n’ont pas de cookie de consentement. Si vous souhaitez mettre en file d’attente les événements d’expérience pour les clients qui n’ont pas de cookie de consentement, définissez cette variable sur pending
. Si vous souhaitez ignorer les événements d’expérience pour les clients qui n’ont pas de cookie de consentement, définissez cette variable sur out
. Vous pouvez également utiliser un élément de données pour définir dynamiquement la valeur de consentement par défaut.
Pour plus d’informations sur la configuration du consentement par défaut, reportez-vous à la section section de consentement par défaut dans le guide de configuration du SDK.
Pour appeler la fonction setConsent
lorsque les préférences de consentement de vos clients ont changé, vous devez créer une nouvelle règle de balise. Commencez par ajouter un nouvel événement et sélectionnez le type d’événement "Code personnalisé" de l’extension Core.
Utilisez l’exemple de code suivant pour votre nouvel événement :
// Wait for window.__tcfapi to be defined, then trigger when the customer has completed their consent and preferences.
function addEventListener() {
if (window.__tcfapi) {
window.__tcfapi("addEventListener", 2, function (tcData, success) {
if (success && tcData.eventStatus === "useractioncomplete") {
// save the tcData.tcString in a data element
_satellite.setVar("IAB TCF Consent String", tcData.tcString);
_satellite.setVar("IAB TCF Consent GDPR", tcData.gdprApplies);
trigger();
}
});
} else {
// window.__tcfapi wasn't defined. Check again in 100 milliseconds
setTimeout(addEventListener, 100);
}
}
addEventListener();
Ce code personnalisé effectue deux opérations :
Définit deux éléments de données, l’un avec la chaîne de consentement et l’autre avec le paramètre gdprApplies
Indicateur. Cela s’avérera utile ultérieurement lors du remplissage de l’action "Définir le consentement".
Déclenche la règle lorsque les préférences de consentement ont changé. L’action "Définir le consentement" doit être utilisée chaque fois que les préférences de consentement ont changé. Ajoutez une action "Définir le consentement" dans l’extension et remplissez le formulaire comme suit :
Standard : "IAB TCF"
Version : "2.0"
Valeur : "%IAB TCF Consent String%"
Le RGPD s’applique : "%Consentement du TCF de l’IAB RGPD%"
Vous ne pouvez pas choisir ces éléments de données à l’aide du sélecteur d’éléments de données, car ils ont été créés par le biais d’un code personnalisé. Vous devez saisir le nom de l’élément de données avec les signes de pourcentage. Ce code met à jour le profil de votre client avec ses nouvelles préférences de consentement chaque fois qu’il change. En outre, le serveur renvoie une valeur de cookie, ce qui peut empêcher le SDK Web de Adobe Experience Platform d’enregistrer des événements d’expérience.
La chaîne de consentement doit être incluse dans l’événement d’expérience XDM. Pour ce faire, utilisez l’élément de données Objet XDM . Commencez par créer un élément de données d’objet XDM ou utilisez-en un que vous avez déjà créé pour envoyer des événements. Si vous avez ajouté le groupe de champs de schéma Confidentialité des événements d’expérience à votre schéma, vous devez disposer d’un consentStrings
clé dans l’objet XDM.
Sélectionner consentStrings.
Choisir Fournir des éléments individuels et sélectionnez Ajouter un élément.
Développez l’objet consentString et développez le premier élément, puis renseignez les valeurs suivantes :
consentStandard
: IAB TCFconsentStandardVersion
: 2.0consentStringValue
: %IAB TCF Consent String%gdprApplies
: %Consentement du TCF de l’IAB%Vous ne pouvez pas choisir ces éléments de données à l’aide du sélecteur d’éléments de données, car ils ont été créés par le biais d’un code personnalisé. Vous devez saisir le nom de l’élément de données avec les signes de pourcentage.
Si l’événement d’expérience initial sur la page est déclenché avec un événement de chargement de page, la chaîne de consentement n’a peut-être pas encore été chargée. Cette règle est destinée à remplacer l’événement de chargement de page actuel. Pour vous assurer que les informations de consentement sont chargées en premier, créez une règle et ajoutez le code suivant en tant qu’événement de code personnalisé :
// Wait for window.__tcfapi to be defined, then trigger when there is a consent string
function addEventListener() {
if (window.__tcfapi) {
window.__tcfapi("addEventListener", 2, function (tcData, success) {
if (success && (tcData.eventStatus === "useractioncomplete" || tcData.eventStatus === "tcloaded")) {
// save the tcData.tcString in a data element
_satellite.setVar("IAB TCF Consent String", tcData.tcString);
_satellite.setVar("IAB TCF GDPR Applies", tcData.gdprApplies);
trigger();
}
});
} else {
// window.__tcfapi wasn"t defined. Check again in 100 milliseconds
setTimeout(addEventListener, 100);
}
}
addEventListener();
Ce code est identique au code personnalisé précédent, à la différence que useractioncomplete
et tcloaded
sont gérés. Le code personnalisé précédent ne se déclenche que lorsque le client choisit ses préférences pour la première fois. Ce code se déclenche également lorsque le client a déjà choisi ses préférences. Par exemple, au second chargement de la page.
Ajoutez une action "Envoyer l’événement" à partir de l’extension SDK Web Platform. Dans le champ XDM, sélectionnez l’élément de données XDM que vous avez créé dans la section précédente.
Lorsque des événements sont déclenchés après l’événement d’expérience initial, les deux éléments de données sont toujours définis et peuvent être utilisés pour envoyer les informations de consentement de l’IAB. Utilisez le même élément de données XDM pour envoyer des événements futurs. Les informations du TCF 2.0 de l’IAB sont incluses.
Maintenant que vous avez appris à utiliser IAB TCF 2.0 avec l’extension SDK Web Platform, vous pouvez également choisir d’intégrer avec d’autres solutions Adobe telles qu’Adobe Analytics ou Adobe Real-time Customer Data Platform. Voir Présentation du Transparency and Consent Framework 2.0 de l’IAB pour plus d’informations.