同意和偏好设置 数据类型
此 隐私、个性化和营销偏好设置的同意 数据类型(以下简称“同意和偏好设置 数据类型”)是 Experience Data Model (XDM)数据类型,旨在支持从您的数据操作中收集由同意管理平台(CMP)和其他源生成的客户权限和偏好设置。
本文档介绍了由提供的字段的结构和预期用途。 同意和偏好设置 数据类型。
先决条件 prerequisites
本文档要求您对XDM以及在中使用架构有一定的了解 Experience Platform. 请在继续之前查看以下文档:
数据类型结构 structure
此 同意和偏好设置 数据类型提供了多个用于捕获的字段 同意 和 偏好设置 信息。
同意是一个选项,允许客户指定如何使用其数据。 大多数同意都有法律含义,其中有些司法管辖区要求先获得许可,然后数据才能以特定方式使用,或者要求客户在不需要明确同意的情况下可以选择停止使用(选择退出)。
偏好设置是一个选项,它允许客户指定应如何处理其品牌体验的不同方面。 这些规则分为两类:
- 个性化偏好设置:有关品牌应如何个性化提供给客户的体验的首选项。
- 营销偏好设置:有关品牌是否可以通过各种渠道联系客户的首选项。
以下屏幕截图显示了数据类型结构在Platform UI中的表示方式:
以下JSON显示了以下数据类型的一个示例: 同意和偏好设置 数据类型可以处理。 有关这些字段中每个字段的特定用途的信息,请参见以下部分。
{
"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"
}
}
}
consents
choices
consents
包含多个描述客户同意和偏好设置的字段。 这些字段将在以下子部分中详细介绍。
"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
表示客户同意收集其数据。
"collect": {
"val": "y"
}
val
adID
adID
表示客户同意是否可以使用广告商ID在此设备上跨应用程序链接客户。
"adID": {
"idType": "IDFA",
"val": "y"
}
idType
IDFA
Apple的广告商ID或 GAID
Google (也称为Android广告商ID (AAID))。val
share
share
表示客户同意其数据可以与第二方或第三方共享(或出售给)。
"share": {
"val": "y"
}
val
personalize
personalize
personalize
捕获客户对其数据可用于个性化的方式的偏好。 客户可以选择退出特定的个性化用例,或完全选择退出个性化。
personalize
不包含营销用例。 例如,如果客户选择不为所有渠道进行个性化,则不应停止通过这些渠道接收通信。 相反,他们收到的消息应该是通用的,而不是基于其用户档案。marketing
,在中说明 下一节),则即使允许个性化,该客户也不应收到任何消息。"personalize": {
"content": {
"val": "y",
}
}
content
val
marketing
marketing
marketing
捕获客户关于其数据可用于哪些营销目的的偏好设置。 客户可以选择退出特定营销用例,或完全选择退出直接营销。
"marketing": {
"preferred": "email",
"any": {
"val": "u"
},
"email": {
"val": "n",
"reason": "Too Frequent"
},
"push": {
"val": "y"
},
"sms": {
"val": "y"
}
}
preferred
any
marketing
. 如果您计划使用更细粒度的同意选项,建议您排除此字段。如果该值设置为
n
,则所有更具体的个性化设置都应忽略。 如果该值设置为 y
,则所有更细粒度的个性化选项也应视为 y
,除非明确设置为 n
. 如果未设置该值,则每个个性化选项的值都应按指定接受。email
push
sms
val
time
metadata
,则不会为该首选项设置此字段。reason
metadata
metadata
捕获有关客户同意和偏好设置的一般元数据,这些元数据在客户同意和偏好设置的上次更新时都会捕获。
"metadata": {
"time": "2019-01-01T15:52:25+00:00",
}
time
time
单个首选项下的值将覆盖 metadata
该特定首选项的时间戳。使用数据类型摄取数据 ingest
要使用 同意和偏好设置 数据类型要从客户那里摄取同意数据,您必须根据包含该数据类型的架构创建数据集。
请参阅上的教程 在UI中创建架构 有关如何向字段分配数据类型的步骤。 创建包含字段的架构后,使用 同意和偏好设置 数据类型,请参阅以下章节 创建数据集 在数据集用户指南中,按照使用现有架构创建数据集的步骤进行操作。
处理同意和偏好设置更改
当客户在您的网站上更改其同意或偏好设置时,应使用收集这些更改并立即实施 Adobe Experience Platform Web SDK. 如果客户选择退出数据收集,则必须立即停止所有数据收集。 如果客户选择退出个性化,则他们访问的下一个页面上应该不会显示个性化。
附录 appendix
以下各节提供了有关 同意和偏好设置 数据类型。
接受的值 val
choice-values
下表概述了接受的值 val
:
y
n
p
p
在电子邮件中选择链接以验证他们提供了正确的电子邮件地址之前,同意将更新为 y
.如果此同意或偏好设置不使用两组验证流程,则
p
选项可用于指示客户尚未响应同意提示。 例如,您可以自动将值设置为 p
在网站第一页上,客户尚未响应同意提示符。 在不要求明确同意的司法辖区中,您还可以使用它来表示客户没有明确选择退出(换言之,假定您同意该选项)。u
dy
请注意,如果法律或公司隐私策略的更改导致某些或所有用户的默认值发生更改,则必须手动更新包含默认值的所有用户档案。
dn
请注意,如果法律或公司隐私策略的更改导致某些或所有用户的默认值发生更改,则必须手动更新包含默认值的所有用户档案。
LI
CT
CP
VI
PI
接受的值 preferred
preferred-values
下表概述了接受的值 preferred
. 此 preferred
值表示客户接收通信的首选渠道,告知他们数据收集、隐私政策和个性化选项。
email
push
inApp
sms
phone
phyMail
inVehicle
inHome
iot
social
other
none
unknown
完整 同意和偏好设置 架构 full-schema
查看的完整架构 同意和偏好设置 数据类型,请参阅 官方XDM存储库.