不同目标类型的配置文件导出行为
Experience Platform中有多种目标类型,如下图所示。 这些目标在触发目标导出以及导出中包括的内容方面略有不同,如下面的部分所述。
流式目标中的消息聚合
在深入了解每种目标类型的特定信息之前,了解 流式目标 的消息聚合概念非常重要。
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
Experience Platform中的企业目标是Amazon Kinesis、Azure事件中心和HTTP API。
Experience Platform可优化将配置文件导出到企业目标的行为,以便仅在符合受众资格或其他重要事件后对配置文件进行了相关更新时将数据导出到API端点。 在以下情况下,会将配置文件导出到您的目标:
在上述所有情况中,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的受众具有一百个成员,并且有五个新配置文件符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包括五个新配置文件。
请注意,所有映射的属性都会导出到配置文件,无论更改位于何处。 因此,在上面的示例中,将导出这五个新配置文件的所有映射属性,即使属性本身未发生更改也是如此。
决定数据导出的因素以及导出中包含的内容
对于为给定配置文件导出的数据,了解 决定数据导出到企业目标 和 哪些数据包含在导出中 的两个不同概念很重要。
- 映射的属性和受众会作为目标导出的提示。 这意味着,如果任何映射的受众更改状态(从
null
更改为realized
或从realized
更改为exiting
)或更新任何映射的属性,则将启动目标导出。 - 由于身份当前无法映射到企业目标,因此给定配置文件上任何身份的更改也将决定目标导出。
- 属性的更改被定义为属性上的任何更新,无论其是否为相同的值。 这意味着即使值本身未发生更改,也会将覆盖属性视为更改。
segmentMembership
对象包括激活数据流中映射的受众,在资格或受众退出事件后,配置文件的状态已发生更改。 请注意,如果其他未映射受众与激活数据流中映射的受众属于同一个合并策略,则配置文件符合这些受众资格的其他未映射受众可以属于目标导出的一部分。identityMap
对象中的所有标识也包括在内(Experience Platform当前不支持企业目标中的标识映射)。- 目标导出中只包含映射的属性。
例如,考虑将此数据流映射到HTTP目标,其中在数据流中选择了三个受众,并且四个属性映射到目标。
配置文件导出到目标可以由符合或退出 三个映射区段 之一的配置文件确定。 但是,在数据导出的segmentMembership
对象中,如果该特定配置文件是其他未映射受众的成员,并且这些受众与触发导出的受众共享相同的合并策略,则可能会显示其他未映射受众。 如果某个配置文件符合 拥有DeLorean Cars的客户 受众的条件,但同时也是 观看的“回到未来”电影 和 科幻迷 区段的成员,则另外这两个受众也将出现在数据导出的segmentMembership
对象中,即使它们未在数据流中映射,前提是它们与 拥有DeLorean Cars的客户 区段共享相同的合并策略。
从配置文件属性的角度来看,对上述四个映射属性所做的任何更改都将决定目标导出,并且配置文件中存在的四个映射属性中的任何一个都会出现在数据导出中。
基于API的流目标 streaming-api-based-destinations
流式目标(如Facebook、Trade Desk和其他基于API的集成)的配置文件导出行为与上述企业目标的行为非常相似。
流目标的示例是属于目录中社交和广告类别的目标。
Experience Platform会优化将配置文件导出到您的流目标的行为,以便仅在符合受众资格或其他重要事件后对配置文件进行了相关更新时,将数据导出到基于流API的目标。 在以下情况下,会将配置文件导出到您的目标:
在上述所有情况中,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的受众具有一百个成员,并且有五个新配置文件符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包括五个新配置文件。
请注意,所有映射的属性都会导出到配置文件,无论更改位于何处。 因此,在上面的示例中,将导出这五个新配置文件的所有映射属性,即使属性本身未发生更改也是如此。
决定数据导出的因素以及导出中包含的内容
有关为给定用户档案导出的数据,请务必了解决定数据导出到流API目标的两个不同概念,以及导出中包含哪些数据。
- 映射的属性和受众会作为目标导出的提示。 这意味着,如果任何映射的受众更改状态(从
null
更改为realized
或从realized
更改为exiting
)或更新任何映射的属性,则将启动目标导出。 - 标识映射中的更改被定义为为配置文件的标识图形添加/删除的标识,用于映射为导出的标识命名空间。
- 对于映射到目标的属性,属性的更改被定义为属性上的任何更新。
- 映射到目标且已更改的受众将包含在
segmentMembership
对象中。 在某些情况下,它们可能会使用多个调用导出。 此外,在某些情况下,某些未更改的受众也可能包含在调用中。 在任何情况下,仅导出映射的受众。 - 命名空间中映射到
identityMap
对象中目标的所有标识也包括在内。 - 目标导出中只包含映射的属性。
例如,将此数据流考虑到一个在数据流中选择了三个受众的流目标。
导出到目标的配置文件可由符合或退出三个映射区段之一的配置文件来确定。 如果配置文件符合 具有DeLorean Cars的客户 区段的条件,则会触发导出。 其他受众(城市 — 达拉斯 和 基本站点活动)也可以导出,以防配置文件中该受众的状态为可能的状态之一(realized
或exited
)。 未映射的受众(如 科幻迷)将不会导出。
从配置文件属性的角度来看,对上述三个映射属性所做的任何更改都将决定目标导出。
批处理(基于文件)目标 file-based-destinations
将配置文件导出到Experience Platform中基于文件的目标时,您可以使用三种类型的计划(如下所列)和两个文件导出选项(完整或增量文件)。 所有这些设置都是在受众级别上设置的,即使多个受众映射到单个目标数据流也是如此。
- 计划导出:配置一个目标,添加一个或多个区段,选择要导出完整文件或增量文件,并选择每天的设置时间或每天应导出文件的几次。 例如,下午5点的导出时间意味着下午5点将导出符合受众条件的配置文件。
- 区段评估后:在每日受众评估作业运行后立即触发导出。 这意味着文件中的导出用户档案编号尽可能接近区段的最新评估群体。
- 按需导出(立即导出文件):根据最新的受众评估作业,在定期计划的导出基础上,一次性导出完整文件。
在上述任何导出情况下,导出的文件都包含符合导出条件的配置文件,以及您选择作为要导出的XDM属性的列。
增量文件导出 incremental-file-exports
并非配置文件的所有更新都允许在增量文件导出中包含配置文件。 例如,如果在配置文件中添加或删除了属性,则导出中不包含该配置文件。
但是,当配置文件的segmentMembership
属性更改时,该配置文件将包含在导出的文件中。 换言之,如果配置文件成为受众的一部分或从受众中删除,则它将包含在增量文件导出中。
同样,如果在身份图中的配置文件中添加了新身份(新电子邮件地址、电话号码、ECID等),则会触发将该配置文件包含在新的增量文件导出中。
如果将新受众添加到目标映射,这不会影响其他区段的资格和导出。 每个受众单独配置导出计划,并且每个区段单独导出文件,即使已将受众添加到同一目标数据流也是如此。
例如,在下图所示的导出设置中(受众正在导出增量文件更新),请注意以下情况(其中配置文件是否包含在增量文件导出中):
- 当配置文件 符合或不符合区段资格时,该配置文件包含在增量文件导出中。
- 向标识图中添加新电话号码时,增量文件导出中包含配置文件**。
- 在配置文件上更新任何映射的XDM字段(如
xdm: loyalty.points
、xdm: loyalty.tier
、xdm: personalEmail.address
)的值时,增量文件导出中不包含配置文件**。 - 无论何时在目标激活工作流中映射
segmentMembership.status
XDM字段,退出受众 的用户档案也包含在导出的增量文件中,状态为exited
。
决定数据导出的因素以及导出中包含的内容
根据上一节中的信息,可以按照以下描述概括向基于文件的目标的配置文件导出行为:
完整文件导出
每天导出受众的全部活跃群体。
增量文件导出
在设置激活工作流后的第一个文件导出中,将导出受众的整个群体。 在后续导出中,仅导出修改后的用户档案。
- 在UI或API中设置的导出计划决定了目标导出的开始。
- 无论用户档案的受众成员资格发生任何更改(包括符合或不符合区段的条件),还是标识映射发生更改,都会使用户档案符合包含在增量导出中的条件。 对配置文件 的属性所做的更改不符合增量导出中包括配置文件的条件。
受众成员资格发生更改的用户档案,以及每个选定用于导出的XDM属性的最新信息。
如果在映射步骤中选择了segmentMembership.status
XDM字段,则具有已退出状态的配置文件将包含在目标导出中。
后续步骤 next-steps
阅读本文档后,您现在了解了在向流式、企业和基于文件的目标导出配置文件时应看到的内容。
接下来,您可以了解如何在激活工作流中处理身份。