Integrare il supporto IAB TCF 2.0 con Platform Web SDK

Questa guida illustra come integrare Interactive Advertising Bureau Transparency & Consent Framework, versione 2.0 (IAB TCF 2.0) con Adobe Experience Platform Web SDK senza utilizzare i tag. Per una panoramica sull'integrazione con IAB TCF 2.0, leggere la panoramica. Per una guida su come eseguire l'integrazione con i tag, leggere la guida IAB TCF 2.0 per i tag.

Introduzione

Questa guida utilizza l'interfaccia __tcfapi per accedere alle informazioni sul consenso. Potrebbe essere più semplice eseguire l’integrazione diretta con il provider di gestione cloud (CMP). Tuttavia, le informazioni contenute in questa guida potrebbero essere ancora utili perché le CMP in genere forniscono funzionalità simili all’API TCF.

Per utilizzare IAB TCF 2.0 con i tag e l’estensione Adobe Experience Platform Web SDK, è necessario disporre di uno schema XDM. Se non hai impostato nessuno di questi, inizia visualizzando questa pagina prima di procedere.

Inoltre, questa guida richiede una buona conoscenza di Adobe Experience Platform Web SDK. Per un rapido aggiornamento, leggere la panoramica di Adobe Experience Platform Web SDK e la documentazione sulle domande frequenti.

Abilitazione del consenso predefinito

Per trattare tutti gli utenti sconosciuti allo stesso modo, è possibile impostare defaultConsent su pending o out. In questo modo gli eventi esperienza vengono messi in coda o eliminati finché non vengono ricevute le preferenze di consenso.

Impostazione del consenso predefinito in base a gdprApplies

Alcune CMP consentono di determinare se al cliente si applica il Regolamento generale sulla protezione dei dati (RGPD). Se desideri presumere il consenso per i clienti a cui non si applica il RGPD, puoi utilizzare il flag gdprApplies nella chiamata API TCF.

L’esempio seguente mostra un modo per farlo:

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

In questo esempio, il comando configure viene chiamato dopo che tcData è stato ottenuto dall'API TCF. Se gdprApplies è true, il consenso predefinito è impostato su pending. Se gdprApplies è false, il consenso predefinito è impostato su in. Assicurarsi di compilare la variabile alloyConfiguration con la configurazione.

Utilizzo dell'evento setConsent

L’API IAB TCF 2.0 fornisce un evento per quando il consenso viene aggiornato dal cliente. Ciò si verifica quando il cliente imposta inizialmente le sue preferenze e quando aggiorna le sue preferenze.

L’esempio seguente mostra un modo per farlo:

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
        }
      ]
    });
  }
});

Questo blocco di codice ascolta l'evento useractioncomplete, quindi imposta il consenso, passando la stringa di consenso e il flag gdprApplies. Se hai identità personalizzate per i clienti, assicurati di compilare la variabile identityMap. Per ulteriori informazioni, consulta la guida in setConsent.

Inclusione delle informazioni sul consenso in sendEvent

All’interno degli schemi XDM, puoi archiviare le informazioni sulle preferenze del consenso dagli eventi Experience. Esistono due modi per aggiungere queste informazioni a ogni evento.

Innanzitutto, puoi fornire lo schema XDM pertinente a ogni chiamata sendEvent. L’esempio seguente mostra un modo per farlo:

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);
  }
});

Questo esempio ottiene le informazioni sul consenso per l’API TCF e quindi invia un evento con le informazioni sul consenso aggiunte allo schema XDM.

L'altro modo per aggiungere le informazioni sul consenso a ogni richiesta è con il callback onBeforeEventSend.

Passaggi successivi

Ora che hai imparato a utilizzare IAB TCF 2.0 con l’estensione Platform Web SDK, puoi anche scegliere di integrarla con altre soluzioni di Adobe come Adobe Analytics o Adobe Real-time Customer Data Platform. Per ulteriori informazioni, consulta la panoramica su IAB Transparency & Consent Framework 2.0.