同意和偏好设置字段组
同意和偏好设置是XDM Individual Profile 类的标准字段组,用于捕获单个客户的同意和偏好设置信息。
字段组结构 structure
同意和偏好设置字段组提供单个对象类型字段consents
以捕获同意和偏好设置信息。 此字段扩展了隐私、Personalization和营销偏好设置的同意数据类型,删除了adID
字段并添加了idSpecific
映射字段。
以下JSON显示了同意和偏好设置字段组可以处理的数据类型示例。 有关如何使用字段组提供的大多数字段的信息,请参阅同意和偏好设置数据类型的指南。 以下子部分重点介绍字段组添加到数据类型的唯一属性。
{
"consents": {
"collect": {
"val": "VI"
},
"share": {
"val": "y"
},
"personalize": {
"content": {
"val": "y"
}
},
"marketing": {
"preferred": "email",
"any": {
"val": "y"
},
"email": {
"val": "y"
}
},
"idSpecific": {
"ECID": {
"37784337855396895622558625508046772577": {
"adID": {
"val": "n",
},
"share": {
"val": "n"
},
"marketing": {
"push": {
"val": "n",
"time": "2020-09-30T01:02:33+00:00",
"reason": "not relevant"
}
}
}
},
"email": {
"john@xyz.com": {
"marketing": {
"email": {
"val": "y"
}
}
}
}
},
"metadata": {
"time": "2019-01-01T15:52:25+00:00"
}
}
}
idSpecific
当特定同意或偏好设置不是普遍适用于某个客户,而是仅限于单个设备或ID时,可以使用idSpecific
。 例如,客户可以选择不接收发往一个地址的电子邮件,而可能允许发往另一个地址的电子邮件。
idSpecific
之外的consents
下提供的同意和偏好设置)适用于该渠道内的所有ID。 因此,无论遵循等效的特定于ID还是特定于设备的设置,所有渠道级别的同意和偏好设置都会直接产生作用:- 如果客户在渠道级别选择退出,则
idSpecific
中的任何等效同意或偏好设置都将被忽略。 - 如果未设置渠道级别的同意或偏好设置,或者客户已选择加入,则会接受
idSpecific
中的等效同意或偏好设置。
idSpecific
对象中的每个键代表Adobe Experience Platform Identity服务识别的特定身份命名空间。 虽然您可以定义自己的自定义命名空间来对不同的标识符进行分类,但建议您使用Identity Service提供的标准命名空间之一来减少实时客户档案的存储大小。 有关身份命名空间的详细信息,请参阅Identity Service文档中的身份命名空间概述。
每个命名空间对象的键表示客户为其设置了首选项的唯一标识值。 每个标识值可以包含一组完整的同意和偏好设置,格式与consents
相同。
"idSpecific": {
"email": {
"jdoe@example.com": {
"marketing": {
"email": {
"val": "n"
}
}
}
},
"ECID": {
"37784337855396895622558625508046772577": {
"collect": {
"val": "y"
},
"adID": {
"val": "n"
},
"marketing": {
"push": {
"val": "n"
}
}
}
}
}
在idSpecific
部分中提供的marketing
对象中,any
和preferred
字段不受支持。 这些字段只能在用户级别配置。 此外,email
、sms
和push
的idSpecific
营销首选项不支持subscriptions
字段。
还有只能在idSpecific
部分提供的同意: adID
。 此字段将在以下子部分中介绍。
adID
adID
同意表示客户同意是否可以使用广告商ID(IDFA或GAID)在此设备上跨应用程序链接客户。 此值只能在idSpecific
部分中的ECID
身份命名空间下配置,不能为其他命名空间或此字段组的用户级别设置。
"idSpecific": {
"ECID": {
"37784337855396895622558625508046772577": {
"collect": {
"val": "y"
},
"adID": {
"val": "n"
},
"marketing": {
"push": {
"val": "n"
}
}
}
}
}
使用字段组摄取数据 ingest
要使用同意和偏好设置字段组从客户中摄取同意数据,您必须基于包含该字段组的架构创建数据集。
有关如何将字段组分配给字段的步骤,请参阅有关在UI中创建架构的教程。 创建架构后,该架构包含的字段具有同意和偏好设置字段组,请参阅数据集用户指南中有关创建数据集的部分,并按照使用现有架构创建数据集的步骤操作。
处理同意和偏好设置更改
当客户在您的网站上更改其同意或偏好设置时,应使用Adobe Experience Platform Web SDK收集这些更改并立即实施。 如果客户选择退出数据收集,则必须立即停止所有数据收集。 如果客户选择退出个性化,则他们访问的下一个页面上应该不会显示个性化。
后续步骤
本文档介绍了同意和偏好设置字段组的结构和用法。 有关字段组提供的其他字段的更多信息,请参阅有关隐私同意、Personalization和营销偏好设置数据类型的文档。