聚合策略
为了确保将数据导出到API端点时实现最高效率,您可以使用各种设置将导出的用户档案聚合为更大或更小的批次,按身份和其他用例对其进行分组。 这还允许您根据API端点的任何下游限制(速率限制、每个API调用的身份数等)定制数据导出。
使用可配置的聚合深入了解Destination SDK提供的设置,或使用尽力聚合告知Destination SDK尽可能多地分批API调用。
使用Destination SDK构建实时(流)目标时,您可以配置如何将导出的用户档案组合在生成的导出中。 此行为由聚合策略设置决定。
要了解此组件在何处适合使用Destination SDK创建的集成,请参阅配置选项文档中的关系图,或查看有关如何使用Destination SDK配置流目标的指南。
您可以通过/authoring/destinations
端点配置聚合策略设置。 有关详细的API调用示例,请参阅以下API参考页面,您可以在其中配置此页面中显示的组件。
本文介绍了可用于目标的所有受支持的聚合策略设置。
阅读本文档后,请参阅有关使用模板和聚合密钥示例的文档,了解如何根据所选的聚合策略将聚合策略包含在消息转换模板中。
支持的集成类型 supported-integration-types
有关哪些类型的集成支持此页面上描述的功能,请参阅下表。
最大努力聚合 best-effort-aggregation
最大努力聚合最适合以下目标:每个请求喜欢较少的配置文件,并且与具有较多数据的更少请求相比,宁愿接收具有较少数据的更多请求。
以下示例配置显示了最大努力聚合配置。 有关可配置聚合的示例,请参阅可配置聚合部分。 下表介绍了适用于最大努力聚合的参数。
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
}
aggregationType
指示目标应使用的聚合策略的类型。 支持的聚合类型:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
此值指示您的终结点在一个HTTP调用中应接收的最大配置文件数。 请注意,这是最大努力汇总。 例如,如果指定值100,Platform在调用中可能会发送任何数量小于100的用户档案。
如果您的服务器不接受每个请求多个用户,请将此值设置为
1
。bestEffortAggregation.splitUserById
true
。可配置的聚合 configurable-aggregation
如果更愿意以大批量方式进行,且在同一调用中使用数千个配置文件,则可配置的聚合效果最佳。 此选项还允许您根据复杂的聚合规则聚合导出的用户档案。
下面的示例配置显示了可配置的聚合配置。 有关最大努力聚合的示例,请参阅最大努力聚合部分。 下表介绍了适用于可配置聚合的参数。
"aggregation":{
"aggregationType":"CONFIGURABLE_AGGREGATION",
"configurableAggregation":{
"splitUserById":true,
"maxBatchAgeInSecs":2400,
"maxNumEventsInBatch":5000,
"aggregationKey":{
"includeSegmentId":true,
"includeSegmentStatus":true,
"includeIdentity":true,
"oneIdentityPerGroup":true,
"groups":[
{
"namespaces":[
"IDFA",
"GAID"
]
},
{
"namespaces":[
"EMAIL"
]
}
]
}
}
}
aggregationType
指示目标应使用的聚合策略的类型。 支持的聚合类型:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
true
。configurableAggregation.maxBatchAgeInSecs
此参数与maxNumEventsInBatch
结合使用,可决定Experience Platform在向端点发送API调用之前应等待的时间。
- 最小值(秒):1800
- 最大值(秒):3600
例如,如果为这两个参数使用最大值,则Experience Platform将等待3600秒或直到10000有符合条件的配置文件为止,然后再进行API调用(以先发生者为准)。
configurableAggregation.maxNumEventsInBatch
此参数与maxBatchAgeInSecs
结合使用,可确定在API调用中应聚合多少个符合条件的配置文件。
- 最小值:1000
- 最大值:10000
例如,如果为这两个参数使用最大值,则Experience Platform将等待3600秒或直到10000有符合条件的配置文件为止,然后再进行API调用(以先发生者为准)。
configurableAggregation.aggregationKey
configurableAggregation.aggregationKey.includeSegmentId
true
。configurableAggregation.aggregationKey.includeSegmentStatus
includeSegmentId
设置为true
。configurableAggregation.aggregationKey.includeIdentity
true
。configurableAggregation.aggregationKey.oneIdentityPerGroup
true
。configurableAggregation.aggregationKey.groups
后续步骤 next-steps
阅读本文后,您应该更好地了解如何为目标配置聚合策略。
要了解有关其他目标组件的更多信息,请参阅以下文章: