彙總原則

為確保將資料匯出至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

閱讀本文後，您應該更瞭解如何為目的地設定彙總原則。

若要深入瞭解其他目的地元件，請參閱下列文章：