不同目标类型的配置文件导出行为
Experience Platform中有多种目标类型,如下图所示。 这些目标在触发目标导出以及导出中包括的内容方面略有不同,如下面的部分所述。
流式目标中的消息聚合 message-aggregation
在深入了解每种目标类型的特定信息之前,了解 流式目标 的消息聚合概念非常重要。
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端点。 在以下情况下,会将配置文件导出到您的目标:
在上述所有情况中,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的受众具有一百个成员,并且有五个新配置文件符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包括五个新配置文件。
决定数据导出的因素以及导出中包含的内容 enterprise-behavior
对于为给定配置文件导出的数据,了解 决定数据导出到企业目标 和 哪些数据包含在导出中 的两个不同概念很重要。
- 映射的属性和区段会作为目标导出的提示。 这意味着,如果配置文件的
segmentMembership状态更改为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的目标。 在以下情况下,会将配置文件导出到您的目标:
在上述所有情况中,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的受众具有一百个成员,并且有五个新配置文件符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包括五个新配置文件。
Experience Platform在沙盒和合并策略级别监视更改的属性,而不是监视每个目标的属性。 如果将使用同一合并策略的受众映射到同一沙盒中的两个不同目标,并且其中一个目标映射对象字段(包含其自己的子字段的字段,也称为子字段),则该对象字段会添加到合并策略的共享受监视属性集中。
因此,对该对象字段的子字段的更改可以触发导出到另一个目标,即使该目标自己的映射不包括对象字段或子字段也是如此。 覆盖具有相同值的字段也会计为更改,并且可能会触发导出。
由于这个原因,在同一沙盒中具有多个流目标(映射的受众共享合并策略)的客户可能会看到比预期更多的导出。 要减少不必要的导出,请查看哪些目标具有映射到其并共享合并策略的受众,并将对象字段映射限制为每个目标所需的子字段。
例如,考虑将两个流目标(目标A和目标B)放在同一沙盒中。 使用相同合并策略的受众将映射到每个目标。
- 目标A映射包含子字段
loyaltyId的对象字段person.loyalty。 - 目标B映射其他字段
person.demographics.age,但未映射person.loyalty或loyaltyId。
否则,这两个字段不相关。 唯一的连接是映射到每个目标的受众使用相同的合并策略,这会导致受监视属性的共享集同时包含这两个字段。 由于目标A的映射将person.loyalty添加到该共享集,因此对loyaltyId的更改也会触发导出到目标B,即使目标B从未映射该对象字段。
如果loyaltyId被同一值覆盖,仍会将此计为更改。 结果,目标A和目标B都可以接收导出。
决定数据导出的因素以及导出中包含的内容 streaming-behavior
有关为给定用户档案导出的数据,请务必了解决定数据导出到流API目标的两个不同概念,以及导出中包含哪些数据。
- 映射的属性和区段会作为目标导出的提示。 这意味着,如果配置文件的
segmentMembership状态更改为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.statusXDM字段,退出受众的用户档案也包含在导出的增量文件中,状态为exited。
决定数据导出的因素以及导出中包含的内容 file-based-export-details
根据上一节中的信息,可以按照以下描述概括向基于文件的目标的配置文件导出行为:
完整文件导出
每天导出受众的全部活跃群体。
增量文件导出
在设置激活工作流后的第一个文件导出中,将导出受众的整个群体。 在后续导出中,仅导出修改后的用户档案。
- 在UI或API中设置的导出计划决定了目标导出的开始。
- 无论用户档案的受众成员资格发生任何更改(包括符合或不符合区段的条件),还是标识映射发生更改,都会使用户档案符合包含在增量导出中的条件。 对配置文件的属性所做的更改不符合增量导出中包括配置文件的条件。
受众成员资格发生更改的用户档案,以及每个选定用于导出的XDM属性的最新信息。
如果在映射步骤中选择了segmentMembership.status XDM字段,则具有已退出状态的配置文件将包含在目标导出中。
后续步骤 next-steps
阅读本文档后,您现在了解了在向流式、企业和基于文件的目标导出配置文件时应看到的内容。
接下来,您可以了解如何在激活工作流中处理身份。