身份命名空间配置

Experience Platform使用标识命名空间描述特定标识的类型。 例如,名为Email的标识命名空间将诸如name@email.com之类的值标识为电子邮件地址。

根据您创建的目标类型(流或基于文件),请牢记以下身份命名空间要求:

  • 通过Destination SDK创建实时(流)目标时,除了配置可将配置文件属性和身份映射到的合作伙伴架构之外,还必须定义目标平台支持的至少​ ​身份命名空间。 例如,如果您的目标平台接受经过哈希处理的电子邮件和IDFA,则必须将这两个标识定义为此文档🔗中进一步描述的。

    note important
    IMPORTANT
    将受众激活到流式目标时,除了目标配置文件属性外,还必须映射​_至少一个目标身份_。 否则,受众不会激活到目标平台。
  • 通过Destination SDK创建基于文件的目标时,标识命名空间的配置是​可选

若要详细了解Experience Platform中的身份命名空间,请参阅身份命名空间文档

在为目标配置身份命名空间时,可以优化目标支持的目标身份映射,例如:

若要了解此组件在何处适合使用Destination SDK创建的集成,请参阅配置选项文档中的关系图,或参阅如何使用Destination SDK配置基于文件的目标的指南。

您可以通过/authoring/destinations端点配置支持的身份命名空间。 有关详细的API调用示例,请参阅以下API参考页面,您可以在其中配置此页面中显示的组件。

本文介绍了可用于目标的所有受支持的身份命名空间配置选项,并显示您在Experience Platform UI中看到的内容。

IMPORTANT
Destination SDK支持的所有参数名称和值均区分大小写​**​**。 要避免区分大小写错误,请完全按照文档中所示使用参数名称和值。

支持的集成类型 supported-integration-types

有关哪些类型的集成支持此页面上描述的功能,请参阅下表。

集成类型
支持功能
实时(流)集成
是(必需)
基于文件(批处理)的集成
是(可选)

支持的参数 supported-parameters

在定义目标支持的目标身份时,您可以使用下表所述的参数配置其行为。

参数
类型
必填/可选
描述
acceptsAttributes
布尔值
可选
指示是否可以将标准配置文件属性映射到正在配置的标识。
acceptsCustomNamespaces
布尔值
可选
指示您是否可以将自定义身份命名空间映射到正在配置的身份命名空间。
acceptedGlobalNamespaces
-
可选
指示可映射到正在配置的身份的标准身份命名空间(例如,IDFA)。
transformation
字符串
可选
当源字段是XDM属性或自定义身份命名空间时,在Experience Platform UI中显示应用转换复选框。 使用此选项可在导出时散列源属性。 要启用此选项,请将值设置为sha256(lower($))
requiredTransformation
字符串
可选
当您选择此源身份命名空间时,应用转换复选框将自动应用于映射,您无法禁用它。 要启用此选项,请将值设置为sha256(lower($))
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

您必须指明能够导出到目标的Experience Platform身份。 例如,Experience Cloud ID、经过哈希处理的电子邮件、设备ID (IDFA、GAID)。 这些值是Experience Platform个标识命名空间,可以从目标映射到标识命名空间。

身份命名空间不要求Experience Platform与您的目标之间有一对一的对应关系。 例如,您可以将Experience Platform IDFA命名空间映射到目标中的IDFA命名空间,也可以将相同的Experience Platform IDFA命名空间映射到目标中的Customer ID命名空间。

有关身份命名空间概述中身份的详细信息。

映射注意事项 mapping-considerations

如果您选择了源身份命名空间但未选择目标映射,Experience Platform将自动使用具有相同名称的属性填充目标映射。

配置可选源字段散列 configure-optional-hashing

在Experience Platform中,您可以选择以哈希格式或纯文本格式摄取数据。 如果目标平台同时接受经过哈希处理的数据和未经过哈希处理的数据,则可以选择Experience Platform在将源字段值导出到目标时是否对其进行哈希处理。

下面的配置在映射步骤中启用了Experience Platform UI中的可选应用转换选项。

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

使用未经过哈希处理的源字段的情况下勾选此选项,让 Adobe Experience Platform 在激活时自动对其进行哈希处理。

将未经过哈希处理的源属性映射到目标期望进行哈希处理的目标属性时(例如: email_lc_sha256phone_sha256),请选中​ 应用转换 ​选项以使Adobe Experience Platform在激活时自动对源属性进行哈希处理。

配置强制源字段散列 configure-mandatory-hashing

如果您的目标仅接受哈希数据,则可以配置导出的属性,使其由Experience Platform自动进行哈希处理。 在映射EmailPhone标识时,以下配置会自动检查​ 应用转换 ​选项。

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

后续步骤 next-steps

您现在了解如何为使用Destination SDK构建的目标配置身份命名空间,包括如何允许属性和命名空间映射,以及如何在导出时应用可选或强制散列。

要了解有关其他目标组件的更多信息,请参阅以下文章:

recommendation-more-help
experience-platform-help-destinations