DocumentazioneExperience PlatformGuida di Experience Data Model (XDM)

Tipo di dati Consensi e preferenze

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Il tipo di dati Consenso per privacy, Personalization e preferenze marketing (di seguito denominato "Consensi e preferenze") è un tipo di dati Experience Data Model (XDM) destinato a supportare la raccolta di autorizzazioni e preferenze del cliente generate dalle piattaforme di gestione del consenso (CMP) e da altre origini dalle operazioni dei dati.

Questo documento descrive la struttura e l'uso previsto dei campi forniti dal tipo di dati Consensi e preferenze.

Prerequisiti prerequisites

Questo documento richiede una buona conoscenza di XDM e dell'utilizzo degli schemi in Experience Platform. Prima di continuare, consulta la seguente documentazione:

Struttura del tipo di dati structure

IMPORTANT
Il tipo di dati Consensi e preferenze è progettato per coprire una serie di casi di utilizzo della gestione del consenso e delle preferenze. Di conseguenza, questo documento descrive l’utilizzo dei campi del tipo di dati in termini generali e fornisce solo suggerimenti su come interpretare l’utilizzo di tali campi. Consulta il team legale della tua privacy per allineare la struttura del tipo di dati con il modo in cui la tua organizzazione interpreta e presenta ai clienti queste scelte di consenso e preferenze.

Il tipo di dati Consensi e preferenze fornisce diversi campi utilizzati per acquisire le informazioni relative a consenso e preferenza.

Il consenso è un’opzione che consente al cliente di specificare in che modo i suoi dati possono essere utilizzati. La maggior parte dei consensi ha un aspetto legale, in quanto alcune giurisdizioni richiedono di ottenere l'autorizzazione prima che i dati possano essere utilizzati in un modo particolare, o richiedono che il cliente abbia la possibilità di interrompere tale utilizzo (opt-out) se non è richiesto il consenso affermativo.

Una preferenza è un’opzione che consente al cliente di specificare in che modo devono essere gestiti i diversi aspetti della sua esperienza con un marchio. Questi rientrano in due categorie:

  • Preferenze Personalization: preferenze relative al modo in cui il brand deve personalizzare le esperienze consegnate a un cliente.
  • Preferenze di marketing: preferenze relative alla possibilità per un marchio di contattare un cliente tramite vari canali.

La schermata seguente mostra come la struttura del tipo di dati è rappresentata nell’interfaccia utente di Experience Platform:

TIP
Consulta la guida su esplorazione delle risorse XDM in per i passaggi su come cercare qualsiasi risorsa XDM e ispezionarne la struttura nell'interfaccia utente di Experience Platform.

Il seguente codice JSON mostra un esempio del tipo di dati che il tipo di dati Consensi e preferenze può elaborare. Le informazioni sull’uso specifico di ciascuno di questi campi sono fornite nelle sezioni seguenti.

{
  "consents": {
    "collect": {
      "val": "VI",
    },
    "adID": {
      "idType": "IDFA",
      "val": "y"
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "u"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}
TIP
Puoi generare dati JSON di esempio per qualsiasi schema XDM definito in Experience Platform al fine di aiutare a visualizzare come mappare i dati sul consenso dei clienti e sulle preferenze. Per ulteriori informazioni, consulta la seguente documentazione:

consents choices

consents contiene diversi campi che descrivono i consensi e le preferenze di un cliente. Questi campi sono descritti più dettagliatamente nelle sottosezioni seguenti.

"consents": {
  "collect": {
    "val": "VI",
  },
  "adID": {
    "idType": "IDFA",
    "val": "y"
  },
  "share": {
    "val": "y",
  },
  "personalize": {
    "content": {
      "val": "y"
    }
  },
  "marketing": {
    "preferred": "email",
    "any": {
      "val": "u"
    },
    "email": {
      "val": "n",
      "reason": "Too Frequent",
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

collect

collect rappresenta il consenso del cliente alla raccolta dei dati.

"collect": {
  "val": "y"
}
Proprietà
Descrizione
val
La scelta del consenso fornito dal cliente per questo caso d’uso. Per informazioni sui valori e le definizioni accettati, vedere appendice.

adID

adID rappresenta il consenso del cliente sulla possibilità di utilizzare un ID inserzionista per collegare il cliente tra le app su questo dispositivo.

"adID": {
  "idType": "IDFA",
  "val": "y"
}
Proprietà
Descrizione
idType
Il tipo di ID annuncio, IDFA per l'ID di Apple per gli inserzionisti o GAID per l'ID dell'inserzionista di Google, noto anche come ID dell'inserzionista di Android (AAID).
val
La scelta del consenso fornito dal cliente per questo caso d’uso. Per informazioni sui valori e le definizioni accettati, vedere appendice.

share

share rappresenta il consenso del cliente per la condivisione dei dati con (o la vendita a) seconde o terze parti.

"share": {
  "val": "y"
}
Proprietà
Descrizione
val
La scelta del consenso fornito dal cliente per questo caso d’uso. Per informazioni sui valori e le definizioni accettati, vedere appendice.

personalize personalize

personalize acquisisce le preferenze del cliente relative ai modi in cui i suoi dati possono essere utilizzati per la personalizzazione. I clienti possono rinunciare a casi di utilizzo di personalizzazione specifici o rinunciare completamente alla personalizzazione.

IMPORTANT
personalize non copre i casi di utilizzo del marketing. Ad esempio, se un cliente rinuncia alla personalizzazione per tutti i canali, non deve interrompere la ricezione di comunicazioni attraverso tali canali. Piuttosto, i messaggi che ricevono devono essere generici e non basati sul loro profilo.
Nello stesso esempio, se un cliente rinuncia al marketing diretto per tutti i canali (tramite marketing, illustrato nella sezione successiva), il cliente non deve ricevere messaggi, anche se la personalizzazione è consentita.
"personalize": {
  "content": {
    "val": "y",
  }
}
Proprietà
Descrizione
content
Rappresenta le preferenze del cliente per i contenuti personalizzati sul sito web o sull’applicazione.
val
Preferenza di personalizzazione fornita dal cliente per il caso d’uso specificato. Nei casi in cui al cliente non debba essere richiesto di fornire il consenso, il valore di questo campo deve indicare la base su cui deve aver luogo la personalizzazione. Per informazioni sui valori e le definizioni accettati, vedere appendice.

marketing marketing

marketing acquisisce le preferenze del cliente per quanto riguarda gli scopi di marketing per i quali i suoi dati possono essere utilizzati. I clienti possono rinunciare a casi di utilizzo di marketing specifici o rinunciare completamente al marketing diretto.

"marketing": {
  "preferred": "email",
  "any": {
    "val": "u"
  },
  "email": {
    "val": "n",
    "reason": "Too Frequent"
  },
  "push": {
    "val": "y"
  },
  "sms": {
    "val": "y"
  }
}
Proprietà
Descrizione
preferred
Indica il canale preferito dal cliente per la ricezione delle comunicazioni. Per i valori accettati, vedere appendice.
any
Rappresenta le preferenze del cliente per il marketing diretto nel suo complesso. La preferenza di consenso fornita in questo campo è considerata la preferenza "predefinita" per qualsiasi canale di marketing, a meno che non venga sostituita da ulteriori sottocampi forniti in marketing. Se prevedi di utilizzare opzioni di consenso più granulari, si consiglia di escludere questo campo.

Se il valore è impostato su n, tutte le impostazioni di personalizzazione più specifiche devono essere ignorate. Se il valore è impostato su y, anche tutte le opzioni di personalizzazione più dettagliate devono essere trattate come y, a meno che non sia impostato esplicitamente su n. Se il valore non è impostato, i valori per ogni opzione di personalizzazione devono essere rispettati come specificato.
email
Indica se il cliente accetta di ricevere messaggi e-mail.
push
Indica se il cliente consente la ricezione di notifiche push.
sms
Indica se il cliente accetta di ricevere SMS.
val
Preferenza fornita dal cliente per il caso d’uso specificato. Nei casi in cui al cliente non deve essere richiesto di fornire il consenso, il valore di questo campo dovrebbe indicare la base su cui dovrebbe basarsi il caso di utilizzo di marketing. Per informazioni sui valori e le definizioni accettati, vedere appendice.
time
Una marca temporale ISO 8601 indicante quando la preferenza di marketing è cambiata, se applicabile. Si noti che se il timestamp di una singola preferenza è uguale a quello fornito in metadata, questo campo non deve essere impostato per tale preferenza.
reason
Quando un cliente rinuncia a un caso di utilizzo di marketing, questo campo stringa rappresenta il motivo per cui il cliente ha rinunciato.

metadata

metadata acquisisce metadati generali sui consensi e le preferenze del cliente ogni volta che sono stati aggiornati per l'ultima volta.

"metadata": {
  "time": "2019-01-01T15:52:25+00:00",
}
Proprietà
Descrizione
time
Una marca temporale ISO 8601 per l’ultimo aggiornamento dei consensi e delle preferenze del cliente. Questo campo può essere utilizzato invece di applicare marche temporali alle singole preferenze per ridurre il carico e la complessità. Specificando un valore time in una singola preferenza si sostituisce la marca temporale metadata per quella particolare preferenza.

Acquisizione di dati tramite il tipo di dati ingest

Per utilizzare il tipo di dati Consensi e preferenze per acquisire i dati sul consenso dai clienti, è necessario creare un set di dati basato su uno schema che contiene tale tipo di dati.

Consulta l'esercitazione sulla creazione di uno schema nell'interfaccia utente per i passaggi su come assegnare tipi di dati ai campi. Dopo aver creato uno schema contenente un campo con tipo di dati Consensi e preferenze, consulta la sezione sulla creazione di un set di dati nella guida utente del set di dati, seguendo i passaggi per creare un set di dati con uno schema esistente.

IMPORTANT
Per inviare i dati sul consenso a Real-Time Customer Profile, è necessario creare uno schema abilitato per Profile basato sulla classe XDM Individual Profile che contiene il tipo di dati Consensi e preferenze. Il set di dati creato in base a tale schema deve essere abilitato anche per Profile. Fare riferimento ai tutorial collegati in precedenza per i passaggi specifici relativi ai requisiti di Real-Time Customer Profile per schemi e set di dati.
Inoltre, devi anche assicurarti che i criteri di unione siano configurati per assegnare la priorità ai set di dati che contengono i dati di consenso e preferenze più recenti, al fine di aggiornare correttamente i profili dei clienti. Per ulteriori informazioni, consulta la panoramica sui criteri di unione.

Gestione delle modifiche di consenso e preferenze

Quando un cliente modifica il proprio consenso o le proprie preferenze sul sito Web, le modifiche devono essere raccolte e applicate immediatamente tramite Adobe Experience Platform Web SDK. Se un cliente rinuncia alla raccolta dei dati, tutta la raccolta dei dati deve cessare immediatamente. Se un cliente rinuncia alla personalizzazione, significa che non dovrebbe essere presente alcuna personalizzazione nella pagina successiva in cui visita.

Appendice appendix

Le sezioni seguenti forniscono informazioni di riferimento aggiuntive relative al tipo di dati Consensi e preferenze.

Valori accettati per val choice-values

La tabella seguente illustra i valori accettati per val:

Valore
Titolo
Descrizione
y
Sì (consenso)
Il cliente ha acconsentito al consenso o alla preferenza. In altre parole, acconsentono all'utilizzo dei propri dati come indicato dal consenso o dalla preferenza in questione.
n
No (rinuncia)
Il cliente ha rinunciato al consenso o alla preferenza. In altre parole, non acconsentono all'utilizzo dei propri dati come indicato dal consenso o dalla preferenza in questione.
p
Verifica in sospeso
Il sistema non ha ancora ricevuto il consenso o il valore della preferenza finale. Questo viene spesso utilizzato come parte di un consenso che richiede una verifica in due fasi. Ad esempio, se un cliente acconsente alla ricezione di e-mail, tale consenso viene impostato su p fino a quando non seleziona un collegamento in un messaggio e-mail per verificare di aver fornito l'indirizzo e-mail corretto, nel qual caso il consenso verrà aggiornato a y.

Se il consenso o la preferenza non utilizza un processo di verifica a due set, è possibile utilizzare la scelta p per indicare che il cliente non ha ancora risposto alla richiesta di consenso. Ad esempio, puoi impostare automaticamente il valore su p nella prima pagina di un sito Web, prima che il cliente abbia risposto alla richiesta di consenso. Nelle giurisdizioni che non richiedono il consenso esplicito, è possibile utilizzarlo anche per indicare che il cliente non ha esplicitamente rinunciato (in altre parole, si presume il consenso).

Questo valore può essere acquisito in Profile utilizzando altri meccanismi, ad esempio l'acquisizione in streaming, ma non è supportato per la raccolta dati o la raccolta di consenso in Edge Network. Anche se il valore p non può essere inviato in modo esplicito, l'accodamento eventi viene comunque gestito da Web SDK e l'evento viene inviato a Edge Network dopo che il consenso dell'utente finale è stato esplicitamente in.
u
Sconosciuto
Le informazioni sul consenso o sulle preferenze del cliente sono sconosciute.
dy
Predefinito di Sì (consenso)
Il cliente non ha fornito un valore di consenso e viene trattato come un consenso ("Sì") per impostazione predefinita. In altre parole, si presume il consenso fino a quando il cliente non indica il contrario.

Se le leggi o le modifiche all'informativa sulla privacy della tua azienda determinano modifiche alle impostazioni predefinite di alcuni o di tutti gli utenti, devi aggiornare manualmente tutti i profili contenenti i valori predefiniti.
dn
Predefinito per No (rinuncia)
Il cliente non ha fornito un valore di consenso e per impostazione predefinita viene trattato come una rinuncia ("No"). In altre parole, si presume che il cliente abbia negato il consenso fino a quando non indica diversamente.

Se le leggi o le modifiche all'informativa sulla privacy della tua azienda determinano modifiche alle impostazioni predefinite di alcuni o di tutti gli utenti, devi aggiornare manualmente tutti i profili contenenti i valori predefiniti.
LI
Interesse legittimo
Il legittimo interesse commerciale a raccogliere e trattare tali dati per lo scopo specificato supera il potenziale danno che essi comportano per l’individuo.
CT
Contratto
La raccolta dei dati per lo scopo specificato è necessaria per adempiere agli obblighi contrattuali con la persona.
CP
Rispetto di un obbligo legale
La raccolta dei dati per lo scopo specificato è necessaria per soddisfare gli obblighi legali dell'impresa.
VI
Interesse vitale dell'individuo
La raccolta di dati per lo scopo specificato è necessaria per proteggere gli interessi vitali dell'individuo.
PI
Interesse pubblico
La raccolta di dati per lo scopo specificato è necessaria per svolgere un compito di interesse pubblico o nell'esercizio di pubblici poteri.

Valori accettati per preferred preferred-values

Nella tabella seguente sono illustrati i valori accettati per preferred. I valori preferred indicano il canale preferito dal cliente per la ricezione di comunicazioni con informazioni sulla raccolta di dati, le policy sulla privacy e le opzioni di personalizzazione.

Valore
Descrizione
email
Questa preferenza indica il consenso del cliente a ricevere messaggi tramite e-mail.
push
Questa preferenza indica il consenso del cliente alla ricezione di notifiche push. Si tratta di messaggi o avvisi inviati direttamente al loro dispositivo, spesso un’app mobile.
inApp
Questa preferenza indica il consenso del cliente alla ricezione dei messaggi in-app. Questi messaggi vengono inviati all’interno di un’app mobile o web e forniscono informazioni mentre l’utente è attivamente coinvolto con l’app.
sms
Questa preferenza indica il consenso del cliente alla ricezione di messaggi tramite SMS (Short Message Service). Si tratta di messaggi di testo inviati al cellulare.
phone
Questa preferenza indica il consenso del cliente a ricevere comunicazioni attraverso interazioni telefoniche.
phyMail
Questa preferenza indica il consenso del cliente a ricevere il materiale tramite posta fisica.
inVehicle
Questa preferenza indica il consenso del cliente a ricevere notifiche mentre si trova nel suo veicolo. Questi messaggi possono essere trasmessi attraverso i sistemi di infotainment del veicolo o altri canali di comunicazione a bordo del veicolo.
inHome
Questa preferenza indica il consenso del cliente alla ricezione dei messaggi mentre si trova a casa. Questi messaggi possono essere inviati tramite dispositivi smart home o altri canali di comunicazione basati su home.
iot
Questa preferenza indica il consenso del cliente a ricevere messaggi relativi all’Internet of Things (IoT). Questi messaggi possono essere inviati tramite dispositivi e sistemi collegati all'interno del proprio ambiente.
social
Questa preferenza indica il consenso del cliente a ricevere comunicazioni tramite le piattaforme di social media.
other
Questa preferenza include i canali che non rientrano nelle categorie standard. Rappresenta canali di comunicazione alternativi o specializzati che possono essere specifici per un particolare business o settore.
none
Questa preferenza indica che il cliente non dispone di un canale di comunicazione preferito.
unknown
Questa preferenza indica che il canale di comunicazione preferito dal cliente non è noto o non è stato specificato. Ciò potrebbe verificarsi se il cliente non ha fornito informazioni esplicite sul consenso o sulle preferenze.

Schema completo di consensi e preferenze full-schema

Per visualizzare lo schema completo per il tipo di dati Consensi e preferenze, fare riferimento al archivio XDM ufficiale.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07