Implementa il consenso con una piattaforma di gestione dei consensi (CMP) utilizzando l’estensione Platform Web SDK

Molte normative legali sulla privacy hanno introdotto requisiti per il consenso attivo e specifico in relazione alla raccolta dei dati, alla personalizzazione e ad altri casi d’uso del marketing. Per soddisfare questi requisiti, Adobe Experience Platform ti consente di acquisire le informazioni sul consenso nei profili dei singoli clienti e di utilizzarle come fattore determinante per l’utilizzo dei dati di ciascun cliente nei flussi di lavoro della piattaforma a valle.

NOTA

Adobe Experience Platform Launch viene integrato in Adobe Experience Platform come suite di tecnologie per la raccolta dati. Nell’interfaccia sono state introdotte diverse modifiche terminologiche di cui tenere conto durante l’utilizzo di questo contenuto:

Questa esercitazione illustra come implementare e attivare i dati di consenso ottenuti da una piattaforma di gestione dei consensi (CMP) utilizzando l’estensione Platform Web SDK nella raccolta dati. Lo faremo utilizzando sia gli standard di Adobe che lo standard di consenso IAB TCF 2.0, con OneTrust o Sourcepoint come CMP di esempio.

Questa esercitazione utilizza l’estensione Platform Web SDK per inviare i dati di consenso a Platform. Per una panoramica dell'SDK web, consulta questa pagina.

Prerequisiti

I prerequisiti per l'utilizzo dell'SDK per web sono elencati qui.

In quella pagina, c'è un requisito per un "Set di dati evento" e, proprio come sembra, questo è un set di dati per contenere i dati dell'evento esperienza. Per inviare le informazioni sul consenso con gli eventi, è necessario aggiungere il gruppo di campi [Privacy Details](https://github.com/adobe/xdm/blob/master/docs/reference/field groups/experience-event/experienceevent-privacy.schema.md) allo schema Experience Event (Evento esperienza):

Per lo standard di consenso Platform v2.0, è inoltre necessario accedere al profilo Adobe Experience per creare uno schema di profilo individuale XDM e un set di dati. Per un'esercitazione sulla creazione dello schema, consulta Creare uno schema utilizzando l'Editor di schema e per il gruppo di campi di profilo Dettagli preferenza richiesto consulta la documentazione XDM.

Questa esercitazione presuppone che tu abbia accesso alla raccolta dati e che tu abbia creato una proprietà tag lato client con l'estensione SDK per web installata e una libreria di lavoro creata e creata per lo sviluppo. Questi argomenti sono descritti in dettaglio e illustrati in questi documenti:

Inoltre, utilizzeremo l’ estensione Platform Debugger Chrome per controllare e convalidare la nostra implementazione.

Per implementare l’esempio IAB TCF con una CMP sul tuo sito, dovrai accedere a una CMP come OneTrust o Sourcepoint per generare i dati che forniscono, oppure puoi semplicemente seguire questo esempio e vedere i risultati qui sotto.

NOTA

Lo standard 1.0 viene gradualmente eliminato a favore della versione v2.0. Lo standard 2.0 ti consente di aggiungere dati di consenso aggiuntivi che possono essere utilizzati per applicare manualmente le preferenze di consenso. Le schermate seguenti dell’estensione Platform Web SDK provengono dalla versione 2.4.0 dell’estensione, compatibile con le versioni v1.0 o v2.0 di Adobe Consent Standard.

Per ulteriori informazioni su questi standard, consulta Supporto delle preferenze di consenso dei clienti.

Passaggio 1: Configurare il consenso nell’estensione SDK per web

Dopo aver installato l’estensione Platform Web SDK in una proprietà tag, possiamo configurare le opzioni per la gestione dei dati di consenso nella schermata di configurazione dell’estensione:

La sezione "Privacy" imposta il livello di consenso per l'SDK se l'utente non ha precedentemente fornito le preferenze di consenso. Questo imposta lo stato predefinito per la raccolta dei dati del consenso e dell’evento nell’SDK. L’impostazione scelta risponde alla domanda "cosa deve fare l’SDK se l’utente non ha ancora fornito preferenze di consenso esplicite?"

  • In : raccogli eventi che si verificano prima che l'utente fornisca le preferenze di consenso.
  • Out: eventi di rilascio che si verificano prima che l’utente fornisca le preferenze di consenso.
  • In sospeso: eventi in coda che si verificano prima che l’utente fornisca le preferenze di consenso.
  • Fornito dall’elemento dati

Se l’impostazione di consenso predefinito è "In", questo indica all’SDK che non deve attendere il consenso esplicito e che deve raccogliere gli eventi che si verificano prima che l’utente fornisca le preferenze di consenso. Queste preferenze vengono in genere gestite e memorizzate in una piattaforma CMP.

Se l'impostazione di consenso predefinita è "Out", questo indica all'SDK che non deve raccogliere eventi che si verificano prima che le preferenze di consenso dell'utente siano impostate. L’attività del visitatore che si verifica prima dell’impostazione della preferenza di consenso non verrà inclusa nei dati inviati dall’SDK dopo aver impostato il consenso. Ad esempio, se scorri e visualizzi una pagina web prima di selezionare il banner di consenso e utilizzi questa impostazione "Out", l’attività di scorrimento e il tempo di visualizzazione non verranno inviati se l’utente successivamente fornisce il consenso esplicito per la raccolta dei dati.

Se l'impostazione di consenso predefinita è "In sospeso", l'SDK mette in coda tutti gli eventi che si verificano prima che l'utente fornisca le preferenze di consenso, in modo che gli eventi possano essere inviati dopo che le preferenze di consenso sono state impostate e dopo che l'SDK è stato inizialmente configurato durante una visita.

Con questa impostazione "In sospeso", il tentativo di eseguire i comandi che richiedono le preferenze di consenso dell'utente (ad esempio, il comando dell'evento) determina la messa in coda del comando all'interno dell'SDK. Questi comandi vengono elaborati solo dopo aver comunicato le preferenze di consenso dell’utente all’SDK.

Una volta che una CMP raccoglie le preferenze dell’utente, possiamo comunicare tali preferenze all’SDK. In una sezione successiva, vedremo come ottenere i dati di consenso e utilizzarli con l’estensione SDK per web.

"Fornito dall’elemento dati" consente di accedere a un elemento dati contenente eventuali dati di preferenza del consenso acquisiti dal codice personalizzato o da una CMP sul sito o nel livello dati. Un elemento dati utilizzato a questo scopo deve essere risolto in "in", "out" o "in sospeso".

Nota: questa impostazione di configurazione per l’SDK non viene mantenuta sui profili degli utenti, ma è specifica per impostare il comportamento dell’SDK prima che il visitatore fornisca le preferenze di consenso esplicito.

Per ulteriori informazioni sulla configurazione dell'estensione SDK per web, consulta la Panoramica dell'estensione Platform Web SDK e Supporto delle preferenze di consenso dei clienti.

Per questo esempio, scegliamo l'opzione "In sospeso" e selezioniamo Salva per salvare le impostazioni di configurazione.

Passaggio 2: Comunicazione delle preferenze di consenso

Ora che abbiamo impostato il comportamento predefinito dell’SDK, possiamo utilizzare i tag per inviare le preferenze di consenso esplicito di un visitatore a Platform. L’invio dei dati di consenso tramite lo standard Adobe 1.0 o 2.0 è facilmente implementabile utilizzando l’azione setConsent dell’SDK per web nelle regole dei tag.

Creiamo una regola per dimostrarlo. Nella proprietà Tag piattaforma , seleziona Regole , quindi fai clic sul pulsante blu Aggiungi regole . Denomina la regola "setAdobeConsent" e seleziona per aggiungere un evento. Per Tipo evento, scegli "Window Loaded" che attiverà questa regola ogni volta che una pagina viene caricata sul nostro sito web. Quindi, in "Azioni" seleziona "Aggiungi" per aprire la schermata di configurazione dell'azione. Qui verranno impostati i dati di consenso. Seleziona il menu a discesa "Estensione" e seleziona "Platform Web SDK", quindi seleziona il "Tipo di azione" e seleziona "Imposta consenso".

In "Informazioni sul consenso", scegliere "Compila un modulo". In questa azione della regola, utilizzeremo l’SDK per web per impostare il consenso per lo standard di consenso di Adobe 1.0 compilando il modulo visualizzato:

Con questa azione Imposta consenso possiamo scegliere di passare "In", "Out" o "Fornito dall’elemento dati". Un elemento dati in questo caso deve essere "in" o "out".

In questo esempio, selezioneremo "In" per indicare che il visitatore ha acconsentito a consentire all’SDK per web di inviare dati a Platform. Seleziona il pulsante blu "Mantieni modifiche" per salvare questa azione, quindi "Salva" per salvare questa regola.

Nota: Una volta che un visitatore del sito web ha rinunciato, l'SDK non ti consente di impostare il consenso degli utenti ad in.

Le regole del tag possono essere attivate da una varietà di eventi incorporati o personalizzati che possono essere utilizzati per trasmettere i dati di consenso al momento appropriato durante una sessione del visitatore. Nell’esempio precedente, abbiamo utilizzato l’evento window loaded per attivare la regola. In una sezione successiva, utilizzeremo un evento di preferenza del consenso da una CMP per attivare un’azione Imposta consenso. Puoi utilizzare un'azione Imposta consenso in una regola attivata da qualsiasi evento che preferisci che indichi un'impostazione di preferenza di consenso.

La versione 2.0 dello standard di consenso Platform funziona con i dati XDM. Inoltre, è necessario aggiungere un gruppo di campi Privacy Details allo schema del profilo in Platform. Per ulteriori informazioni su Adobe standard versione 2.0 e questo gruppo di campi, consulta Elaborazione del consenso in Platform .

Creeremo un elemento dati di codice personalizzato per trasmettere dati alle proprietà di raccolta e metadati dell’oggetto consenso mostrato nello schema seguente:

Questo gruppo di campi Dettagli preferenza contiene i campi per il tipo di dati Consensi e preferenze XDM che conterrà i dati delle preferenze di consenso inviati a Platform con l’estensione Platform Web SDK nella nostra azione regola. Attualmente, le uniche proprietà richieste per implementare Platform Consent Standard 2.0 sono il valore di raccolta (val) e il valore di tempo dei metadati, evidenziati in precedenza in rosso.

Creiamo un elemento dati per questi dati. Seleziona Elementi dati e il pulsante blu Aggiungi elemento dati . Chiamiamolo "xdm-permission 2.0" e utilizzando l’estensione Core, selezioneremo un tipo di codice personalizzato. Puoi immettere o copiare e incollare i seguenti dati nella finestra dell’editor di codice personalizzato:

var dateString = new Date().toISOString();

return {
  collect: {
    val: "y"
  },
  metadata: {
    time: dateString
  }
}

Il campo temporale deve specificare l’ultima volta che l’utente ha aggiornato le proprie preferenze di consenso. Stiamo creando una marca temporale qui come esempio utilizzando un metodo standard sull'oggetto Data JavaScript. Seleziona salva per salvare il codice personalizzato e seleziona nuovamente salva per salvare l’elemento dati.

Quindi, selezioniamo Regole, quindi il pulsante blu Aggiungi regola e immettiamo il nome "setConsent onLoad - Consent 2.0". Scegliamo l’evento Window Loaded come attivatore della regola, quindi seleziona Aggiungi in Azioni. Scegli l’estensione Platform Web SDK e, per Tipo azione, scegli Imposta consenso. Lo standard deve essere Adobe e la versione deve essere 2.0. Per Valore, utilizzeremo l’elemento dati appena creato che contiene i valori di raccolta e ora che dobbiamo inviare a Platform:

Per rivedere questa azione di esempio, chiamiamo l’estensione Set Consent dall’SDK per web di Platform e passiamo lo Standard e la Versione dal modulo, mentre trasmettiamo i valori per la raccolta e l’ora dall’elemento dati creato in precedenza.

Seleziona il pulsante blu Salva e di nuovo per salvare la regola.

Ora disponiamo di due regole, una per ciascuno degli standard di Platform Consent. In pratica, probabilmente sceglierai uno standard tra i tuoi siti. Ora creeremo un esempio utilizzando lo standard di consenso IAB TCF 2.0.

Utilizzo dell’SDK per web con lo standard di consenso IAB TCF 2.0

Per ulteriori informazioni sulla versione 2.0 del Transparency and Consent Framework IAB, visita il sito web IAB Europe .

Per impostare i dati delle preferenze di consenso utilizzando questo standard, è necessario aggiungere il gruppo di campi Privacy Details allo schema Experience Event (Evento esperienza) in Platform:

Questo gruppo di campi contiene i campi delle preferenze di consenso richiesti dallo standard IAB TCF 2.0. Per ulteriori informazioni sugli schemi e sui gruppi di campi, consulta la Panoramica del sistema XDM.

Passaggio 1: Creare un elemento dati di consenso

Per inviare i dati evento di consenso dai tag utilizzando lo standard di consenso IAB TCF 2.0, per prima cosa abbiamo impostato un elemento dati xdm con i campi di consenso richiesti:

Nella proprietà lato client dei tag, seleziona Elementi dati e il pulsante blu "Aggiungi elemento dati". Questo elemento dati verrà denominato "xdm-permissionStrings" per questo esempio. Questi campi xdm contengono i dati di consenso utente richiesti per lo standard IAB TCF 2.0.

Nel menu a discesa Estensione , scegli "Platform Web SDK" e, per Tipo di elemento dati, scegli "Oggetto XDM". Viene visualizzata la mappatura xdm, che consente di selezionare ed espandere l’elemento "permissionStrings" come mostrato nella schermata precedente.

Imposta ciascuna delle proprietà consentString come segue:

  • consentStandard: IAB TCF
  • consentStandardVersion: 2.0
  • consentStringValue: %IAB TCF Consent String%
  • containsPersonalData: False (scelta dal pulsante Seleziona valore )
  • gdprApplies: %IAB TCF Consent GDPR%

Insieme a permissionStandard e consentStandardVersion sono presenti solo stringhe di testo per lo standard in uso, ovvero IAB TCF versione 2.0. Il permissionStringValue fa riferimento a un elemento di dati denominato "IAB TCF Consent String". I segni di percentuale che circondano il testo indicano il nome di un elemento dati, e lo guarderemo tra un attimo. La proprietà containsPersonalData indica se la stringa di consenso IAB TCF 2.0 contiene dati personali con "True" o "False". Il campo rgpdApplies indica se si applica "true" per il RGPD, "false" per il RGPD non si applica, o "undefined" per distanza sconosciuta se il RGPD è applicabile. Al momento, l’SDK per web tratterà "non definito" come "true", pertanto i dati di consenso inviati con "gdprApplies": "indefinito" sarà trattato come se il visitatore si trovi in un’area in cui si applica il RGPD.

Per ulteriori informazioni su queste proprietà e sui tag IAB TCF 2.0, consulta la documentazione sul consenso .

Passaggio 2: Crea una regola per impostare il consenso con lo standard IAB TCF 2.0

Successivamente, creiamo una regola per impostare il consenso con l’SDK per web quando i dati di consenso per questo standard vengono impostati o modificati da un visitatore del sito web. In questa regola vedremo anche come acquisire i segnali di modifica del consenso da una piattaforma CMP come OneTrust o Sourcepoint.

Aggiungere un evento regola

Seleziona la sezione Regole nella proprietà Tag Platform , quindi fai clic sul pulsante blu Aggiungi regola . Denomina la regola setConsent - IAB e seleziona Aggiungi in Eventi. Denomina questo evento tcfapi addEventListener e seleziona Open Editor per aprire l'editor di codice personalizzato.

Copia e incolla il seguente codice nella finestra dell'editor:

// 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" || tcData.eventStatus === "tcloaded")) {
        // save the tcData.tcString properties in data elements
        _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 crea ed esegue semplicemente una funzione chiamata addEventListener. La funzione controlla se la finestra.__tcfapi esiste e, in caso affermativo, aggiunge un listener di eventi in base alle specifiche dell'API. Per ulteriori informazioni su tali specifiche, consulta l’ repository IAB su GitHub. Se questo listener di eventi viene aggiunto correttamente e il visitatore del sito web ha completato le scelte di consenso e preferenze, il codice imposta le variabili personalizzate dei tag per tcData tcString e l'indicatore per le aree RGPD. Anche in questo caso, per ulteriori informazioni su IAB TCF, consulta IAB sito web e GitHub repo per informazioni tecniche. Dopo aver impostato questi valori, il codice esegue la funzione di attivazione che attiva l'esecuzione di questa regola.

Se la finestra.__tcfapi l'oggetto non esisteva al primo avvio dell'esecuzione di questa funzione, la funzione lo controlla nuovamente ogni 100 millisecondi, in modo che il listener di eventi possa essere aggiunto. L'ultima riga di codice esegue semplicemente la funzione addEventListener definita nelle righe di codice sopra di essa.

Per riepilogare, abbiamo creato una funzione per verificare lo stato del consenso impostato da un visitatore del sito web utilizzando un banner di consenso CMP (o personalizzato). Quando questa preferenza di consenso è impostata, questo codice crea due variabili personalizzate (elementi dati codice personalizzato) che possiamo utilizzare nell'azione della regola. Dopo aver incollato il codice riportato sopra nella finestra dell'editor di codice personalizzato del nostro evento, seleziona il pulsante blu Salva per salvare l'evento della regola.

Imposta l’azione Imposta regola consenso per utilizzare questi valori e inviarli a Platform.

Aggiungi un'azione regola

Selezionare Aggiungi nella sezione Azioni. In Estensione , scegli SDK web per piattaforma dal menu a discesa. In Tipo azione, scegli Imposta consenso. Denomina questa azione setConsent.

Nella configurazione dell’azione in Informazioni consenso, scegli Compila un modulo. Per Standard, scegli IAB TCF e per Versione inserisci 2.0. Per Valore, utilizzeremo la variabile personalizzata dal nostro evento e immetteremo %IAB TCF Consent String% che proviene da tcData che abbiamo acquisito nella funzione personalizzata dell'evento della regola sopra.

In Applicazione RGPD utilizzeremo l’altra variabile personalizzata dal nostro evento e immetteremo %IAB TCF Consent RGPD% che proviene anche da tcData che abbiamo acquisito nella funzione personalizzata dell’evento regola di cui sopra. Se sai che il RGPD verrà o meno applicato ai visitatori di questo sito web, puoi selezionare Sì o No, a seconda dei casi, invece di utilizzare la scelta della variabile personalizzata (elemento dati). Puoi anche utilizzare la logica condizionale in un elemento dati per verificare se il RGPD è applicabile e restituire il valore appropriato.

In RGPD Contiene dati personali, seleziona l’opzione per indicare se i dati di questo utente contengono o meno dati personali. Un elemento dati in questo caso deve essere true o false.

Seleziona il pulsante blu Salva per salvare l’azione e il pulsante blu Salva (o Salva nella libreria) per salvare la regola. A questo punto, hai implementato correttamente l’elemento dati e la regola nei tag per impostare il consenso tramite l’estensione SDK per web con lo standard di consenso IAB TCF 2.0.

Passaggio 3: Salva nella libreria e genera

Se utilizzi il prerequisito libreria di lavoro, hai già salvato queste modifiche e generato la libreria di sviluppo:

Passaggio 4: Inspect e convalida della raccolta dati

Sul nostro sito, aggiorniamo la pagina e confermiamo la build della libreria nell’ estensione Debugger Chrome, nella sezione del menu tag :

Possiamo anche controllare la chiamata setConsent per gli standard Adobe 1.0 o 2.0 nella sezione debugger Platform Web SDK , selezionando sulla riga POST Body nella richiesta di rete dove vedi {"consent":[{"value":{"general":"in"},"version…:

Per convalidare la chiamata setConsent e la nostra regola per lo standard IAB TCF 2.0, utilizzeremo il banner di consenso OneTrust sul nostro sito di test per impostare le preferenze di consenso e creare i tcData descritti in precedenza:

Dopo aver selezionato “Accetto”, possiamo controllare la chiamata setConsent per lo standard IAB TCF 2.0 nella sezione debugger Platform Web SDK , selezionando sulla riga corpo di POST nella richiesta di rete in cui viene visualizzato {"consent":[{"value":"someAlphaNumericCharacters….

Qui vediamo i dati impostati in precedenza nei nostri elementi dati e nelle nostre regole di tag. La proprietà value contiene i dati tcString codificati visualizzati in precedenza.

OneTrust, Sourcepoint e altri CMP che implementano lo standard IAB TCF 2.0 produrranno tutti dati simili nelle nostre pagine. Possiamo acquisire tali dati e utilizzarli con l’estensione SDK per web nei tag utilizzando l’evento codice personalizzato nella regola creata in precedenza. Il codice personalizzato sarà lo stesso indipendentemente dalla CMP utilizzata per generare i dati IAB TCF 2.0. Il codice personalizzato può essere utilizzato anche con uno degli standard di consenso della piattaforma (1.0 o 2.0).

Invio di dati di consenso con eventi Experience

Potresti aver notato che non abbiamo fatto riferimento all’elemento dati "xdm-permissionStrings" creato in precedenza in un campo elemento dati in una delle nostre regole. Questo elemento dati è da utilizzare quando devi inviare i dati di consenso con un evento di esperienza.

Poiché questo elemento dati contiene tutti i campi richiesti per lo standard IAB TCF 2.0, è sufficiente fare riferimento all’elemento dati quando si inviano questi dati xdm con i tuoi eventi Experience:

Conclusione

Dopo aver esaminato e convalidato i dati, dovresti vedere come implementare e attivare i dati di consenso ottenuti da una CMP utilizzando l’estensione Platform Web SDK per Platform.

In questa pagina