身份命名空间配置

上次更新: 2024-01-25
  • 创建对象:
  • Developer
    User
    Admin
    Leader

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

通过Destination SDK创建目标时,除了 配置合作伙伴架构 用户可以将配置文件属性和身份映射到,您还可以定义目标平台支持的身份命名空间。

在执行此操作时,用户除了可以选择目标配置文件属性之外,还可以选择目标身份。

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

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

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

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

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

重要

Destination SDK支持的所有参数名称和值包括 区分大小写. 为避免出现区分大小写错误,请完全按照文档中的说明使用参数名称和值。

支持的集成类型

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

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

支持的参数

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

参数 类型 必填/可选 描述
acceptsAttributes 布尔值 可选 指示客户是否可以将标准配置文件属性映射到您配置的身份。
acceptsCustomNamespaces 布尔值 可选 指示客户是否可以将自定义身份命名空间映射到您配置的身份命名空间。
acceptedGlobalNamespaces - 可选 指示哪些 标准身份命名空间 (例如, IDFA)客户可以映射到您正在配置的身份。
transformation 字符串 可选 显示 应用转换 如果源字段是XDM属性或自定义身份命名空间,请选中Platform UI中的复选框。 使用此选项可让用户在导出时散列源属性。 要启用此选项,请将值设置为 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 命名空间中指定目标的URL。

有关身份的详细信息,请参阅 身份命名空间概述.

映射注意事项

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

配置可选源字段散列

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

下面的配置启用可选的 应用转换 选项,位于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在激活时自动哈希源属性的选项。

配置强制源字段散列

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

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

后续步骤

阅读本文后,您应该更好地了解如何为使用Destination SDK构建的目标配置身份命名空间。

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

在此页面上