聚合策略

为了确保将数据导出到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
   }
}

可配置的聚合 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"
               ]
            }
         ]
      }
   }
}

后续步骤 next-steps

阅读本文后，您应该更好地了解如何为目标配置聚合策略。

要了解有关其他目标组件的更多信息，请参阅以下文章：