彙總原則
為確保將資料匯出至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
如果您想要依受眾ID將匯出至目的地的設定檔分組。configurableAggregation.aggregationKey.includeSegmentStatus
includeSegmentId
至 true
,如果您想要依受眾ID和受眾狀態,將匯出至目的地的設定檔分組。configurableAggregation.aggregationKey.includeIdentity
true
如果您想要依身分名稱空間將匯出至目的地的設定檔分組。configurableAggregation.aggregationKey.oneIdentityPerGroup
true
如果您希望匯出的設定檔根據單一身分歸入群組(GAID、IDFA、電話號碼、電子郵件等)。configurableAggregation.aggregationKey.groups
後續步驟 next-steps
閱讀本文後,您應該更瞭解如何為目的地設定彙總原則。
若要深入瞭解其他目的地元件,請參閱下列文章: