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:

    1. Lo schema di profilo individuale XDM contiene il gruppo di campi Consenso IAB TCF 2.0.
    2. Lo schema Experience Event contiene il gruppo di campi Consenso IAB TCF 2.0.
    3. 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.

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.

defaultConsent
setConsent
La raccolta dei dati avviene
Web SDK imposta i cookie del browser
in
in
in
out
No
in
Non impostato
pending
in
pending
out
No
pending
Non impostato
No
No
out
in
out
out
No
out
Non impostato
No
No

I seguenti cookie vengono impostati quando la configurazione del consenso consente:

Nome
Età massima
Descrizione
AMCV_###@AdobeOrg
34128000 (395 giorni)
Presente quando idMigrationEnabled è abilitato. Questa funzione risulta utile durante la transizione al Web SDK mentre alcune parti del sito utilizzano ancora visitor.js.
Cookie demdex
15552000 (180 giorni)
Presente se la sincronizzazione ID è abilitata. Audience Manager imposta questo cookie per assegnare un ID univoco a un visitatore del sito. Il cookie demdex aiuta Audience Manager a eseguire funzioni di base come l’identificazione dei visitatori, la sincronizzazione degli ID, la segmentazione, la modellazione, il reporting e così via.
kndctr_orgid_cluster
1800 (30 minuti)
Memorizza l’area Edge Network che soddisfa le richieste dell’utente corrente. L’area viene utilizzata nel percorso URL in modo che Edge Network possa indirizzare la richiesta all’area corretta. Se un utente si connette con un indirizzo IP diverso o in una sessione diversa, la richiesta viene nuovamente indirizzata all’area più vicina.
kndct_orgid_identity
34128000 (395 giorni)
Memorizza l’ECID, così come altre informazioni relative all’ECID.
kndctr_orgid_consent
15552000 (180 giorni)
Memorizza le preferenze di consenso degli utenti per il sito Web.
s_ecid
63115200 (2 anni)
Contiene una copia dell'Experience Cloud ID (ECID) o MID. Il MID viene memorizzato in una coppia chiave/valore con sintassi 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.

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.
  2. Passa a Raccolta dati > Tag.
  3. Seleziona la proprietà tag desiderata.
  4. Passa a Regole, quindi seleziona la regola desiderata.
  5. In Azioni, seleziona un'azione esistente o creane una.
  6. Imposta il campo a discesa Estensione su Adobe Experience Platform Web SDK e imposta Tipo azione su Imposta consenso.
  7. Imposta i campi desiderati a destra, tra cui Standard e Consenso generale.
  8. 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 di consent 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 quando setConsent viene eseguito prima di altri comandi, ad esempio sendEvent.
  • edgeConfigOverrides: oggetto contenente sostituzioni della configurazione dello stream di dati.
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
// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});
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
// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});
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
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

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.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636