身份命名空间配置
Experience Platform使用身份命名空间来描述特定身份的类型。 例如,名为Email
的标识命名空间将诸如name@email.com
之类的值标识为电子邮件地址。
根据您创建的目标类型(流或基于文件),请牢记以下身份命名空间要求:
-
在通过Destination SDK创建实时(流)目标时,除了配置用户可将配置文件属性和身份映射到其中的合作伙伴架构之外,还必须定义目标平台支持的至少 个 身份命名空间。 例如,如果您的目标平台接受经过哈希处理的电子邮件和IDFA,则必须将这两个标识定义为此文档🔗中进一步描述的。
note important IMPORTANT 将受众激活到流式目标时,除了目标配置文件属性外,用户还必须映射_至少一个目标身份_。 否则,受众将不会激活到目标平台。 -
通过Destination SDK创建基于文件的目标时,标识命名空间的配置是 可选。
要了解有关Experience Platform中身份命名空间的更多信息,请参阅身份命名空间文档。
在为目标配置身份命名空间时,可以优化目标支持的目标身份映射,例如:
若要了解此组件在何处适合使用Destination SDK创建的集成,请参阅配置选项文档中的关系图,或参阅如何使用Destination SDK配置基于文件的目标的指南。
您可以通过/authoring/destinations
端点配置支持的身份命名空间。 有关详细的API调用示例,请参阅以下API参考页面,您可以在其中配置此页面中显示的组件。
本文介绍了可用于目标的所有受支持的身份命名空间配置选项,并显示客户将在Platform UI中看到的内容。
支持的集成类型 supported-integration-types
有关哪些类型的集成支持此页面上描述的功能,请参阅下表。
支持的参数 supported-parameters
在定义目标支持的目标身份时,您可以使用下表所述的参数配置其行为。
acceptsAttributes
acceptsCustomNamespaces
transformation
sha256(lower($))
。requiredTransformation
sha256(lower($))
。"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
}
您必须指定客户能够导出到目标的Platform身份。 例如,Experience Cloud ID、经过哈希处理的电子邮件、设备ID (IDFA、GAID)。 这些值是Platform个身份命名空间,客户可以从目标映射到身份命名空间。
身份命名空间不要求Platform与您的目标之间有一对一的对应关系。
例如,客户可以将Platform IDFA命名空间映射到目标中的IDFA命名空间,也可以将相同的Platform IDFA命名空间映射到目标中的Customer ID命名空间。
有关身份命名空间概述中身份的详细信息。
映射注意事项
如果客户选择了源身份命名空间但未选择目标映射,则Platform会自动使用具有相同名称的属性填充目标映射。
配置可选源字段散列
Experience Platform客户可以选择以哈希格式或纯文本格式将数据摄取到Platform中。 如果您的目标平台接受经过哈希处理的数据和未经过哈希处理的数据,则可以让客户选择在将源字段值导出到目标时,Platform是否应对其进行哈希处理。
下面的配置在映射步骤中启用了平台UI中的可选应用转换选项。
"identityNamespaces":{
"Customer_contact":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation": "sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
},
"Phone":{
}
}
}
}
使用未进行哈希处理的源字段时选中此选项,让 Adobe Experience Platform 在激活时自动对它们进行哈希处理。
将未经过哈希处理的源属性映射到目标期望进行哈希处理的目标属性时(例如: email_lc_sha256
或phone_sha256
),请选中 应用转换 选项,以使Adobe Experience Platform在激活时自动对源属性进行哈希处理。
配置强制源字段散列
如果您的目标仅接受哈希数据,则可以配置导出的属性,使其由Platform自动进行哈希处理。 在映射Email
和Phone
标识时,以下配置会自动检查 应用转换 选项。
"identityNamespaces":{
"Customer_contact":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation": "sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
"requiredTransformation": "sha256(lower($))"
},
"Phone":{
"requiredTransformation": "sha256(lower($))"
}
}
}
}
后续步骤 next-steps
阅读本文后,您应该更好地了解如何为使用Destination SDK构建的目标配置身份命名空间。
要了解有关其他目标组件的更多信息,请参阅以下文章: