将受众激活到批量配置文件导出目标
概述 overview
本文介绍了在Adobe Experience Platform中激活受众以批量处理基于文件的目标(如云存储和电子邮件营销目标)所需的工作流。
先决条件 prerequisites
要将受众激活到目标,您必须已成功连接到目标。 如果您尚未这样做,请转到目标目录,浏览支持的目标,然后配置要使用的目标。
支持的导出文件格式 supported-file-formats-export
导出受众时支持以下文件格式:
- CSV
- JSON
- Parquet
请注意,导出CSV文件可让您在构建导出文件的结构方面拥有更大的灵活性。 阅读有关CSV文件文件格式配置的更多信息。
选择所需的文件格式,以便在创建与基于文件的目标的连接时导出。
选择您的目标 select-destination
-
在左侧导航中选择目标,选择 目录 选项卡,然后在要激活受众的目标对应的卡片中选择激活受众。
(可选)按名称而不是浏览完整目录来搜索目标。
{modal="regular"}
-
选中要用于激活受众的目标连接旁边的复选框,然后选择下一步。
(可选)使用搜索框按名称查找目标连接,或选择过滤器图标以显示过滤器面板并根据您的首选条件缩小结果范围。
在“选择目标”步骤中突出显示
{modal="regular"}
-
移到下一部分以选择您的受众。
选择您的受众 select-audiences
-
选中要激活到目标的受众旁边的复选框,然后选择下一步。
(可选)使用搜索框按名称查找受众,或选择过滤器图标按评估类型(边缘、流或批处理)、命名空间来源或标记缩小结果范围。
note tip TIP 您可以按照在受众浏览屏幕上使用的相同标记进行过滤。 您在其中添加到受众的任何标记都会转移到此屏幕中。 在“选择受众”步骤中突出显示
{modal="regular"}
您可以从多种类型的受众中进行选择,具体取决于其来源:
计划受众导出 scheduling
Adobe Experience Platform将电子邮件营销和云存储目标的数据导出为不同的文件类型。 在 计划 页面中,您可以为要导出的每个受众配置计划和文件名。
使用 新受众 和 激活的受众 选项在此页面的两个视图之间切换:
- 新受众:仅显示您在当前激活流程中添加到目标的受众。
- 激活的受众:显示您在以前的激活流程中激活到目标的受众。
Experience Platform会自动为每次文件导出设置默认计划。 您可以根据需要修改默认计划,方法是选择每个计划旁边的铅笔图标,并定义自定义计划。
对于每个受众,请选择两种导出类型之一: 导出完整文件或导出增量文件。
在计划步骤中突出显示
要同时编辑多个计划,请使用屏幕左侧的复选框选择受众,然后选择编辑计划。 然后,您配置的计划将被应用于选定受众的所有导出文件。
filename.csv、filename_2.csv、filename_3.csv。导出全部文件 export-full-files
选择 导出完整文件 以触发导出包含所选受众的所有配置文件资格的完整快照的文件。
-
使用 频率 选择器选择导出频率:
- 一次:计划一次按需完整文件导出。
- 每日:计划每天在指定时间导出一次完整文件。
- 每周:选择开始日期,后续导出将发生在一周的该日,直到所选的结束日期。
- 每月:选择开始日期,后续导出将在该月的该日期进行,直到所选的结束日期为止。 对于少于 30 或 31 天的月份,导出将在该月的最后一天进行。
note NOTE 当前仅基于文件的以下云存储目标支持每周和每月计划选项,并且仅在激活人员受众和潜在受众时支持。 每周和每月计划选项不适用于其他目标类型。 -
使用 时间 切换开关选择导出是在受众评估后立即执行,还是在指定时间按计划执行。 在选择 已计划 选项时,您可以使用选择器以UTC格式选择一天中何时进行导出。
使用 区段评估后 选项可在每日Experience Platform批处理分段作业完成后立即运行激活作业。 此选项可确保当激活作业运行时,将最新的配置文件导出到您的目标。 这可能会导致根据您的操作,每天多次导出受众。
note important IMPORTANT 如果您对已设置为在区段评估后激活的受众运行灵活受众评估,则无论之前有任何每日激活作业,这些受众都会在灵活受众评估作业完成后立即激活。 这可能会导致根据您的操作,每天多次导出受众。 {modal="regular"}
使用 已计划 选项使激活作业在固定时间运行。 此选项可确保每天在同一时间导出Experience Platform配置文件数据。 但是,您导出的用户档案可能不是最新的,具体取决于批量分段作业是否在激活作业开始之前完成。
{modal="regular"}
在映射过去24小时内创建并通过批量分段评估的受众时,请将每日导出计划设置为至少从第二天开始。 这样可确保首先运行每日批次评估作业,并且您正在导出完整的受众数据。
配置导出计划时,请在完成激活流程后至少将开始时间设置为1小时。 在整个系统中传播受众激活可能耗时1小时。 如果您计划导出在激活后1小时内运行,则可能会错过计划的导出。
-
使用 Date 选择器选择应该执行导出的日期或时间间隔。 对于每日导出,最佳实践是将开始和结束日期设置为与下游平台中的促销活动持续时间一致。
note important IMPORTANT 选择导出间隔时,该间隔的最后一天不包含在导出中。 例如,如果选择1月4日至11日之间的时间间隔,则最后一次文件导出将在1月10日进行。 -
选择 创建 以保存计划。
了解计划的导出行为 export-behavior
计划的导出包括受众快照数据以及在快照创建和导出之间发生的任何增量配置文件或身份更改。 这与按需导出不同,后者仅使用快照数据。
下表重点说明了计划出口与按需出口的差异,尤其是在数据新鲜度和预期用途方面:
如果在受众评估后更新了用户档案,则计划导出将包括更新的属性值,即使评估时确定了受众成员资格也是如此。
示例:“retailID为null的用户档案”的受众可能会导出填充了retailID的用户档案(如果该字段在 评估后 但在 计划导出前 更新)。
推荐
- 配置重复数据删除键以防止重复记录
- 对精确基于快照的数据使用按需导出
- 将批量摄取与评估计划调整到一致以最大限度地减少差异
有关按需导出,请参阅有关按需导出文件的文档。
导出增量文件 export-incremental-files
选择 导出增量文件 以触发导出,其中第一个文件是选定受众的所有配置文件资格的完整快照,后续文件是自上次导出以来的增量配置文件资格。
-
使用 频率 选择器选择导出频率:
- 每日:安排每天在指定的时间导出一次增量文件。
- 小时:计划每3、6、8或12小时执行一次增量文件导出。
-
使用 Time 选择器以UTC格式选择一天中何时进行导出。
-
使用 日期 选择器选择应执行导出的时间间隔。 最佳实践是将您的开始和结束日期设置为与下游平台中的促销活动持续时间一致。
note important IMPORTANT 间隔的最后一天不包含在导出中。 例如,如果选择1月4日至11日之间的时间间隔,则最后一次文件导出将在1月10日进行。 -
选择 创建 以保存计划。
轮廓名 configure-file-names
对于大多数目标,默认文件名由目标名称、受众ID以及日期和时间指示器组成。 例如,您可以编辑导出的文件名,以区分不同的促销活动,或者将数据导出时间附加到文件。 请注意,某些目标开发人员可能选择为其目标显示不同的默认文件名附加选项。
要打开模式窗口并编辑文件名,请选择铅笔图标。 文件名限制为255个字符。
在文件名编辑器中,可以选择要添加到文件名的不同组件。
无法从文件名中删除目标名称和受众ID。 除了这些选项之外,您还可以添加以下选项:
MMDDYYYY_HHMMSS格式或文件生成时间的UNIX 10位时间戳之间选择。 如果希望文件随每次增量导出而生成动态文件名,请选择以下选项之一。要同时编辑多个文件名,请使用屏幕左侧的复选框选择受众,然后选择编辑文件名。 然后,您配置的文件名选项将应用于所选受众的所有导出文件。
选择 应用更改 以确认您的选择。
配置完所有受众后,选择 下一步 以继续。
映射 mapping
在此步骤中,必须选择要添加到导出到目标目标的文件中的配置文件属性。 要选择要导出的配置文件属性和标识,请执行以下操作:
-
在 映射 页面中,选择添加新映射,然后选择 Source字段 条目右侧的箭头。
{modal="regular"}
-
在 选择源字段 页面中,使用 选择属性 或 选择标识命名空间 切换开关在两个类别的源字段之间切换,然后选择要包含在导出文件中到目标的配置文件属性或标识。 完成后,选择保存。
note tip TIP 使用搜索框筛选源字段,如下图所示。 搜索匹配部分的、不区分大小写的文本,适用于配置文件属性以及标准Adobe和自定义身份命名空间。 使用 仅显示包含数据的字段 切换开关可仅显示填充了值的架构字段。 默认情况下,仅显示填充的架构字段。
{modal="regular"}
使用 显示字段的显示名称 切换来显示字段的友好名称,而不是架构字段名称。
{modal="regular"}
-
您选择导出的字段现在会显示在映射视图中。 如果需要,可以编辑导出文件中的标头名称。 要实现此目的,请选择目标字段上的图标。
note NOTE 导出文件中的字段名称不支持点( .)。 如果字段名称包含点(如person.name.firstName),则导出的列名称中每个点都将替换为下划线(_)。 例如,person.name.firstName将在导出文件中变为person_name_firstName。在映射视图中突出显示
{modal="regular"}
-
在 选择目标字段 页中,键入导出文件中标题的所需名称,然后选择保存。
{modal="regular"}
-
您选择导出的字段现在会显示在映射视图中,并在导出的文件中显示编辑后的标题。
{modal="regular"}
-
(可选)用户界面中映射字段的顺序反映在导出CSV文件中列的顺序(从上到下),其中顶行是CSV文件中最左侧的列。 您可以通过拖放映射行,以所需的任何方式重新排列映射字段,如下所示。
{modal="regular"}
-
映射身份时,Experience Platform会自动将其标记为强制键和重复数据删除键。 无法为标识映射清除这些选择。
{modal="regular"}
-
要添加更多要导出的字段,请重复上述步骤。
有关强制属性、重复数据删除键、计算字段和映射步骤的已知限制的详细信息,请参阅批处理目标映射引用。
选择扩充属性 select-enrichment-attributes
扩充属性对应于Experience Platform中作为 自定义上传 摄取的自定义上传受众。 在此步骤中,您可以为每个选定的外部受众选择要导出到目标的属性。
请按照以下步骤为每个外部受众选择扩充属性:
- 在 扩充属性 列中,选择
(编辑)按钮。
- 选择添加扩充属性。 将显示一个新的空架构字段。
{modal="regular"}
- 选择空字段右侧的按钮以打开字段选择屏幕。
- 选择要为受众导出的属性。
{modal="regular"}
- 添加所有要导出的属性后,选择保存并关闭。
- 对每个外部受众重复这些步骤。
选择 下一步 以移至审阅步骤。
[Beta]{class="badge informative"} 从扩充属性中导出数组和对象 export-arrays-enrichment-attributes
当使用JSON或Parquet输出并且启用了导出数组、映射和对象切换将受众导出到云存储目标时,您可以将复杂的数据结构(包括整个数组或从对象数组中选择的字段)导出为扩充属性。
扩充属性步骤显示一个两列映射界面:
- Source字段:完整的架构路径,当所选字段在数组中时,该路径可能包含计算的
transformArray表达式。 您可以使用源字段右侧的函数图标来标识计算表达式,这与为常规属性显示的架构图标不同。 - 目标字段:在导出的文件中用作字段名称的别名。 编辑此项以在导出的文件中使用其他名称。 目标字段只能包含字母、数字和下划线。 不允许使用点、破折号和其他特殊字符。
仅当满足以下所有条件时,此功能才可用:
- 目标是以下受支持的云存储目标之一:Amazon S3、SFTP、Azure Blob存储、Azure Data Lake Storage Gen2、Data Landing Zone或Google Cloud Storage。
- 目标连接的文件类型设置为JSON或Parquet。
- 目标连接具有 导出数组、映射和对象 切换集位于。
- 您正在激活的受众源自Segmentation Service外部。 其中包括受众,如受众构成受众、相似受众、联合受众、在其他Experience Platform应用程序(如Adobe Journey Optimizer)中生成的受众等等。 了解各种受众源。
导出整个数组 export-entire-array
从源字段选择屏幕中选择数组属性的名称。 源字段填入数组路径,而目标字段自动填入数组名称。 导出的输出保留数组中所有对象及其所有属性。
从对象数组导出单个字段 export-single-array-field
当您选择嵌套在对象数组中的属性时,Source字段会自动使用transformArray计算表达式填充,并使用to_object从数组中的每个对象中提取该属性。
例如,选择someArray[*].amount会在源字段中填充以下内容:
transformArray(someArray, x -> to_object("amount", x.amount))
目标字段自动填充叶节点名称(amount)。 如果您希望更改目标字段的名称,可以更改该名称。
从对象数组导出多个字段 export-multiple-array-fields
要从同一对象数组导出多个属性,请按照以下两步流程操作:
- 使用源字段选取器从数组中选择一个属性。 该对话框会自动填充该字段的计算表达式。
- 在 Source字段 中手动编辑生成的
transformArray表达式,以在to_object函数中添加其他属性。
例如,要从someArray中导出amount和date,请先选择someArray[*].amount,然后将表达式编辑为:
transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))
导出数组中的每个对象中只包括您指定的字段。 此外,您可以根据需要更改导出文件中的顶级阵列的名称。
审阅 review
- 这些字段在受众定义中使用。
- 这些字段配置为目标目标的投影属性。
person.name.firstName的某些数据使用标签与目标的营销操作冲突,您将在审核步骤中看到数据使用策略冲突。 有关详细信息,请参阅 Adobe Experience Platform🔗中的数据管理。在 审核 页面上,您可以看到所选内容的摘要。 选择 取消 以中断流,上一步以修改您的设置,或者选择 完成 以确认您的选择并开始将数据发送到目标。
同意策略评估 consent-policy-evaluation
如果您的组织购买了 Adobe Healthcare Shield 或 Adobe 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.firstname、person.lastname、person.gender、person.birthyear和personalEmail.address。