Show Menu
SUJETS×

Utilisation d’IAB TCF 2.0 avec l’extension Adobe Experience Platform Web SDK

Ce guide explique comment intégrer Interactive Advertising Bureau Transparency & Consent Framework, version 2.0 (IAB TCF 2.0) au Adobe Experience Platform Web SDK sans utiliser d’Experience Platform Launch. Pour un aperçu de l’intégration avec IAB TCF 2.0, consultez la présentation . Pour un guide sur la façon de s'intégrer à l'Experience Platform Launch, lisez le guide IAB TCF 2.0 pour Experience Platform Launch .

Prise en main

Ce guide utilise l' __tcfapi interface pour accéder aux renseignements sur le consentement. Il peut s’avérer plus facile pour vous d’intégrer directement votre fournisseur de gestion de cloud (CMP). Toutefois, les informations contenues dans ce guide peuvent encore être utiles car les CMP offrent généralement des fonctionnalités similaires à l’API TCF.
Ces exemples supposent que lorsque le code est exécuté, window.__tcfapi il est défini sur la page. Les CMP peuvent fournir un hook où vous pouvez exécuter ces fonctions lorsque l' __tcfapi objet est prêt.
Pour utiliser IAB TCF 2.0 avec Experience Platform Launch et l’extension AEP Web SDK, vous devez disposer d’un schéma XDM. Si vous n'avez défini aucune de ces options, début en consultant le guide de début rapide JavaScript du kit Adobe Experience Platform Web SDK avant de continuer.
En outre, ce guide vous demande de bien comprendre le SDK Web de Adobe Experience Platform. Pour une actualisation rapide, veuillez lire la présentation du SDK Web Adobe Experience Platform et la documentation sur les questions Questions fréquemment posées fréquentes.

Activation du consentement par défaut

Si vous souhaitez traiter tous les utilisateurs inconnus de la même manière, vous pouvez définir le consentement par défaut sur pending . Cette option met en file d’attente les Événements d’expérience jusqu’à ce que les préférences de consentement soient reçues.
Pour plus d'informations sur le consentement par défaut, reportez-vous à la section de consentement par défaut de la documentation de configuration du SDK Web de la plate-forme.

Définition du consentement par défaut en fonction de gdprApplies

Certains 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 GDPR ne s’applique pas, vous pouvez utiliser l’ gdprApplies indicateur dans l’appel de l’API TCF.
L’exemple suivant illustre une façon de procéder :
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 configure commande est appelée une fois tcData obtenue à partir de l’API TCF. Si gdprApplies la valeur est true, le consentement par défaut est défini sur pending . Si gdprApplies la valeur est false, le consentement par défaut est défini sur in . Veillez à renseigner la alloyConfiguration variable avec votre configuration.
Lorsque le consentement par défaut est défini sur in , la setConsent commande peut toujours être utilisée pour enregistrer vos préférences de consentement des clients.

Utilisation du événement setConsent

L’API TCF 2.0 de l’IAB fournit un événement pour le moment où 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 façon de procéder :
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 le useractioncomplete événement, puis définit le consentement, en transmettant la chaîne de consentement et l' gdprApplies indicateur. Si vous disposez d’identités personnalisées pour vos clients, veillez à renseigner la identityMap variable. Consultez le guide sur le consentement Soutien du consentement à l'appui pour plus d'information sur l'appel setConsent .

Inclusion des informations de consentement dans sendEvent

Dans les schémas XDM, vous pouvez stocker les informations de préférence de consentement dans les Événements d’expérience. Il existe deux façons d’ajouter ces informations à chaque événement.
Tout d'abord, vous pouvez fournir le schéma XDM approprié à chaque sendEvent appel. L’exemple suivant illustre une façon de procéder :
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. Consultez le guide des événements de suivi pour comprendre ce qui doit figurer dans les sendEvent options de commande.
L’autre moyen d’ajouter les informations de consentement à chaque requête consiste à utiliser le rappel onBeforeEventSend . Pour plus d’informations sur la manière de procéder, consultez la section sur la modification des événements globalement dans la documentation des événements de suivi.

Étapes suivantes

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