将受众激活到批量配置文件导出目标

IMPORTANT
  • 激活受众并启用 映射步骤 的工作流中,您需要 查看目标激活目标查看配置文件、和 查看区段 访问控制权限.

  • 要激活受众,请不通过 映射步骤 的工作流中,您需要 查看目标激活没有映射的区段查看配置文件、和 查看区段 访问控制权限.

  • 要导出 身份,您需要 查看身份图 访问控制权限.

    img-md
    w-100 modal-image
    选择工作流中突出显示的身份命名空间以将受众激活到目标。
阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

概述 overview

本文介绍了在Adobe Experience Platform中激活受众以批量处理基于文件的目标(如云存储和电子邮件营销目标)所需的工作流。

先决条件 prerequisites

要将受众激活到目标,您必须已成功完成 已连接到目标. 如果您尚未这样做,请转到 目标目录,浏览支持的目标,并配置要使用的目标。

支持的导出文件格式 supported-file-formats-export

导出受众时支持以下文件格式:

  • CSV
  • JSON
  • Parquet

请注意,导出CSV文件可让您在构建导出文件的结构方面拥有更大的灵活性。 详细了解 CSV文件的文件格式配置.

选择所需的文件格式以便在下列情况下导出 创建与基于文件的目标的连接.

选择您的目标 select-destination

  1. 转到 “连接”>“目标”,然后选择 目录 选项卡。

    突出显示如何转到目标目录选项卡的图像。

  2. 选择 激活受众 ,,如下图所示。

    激活目录页面中高亮显示的受众控件。

  3. 选择要用于激活受众的目标连接,然后选择 下一个.

    高亮显示的复选框可选择一个或多个要将受众激活到的目标。

  4. 移到下一节至 选择您的受众.

选择您的受众 select-audiences

要选择要激活到目标的受众,请选中受众名称左侧的复选框,然后选择 下一个.

您可以从多种类型的受众中进行选择,具体取决于其来源:

  • 分段服务:分段服务在Experience Platform中生成的受众。 请参阅 分段文档 以了解更多详细信息。
  • 自定义上传:在Experience Platform之外生成的受众,以CSV文件形式上传到Platform。 要了解有关外部受众的更多信息,请参阅关于以下内容的文档: 导入受众.
  • 其他类型的受众,源自其他Adobe解决方案,例如 Audience Manager.

选择要激活的一个或多个受众时显示的复选框。

TIP
选择源自 自定义上传 自动启用 选择扩充属性 步骤。
TIP
您可以从现有的激活流中删除受众 激活数据 页面。 请参阅 专用文档 以了解详细信息。

计划受众导出 scheduling

Adobe Experience Platform 将电子邮件营销和云存储目标的数据导出为 不同的文件类型. 在 正在计划 页面上,您可以为要导出的每个受众配置计划和文件名。

Experience Platform会自动为每次文件导出设置默认计划。 您可以根据需要修改默认计划,方法是选择每个计划旁边的铅笔图标,并定义自定义计划。

编辑计划步骤中突出显示的计划控制。

TIP
您可以从以下位置编辑现有激活流的受众激活计划: 激活数据 页面。 请参阅相关文档 批量编辑激活计划 以了解详细信息。
IMPORTANT
Adobe Experience Platform 自动以每个文件500万条记录(行)拆分导出文件。 每一行表示一个配置文件。
拆分文件名后附加一个数字,指示文件是较大导出的一部分,例如: filename.csvfilename_2.csvfilename_3.csv.

导出全部文件 export-full-files

选择 导出完整文件 触发导出一个文件,其中包含选定受众的所有配置文件资格的完整快照。

已选中“导出完整文件”切换开关。

  1. 使用 频率 选择器以选择导出频率:

    • 一次:计划一次按需完整文件导出。
    • 每日:计划每天在指定时间导出一次完整文件。
  2. 使用 时间 切换是否选择应在受众评估后立即导出,还是按计划在指定时间导出。 选择 已计划 选项,则可以使用选择器选择一天中的时间,在 UTC 格式,应何时进行导出。

    note note
    NOTE
    区段评估后 以下所述的选项仅适用于部分Beta测试版客户。

    使用 区段评估后 一个选项,用于在每日Platform批处理分段作业完成后立即运行激活作业。 此选项可确保当激活作业运行时,将最新的配置文件导出到您的目标。

    图像突出显示批处理目标的激活流中的区段后评估选项。
    使用 已计划 用于使激活作业在固定时间运行的选项。 此选项可确保每天在同一时间导出Experience Platform配置文件数据。 但是,您导出的用户档案可能不是最新的,具体取决于批量分段作业是否在激活作业开始之前完成。

    突出显示批量目标激活流中的已计划选项并显示时间选择器的图像。

  3. 使用 日期 选择器来选择应执行导出的日期或时间间隔。 对于每日导出,最佳实践是将开始和结束日期设置为与下游平台中的促销活动持续时间一致。

    note important
    IMPORTANT
    选择导出间隔时,该间隔的最后一天不包含在导出中。 例如,如果选择1月4日至11日之间的时间间隔,则最后一次文件导出将在1月10日进行。
  4. 选择 创建 以保存计划。

导出增量文件

选择 导出增量文件 用于触发导出,其中第一个文件是选定受众的所有配置文件资格的完整快照,后续文件是自上次导出以来的增量配置文件资格。

IMPORTANT
第一个导出的增量文件包含符合受众条件的所有用户档案,这些文件可用作回填。

“导出增量文件”切换为选定状态。

  1. 使用 频率 选择器以选择导出频率:

    • 每日:安排增量文件每天在指定的时间导出一次。
    • 每小时:计划每3、6、8或12小时执行一次增量文件导出。
  2. 使用 时间 选择器以选择一天中的时间,在 UTC 格式,应何时进行导出。

  3. 使用 日期 选择器来选择应进行导出的时间间隔。 最佳实践是将您的开始和结束日期设置为与下游平台中的促销活动持续时间一致。

    note important
    IMPORTANT
    间隔的最后一天不包含在导出中。 例如,如果选择1月4日至11日之间的时间间隔,则最后一次文件导出将在1月10日进行。
  4. 选择 创建 以保存计划。

配置文件名

对于大多数目标,默认文件名由目标名称、受众ID以及日期和时间指示器组成。 例如,您可以编辑导出的文件名,以区分不同的促销活动,或者将数据导出时间附加到文件。 请注意,某些目标开发人员可能选择为其目标显示不同的默认文件名附加选项。

要打开模式窗口并编辑文件名,请选择铅笔图标。 文件名限制为255个字符。

NOTE
下图显示了如何编辑的文件名 Amazon S3 目标,但所有批处理目标的过程都相同(例如SFTP、 Azure Blob Storage,或 Google Cloud Storage)。

图像突出显示用于配置文件名的铅笔图标。

在文件名编辑器中,可以选择要添加到文件名的不同组件。

显示所有可用文件名选项的图像。

无法从文件名中删除目标名称和受众ID。 除了这些选项之外,您还可以添加以下选项:

文件名选项
描述
受众名称
导出受众的名称。
日期和时间
在添加 MMDDYYYY_HHMMSS 格式或文件生成时间的UNIX 10位时间戳。 如果希望文件随每次增量导出而生成动态文件名,请选择以下选项之一。
自定文本
要添加到文件名的任何自定义文本。
目标Id
用于导出受众的目标数据流的ID。
目标名称
用于导出受众的目标数据流的名称。
组织名称
Experience Platform中的组织名称。
沙盒名称
用于导出受众的沙盒的ID。

选择 应用更改 以确认您的选择。

IMPORTANT
如果您不选择 日期和时间 组件中,文件名将是静态的,并且新的导出文件将使用每次导出覆盖存储位置中的上一个文件。 将周期性导入作业从存储位置运行到电子邮件营销平台时,这是推荐的选项。

配置完所有受众后,选择 下一个 以继续。

映射 mapping

在此步骤中,必须选择要添加到导出到目标目标的文件中的配置文件属性。 要选择要导出的配置文件属性和标识,请执行以下操作:

  1. 映射 页面,选择 添加新映射.

    添加在映射工作流中高亮显示的新字段控件。

  2. 选择右侧的箭头 源字段 进入。

    选择映射工作流中高亮显示的源字段控件。

  3. 选择源字段 页面上,选择要包含在导出到目标文件中的配置文件属性和身份,然后选择 选择.

    note tip
    TIP
    您可以使用搜索字段缩小选择范围,如下图所示。

    显示可导出到目标的配置文件属性的模式窗口。

  4. 您选择导出的字段现在会显示在映射视图中。 如果需要,可以编辑导出文件中的标头名称。 要实现此目的,请选择目标字段上的图标。

    显示可导出到目标的配置文件属性的模式窗口。

  5. 选择目标字段 在导出的文件中键入所需的标头名称,然后选择 选择.

    显示标题的键入友好名称的模式窗口。

  6. 您选择导出的字段现在会显示在映射视图中,并在导出的文件中显示编辑后的标题。

    显示可导出到目标的配置文件属性的模式窗口。

  7. badge informative
    Beta
    note note
    NOTE
    此功能为测试版,仅向部分客户提供。 要请求访问此功能,请联系您的Adobe代表。

    显示通过拖放重新排序的映射字段的录制。

  8. (可选)您可以将导出的字段选择为 必需键重复数据删除键.

    显示可导出到目标的配置文件属性的模式窗口。

  9. 要添加更多要导出的字段,请重复上述步骤。

强制属性 mandatory-attributes

必填属性是启用用户的复选框,可确保所有配置文件记录都包含所选属性。 例如:所有导出的用户档案都包含电子邮件地址​。

您可以将属性标记为必需,以确保 Platform 仅导出包含特定属性的配置文件。 因此,它可以用作附加的筛选形式。 将属性标记为必填字段是 必需。

不选择强制属性会导出所有符合条件的配置文件,而不管其属性如何。

建议其中一个属性为 唯一标识符 从你的架构中。 有关强制属性的更多信息,请参阅 电子邮件营销目标 文档。

内部重复数据删除键 deduplication-keys

重复数据删除键是用户定义的主键,可确定用户希望为其配置文件进行重复数据删除的身份​。

重复数据删除键消除了在一个导出文件中拥有同一配置文件的多个记录的可能性。

可通过三种方式在中使用重复数据删除键 Platform:

  • 使用单个身份命名空间作为 重复数据删除键
  • 使用 XDM profile as a 重复数据删除键
  • 使用来自的两个配置文件属性的组合 XDM 配置文件作为复合键
IMPORTANT
您可以将单个身份命名空间导出到目标,并且该命名空间会自动设置为重复数据删除键。 不支持向目标发送多个命名空间。
不能将身份命名空间和配置文件属性的组合用作重复数据删除键。

重复数据删除示例 deduplication-example

此示例说明了重复数据删除的工作方式,具体取决于所选的重复数据删除键。

让我们考虑以下两个配置文件。

用户档案A

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe_1@example.com"
      },
      {
        "id": "johndoe_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-03-10 10:03:08"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "Doe",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

个人资料B

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe_1@example.com"
      },
      {
        "id": "johndoe_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-04-10 11:33:28"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "D",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

重复数据删除用例1:无重复数据删除 deduplication-use-case-1

如果不使用重复数据删除,导出文件将包含以下条目。

个人电子邮件
firstName
姓氏
johndoe@example.com
John
Doe
johndoe@example.com
John
D

重复数据删除使用案例2:基于身份命名空间进行重复数据删除 deduplication-use-case-2

假设重复数据删除由 Email 命名空间中,导出文件将包含以下条目。 配置文件B是符合受众条件的最新配置文件,因此它是唯一导出的。

电子邮件*
个人电子邮件
firstName
姓氏
johndoe_1@example.com
johndoe@example.com
John
D
johndoe_2@example.com
johndoe@example.com
John
D

重复数据删除使用案例3:基于单个配置文件属性进行重复数据删除 deduplication-use-case-3

假设重复数据删除由 personal Email 属性,导出文件将包含以下条目。 配置文件B是符合受众条件的最新配置文件,因此它是唯一导出的。

个人电子邮件*
firstName
姓氏
johndoe@example.com
John
D

重复数据删除使用案例4:基于两个配置文件属性的重复数据删除 deduplication-use-case-4

假定通过复合键进行重复数据删除 personalEmail + lastName,则导出文件将包含以下条目。

个人电子邮件*
姓氏*
firstName
johndoe@example.com
D
John
johndoe@example.com
Doe
John

Adobe建议选择身份命名空间,如 CRM ID 或电子邮件地址作为重复数据删除键,以确保唯一标识所有配置文件记录。

NOTE
如果有任何数据使用标签应用于数据集(而不是整个数据集)中的某些字段,则会在激活时强制实施这些字段级标签,具体情况如下:
  • 这些字段在受众定义中使用。
  • 这些字段配置为目标目标的投影属性。
例如,如果字段 person.name.firstName 具有与目标的营销操作冲突的特定数据使用标签,则会在审核步骤中向您显示数据使用策略违规。 有关更多信息,请参阅 Adobe Experience Platform中的数据治理.

测试版通过计算字段导出数组 export-arrays-calculated-fields

部分测试版客户可以将阵列对象从Experience Platform导出到云存储目标。 详细了解 导出数组和计算字段 并联系Adobe代表以获取该功能的访问权限。

已知限制 known-limitations

映射 页面具有以下已知限制:

无法通过映射工作流选择受众成员资格属性

由于已知限制,您当前无法使用 选择字段 要添加的窗口 segmentMembership.status 到您的文件导出。 相反,您需要手动粘贴值 xdm: segmentMembership.status “架构”字段中,如下所示。

屏幕录制,其中显示了激活工作流映射步骤中的受众成员资格解决方法。

文件导出将以下列方式有所不同,具体取决于是否 segmentMembership.status 已选中:

  • 如果 segmentMembership.status 字段已选中,导出的文件包括 活动 初始完整快照中的成员和 活动已过期 后续增量导出中的成员。
  • 如果 segmentMembership.status 未选择字段,导出的文件仅包括 活动 初始完整快照及其后的增量导出中的成员。

详细了解 基于文件的目标的配置文件导出行为.

当前无法选择要导出的身份命名空间

当前不支持选择导出身份命名空间(如下图所示)。 选择要导出的任何身份命名空间将导致中出现错误 审核 步骤。

显示身份导出的映射不受支持。

作为临时解决方法,如果您需要在测试版期间将身份命名空间添加到导出的文件,您可以:

  • 对于要在导出中包含身份命名空间的数据流,请使用旧版云存储目标
  • 将身份作为属性上传到Experience Platform,然后将其导出到您的云存储目标。

选择配置文件属性 select-attributes

IMPORTANT
目录中的所有云存储目标都可以查看改进的内容 映射 步骤 取代 选择属性 此部分介绍了的步骤。
选择属性 仍会为Adobe Campaign、OracleResponsys、OracleEloqua和SalesforceMarketing Cloud电子邮件营销目标显示步骤。

对于基于配置文件的目标,必须选择要发送到目标目标的配置文件属性。

  1. 选择属性 页面,选择 添加新字段.

    突出显示添加新字段按钮的图像。

  2. 选择右侧的箭头 架构字段 进入。

    突出显示如何选择源字段的图像。

  3. 选择字段 页面上,选择要发送到目标的XDM属性或身份命名空间,然后选择 选择.

    显示可用作源字段的各种字段的图像。

  4. 要添加更多映射,请重复执行第一步到第三步。

NOTE
Adobe Experience Platform会使用架构中的四个推荐的常用属性预填充您的选择: person.name.firstNameperson.name.lastNamepersonalEmail.addresssegmentMembership.status.

该图像显示了受众激活工作流映射步骤中预填充的推荐属性。

IMPORTANT
由于已知限制,您当前无法使用 选择字段 要添加的窗口 segmentMembership.status 到您的文件导出。 相反,您必须手动粘贴值 xdm: segmentMembership.status “架构”字段中,如下所示。
屏幕录制,其中显示了激活工作流映射步骤中的受众成员资格解决方法。

文件导出在以下方面有所不同,具体取决于是否 segmentMembership.status 已选中:

  • 如果 segmentMembership.status 字段已选中,导出的文件包括 活动 初始完整快照中的成员和 活动已过期 后续增量导出中的成员。
  • 如果 segmentMembership.status 未选择字段,导出的文件仅包括 活动 初始完整快照及其后的增量导出中的成员。

选择扩充属性 select-enrichment-attributes

IMPORTANT
此步骤仅在您选择的情况下显示 自定义上传 受众时段 受众选择 步骤。

扩充属性对应于Experience Platform中摄取的自定义上传受众,如 自定义上传. 在此步骤中,您可以为每个选定的外部受众选择要导出到目标的属性。

显示扩充属性选择步骤的用户界面图像。

请按照以下步骤为每个外部受众选择扩充属性:

  1. 扩充属性 列中,选择 “编辑”按钮 (编辑)按钮。
  2. 选择 添加扩充属性. 将显示一个新的空架构字段。
    显示扩充属性模式屏幕的UI图像。
  3. 选择空字段右侧的按钮以打开字段选择屏幕。
  4. 选择要为受众导出的属性。
    显示扩充属性列表的用户界面图像。
  5. 添加要导出的所有属性后,选择 保存并关闭.
  6. 对每个外部受众重复这些步骤。

如果要在不导出任何属性的情况下将外部受众激活到目标,请启用 排除扩充属性 切换。 此选项会从外部受众导出用户档案,但不会将其任何相应的属性发送到您的目标。

用户界面图像显示“排除扩充属性”切换。

选择 下一个 以移至 审核 步骤。

审核 review

审核 页面上,您可以看到选择的摘要。 选择 取消 来打破气流, 返回 以修改设置,或者 完成 以确认您的选择并开始向目标发送数据。

审核步骤中显示的选择摘要。

同意策略评估 consent-policy-evaluation

如果您的组织购买了 Adobe Healthcare ShieldAdobe Privacy & Security Shield,请选择​ 查看适用的同意策略 ​以查看应用了哪些同意策略以及作为其结果包含在激活中的配置文件数量。阅读关于 同意政策评估 以了解更多信息。

数据使用策略检查 data-usage-policy-checks

审核 步骤,Experience Platform还会检查是否存在任何数据使用策略违规。 下面显示了一个违反策略的示例。 在解决该违规之前,您无法完成受众激活工作流。 有关如何解决策略违规的信息,请参阅 数据使用策略违规 数据管理文档一节中。

激活工作流中显示的数据策略违规示例。

筛选受众 filter-audiences

此外,在此步骤中,您可以使用页面上的可用过滤器仅显示其计划或映射作为此工作流的一部分而更新的受众。 您还可以切换要查看的表列。

显示审核步骤中可用的受众过滤器的屏幕录制。

如果您对您的选择感到满意,并且未检测到任何违反策略的情况,请选择 完成 以确认您的选择并开始向目标发送数据。

验证受众激活 verify

将受众导出到云存储目标时,Adobe Experience Platform会创建 .csv.json,或 .parquet 文件存储位置。 预计会根据您在工作流中设置的时间表,在您的存储位置中创建一个新文件。 默认文件格式如下所示,但您可以 编辑文件名的组件
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv

例如,如果您选择了每日导出频率,则您连续三天收到的文件可能会如下所示:

Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv

这些文件在您的存储位置中存在,即确认激活成功。 要了解导出文件的结构,您可以 下载示例.csv文件. 此示例文件包括配置文件属性 person.firstnameperson.lastnameperson.genderperson.birthyear、和 personalEmail.address.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6