文档Experience Platform目标指南

从Real-Time CDP导出数组、映射和对象

最近更新: 2025年5月16日
  • 主题:
  • 目标

创建对象:

  • 管理员
  • 用户
可用性
将阵列和其他复杂对象导出到云存储目标的功能通常适用于以下目标: Azure Data Lake Storage Gen2、Data Landing Zone、Google Cloud Storage、Amazon S3、Azure Blob、SFTP。
此外,您还可以将映射类型字段导出到以下目标:Amazon Kinesis、HTTP API、Azure事件中心。

了解如何将阵列、映射和对象从Real-Time CDP导出到云存储目标。 此外,您还可以将映射类型字段导出到企业目标和有限的边缘个性化目标。 阅读本文档以了解导出工作流、通过此功能启用的用例以及已知限制。 请查看下表,以了解每种目标类型可用的功能。

目标类型能够导出数组、映射和其他自定义对象
Adobe创作的云存储目标(Amazon S3、Azure Blob、Azure Data Lake Storage Gen2、Data Landing Zone、Google Cloud Storage、SFTP)是,在设置目标连接时,打开了启用数组、映射和对象导出切换开关。
基于文件的电子邮件营销目标(Adobe Campaign、Oracle Eloqua、Oracle Responsys、Salesforce Marketing Cloud)否
现有合作伙伴构建的自定义云存储目标(通过Destination SDK构建的基于文件的自定义目标)否
企业目标(Amazon Kinesis、Azure事件中心、HTTP API)部分。 您可以在激活工作流的映射步骤中选择和导出映射类型对象。
流目标(例如:Facebook、Braze、Google Customer Match等)否
Edge个性化目标否

您可以将此页面作为您希望了解有关从Experience Platform导出数组、映射和其他对象类型的所有信息的首选位置。

底线在前面

在此部分中获取有关功能的最重要信息,并继续在下面转到文档的其他部分以了解详细信息。

  • 对于云存储目标,导出阵列、映射和对象的功能取决于您选择的​ 导出阵列、映射、对象 ​切换开关。 请在页面🔗上的下方阅读更多相关信息。
  • 您可以在JSON和Parquet文件中将阵列、映射和对象导出到云存储目标。 对于Enterprise和Edge个性化目标,导出的数据类型为JSON。 人员和潜在客户受众受支持,而帐户受众不受支持。
  • 对于基于文件的云存储目标,您​ 可以 ​将数组、映射和对象导出到CSV文件,但前提是使用array_to_string函数使用计算字段功能并将它们串联为字符串。

Experience Platform中的数组和其他对象类型

在Experience Platform中,您可以使用XDM架构管理不同的字段类型。 在添加对数组导出的支持之前,您可以将简单的键值对类型字段(例如Experience Platform中的字符串)导出到所需的目标。 以前支持导出的此类字段示例为personalEmail.address:johndoe@acme.org。

Experience Platform中的其他字段类型包括数组字段。 阅读有关在Experience Platform UI中管理数组字段的更多信息。 您现在可以导出数组对象,如下面的示例所示。

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

除了阵列之外,您还可以将映射和对象从Experience Platform导出到所需的云存储目标。 详细了解Experience Platform中的映射和对象。

先决条件

将连接到所需的云存储目标,完成云存储目标的激活步骤并转到映射步骤。 连接到所需的云目标时,必须选择​ 导出数组、映射、对象 ​切换开关。 有关更多信息,请参阅以下部分。

注意
对于企业和边缘个性化目标,无需选择​ 导出数组、映射、对象 ​切换开关,即可提供对映射类型字段的导出支持。 连接到这些类型的目标时,此切换不可用或需要使用。

导出数组、映射和对象切换

当连接到基于文件的云存储目标时,可以设置打开或关闭​ 导出阵列、映射、对象 ​的切换开关。

使用打开或关闭设置以及突出显示弹出框来导出数组、映射、对象切换。

将此设置切换为​ 开,以启用将数组、映射和对象导出到 JSON 或 Parquet 文件的功能。将受众激活到云存储目标时,您可以在映射步骤的源字段视图中选择这些对象类型。 但是,如果启用此设置,则不能在激活时使用计算字段选项来转换数据。

将其切换为​ 关 ​后,您可以在激活受众时使用计算字段选项并应用各种数据转换功能。但是,您不能将数组、映射和对象导出到JSON或Parquet文件,并且必须为此配置单独的目标。

导出数组、映射、对象将​ 切换为

启用此设置后,您可以通过激活工作流映射步骤中的源字段选择器选择对象,导出整个对象(例如person.name)和数组。

在激活工作流的映射步骤中,通过源字段选择器选择对象。

选中此选项后,用户界面会阻止用户使用计算字段,并且禁用​ 添加计算字段 ​控件,如下所示。 要将计算字段用于数据转换,请在关闭切换的情况下设置目标连接。

已禁用计算字段控件。

导出数组、映射、对象切换​ 关闭

如果将此选项设置为​ off,则可以在激活受众时使用计算字段选项并应用各种数据转换函数。 但是,您不能将数组、映射和对象导出到JSON或Parquet文件,并且必须为此配置单独的目标。

您​ 可以 ​使用计算字段功能将数组、映射和对象导出到CSV文件,并使用array_to_string函数将它们串联为字符串。 阅读有关使用该函数的更多信息。

阅读有关使用计算字段以对导出到云存储目标的数据执行转换的更多信息。

示例导出文件

通过使用此功能,您可以导出Parquet和JSON文件,其中的数据会保留Experience Platform中的结构。 在下方查看导出的JSON文件示例。

选择可查看导出的JSON文件。
{
  "person_name_firstName": "John",
  "person_name_lastName": "Smith",
  "_acmeinc_customer_hs_main_address_scalar": "Oak Avenue No 12",
  "_acmeinc_customer_hs_locations_array": [
    "home address 12",
    "office address 12"
  ],
  "_acmeinc_customer_hs_date_array": [
    "2024-11-14",
    "2024-11-15"
  ],
  "_acmeinc_customer_hs_customer_obj_emails_array0": "john.smith@example.com",
  "_acmeinc_customer_hs_customer_obj": {
    "emails_array": [
      "john.smith@example.com",
      "j.smith@example.com"
    ],
    "name_scalar": "John Smith"
  },
  "_acmeinc_customer_hs_addresses_array_obj": [
    {
      "is_primary": true,
      "streetName_scalar": "Maple Street",
      "streetNo_int": 12
    },
    {
      "is_primary": false,
      "streetName_scalar": "Pine Road",
      "streetNo_int": 45
    }
  ],
  "_acmeinc_customer_hs_addresses_array_obj0": {
    "is_primary": true,
    "streetName_scalar": "Maple Street",
    "streetNo_int": 12
  }
}
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6