Intégration de la prise en charge du TCF 2.0 de l’IAB au SDK Web de Platform

Ce guide explique comment intégrer l’Interactive Advertising Bureau Transparency & Consent Framework, version 2.0 (IAB TCF 2.0) au SDK Web de Adobe Experience Platform sans utiliser de balises. Pour un aperçu de l’intégration à IAB TCF 2.0, consultez la aperçu. Pour obtenir un guide sur l’intégration aux balises, lisez le Guide du TCF 2.0 de l’IAB pour les balises.

Prise en main

Ce guide utilise la méthode __tcfapi pour accéder aux informations de consentement. Il peut être plus facile d’intégrer directement votre fournisseur de gestion du cloud (CMP). Toutefois, les informations contenues dans ce guide peuvent être utiles, car les CMP offrent généralement des fonctionnalités similaires à l’API TCF.

Pour utiliser IAB TCF 2.0 avec des balises et l’extension SDK Web Adobe Experience Platform, vous devez disposer d’un schéma XDM disponible. Si vous n’avez défini aucune de ces options, commencez par afficher cette page avant de continuer.

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 la variable Questions fréquentes la documentation.

Activation du consentement par défaut

Si vous souhaitez traiter tous les utilisateurs inconnus de la même manière, vous pouvez définir defaultConsent to pending ou out. Cette file d’attente ou ignore les événements d’expérience jusqu’à ce que les préférences de consentement soient reçues.

Définition du consentement par défaut basé sur gdprApplies

Certaines CMP permettent de déterminer si le Règlement général sur la protection des données (RGPD) s’applique au client. Si vous souhaitez obtenir le consentement des clients pour lesquels le RGPD ne s’applique pas, vous pouvez utiliser la variable gdprApplies Indicateur dans l’appel de l’API TCF.

L’exemple suivant illustre une méthode :

var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
    window.alloy("configure", alloyConfiguration);
  }
});

Dans cet exemple, la variable configure est appelée après la tcData est obtenu à partir de l’API TCF. If gdprApplies est définie sur true, le consentement par défaut est défini sur pending. If gdprApplies est définie sur false, le consentement par défaut est défini sur in. Veillez à renseigner la variable alloyConfiguration avec votre configuration.

Utilisation de l’événement setConsent

L’API IAB TCF 2.0 fournit un événement pour lorsque le consentement est mis à jour par le client. Cela se produit lorsque le client définit initialement ses préférences et lorsque le client met à jour ses préférences.

L’exemple suivant illustre une méthode :

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

Ce bloc de code écoute les useractioncomplete puis définit le consentement, en transmettant la chaîne de consentement et la variable gdprApplies Indicateur. Si vous disposez d’identités personnalisées pour vos clients, veillez à renseigner la variable identityMap Variable . Reportez-vous au guide sur prise en charge du consentement pour plus d’informations sur l’appel setConsent.

Inclusion des informations de consentement dans sendEvent

Dans les schémas XDM, vous pouvez stocker les informations de préférences de consentement des événements d’expérience. Il existe deux manières d’ajouter ces informations à chaque événement.

Tout d’abord, vous pouvez fournir le schéma XDM approprié sur chaque sendEvent appelez . L’exemple suivant illustre une méthode :

var sendEventOptions = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    sendEventOptions.xdm.consentStrings = [{
      consentStandard: "IAB TCF"
      consentStandardVersion: "2.0"
      consentStringValue: tcData.tcString,
      gdprApplies: tcData.gdprApplies
    }];
    window.alloy("sendEvent", sendEventOptions);
  }
});

Cet exemple récupère les informations de consentement pour l’API TCF, puis envoie un événement avec les informations de consentement ajoutées au schéma XDM.

L’autre moyen d’ajouter des informations de consentement à chaque requête consiste à utiliser la variable onBeforeEventSend rappel.

Étapes suivantes

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.