Integrare il supporto IAB TCF 2.0 utilizzando i tag e l’estensione Platform Web SDK

Adobe Experience Platform Web SDK supporta Interactive Advertising Bureau Transparency & Consent Framework, versione 2.0 (IAB TCF 2.0). Questa guida illustra come impostare una proprietà tag per inviare informazioni sul consenso IAB TCF 2.0 ad Adobe utilizzando l’estensione tag Adobe Experience Platform Web SDK.

Se non desideri utilizzare i tag, consulta la guida in Utilizzo di IAB TCF 2.0 senza tag.

Introduzione

Per utilizzare IAB TCF 2.0 con i tag e l’estensione Platform Web SDK, è necessario disporre di uno schema XDM e di un set di dati.

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.

Impostazione del consenso predefinito

Nella configurazione dell’estensione è presente un’impostazione per il consenso predefinito. Questo controlla il comportamento dei clienti che non hanno un cookie di consenso. Se desideri mettere in coda eventi esperienza per i clienti che non hanno un cookie di consenso, imposta questo su pending. Se desideri eliminare gli eventi esperienza per i clienti che non hanno un cookie di consenso, imposta questo su out. Puoi anche utilizzare un elemento dati per impostare dinamicamente il valore del consenso predefinito. Per ulteriori informazioni, vedere defaultConsent.

Aggiornamento del profilo con le informazioni sul consenso consent-code-1

Per chiamare l'azione setConsent quando le preferenze di consenso dei clienti sono cambiate, crea una regola di tag. Per iniziare, aggiungi un nuovo evento e scegli il tipo di evento "Custom Code" dell’estensione Core.

Utilizza il seguente esempio di codice per il nuovo evento:

// 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();

Questo codice personalizzato esegue due operazioni:

Creazione di un elemento dati XDM per eventi esperienza

La stringa di consenso deve essere inclusa nell’evento esperienza XDM. A questo scopo, utilizza l’elemento dati Oggetto XDM. Inizia creando un nuovo elemento dati Oggetto XDM o, in alternativa, utilizzane uno già creato per l’invio di eventi. Se hai aggiunto il gruppo di campi dello schema Privacy dell’evento esperienza allo schema, dovresti disporre di una chiave consentStrings nell’oggetto XDM.

Invio di un evento esperienza iniziale con informazioni sul consenso IAB TCF 2.0

Se l’evento esperienza iniziale sulla pagina viene attivato con un evento di caricamento pagina, la stringa di consenso potrebbe non essere ancora stata caricata. Questa regola ha lo scopo di sostituire l'evento di caricamento pagina corrente. Per assicurarti che le informazioni sul consenso siano caricate per prime, crea una nuova regola e aggiungi il seguente codice come evento di codice personalizzato:

// 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();

Questo codice è identico al codice personalizzato precedente, con la differenza che vengono gestiti sia gli eventi useractioncomplete che tcloaded. Il codice personalizzato precedente viene attivato solo quando il cliente sceglie le proprie preferenze per la prima volta. Questo codice si attiva anche quando il cliente ha già scelto le proprie preferenze. Ad esempio, al secondo caricamento della pagina.

Aggiungi un’azione "Invia evento" dall’estensione Platform Web SDK. All’interno del campo XDM, scegli l’elemento dati XDM creato nella sezione precedente.

Invio di altri eventi con informazioni sul consenso IAB TCF 2.0

Quando gli eventi vengono attivati dopo l’evento esperienza iniziale, i due elementi di dati sono ancora definiti e possono essere utilizzati per inviare le informazioni sul consenso IAB. Utilizza lo stesso elemento dati XDM per inviare eventi futuri. Sono incluse le informazioni IAB TCF 2.0.

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.