https://ns.adobe.com/xdm/datatypes/consent-preferences
This schema captures privacy, personalization and marketing preferences (consents).
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Defined In |
|---|---|---|---|---|---|---|
| Can be instantiated | Yes | Deprecated | No | Forbidden | Permitted | datatypes/deprecated-consentpreferences.schema.json |
{
"xdm:choices": {
"xdm:consents": {
"xdm:dataCollection": {
"xdm:choice": "yes",
"xdm:timestamp": "2019-01-01T15:52:25+00:00",
"xdm:basisOfProcessing": "consent"
},
"xdm:deviceLinking": {
"xdm:basisOfProcessing": "vital_interest"
},
"xdm:pseudonymousAnalysis": {
"xdm:choice": "no"
}
},
"xdm:personalizationPreferences": {
"xdm:anyPersonalization": {
"xdm:choice": "unknown",
"xdm:timestamp": "2019-01-01T15:52:25+00:00",
"xdm:basisOfProcessing": "consent"
},
"xdm:email": {
"xdm:choice": "yes"
},
"xdm:pushNotifications": {
"xdm:choice": "no",
"xdm:basisOfProcessing": "legitimate_interest",
"xdm:timestamp": "2019-01-01T15:52:25+00:00"
}
},
"xdm:marketingPreferences": {
"xdm:preferredChannel": "email",
"xdm:anyMarketing": {
"xdm:choice": "yes"
},
"xdm:email": {
"xdm:choice": "yes"
},
"xdm:pushNotifications": {
"xdm:choice": "no",
"xdm:reason": "not relevant"
},
"xdm:iot": {
"xdm:choice": "yes",
"xdm:timestamp": "2019-01-01T15:52:25+00:00",
"xdm:basisOfProcessing": "legitimate_interest"
}
}
},
"xdm:choicesMetadata": {
"xdm:version": "1.0.0",
"xdm:timestamp": "2019-01-01T15:52:25+00:00",
"xdm:source": "BestCMP",
"xdm:userIDfromSource": "12F5B902C89EA592",
"xdm:userCountryRegionCode": "US-CA",
"xdm:countryRegionSource": "ip"
}
}| Property | Type | Required | Defined by |
|---|---|---|---|
| xdm:choices | complex | Optional | Privacy/Marketing Preferences (Consent) (this schema) |
| xdm:choicesMetadata | complex | Optional | Privacy/Marketing Preferences (Consent) (this schema) |
* |
any | Additional | this schema allows additional properties |
Specific Consent and Preference Options
xdm:choices
- is optional
- type: complex
- defined in this schema
Unknown type ``.
{
"properties": {
"xdm:consents": {
"title": "Consents",
"description": "Encapsulates user consents.",
"type": "object",
"properties": {
"xdm:dataCollection": {
"title": "Data Collection",
"description": "Data collection is permitted",
"$ref": "#/definitions/consent-fields"
},
"xdm:sellData": {
"title": "Sell Data",
"description": "Selling of user's Data to 2nd or 3rd parties is permitted",
"$ref": "#/definitions/consent-fields"
},
"xdm:shareData": {
"title": "Share Data",
"description": "Sharing of user's Data with 2nd or 3rd parties is permitted",
"$ref": "#/definitions/consent-fields"
},
"xdm:pseudonymousAnalysis": {
"title": "Pseudonymous Analysis",
"description": "Data can be used for analysis that may include an ID that may or may not be tied to an actual person",
"$ref": "#/definitions/consent-fields"
},
"xdm:deviceLinking": {
"title": "Device Linking",
"description": "Attempts to link multiple devices belonging to an individual or household are permitted",
"$ref": "#/definitions/consent-fields"
}
}
},
"xdm:personalizationPreferences": {
"title": "Personalization Preferences",
"description": "User's Personalization Preferences",
"type": "object",
"properties": {
"xdm:anyPersonalization": {
"title": "General Personalization Preference",
"description": "Is permission granted to perform any type of personalization",
"$ref": "#/definitions/personalization-fields"
},
"xdm:email": {
"title": "Personalize email",
"description": "Allow personalization of emails sent to the user",
"$ref": "#/definitions/personalization-fields"
},
"xdm:physicalMail": {
"title": "Personalize physical mail",
"description": "Allow personalization of offers sent via traditional/physical mail",
"$ref": "#/definitions/personalization-fields"
},
"xdm:pushNotifications": {
"title": "Personalize push notifications",
"description": "Personalization of push notifications is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:sms": {
"title": "Personalize SMS",
"description": "Personalization of text messages is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:phoneCalls": {
"title": "Personalize phone calls",
"description": "Allow phone calls that the brand initiates to be personalized based on the user's interests or behavior",
"$ref": "#/definitions/personalization-fields"
},
"xdm:iotDevices": {
"title": "Personalize IoT Devices",
"description": "Personalization of interactions with IoT devices is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:socialMedia": {
"title": "Personalize Social Media",
"description": "Personalization of interactions on Social Media sites/apps is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:inAppMessages": {
"title": "Personalize in-app messages",
"description": "Allow personalization of messages displayed within my apps",
"$ref": "#/definitions/personalization-fields"
},
"xdm:inVehicle": {
"title": "Personalize in-vehicle",
"description": "Personalization of in-vehicle experiences is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:inHome": {
"title": "Personalize in-home",
"description": "Personalization of in-home experiences is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:inStore": {
"title": "Personalize in-store",
"description": "Personalization of in-store experiences is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:content": {
"title": "Personalize content",
"description": "Allow personalization of the content on my site or in my apps",
"$ref": "#/definitions/personalization-fields"
},
"xdm:offers": {
"title": "Personalize Offers",
"description": "Allow personalization of 1st-party offers displayed on this site or with this app",
"$ref": "#/definitions/personalization-fields"
},
"xdm:customerSupport": {
"title": "Personalize customer support",
"description": "Allow customer support to personalize responses/suggestions based on user's interests or behavior",
"$ref": "#/definitions/personalization-fields"
},
"xdm:thirdPartyOffers": {
"title": "Personalize ",
"description": "Personalization of third-party offers/ads displayed on this brand's sites or apps is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:thirdPartyContent": {
"title": "Personalize ",
"description": "Personalization of third-party content displayed on this brand's sites or apps is permitted",
"$ref": "#/definitions/personalization-fields"
},
"xdm:advertising": {
"title": "Personalize Ads",
"description": "Personalization of this brand's ads on third-party sites/apps is permitted",
"$ref": "#/definitions/personalization-fields"
}
}
},
"xdm:marketingPreferences": {
"title": "Marketing Preferences",
"description": "User's Direct Marketing Preferences",
"type": "object",
"properties": {
"xdm:preferredChannel": {
"title": "Preferred Channel",
"description": "User's preferred channel for receiving communications",
"type": "string",
"enum": [
"email",
"push_notifications",
"in_app_messages",
"sms",
"phone_calls",
"physical_mail",
"inVehicle_messages",
"in_home_messages",
"iot_messages",
"social_media",
"other",
"none",
"unknown"
],
"meta:enum": {
"email": "email",
"push_notifications": "Push Notifications",
"in_app_messages": "In-app Messages",
"sms": "SMS (Text Messages)",
"phone_calls": "Phone Calls",
"physical_mail": "Physical Mail",
"inVehicle_messages": "In-vehicle Messages",
"in_home_messages": "In-home Messages",
"iot": "IoT Messages",
"social_media": "Social Media",
"other": "Other",
"no_preferred": "No Preferred Channel",
"unknown": "Unknown"
}
},
"xdm:anyMarketing": {
"title": "General Direct Marketing Preference",
"description": "Does user permit any type of direct marketing",
"$ref": "#/definitions/marketing-fields"
},
"xdm:email": {
"title": "Receive email",
"description": "User agrees to receive email",
"$ref": "#/definitions/marketing-fields"
},
"xdm:physicalMail": {
"title": "Receive physical mail",
"description": "User agrees to being contacted via traditional/physical mail.",
"$ref": "#/definitions/marketing-fields"
},
"xdm:pushNotifications": {
"title": "Receive push notifications",
"description": "User permits receiving push notifications",
"$ref": "#/definitions/marketing-fields"
},
"xdm:sms": {
"title": "Receive SMS",
"description": "User agrees to receive text messages",
"$ref": "#/definitions/marketing-fields"
},
"xdm:phoneCalls": {
"title": "Receive phone calls",
"description": "The brand may contact the user via phone",
"$ref": "#/definitions/marketing-fields"
},
"xdm:iotMessages": {
"title": "Receive IoT messages",
"description": "It is okay to interact with the user via IoT devices",
"$ref": "#/definitions/marketing-fields"
},
"xdm:socialMedia": {
"title": "Receive Social Media Messages",
"description": "It is okay to send messages to the user on their social media accounts",
"$ref": "#/definitions/marketing-fields"
},
"xdm:inAppMessages": {
"title": "Receive in-app messages",
"description": "User permits messages to be shown within the brands's apps",
"$ref": "#/definitions/marketing-fields"
},
"xdm:inVehicleMessages": {
"title": "Receive in-vehicle messages",
"description": "It is okay to interact with the user via technology installed in the user's vehicle",
"$ref": "#/definitions/marketing-fields"
},
"xdm:inHomeMessages": {
"title": "Receive in-home messages",
"description": "It is okay to interact with the user via technology installed in the user's home",
"$ref": "#/definitions/marketing-fields"
}
}
}
},
"title": "Consent and Preference Choices",
"description": "Specific Consent and Preference Options",
"simpletype": "complex"
}Metadata that applies to all consents and preferences that don't specify a different value
xdm:choicesMetadata
- is optional
- type: complex
- defined in this schema
Unknown type ``.
{
"properties": {
"xdm:version": {
"title": "Consent Schema Version",
"description": "Version of the Consents and Preferences Schema",
"type": "string",
"pattern": "^[0-9]{1,2}\\.[0-9]{1,2}\\.[0-9]{1,4}$",
"default": "1.0.0"
},
"xdm:timestamp": {
"title": "Consent/Preferences timestamp",
"description": "Timestamp of this complete set of user consents and preferences",
"type": "string",
"format": "date-time"
},
"xdm:source": {
"title": "Consent/Preferences source",
"description": "Through which interface did the user provide their choices for this complete set of user consents and preferences",
"$ref": "#/definitions/source"
},
"xdm:userIDfromSource": {
"title": "Source's ID for the user",
"description": "Source's ID for the user",
"type": "string",
"maxLength": 20
},
"xdm:userCountryRegionCode": {
"title": "User Country (and optionally Region) Code",
"description": "ISO 3166 alpha2 country code or ISO 3166-2 country plus state/province code for use in helping to determine how to interpret consent values",
"type": "string",
"maxLength": 6,
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3}){0,1}$"
},
"xdm:countryRegionSource": {
"title": "Country/Region Source",
"description": "Method used to determine the user's country/region",
"type": "string",
"enum": [
"ip",
"gps",
"user_provided",
"website_location",
"inferred",
"other"
],
"meta:enum": {
"ip": "IP Address",
"gps": "Device GPS",
"user_provided": "User Provided",
"website_location": "Website location or eTLD",
"inferred": "Inferred",
"other": "Other"
}
}
},
"title": "Consent and Preference Metadata",
"description": "Metadata that applies to all consents and preferences that don't specify a different value",
"simpletype": "complex"
}| Property | Type | Group |
|---|---|---|
| xdm:basisOfProcessing | reference | https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/marketing-fields |
| xdm:choice | reference | https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/marketing-fields |
| xdm:consents | object |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/choices |
| xdm:countryRegionSource | enum |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/metadata |
| xdm:marketingPreferences | object |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/choices |
| xdm:personalizationPreferences | object |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/choices |
| xdm:reason | string |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/marketing-fields |
| xdm:source | reference | https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/metadata |
| xdm:timestamp | string |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/metadata |
| xdm:userCountryRegionCode | string |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/metadata |
| xdm:userIDfromSource | string |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/metadata |
| xdm:version | string |
https://ns.adobe.com/xdm/datatypes/consent-preferences#/definitions/metadata |
xdm:basisOfProcessing
- is optional
- type: reference
- defined in this schema
xdm:choice
- is optional
- type: reference
- defined in this schema
Encapsulates user consents.
xdm:consents
- is optional
- type:
object - defined in this schema
object with following properties:
| Property | Type | Required |
|---|---|---|
xdm:dataCollection |
Optional | |
xdm:deviceLinking |
Optional | |
xdm:pseudonymousAnalysis |
Optional | |
xdm:sellData |
Optional | |
xdm:shareData |
Optional |
Data collection is permitted
xdm:dataCollection
- is optional
- type: reference
Attempts to link multiple devices belonging to an individual or household are permitted
xdm:deviceLinking
- is optional
- type: reference
Data can be used for analysis that may include an ID that may or may not be tied to an actual person
xdm:pseudonymousAnalysis
- is optional
- type: reference
Selling of user's Data to 2nd or 3rd parties is permitted
xdm:sellData
- is optional
- type: reference
Sharing of user's Data with 2nd or 3rd parties is permitted
xdm:shareData
- is optional
- type: reference
Method used to determine the user's country/region
xdm:countryRegionSource
- is optional
- type:
enum - defined in this schema
The value of this property must be equal to one of the known values below.
| Value | Description |
|---|---|
ip |
IP Address |
gps |
Device GPS |
user_provided |
User Provided |
website_location |
Website location or eTLD |
inferred |
Inferred |
other |
Other |
User's Direct Marketing Preferences
xdm:marketingPreferences
- is optional
- type:
object - defined in this schema
object with following properties:
| Property | Type | Required |
|---|---|---|
xdm:anyMarketing |
Optional | |
xdm:email |
Optional | |
xdm:inAppMessages |
Optional | |
xdm:inHomeMessages |
Optional | |
xdm:inVehicleMessages |
Optional | |
xdm:iotMessages |
Optional | |
xdm:phoneCalls |
Optional | |
xdm:physicalMail |
Optional | |
xdm:preferredChannel |
string | Optional |
xdm:pushNotifications |
Optional | |
xdm:sms |
Optional | |
xdm:socialMedia |
Optional |
Does user permit any type of direct marketing
xdm:anyMarketing
- is optional
- type: reference
User agrees to receive email
xdm:email
- is optional
- type: reference
User permits messages to be shown within the brands's apps
xdm:inAppMessages
- is optional
- type: reference
It is okay to interact with the user via technology installed in the user's home
xdm:inHomeMessages
- is optional
- type: reference
It is okay to interact with the user via technology installed in the user's vehicle
xdm:inVehicleMessages
- is optional
- type: reference
It is okay to interact with the user via IoT devices
xdm:iotMessages
- is optional
- type: reference
The brand may contact the user via phone
xdm:phoneCalls
- is optional
- type: reference
User agrees to being contacted via traditional/physical mail.
xdm:physicalMail
- is optional
- type: reference
User's preferred channel for receiving communications
xdm:preferredChannel
- is optional
- type:
enum
The value of this property must be equal to one of the known values below.
| Value | Description |
|---|---|
email |
|
push_notifications |
Push Notifications |
in_app_messages |
In-app Messages |
sms |
SMS (Text Messages) |
phone_calls |
Phone Calls |
physical_mail |
Physical Mail |
inVehicle_messages |
In-vehicle Messages |
in_home_messages |
In-home Messages |
iot |
IoT Messages |
social_media |
Social Media |
other |
Other |
no_preferred |
No Preferred Channel |
unknown |
Unknown |
iot_messages |
|
none |
User permits receiving push notifications
xdm:pushNotifications
- is optional
- type: reference
User agrees to receive text messages
xdm:sms
- is optional
- type: reference
It is okay to send messages to the user on their social media accounts
xdm:socialMedia
- is optional
- type: reference
User's Personalization Preferences
xdm:personalizationPreferences
- is optional
- type:
object - defined in this schema
object with following properties:
| Property | Type | Required |
|---|---|---|
xdm:advertising |
Optional | |
xdm:anyPersonalization |
Optional | |
xdm:content |
Optional | |
xdm:customerSupport |
Optional | |
xdm:email |
Optional | |
xdm:inAppMessages |
Optional | |
xdm:inHome |
Optional | |
xdm:inStore |
Optional | |
xdm:inVehicle |
Optional | |
xdm:iotDevices |
Optional | |
xdm:offers |
Optional | |
xdm:phoneCalls |
Optional | |
xdm:physicalMail |
Optional | |
xdm:pushNotifications |
Optional | |
xdm:sms |
Optional | |
xdm:socialMedia |
Optional | |
xdm:thirdPartyContent |
Optional | |
xdm:thirdPartyOffers |
Optional |
Personalization of this brand's ads on third-party sites/apps is permitted
xdm:advertising
- is optional
- type: reference
Is permission granted to perform any type of personalization
xdm:anyPersonalization
- is optional
- type: reference
Allow personalization of the content on my site or in my apps
xdm:content
- is optional
- type: reference
Allow customer support to personalize responses/suggestions based on user's interests or behavior
xdm:customerSupport
- is optional
- type: reference
Allow personalization of emails sent to the user
xdm:email
- is optional
- type: reference
Allow personalization of messages displayed within my apps
xdm:inAppMessages
- is optional
- type: reference
Personalization of in-home experiences is permitted
xdm:inHome
- is optional
- type: reference
Personalization of in-store experiences is permitted
xdm:inStore
- is optional
- type: reference
Personalization of in-vehicle experiences is permitted
xdm:inVehicle
- is optional
- type: reference
Personalization of interactions with IoT devices is permitted
xdm:iotDevices
- is optional
- type: reference
Allow personalization of 1st-party offers displayed on this site or with this app
xdm:offers
- is optional
- type: reference
Allow phone calls that the brand initiates to be personalized based on the user's interests or behavior
xdm:phoneCalls
- is optional
- type: reference
Allow personalization of offers sent via traditional/physical mail
xdm:physicalMail
- is optional
- type: reference
Personalization of push notifications is permitted
xdm:pushNotifications
- is optional
- type: reference
Personalization of text messages is permitted
xdm:sms
- is optional
- type: reference
Personalization of interactions on Social Media sites/apps is permitted
xdm:socialMedia
- is optional
- type: reference
Personalization of third-party content displayed on this brand's sites or apps is permitted
xdm:thirdPartyContent
- is optional
- type: reference
Personalization of third-party offers/ads displayed on this brand's sites or apps is permitted
xdm:thirdPartyOffers
- is optional
- type: reference
Reason for opting out
xdm:reason
- is optional
- type:
string - defined in this schema
string
- maximum length: 20 characters
Through which interface did the user provide their choices for this complete set of user consents and preferences
xdm:source
- is optional
- type: reference
- defined in this schema
Timestamp of this complete set of user consents and preferences
xdm:timestamp
- is optional
- type:
string - defined in this schema
string
- format:
date-time– date and time (according to RFC 3339, section 5.6)
ISO 3166 alpha2 country code or ISO 3166-2 country plus state/province code for use in helping to determine how to interpret consent values
xdm:userCountryRegionCode
- is optional
- type:
string - defined in this schema
string
- maximum length: 6 characters All instances must conform to this regular expression (test examples here):
^[A-Z]{2}(-[A-Z0-9]{1,3}){0,1}$Source's ID for the user
xdm:userIDfromSource
- is optional
- type:
string - defined in this schema
string
- maximum length: 20 characters
Version of the Consents and Preferences Schema
xdm:version
- is optional
- type:
string - default:
"1.0.0" - defined in this schema
string
All instances must conform to this regular expression (test examples here):
^[0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,4}$