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

IMPORTANT
  • 要激活受众并启用工作流的映射步骤,您需要​查看目标激活目标查看配置文件​和​查看区段 访问控制权限
  • 要激活受众而不执行工作流的映射步骤,您需要​查看目标激活没有映射的区段查看配置文件​和​查看区段 访问控制权限
  • 要导出​标识,您需要​查看标识图形 访问控制权限
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}
阅读访问控制概述或联系您的产品管理员以获取所需的权限。

概述 overview

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

先决条件 prerequisites

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

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

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

  • CSV
  • JSON
  • Parquet

请注意,导出CSV文件可让您在构建导出文件的结构方面拥有更大的灵活性。 阅读有关CSV文件文件格式配置的更多信息

选择所需的文件格式,以便在创建与基于文件的目标的连接时导出。

选择您的目标 select-destination

  1. 在左侧导航中选择​目标,选择​ 目录 ​选项卡,然后在要激活受众的目标对应的卡片中选择​激活受众

    (可选)按名称而不是浏览完整目录来搜索目标。

    目标导航、“目录”选项卡和“激活受众”控件在目标目录中突出显示,搜索框突出显示为按名称查找目标的可选方式。 {modal="regular"}

  2. 选中要用于激活受众的目标连接旁边的复选框,然后选择​下一步

    (可选)使用搜索框按名称查找目标连接,或选择过滤器图标以显示过滤器面板并根据您的首选条件缩小结果范围。

    在“选择目标”步骤中突出显示 搜索框、筛选器面板切换、目标连接复选框和“下一步”按钮。 {modal="regular"}

  3. 移到下一部分以选择您的受众

选择您的受众 select-audiences

  1. 选中要激活到目标的受众旁边的复选框,然后选择​下一步

    (可选)使用搜索框按名称查找受众,或选择过滤器图标按评估类型(边缘、流或批处理)、命名空间来源或标记缩小结果范围。

    note tip
    TIP
    您可以按照在受众浏览屏幕上使用的相同标记进行过滤。 您在其中添加到受众的任何标记都会转移到此屏幕中。

    在“选择受众”步骤中突出显示 搜索框、筛选器面板切换、受众复选框和“下一步”按钮。 {modal="regular"}

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

  • 分段服务:分段服务在Experience Platform中生成的受众。 有关详细信息,请参阅分段文档
  • 自定义上传:受众在Experience Platform外部生成,并以CSV文件形式上传到Experience Platform。 要了解有关外部受众的更多信息,请参阅有关导入受众的文档。 选择源自​ 自定义上传 ​的受众会自动启用选择扩充属性步骤。
  • 其他类型的受众,来自其他Adobe解决方案,如Audience Manager。
IMPORTANT
将自定义上传受众激活到基于文件的批处理目标时,您可以在数据流中激活10个此类受众的限制。
TIP
要从现有激活流程中删除受众,请使用​ 激活数据 ​页面。 阅读有关如何从激活流中删除多个受众的部分以了解详细信息。

计划受众导出 scheduling

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

使用​ 新受众 ​和​ 激活的受众 ​选项在此页面的两个视图之间切换:

  • 新受众:仅显示您在当前激活流程中添加到目标的受众。
  • 激活的受众:显示您在以前的激活流程中激活到目标的受众。

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

对于每个受众,请选择两种导出类型之一: 导出完整文件导出增量文件

在计划步骤中突出显示 铅笔图标。 {modal="regular"}

要同时编辑多个计划,请使用屏幕左侧的复选框选择受众,然后选择​编辑计划。 然后,您配置的计划将被应用于选定受众的所有导出文件。

在计划步骤中突出显示“标题”复选框和“编辑”计划控件。 {modal="regular"}

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

导出全部文件 export-full-files

选择​ 导出完整文件 ​以触发导出包含所选受众的所有配置文件资格的完整快照的文件。

导出完整文件切换选定项。 {modal="regular"}

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

    • 一次:计划一次按需完整文件导出。
    • 每日:计划每天在指定时间导出一次完整文件。
    • 每周:选择开始日期,后续导出将发生在一周的该日,直到所选的结束日期。
    • 每月:选择开始日期,后续导出将在该月的该日期进行,直到所选的结束日期为止。 对于少于 30 或 31 天的月份,导出将在该月的最后一天进行。
    note
    NOTE
    当前仅基于文件的以下云存储目标支持每周和每月计划选项,并且仅在激活人员受众潜在受众时支持。
    每周和每月计划选项不适用于其他目标类型。
  2. 使用​ 时间 ​切换开关选择导出是在受众评估后立即执行,还是在指定时间按计划执行。 在选择​ 已计划 ​选项时,您可以使用选择器以UTC格式选择一天中何时进行导出。

    使用​ 区段评估后 ​选项可在每日Experience Platform批处理分段作业完成后立即运行激活作业。 此选项可确保当激活作业运行时,将最新的配置文件导出到您的目标。 这可能会导致根据您的操作,每天多次导出受众。

    note important
    IMPORTANT
    如果您对已设置为在区段评估后激活的受众运行灵活受众评估,则无论之前有任何每日激活作业,这些受众都会在灵活受众评估作业完成后立即激活。 这可能会导致根据您的操作,每天多次导出受众。

    在“编辑计划”对话框中突出显示区段评估选项后。 {modal="regular"}

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

    编辑计划对话框中突出显示的计划选项和开始时间选择器。 {modal="regular"}

    在映射过去24小时内创建并通过批量分段评估的受众时,请将每日导出计划设置为至少从第二天开始。 这样可确保首先运行每日批次评估作业,并且您正在导出完整的受众数据。

    配置导出计划时,请在完成激活流程后至少将开始时间设置为​1小时。 在整个系统中传播受众激活可能耗时1小时。 如果您计划导出在激活后1小时内运行,则可能会错过计划的导出。

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

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

了解计划的导出行为 export-behavior

计划的导出包括受众快照数据以及在快照创建和导出之间发生的任何增量配置文件或身份更改。 这与按需导出不同,后者仅使用快照数据。

下表重点说明了计划出口与按需出口的差异,尤其是在数据新鲜度和预期用途方面:

计划导出
立即导出文件
数据源
快照+增量更改
仅快照
轮廓属性
导出时的当前值
快照时的值

如果在受众评估后更新了用户档案,则计划导出将包括更新的属性值,即使评估时确定了受众成员资格也是如此。

示例:“retailID为null的用户档案”的受众可能会导出填充了retailID的用户档案(如果该字段在​ 评估后 ​但在​ 计划导出前 ​更新)。

推荐

  • 配置重复数据删除键以防止重复记录
  • 对精确基于快照的数据使用按需导出
  • 将批量摄取与评估计划调整到一致以最大限度地减少差异

有关按需导出,请参阅有关按需导出文件的文档。

导出增量文件 export-incremental-files

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

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

导出增量文件切换选定项。 {modal="regular"}

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

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

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

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

轮廓名 configure-file-names

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

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

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

图像突出显示用于配置文件名的铅笔图标。 {modal="regular"}

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

图像显示所有可用的文件名选项。 {modal="regular"}

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

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

要同时编辑多个文件名,请使用屏幕左侧的复选框选择受众,然后选择​编辑文件名。 然后,您配置的文件名选项将应用于所选受众的所有导出文件。

在计划步骤中高亮显示的“标题”复选框和“编辑文件名”控件。 {modal="regular"}

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

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

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

映射 mapping

IMPORTANT
下面描述的​ 映射 ​步骤适用于所有云存储目标。 如果您要将受众激活到Adobe Campaign、Oracle Responsys、Oracle Eloqua或Salesforce Marketing Cloud,请改为参阅选择配置文件属性(旧版)

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

  1. 在​ 映射 ​页面中,选择​添加新映射,然后选择​ Source字段 ​条目右侧的箭头。

    添加映射工作流中突出显示的新映射控件和源字段箭头。 {modal="regular"}

  2. 在​ 选择源字段 ​页面中,使用​ 选择属性 ​或​ 选择标识命名空间 ​切换开关在两个类别的源字段之间切换,然后选择要包含在导出文件中到目标的配置文件属性或标识。 完成后,选择​保存

    note tip
    TIP
    使用搜索框筛选源字段,如下图所示。 搜索匹配部分的、不区分大小写的文本,适用于配置文件属性以及标准Adobe和自定义身份命名空间。

    使用​ 仅显示包含数据的字段 ​切换开关可仅显示填充了值的架构字段。 默认情况下,仅显示填充的架构字段。

    选择属性和身份命名空间切换在“选择源”字段页中突出显示。 {modal="regular"}

    使用​ 显示字段的显示名称 ​切换来显示字段的友好名称,而不是架构字段名称。

    显示显示显示名称切换的源字段页。 {modal="regular"}

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

    note
    NOTE
    导出文件中的字段名称不支持点(.)。 如果字段名称包含点(如person.name.firstName),则导出的列名称中每个点都将替换为下划线(_)。 例如,person.name.firstName将在导出文件中变为person_name_firstName

    在映射视图中突出显示 目标字段图标。 {modal="regular"}

  4. 在​ 选择目标字段 ​页中,键入导出文件中标题的所需名称,然后选择​保存

    在选择目标字段页中突出显示的属性名称字段。 {modal="regular"}

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

    高亮显示映射视图中更新的标题名称的目标字段。 {modal="regular"}

  6. (可选)用户界面中映射字段的顺序反映在导出CSV文件中列的顺序(从上到下),其中顶行是CSV文件中最左侧的列。 您可以通过拖放映射行,以所需的任何方式重新排列映射字段,如下所示。

    显示通过拖放重新排序的映射字段的录制。 {modal="regular"}

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

    映射身份时,Experience Platform会自动将其标记为强制键和重复数据删除键。 无法为标识映射清除这些选择。

    映射视图中高亮显示的必需键和重复数据删除键列。 {modal="regular"}

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

有关强制属性、重复数据删除键、计算字段和映射步骤的已知限制的详细信息,请参阅批处理目标映射引用

选择扩充属性 select-enrichment-attributes

IMPORTANT
仅当您在受众选择步骤中选择了​ 自定义上传 ​受众时,才会显示此步骤。

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

TIP
如果要在不导出任何属性的情况下将外部受众激活到目标,请启用​ 排除扩充属性 ​切换开关。 此选项会从外部受众导出用户档案,但不会将其任何相应的属性发送到您的目标。
UI图像显示“排除扩充属性”切换。 {modal="regular"}

显示扩充属性选择步骤的UI图像。 {modal="regular"}

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

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

选择​ 下一步 ​以移至审阅步骤。

[Beta]{class="badge informative"} 从扩充属性中导出数组和对象 export-arrays-enrichment-attributes

AVAILABILITY
从扩充属性中导出阵列和对象的功能处于测试阶段,可供选定客户使用。 要请求访问权限,请与 Adobe 代表联系。

当使用JSON或Parquet输出并且启用了导出数组、映射和对象​​切换将受众导出到云存储目标时,您可以将复杂的数据结构(包括整个数组或从对象数组中选择的字段)导出为扩充属性。

“选择扩充属性”对话框显示“导出数组和复杂对象”启用横幅以及两列Source和Target映射界面。 {modal="regular"}

扩充属性步骤显示一个两列映射界面:

  • Source字段:完整的架构路径,当所选字段在数组中时,该路径可能包含计算的transformArray表达式。 您可以使用源字段右侧的函数图标来标识计算表达式,这与为常规属性显示的架构图标不同。
  • 目标字段:在导出的文件中用作字段名称的别名。 编辑此项以在导出的文件中使用其他名称。 目标字段只能包含字母、数字和下划线。 不允许使用点、破折号和其他特殊字符。

仅当满足以下所有条件时,此功能才可用:

导出整个数组 export-entire-array

从源字段选择屏幕中选择数组属性的名称。 源字段填入数组路径,而目标字段自动填入数组名称。 导出的输出保留数组中所有对象及其所有属性。

在扩充属性对话框中显示如何按名称选择数组属性以导出整个数组的录制。 {modal="regular"}

从对象数组导出单个字段 export-single-array-field

当您选择嵌套在对象数组中的属性时,Source字段​会自动使用transformArray计算表达式填充,并使用to_object从数组中的每个对象中提取该属性。

例如,选择someArray[*].amount会在源字段中填充以下内容:

transformArray(someArray, x -> to_object("amount", x.amount))

目标字段自动填充叶节点名称(amount)。 如果您希望更改目标字段的名称,可以更改该名称。

显示如何选择数组中的嵌套字段以使用transformArray计算表达式自动填充源字段的录制。 {modal="regular"}

从对象数组导出多个字段 export-multiple-array-fields

要从同一对象数组导出多个属性,请按照以下两步流程操作:

  1. 使用源字段选取器从数组中选择一个属性。 该对话框会自动填充该字段的计算表达式。
  2. 在​ Source字段 ​中手动编辑生成的transformArray表达式,以在to_object函数中添加其他属性。

例如,要从someArray中导出amountdate,请先选择someArray[*].amount,然后将表达式编辑为:

transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))

导出数组中的每个对象中只包括您指定的字段。 此外,您可以根据需要更改导出文件中的顶级阵列的名称。

显示如何从数组中选择一个字段,然后手动编辑transformArray表达式以包含多个字段的录制。 {modal="regular"}

NOTE
UI当前支持一次从数组中选择一个字段。 要从同一个映射中的同一数组导出多个字段,请选择第一个字段,然后手动编辑源表达式,如上所示。

审阅 review

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

在​ 审核 ​页面上,您可以看到所选内容的摘要。 选择​ 取消 ​以中断流,上一步​以修改您的设置,或者选择​ 完成 ​以确认您的选择并开始将数据发送到目标。

审核步骤中显示的选择摘要。 {modal="regular"}

如果您的组织购买了 Adobe Healthcare ShieldAdobe Privacy & Security Shield,请选择​ 查看适用的同意策略 ​以查看应用了哪些同意策略以及作为其结果包含在激活中的轮廓数量。 有关详细信息,请阅读同意策略评估

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

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

激活工作流中显示的数据策略违规示例。 {modal="regular"}

筛选受众 filter-audiences

使用​ 新受众 ​和​ 已激活的受众 ​切换开关,在此激活流中添加的受众与之前流中已激活目标的受众之间进行切换。

要选择要在表格中显示的列,请选择定制表格图标。 在​ 自定义表 ​对话框中,选择或清除要显示的列,然后选择​应用

屏幕录制,显示“新受众”和“激活的受众”切换,以及“自定义表”对话框,该对话框用于选择审核表中显示的列。 {modal="regular"}

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

验证受众激活 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.birthyearpersonalEmail.address

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