setConsent

Il comando setConsent indica all'SDK Web se deve inviare dati (consenso), ignorare dati (rinuncia) o utilizzare defaultConsent (consenso sconosciuto).

L’SDK per web supporta i seguenti standard:

Dopo aver utilizzato questo comando, Web SDK scrive le preferenze dell’utente in un cookie. La prossima volta che l’utente carica il sito web nel browser, l’SDK recupera queste preferenze persistenti per determinare se gli eventi possono essere inviati a Adobe.

L’Adobe consiglia di memorizzare le preferenze della finestra di dialogo di consenso separatamente dal consenso dell’SDK per web. L’SDK per web non offre un modo per recuperare il consenso. Per assicurarsi che le preferenze utente rimangano sincronizzate con l'SDK, è possibile chiamare il comando setConsent a ogni caricamento di pagina. L’SDK web effettua una chiamata al server solo quando cambia il consenso.

Utilizzo di defaultConsent insieme a setConsent using-consent

L’SDK per web offre due comandi di configurazione del consenso complementari:

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.

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

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.

In questa azione puoi includere più oggetti di consenso.

Impostare il consenso utilizzando la libreria JavaScript dell’SDK per web

Esegui il comando setConsent quando chiami l'istanza configurata dell'SDK Web. In questo comando è possibile includere i seguenti oggetti:

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

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

// 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

L’SDK per web 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 all'SDK Web utilizzando il comando setConsent, l'SDK mantiene le preferenze utente a un cookie. La prossima volta che l’utente carica il sito web nel browser, l’SDK web recupererà e utilizzerà queste preferenze persistenti per determinare se gli eventi possono essere inviati o meno a 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 dall’SDK per web. Per assicurarsi che le preferenze utente rimangano sincronizzate con l'SDK, è possibile chiamare il comando setConsent a ogni caricamento di pagina. L’SDK web effettua una chiamata al server solo se le preferenze sono cambiate.

Sincronizzazione delle identità durante la configurazione del consenso sync-identities

Quando il consenso predefinito (impostato tramite il parametro defaultConsent) è impostato su pending o out, l'impostazione setConsent potrebbe essere la prima richiesta che viene inviata e stabilisce l'identità. Per questo motivo, potrebbe essere importante sincronizzare le identità alla prima richiesta. È possibile aggiungere la mappa delle identità al comando setConsent come nel comando sendEvent. Consulta using identityMap per un esempio di come includere la mappa delle identità nel comando.