不同目标类型的配置文件导出行为

Experience Platform中有多种目标类型,如下图所示。 这些目标在触发目标导出以及导出中包括的内容方面略有不同,如下面的部分所述。

IMPORTANT
本文档页面仅介绍图表底部高亮显示的连接的配置文件导出行为。

目标图类型

流式目标中的消息聚合

在深入了解每种目标类型的特定信息之前,了解​ 流式目标 ​的消息聚合概念非常重要。

Experience Platform目标会以HTTPS调用的形式将数据导出到基于API的集成。 一旦其他上游服务通知目标服务由于批量摄取、流式摄取、批量分段、流式分段或身份图更改而更新了用户档案,数据将被导出并发送到流式目标。

用户档案在发送到目标API端点之前会聚合到HTTPS消息中。

以具有​ 可配置聚合 ​策略的Facebook目标为例 — 数据以聚合方式发送,其中目标服务接收来自配置文件服务上游的所有传入数据,并在将数据分派到Facebook之前按以下方式之一聚合这些数据:

  • 记录数(最多10,000)或
  • 时间窗口间隔(300秒)

首次满足上述阈值的任何一个都会触发导出到Facebook的操作。 因此,在Facebook Custom Audiences仪表板中,您可能会看到以10,000条记录增量从Experience Platform中输入的受众。 您可能会每2-3分钟看到10,000条记录,因为处理和聚合数据的速度比300秒导出间隔快,而且发送速度也快,所以大约每2-3分钟就会处理一次所有记录。 如果没有足够的记录来构成10,000批,则当前记录数将按满足时间窗口阈值时的方式发送,因此您也可能会看到发送到Facebook的较小批。

作为另一个示例,请考虑具有maxUsersPerRequest: 10的​ 最大努力聚合 ​策略的HTTP API目标。 这意味着,在触发对此目标的HTTP调用之前,最多将汇总10个配置文件,但Experience Platform会在目标服务收到来自上游服务的更新重新评估信息后立即尝试将配置文件调度到目标。

聚合策略是可配置的,目标开发人员可以决定如何配置聚合策略以最好地满足下游API端点的速率限制。 有关聚合策略的详细信息,请参阅Destination SDK文档。

流配置文件导出(企业)目标 streaming-profile-destinations

IMPORTANT
企业目标仅适用于Adobe Real-time Customer Data Platform Ultimate客户。

Experience Platform中的企业目标是Amazon Kinesis、Azure事件中心和HTTP API。

Experience Platform可优化将配置文件导出到企业目标的行为,以便仅在符合受众资格或其他重要事件后对配置文件进行了相关更新时将数据导出到API端点。 在以下情况下,会将配置文件导出到您的目标:

  • 配置文件更新由映射到目标的至少一个受众的受众成员资格中的更改决定。 例如,配置文件已符合映射到目标的其中一个受众的条件,或已退出映射到目标的其中一个受众。
  • 配置文件更新由标识映射中的更改决定。 例如,对于已经符合映射到目标的其中一个受众资格的用户档案,在身份映射属性中添加了一个新身份。
  • 配置文件更新由映射到目标的至少一个属性的更改确定。 例如,将映射步骤中映射到目标的某个属性添加到配置文件中。

在上述所有情况中,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的受众具有一百个成员,并且有五个新配置文件符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包括五个新配置文件。

请注意,所有映射的属性都会导出到配置文件,无论更改位于何处。 因此,在上面的示例中,将导出这五个新配置文件的所有映射属性,即使属性本身未发生更改也是如此。

决定数据导出的因素以及导出中包含的内容

对于为给定配置文件导出的数据,了解​ 决定数据导出到企业目标 ​和​ 哪些数据包含在导出中 ​的两个不同概念很重要。

决定目标导出的因素
目标导出中包含的内容
  • 映射的属性和受众会作为目标导出的提示。 这意味着,如果任何映射的受众更改状态(从null更改为realized或从realized更改为exiting)或更新任何映射的属性,则将启动目标导出。
  • 由于身份当前无法映射到企业目标,因此给定配置文件上任何身份的更改也将决定目标导出。
  • 属性的更改被定义为属性上的任何更新,无论其是否为相同的值。 这意味着即使值本身未发生更改,也会将覆盖属性视为更改。
  • segmentMembership对象包括激活数据流中映射的受众,在资格或受众退出事件后,配置文件的状态已发生更改。 请注意,如果其他未映射受众与激活数据流中映射的受众属于同一个合并策略,则配置文件符合这些受众资格的其他未映射受众可以属于目标导出的一部分。
  • identityMap对象中的所有标识也包括在内(Experience Platform当前不支持企业目标中的标识映射)。
  • 目标导出中只包含映射的属性。
IMPORTANT
将用户档案激活到目标时,企业目标会流式传输回填数据。 这意味着在将激活工作流配置到目标之后,首次数据导出将包括符合激活受众条件的用户档案,然后该受众将映射到目标。
recommendation-more-help

例如,考虑将此数据流映射到HTTP目标,其中在数据流中选择了三个受众,并且四个属性映射到目标。

企业目标数据流

配置文件导出到目标可以由符合或退出​ 三个映射区段 ​之一的配置文件确定。 但是,在数据导出的segmentMembership对象中,如果该特定配置文件是其他未映射受众的成员,并且这些受众与触发导出的受众共享相同的合并策略,则可能会显示其他未映射受众。 如果某个配置文件符合​ 拥有DeLorean Cars的客户 ​受众的条件,但同时也是​ 观看的“回到未来”电影 ​和​ 科幻迷 ​区段的成员,则另外这两个受众也将出现在数据导出的segmentMembership对象中,即使它们未在数据流中映射,前提是它们与​ 拥有DeLorean Cars的客户 ​区段共享相同的合并策略。

从配置文件属性的角度来看,对上述四个映射属性所做的任何更改都将决定目标导出,并且配置文件中存在的四个映射属性中的任何一个都会出现在数据导出中。

TIP
您可以在Amazon KinesisAzure事件中心HTTP API目标文档页中看到导出到各种企业目标的数据的示例。

基于API的流目标 streaming-api-based-destinations

流式目标(如Facebook、Trade Desk和其他基于API的集成)的配置文件导出行为与上述企业目标的行为非常相似。

流目标的示例是属于目录中社交和广告类别的目标。

Experience Platform会优化将配置文件导出到您的流目标的行为,以便仅在符合受众资格或其他重要事件后对配置文件进行了相关更新时,将数据导出到基于流API的目标。 在以下情况下,会将配置文件导出到您的目标:

  • 配置文件更新由映射到目标的至少一个受众的受众成员资格中的更改决定。 例如,配置文件已符合映射到目标的其中一个受众的条件,或已退出映射到目标的其中一个受众。
  • 配置文件更新是由标记为导出此目标实例的标识命名空间在标识映射中的更改确定的。 例如,对于已经符合映射到目标的其中一个受众资格的用户档案,在身份映射属性中添加了一个新身份。
  • 配置文件更新由映射到目标的至少一个属性的更改确定。 例如,将映射步骤中映射到目标的某个属性添加到配置文件中。
  • 在配置自动同意实施并且用户档案选择退出后,用户档案的同意会发生更改。 自动同意实施会将受众退出事件发送到目标,因此该配置文件不会包含在目标的任何定位中。

在上述所有情况中,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的受众具有一百个成员,并且有五个新配置文件符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包括五个新配置文件。

请注意,所有映射的属性都会导出到配置文件,无论更改位于何处。 因此,在上面的示例中,将导出这五个新配置文件的所有映射属性,即使属性本身未发生更改也是如此。

决定数据导出的因素以及导出中包含的内容

有关为给定用户档案导出的数据,请务必了解决定数据导出到流API目标的两个不同概念,以及导出中包含哪些数据。

决定目标导出的因素
目标导出中包含的内容
  • 映射的属性和受众会作为目标导出的提示。 这意味着,如果任何映射的受众更改状态(从null更改为realized或从realized更改为exiting)或更新任何映射的属性,则将启动目标导出。
  • 标识映射中的更改被定义为为配置文件的标识图形添加/删除的标识,用于映射为导出的标识命名空间。
  • 对于映射到目标的属性,属性的更改被定义为属性上的任何更新。
  • 映射到目标且已更改的受众将包含在segmentMembership对象中。 在某些情况下,它们可能会使用多个调用导出。 此外,在某些情况下,某些未更改的受众也可能包含在调用中。 在任何情况下,仅导出映射的受众。
  • 命名空间中映射到identityMap对象中目标的所有标识也包括在内。
  • 目标导出中只包含映射的属性。
IMPORTANT
将用户档案激活到目标时,流API目标会流式回填数据。 这意味着在将激活工作流配置到目标之后,首次数据导出将包括符合激活受众条件的用户档案,然后该受众将映射到目标。

例如,将此数据流考虑到一个在数据流中选择了三个受众的流目标。

流式目标数据流

导出到目标的配置文件可由符合或退出三个映射区段之一的配置文件来确定。 如果配置文件符合​ 具有DeLorean Cars的客户 ​区段的条件,则会触发导出。 其他受众(城市 — 达拉斯 ​和​ 基本站点活动)也可以导出,以防配置文件中该受众的状态为可能的状态之一(realizedexited)。 未映射的受众(如​ 科幻迷)将不会导出。

从配置文件属性的角度来看,对上述三个映射属性所做的任何更改都将决定目标导出。

批处理(基于文件)目标 file-based-destinations

将配置文件导出到Experience Platform中基于文件的目标时,您可以使用三种类型的计划(如下所列)和两个文件导出选项(完整或增量文件)。 所有这些设置都是在受众级别上设置的,即使多个受众映射到单个目标数据流也是如此。

  • 计划导出:配置一个目标,添加一个或多个区段,选择要导出完整文件或增量文件,并选择每天的设置时间或每天应导出文件的几次。 例如,下午5点的导出时间意味着下午5点将导出符合受众条件的配置文件。
  • 区段评估后:在每日受众评估作业运行后立即触发导出。 这意味着文件中的导出用户档案编号尽可能接近区段的最新评估群体。
  • 按需导出(立即导出文件):根据最新的受众评估作业,在定期计划的导出基础上,一次性导出完整文件。

在上述任何导出情况下,导出的文件都包含符合导出条件的配置文件,以及您选择作为要导出的XDM属性的列。

TIP
当流式受众映射到批处理目标时,导出文件中的配置文件数更有可能接近于区段中的用户数。 这是因为最新受众评估更接近导出时间的可能性更高。

增量文件导出 incremental-file-exports

并非配置文件的所有更新都允许在增量文件导出中包含配置文件。 例如,如果在配置文件中添加或删除了属性,则导出中不包含该配置文件。

但是,当配置文件的segmentMembership属性更改时,该配置文件将包含在导出的文件中。 换言之,如果配置文件成为受众的一部分或从受众中删除,则它将包含在增量文件导出中。

同样,如果在身份图中的配置文件中添加了新身份(新电子邮件地址、电话号码、ECID等),则会触发将该配置文件包含在新的增量文件导出中。

如果将新受众添加到目标映射,这不会影响其他区段的资格和导出。 每个受众单独配置导出计划,并且每个区段单独导出文件,即使已将受众添加到同一目标数据流也是如此。

例如,在下图所示的导出设置中(受众正在导出增量文件更新),请注意以下情况(其中配置文件是否包含在增量文件导出中):

导出具有多个选定属性的设置。

  • 当配置文件​ 符合或不符合区段资格时,该配置文件包含在增量文件导出中
  • 向标识图中添加新电话号码时,增量文件导出中包含配置文件​**。
  • 在配置文件上更新任何映射的XDM字段(如xdm: loyalty.pointsxdm: loyalty.tierxdm: personalEmail.address)的值时,增量文件导出中不包含配置文件​**。
  • 无论何时在目标激活工作流中映射segmentMembership.status XDM字段,退出受众​ 的用户档案也包含在导出的增量文件中,状态为exited

决定数据导出的因素以及导出中包含的内容

根据上一节中的信息,可以按照以下描述概括向基于文件的目标的配置文件导出行为:

完整文件导出

每天导出受众的全部活跃群体。

决定目标导出的因素
导出文件中包含的内容
在完整文件导出中,每个文件导出都会包含区段的整个活动用户档案群体(基于最新的受众评估)。 每个为导出选择的XDM属性的最新值也作为列包含在每个文件中。 请注意,处于已退出状态的配置文件不会包含在文件导出中。

增量文件导出

在设置激活工作流后的第一个文件导出中,将导出受众的整个群体。 在后续导出中,仅导出修改后的用户档案。

决定目标导出的因素
导出文件中包含的内容
  • 在UI或API中设置的导出计划决定了目标导出的开始。
  • 无论用户档案的受众成员资格发生任何更改(包括符合或不符合区段的条件),还是标识映射发生更改,都会使用户档案符合包含在增量导出中的条件。 对配置文件​ 的属性所做的更改不符合增量导出中包括配置文件的条件。

受众成员资格发生更改的用户档案,以及每个选定用于导出的XDM属性的最新信息。

如果在映射步骤中选择了segmentMembership.status XDM字段,则具有已退出状态的配置文件将包含在目标导出中。

TIP
提醒您,如果对配置文件的标识映射进行了更改,则该配置文件有资格包含在增量文件导出中。 属性值​ 中的更改不允许 ​包含在增量文件导出中。

后续步骤 next-steps

阅读本文档后,您现在了解了在向流式、企业和基于文件的目标导出配置文件时应看到的内容。

接下来,您可以了解如何在激活工作流中处理身份

7f4d1967-bf93-4dba-9789-bb6b505339d6