setConsent
Il comando setConsent
indica al Web SDK se deve inviare dati (consenso), ignorare dati (rinuncia) o utilizzare defaultConsent
(consenso sconosciuto).
Il Web SDK supporta i seguenti standard:
-
Adobe standard: sono supportati sia gli standard 1.0 che 2.0.
-
IAB Transparency & Consent Framework: se utilizzi questo standard, il profilo cliente in tempo reale del visitatore viene aggiornato con le informazioni sul consenso se l'implementazione è configurata correttamente:
- Lo schema di profilo individuale XDM contiene il gruppo di campi Consenso IAB TCF 2.0.
- Lo schema Experience Event contiene il gruppo di campi Consenso IAB TCF 2.0.
- Includi le informazioni sul consenso IAB nell'evento oggetto XDM. Il Web SDK non include automaticamente le informazioni sul consenso durante l’invio dei dati dell’evento.
Dopo aver utilizzato questo comando, il Web SDK scrive le preferenze dell'utente in un cookie. La prossima volta che l’utente carica il sito web nel browser, SDK recupera queste preferenze persistenti per determinare se gli eventi possono essere inviati ad Adobe.
Adobe consiglia di memorizzare le preferenze della finestra di dialogo sul consenso separatamente dal consenso per Web SDK. Il Web SDK non offre un modo per recuperare il consenso. Per assicurarsi che le preferenze utente rimangano sincronizzate con SDK, è possibile chiamare il comando setConsent
a ogni caricamento di pagina. Il Web SDK effettua una chiamata al server solo quando cambia il consenso.
Considerazioni sulla sincronizzazione delle identità identity-considerations
Il comando setConsent
utilizza solo ECID
dalla mappa delle identità, in quanto il comando opera a livello di dispositivo. Altre identità della mappa delle identità non vengono prese in considerazione dal comando setConsent
.
Utilizzo di defaultConsent
insieme a setConsent
using-consent
Il Web SDK offre due comandi di configurazione del consenso complementari:
defaultConsent
: questo comando ha lo scopo di acquisire le preferenze di consenso dei clienti di Adobe che utilizzano Web SDK.setConsent
: questo comando ha lo scopo di acquisire le preferenze di consenso dei visitatori del tuo sito.
Se utilizzate insieme, queste impostazioni possono portare a risultati diversi di raccolta dati e impostazione dei cookie, a seconda dei valori configurati.
Vedi la tabella seguente per capire quando si verifica la raccolta dei dati e quando vengono impostati i cookie, in base alle impostazioni del consenso.
in
in
in
out
in
pending
in
pending
out
pending
out
in
out
out
out
I seguenti cookie vengono impostati quando la configurazione del consenso consente:
idMigrationEnabled
è abilitato. Questa funzione risulta utile durante la transizione al Web SDK mentre alcune parti del sito utilizzano ancora visitor.js
.s_ecid=MCMID|<ECID>
.Impostare il consenso utilizzando l’estensione tag Web SDK
L’impostazione del consenso viene eseguita come azione all’interno di una regola nell’interfaccia dei tag di raccolta dati di Adobe Experience Platform.
- Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.
- Passa a Raccolta dati > Tag.
- Seleziona la proprietà tag desiderata.
- Passa a Regole, quindi seleziona la regola desiderata.
- In Azioni, seleziona un'azione esistente o creane una.
- Imposta il campo a discesa Estensione su Adobe Experience Platform Web SDK e imposta Tipo azione su Imposta consenso.
- Imposta i campi desiderati a destra, tra cui Standard e Consenso generale.
- Fai clic su Mantieni modifiche, quindi esegui il flusso di lavoro di pubblicazione.
In questa azione puoi includere più oggetti di consenso.
Impostare il consenso utilizzando la libreria JavaScript di Web SDK
Eseguire il comando setConsent
quando si chiama l'istanza configurata del Web SDK. In questo comando è possibile includere i seguenti oggetti:
consent[]
: matrice diconsent
oggetti. L’oggetto consenso è formattato in modo diverso a seconda dello standard e della versione scelti. Consulta le schede seguenti per esempi di ciascun oggetto di consenso, a seconda dello standard di consenso.identityMap
: oggetto che controlla come viene generato un ECID e a quali ID sono associate le informazioni sul consenso. Adobe consiglia di includere questo oggetto quandosetConsent
viene eseguito prima di altri comandi, ad esempiosendEvent
.edgeConfigOverrides
: oggetto contenente sostituzioni della configurazione dello stream di dati.
Oggetto consent
standard Adobe 2.0
Se utilizzi Adobe Experience Platform, devi includere un gruppo di campi dello schema di privacy nello schema del profilo. Consulta Governance, privacy e sicurezza in Adobe Experience Platform per ulteriori informazioni sullo standard Adobe 2.0. Puoi aggiungere dati all'interno dell'oggetto valore seguente corrispondenti allo schema del campo consents
del gruppo di campi del profilo Consensi e preferenze.
-
standard
: lo standard di consenso scelto. Imposta questa proprietà su"Adobe"
per lo standard Adobe 2.0. -
version
: stringa che rappresenta la versione dello standard di consenso. Imposta questa proprietà su"2.0"
per lo standard Adobe 2.0. -
value
: oggetto contenente i valori di consenso.value.collect.val
: valore del consenso. Impostare su"y"
quando gli utenti acconsentono e su"n"
quando gli utenti rinunciano.value.metadata.time
: la marca temporale dell'ultimo aggiornamento delle impostazioni di consenso da parte degli utenti.
code language-js |
---|
|
Oggetto consent
standard IAB TCF 2.0
Per registrare le preferenze di consenso dell’utente fornite tramite lo standard Interactive Advertising Bureau Europe (IAB) Transparency and Consent Framework (TCF), imposta la stringa di consenso come mostrato di seguito.
Se il consenso è impostato in questo modo, Real-Time Customer Profile viene aggiornato con le informazioni sul consenso. Affinché ciò funzioni, lo schema XDM del profilo deve contenere il gruppo di campi dello schema di privacy del profilo 🔗. Durante l’invio di eventi, le informazioni sul consenso IAB devono essere aggiunte manualmente all’oggetto XDM dell’evento. Il Web SDK non include automaticamente le informazioni sul consenso negli eventi.
Per inviare le informazioni sul consenso negli eventi, è necessario aggiungere il gruppo di campi Privacy evento esperienza allo schema XDM ExperienceEvent abilitato per Profile. Consulta la sezione sull'aggiornamento dello schema ExperienceEvent🔗 nella guida alla preparazione del set di dati per i passaggi su come configurare questo elemento.
standard
: lo standard di consenso scelto. Impostare questa proprietà su"IAB TCF"
per lo standard IAB TCF 2.0.version
: stringa che rappresenta la versione dello standard di consenso. Impostare questa proprietà su"2.0"
per lo standard IAB TCF 2.0.value
: stringa contenente il valore del consenso.gdprApplies
: valore booleano che determina se il RGPD si applica a questo valore di consenso. Il valore predefinito ètrue
.gdprContainsPersonalData
: valore booleano che determina se i dati evento associati all'utente contengono dati personali. Il valore predefinito èfalse
.
code language-js |
---|
|
Oggetto consent
standard Adobe 1.0
standard
: lo standard di consenso scelto. Imposta questa proprietà su"Adobe"
per lo standard Adobe 1.0.version
: stringa che rappresenta la versione dello standard di consenso. Imposta questa proprietà su"1.0"
per lo standard Adobe 1.0.value.general
: valore del consenso. Impostare su"in"
quando gli utenti acconsentono e su"out"
quando gli utenti rinunciano.
code language-js |
---|
|
Invio di più standard in una richiesta multiple-standards
Il Web SDK supporta anche l’invio di più oggetti di consenso in una richiesta, come illustrato nell’esempio seguente.
alloy("setConsent", {
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: {
val: "y"
},
metadata: {
time: "2021-03-17T15:48:42-07:00"
}
}
}, {
standard: "IAB TCF",
version: "2.0",
value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
gdprApplies: true
}]
});
Persistenza delle preferenze di consenso persistence
Dopo aver comunicato le preferenze utente al Web SDK utilizzando il comando setConsent
, SDK mantiene le preferenze utente a un cookie. Al successivo caricamento del sito web nel browser, il Web SDK recupererà e utilizzerà queste preferenze persistenti per determinare se è possibile inviare o meno eventi ad Adobe.
Per visualizzare la finestra di dialogo di consenso con le preferenze correnti, è necessario memorizzare le preferenze utente in modo indipendente. Non è possibile recuperare le preferenze utente dal Web SDK. Per assicurarsi che le preferenze utente rimangano sincronizzate con SDK, è possibile chiamare il comando setConsent
a ogni caricamento di pagina. Il Web SDK effettuerà una chiamata al server solo se le preferenze sono cambiate.