Intégration de la prise en charge d’IAB TCF 2.0 à l’aide de Platform launch et de l’extension Platform Web SDK

Adobe Experience Platform Web SDK prend en charge Interactive Advertising Bureau Transparency & Consent Framework, version 2.0 (IAB TCF 2.0). Ce guide vous explique comment configurer une propriété Adobe Experience Platform Launch pour envoyer des informations de consentement IAB TCF 2.0 à l’Adobe à l’aide de l’extension Adobe Experience Platform Web SDK pour Experience Platform Launch.

Si vous ne souhaitez pas utiliser d'Experience Platform Launch, veuillez consulter le guide sur l'utilisation d'IAB TCF 2.0 sans Experience Platform Launch.

Prise en main

Pour utiliser IAB TCF 2.0 avec Experience Platform Launch et l'extension Platform Web SDK, vous devez disposer d'un schéma XDM et d'un jeu de données.

En outre, ce guide vous demande de bien comprendre le SDK Web de Adobe Experience Platform. Pour une actualisation rapide, consultez la présentation du SDK Web de Adobe Experience Platform et la documentation sur les questions fréquentes.

Définition du consentement par défaut

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 ce paramètre 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, consultez la section consentement par défaut du guide de configuration du SDK.

Pour appeler l'action setConsent lorsque les préférences de consentement de vos clients ont changé, vous devez créer une nouvelle règle d'Experience Platform Launch. Début en ajoutant un nouveau événement et en choisissant le type d'événement "Code personnalisé" de l'extension Core.

Utilisez l’exemple de code suivant pour votre nouveau é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 l’indicateur gdprApplies. Cela s’avère utile ultérieurement lors de l’exécution 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%"

  • GDPR s'applique : "%IAB TCF Consent GDPR%"

Action de consentement du jeu IAB

IMPORTANT

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 à l’aide 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. De plus, le serveur renvoie une valeur de cookie, ce qui peut empêcher Adobe Experience Platform Web SDK d’enregistrer des Événements d’expérience.

Création d’un élément de données XDM pour les Événements d’expérience

La chaîne de consentement doit être incluse dans le Événement d’expérience XDM. Pour ce faire, utilisez l’élément de données Objet XDM. Début en créant un nouvel élément de données d’objet XDM ou en utilisant un élément déjà créé pour l’envoi de événements. Si vous avez ajouté le groupe de champs schéma de confidentialité d’Experience Événement à votre schéma, vous devez disposer d’une clé consentStrings dans l’objet XDM.

  1. Sélectionnez consentStrings.

  2. Choisissez Fournissez des éléments individuels et sélectionnez Ajouter un élément.

  3. Développez l’en-tête consentString, développez le premier élément, puis renseignez les valeurs suivantes :

  • consentStandard: IAB TCF
  • consentStandardVersion: 2,0
  • consentStringValue: %IAB Chaîne de consentement TCF%
  • gdprApplies: %IAB TCF Consentement GDPR%
IMPORTANT

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 à l’aide d’un code personnalisé. Vous devez saisir le nom de l’élément de données avec les signes de pourcentage.

Envoi d’un premier Événement d’expérience avec des informations de consentement IAB TCF 2.0

Si le Événement d’expérience initial sur la page est déclenché avec un événement de chargement de page, il se peut que la chaîne de consentement n’ait pas encore été chargée. Cette règle est destinée à remplacer le é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 que é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, sauf que les événements useractioncomplete et tcloaded sont tous deux 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 page.

Ajoutez une action "Envoyer le Événement" à partir de l'extension Platform Web SDK. Dans le champ XDM, choisissez l’élément de données XDM que vous avez créé dans la section précédente.

Envoi d’autres événements avec des informations de consentement IAB TCF 2.0

Lorsque des événements sont déclenchés après le É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 IAB. Utilisez le même élément de données XDM pour envoyer des événements futurs. Les informations du CCI TCF 2.0 sont incluses.

Étapes suivantes

Maintenant que vous avez appris à utiliser IAB TCF 2.0 avec l'extension Platform Web SDK, vous pouvez également choisir de vous intégrer à d'autres solutions d'Adobe telles que Adobe Analytics ou la plate-forme de données client en temps réel. Pour plus d'informations, consultez la présentation du Cadre de transparence et de consentement IAB 2.0.

Sur cette page