将受众激活到批量配置文件导出目标
概述 overview
本文介绍了在Adobe Experience Platform中激活受众以批量处理基于文件的目标(如云存储和电子邮件营销目标)所需的工作流。
先决条件 prerequisites
要将受众激活到目标,您必须已成功连接到目标。 如果您尚未这样做,请转到目标目录,浏览支持的目标,然后配置要使用的目标。
支持的导出文件格式 supported-file-formats-export
导出受众时支持以下文件格式:
- CSV
- JSON
- Parquet
请注意,导出CSV文件可让您在构建导出文件的结构方面拥有更大的灵活性。 阅读有关CSV文件文件格式配置的更多信息。
选择所需的文件格式,以便在创建与基于文件的目标的连接时导出。
选择您的目标 select-destination
-
转到 连接>目标,然后选择 目录 选项卡。
-
在与您要激活受众的目标对应的卡片上,选择 激活受众,如下图所示。
-
选择要用于激活受众的目标连接,然后选择 下一步。
-
移到下一部分以选择您的受众。
选择您的受众 select-audiences
要选择要激活到目标的受众,请使用受众名称左侧的复选框,然后选择 下一步。
您可以从多种类型的受众中进行选择,具体取决于其来源:
计划受众导出 scheduling
Adobe Experience Platform将电子邮件营销和云存储目标的数据导出为不同的文件类型。 在 计划 页面中,您可以为要导出的每个受众配置计划和文件名。
Experience Platform会自动为每次文件导出设置默认计划。 您可以根据需要修改默认计划,方法是选择每个计划旁边的铅笔图标,并定义自定义计划。
filename.csv
、filename_2.csv
、filename_3.csv
。导出全部文件 export-full-files
选择 导出完整文件 以触发导出包含所选受众的所有配置文件资格的完整快照的文件。
-
使用 频率 选择器选择导出频率:
- 一次:计划一次按需完整文件导出。
- 每日:计划每天在指定时间导出一次完整文件。
-
使用 时间 切换开关选择导出是在受众评估后立即执行,还是在指定时间按计划执行。 在选择 已计划 选项时,您可以使用选择器以UTC格式选择一天中何时进行导出。
note note NOTE 下面介绍的 区段评估后 选项仅适用于选择Beta客户。 使用 区段评估后 选项可在每日平台批处理分段作业完成后立即运行激活作业。 此选项可确保当激活作业运行时,将最新的配置文件导出到您的目标。
使用 已计划 选项使激活作业在固定时间运行。 此选项可确保每天在同一时间导出Experience Platform配置文件数据。 但是,您导出的用户档案可能不是最新的,具体取决于批量分段作业是否在激活作业开始之前完成。 -
使用 Date 选择器选择应该执行导出的日期或时间间隔。 对于每日导出,最佳实践是将开始和结束日期设置为与下游平台中的促销活动持续时间一致。
note important IMPORTANT 选择导出间隔时,该间隔的最后一天不包含在导出中。 例如,如果选择1月4日至11日之间的时间间隔,则最后一次文件导出将在1月10日进行。 -
选择 创建 以保存计划。
导出增量文件
选择 导出增量文件 以触发导出,其中第一个文件是选定受众的所有配置文件资格的完整快照,后续文件是自上次导出以来的增量配置文件资格。
-
使用 频率 选择器选择导出频率:
- 每日:安排每天在指定的时间导出一次增量文件。
- 小时:计划每3、6、8或12小时执行一次增量文件导出。
-
使用 Time 选择器以UTC格式选择一天中何时进行导出。
-
使用 日期 选择器选择应执行导出的时间间隔。 最佳实践是将您的开始和结束日期设置为与下游平台中的促销活动持续时间一致。
note important IMPORTANT 间隔的最后一天不包含在导出中。 例如,如果选择1月4日至11日之间的时间间隔,则最后一次文件导出将在1月10日进行。 -
选择 创建 以保存计划。
配置文件名
对于大多数目标,默认文件名由目标名称、受众ID以及日期和时间指示器组成。 例如,您可以编辑导出的文件名,以区分不同的促销活动,或者将数据导出时间附加到文件。 请注意,某些目标开发人员可能选择为其目标显示不同的默认文件名附加选项。
要打开模式窗口并编辑文件名,请选择铅笔图标。 文件名限制为255个字符。
在文件名编辑器中,可以选择要添加到文件名的不同组件。
无法从文件名中删除目标名称和受众ID。 除了这些选项之外,您还可以添加以下选项:
MMDDYYYY_HHMMSS
格式或文件生成时间的UNIX 10位时间戳之间选择。 如果希望文件随每次增量导出而生成动态文件名,请选择以下选项之一。选择 应用更改 以确认您的选择。
配置完所有受众后,选择 下一步 以继续。
映射 mapping
在此步骤中,必须选择要添加到导出到目标目标的文件中的配置文件属性。 要选择要导出的配置文件属性和标识,请执行以下操作:
-
在 映射 页面中,选择 添加新映射。
-
选择 Source字段 条目右侧的箭头。
-
在 选择源字段 页面中,选择要包含在导出到目标文件中的配置文件属性和身份,然后选择 选择。
note tip TIP 您可以使用搜索字段缩小选择范围,如下图所示。 使用 仅显示包含数据的字段 切换开关可仅显示填充了值的架构字段。 默认情况下,仅显示填充的架构字段。
-
您选择导出的字段现在会显示在映射视图中。 如果需要,可以编辑导出文件中的标头名称。 要实现此目的,请选择目标字段上的图标。
-
在 选择目标字段 页中,键入导出文件中标题的所需名称,然后选择 选择。
-
您选择导出的字段现在会显示在映射视图中,并在导出的文件中显示编辑后的标题。
-
(可选)用户界面中映射字段的顺序反映在导出CSV文件中列的顺序(从上到下),其中顶行是CSV文件中最左侧的列。 您可以通过拖放映射行,以所需的任何方式重新排列映射字段,如下所示。
note note NOTE 此功能为测试版,仅向部分客户提供。 要请求访问此功能,请联系您的Adobe代表。 -
-
要添加更多要导出的字段,请重复上述步骤。
强制属性 mandatory-attributes
必填属性是启用用户的复选框,可确保所有配置文件记录都包含所选属性。 例如:所有导出的用户档案都包含电子邮件地址。
您可以将属性标记为必需,以确保Platform仅导出包含特定属性的配置文件。 因此,它可以用作附加的筛选形式。 将属性标记为必需是 非 必需的。
不选择强制属性会导出所有符合条件的配置文件,而不管其属性如何。
建议其中一个属性是架构中的唯一标识符。 有关强制属性的更多信息,请参阅电子邮件营销目标文档中的身份部分。
内部重复数据删除键 deduplication-keys
重复数据删除键是用户定义的主键,可确定用户希望为其配置文件进行重复数据删除的身份。
重复数据删除键消除了在一个导出文件中拥有同一配置文件的多个记录的可能性。
有三种方法可以在Platform中使用重复数据删除键:
- 将单个身份命名空间用作重复数据删除键
- 将XDM配置文件中的单个配置文件属性用作重复数据删除键
- 将XDM配置文件中的两个配置文件属性的组合用作复合键
重复数据删除示例 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
如果不使用重复数据删除,导出文件将包含以下条目。
重复数据删除使用案例2:基于身份命名空间进行重复数据删除 deduplication-use-case-2
假定按Email命名空间删除重复项,则导出文件将包含以下条目。 配置文件B是符合受众条件的最新配置文件,因此它是唯一导出的。
重复数据删除使用案例3:基于单个配置文件属性进行重复数据删除 deduplication-use-case-3
假定按personal Email
属性去重,则导出文件将包含以下条目。 配置文件B是符合受众条件的最新配置文件,因此它是唯一导出的。
重复数据删除使用案例4:基于两个配置文件属性的重复数据删除 deduplication-use-case-4
假定按复合键personalEmail + lastName
删除重复项,则导出文件将包含以下条目。
Adobe建议选择身份命名空间(如CRM ID或电子邮件地址)作为重复数据删除键,以确保所有配置文件记录均被唯一识别。
- 这些字段在受众定义中使用。
- 这些字段配置为目标目标的投影属性。
person.name.firstName
的某些数据使用标签与目标的营销操作冲突,您将在审核步骤中看到数据使用策略冲突。 有关详细信息,请参阅Adobe Experience Platform中的数据管理。[Beta]{class="badge informative"}通过计算字段导出数组 export-arrays-calculated-fields
部分测试版客户可以将阵列对象从Experience Platform导出到云存储目标。 阅读有关导出数组和计算字段的更多信息,并联系您的Adobe代表以获取该功能的访问权限。
已知限制 known-limitations
新 映射 页面具有以下已知限制:
无法通过映射工作流选择受众成员资格属性
由于已知限制,您当前无法使用 选择字段 窗口将segmentMembership.seg_namespace.seg_id.status
添加到文件导出。 相反,您需要将值xdm: segmentMembership.seg_namespace.seg_id.status
手动粘贴到架构字段中,如下所示。
segmentMembership.seg_namespace.seg_id.status
segmentMembership.seg_namespace.seg_id.lastQualificationTime
文件导出将因以下方式而异,具体取决于是否选择了segmentMembership.seg_namespace.seg_id.status
:
- 如果选择了
segmentMembership.seg_namespace.seg_id.status
字段,则导出的文件在初始完整快照中包含 Active 成员,在后续增量导出中包含 Active 和 Expired 成员。 - 如果未选择
segmentMembership.seg_namespace.seg_id.status
字段,则导出的文件在初始完整快照和后续增量导出中仅包含 活动 成员。
阅读有关基于文件的目标的配置文件导出行为的详细信息。
当前无法选择要导出的身份命名空间
当前不支持选择导出身份命名空间(如下图所示)。 选择任何要导出的身份命名空间都将导致 审核 步骤出错。
作为临时解决方法,如果您需要在测试版期间将身份命名空间添加到导出的文件,您可以:
- 对于要在导出中包含身份命名空间的数据流,请使用旧版云存储目标
- 将身份作为属性上传到Experience Platform,然后将其导出到您的云存储目标。
选择配置文件属性 select-attributes
对于基于配置文件的目标,必须选择要发送到目标目标的配置文件属性。
-
在 选择属性 页面中,选择 添加新字段。
-
选择 架构字段 条目右侧的箭头。
-
在 选择字段 页面中,选择要发送到目标的XDM属性或身份命名空间,然后选择 选择。
-
要添加更多映射,请重复执行第一步到第三步。
person.name.firstName
、person.name.lastName
、personalEmail.address
、segmentMembership.seg_namespace.seg_id.status
。
segmentMembership.seg_namespace.seg_id.status
添加到文件导出。 相反,您必须将值xdm: segmentMembership.seg_namespace.seg_id.status
手动粘贴到架构字段中,如下所示。文件导出在以下方面有所不同,具体取决于是否选择了segmentMembership.seg_namespace.seg_id.status
:
- 如果选择了
segmentMembership.seg_namespace.seg_id.status
字段,则导出的文件在初始完整快照中包含 Active 成员,在后续增量导出中包含 Active 和 Expired 成员。 - 如果未选择
segmentMembership.seg_namespace.seg_id.status
字段,则导出的文件在初始完整快照和后续增量导出中仅包含 活动 成员。
选择扩充属性 select-enrichment-attributes
扩充属性对应于Experience Platform中作为 自定义上传 摄取的自定义上传受众。 在此步骤中,您可以为每个选定的外部受众选择要导出到目标的属性。
请按照以下步骤为每个外部受众选择扩充属性:
- 在 扩充属性 列中,选择 (编辑)按钮。
- 选择 添加扩充属性。 将显示一个新的空架构字段。
- 选择空字段右侧的按钮以打开字段选择屏幕。
- 选择要为受众导出的属性。
- 添加所有要导出的属性后,选择 保存并关闭。
- 对每个外部受众重复这些步骤。
如果要在不导出任何属性的情况下将外部受众激活到目标,请启用 排除扩充属性 切换开关。 此选项会从外部受众导出用户档案,但不会将其任何相应的属性发送到您的目标。
选择 下一步 以移至审阅步骤。
审查 review
在 审核 页面上,您可以看到所选内容的摘要。 选择 取消 以中断流,上一步 以修改您的设置,或者选择 完成 以确认您的选择并开始将数据发送到目标。
同意策略评估 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
。