歸因範圍可讓 API 呼叫端在來源和觸發條件登錄期間指定字串清單，以便在歸因發生前進行篩選。這樣一來，您就能進行更精細的篩選，提高 API 效率並提供更多彈性。舉例來說，這項功能可讓您清楚追蹤同一網站上的不同廣告主。這項功能還可讓您在單一廣告橫幅中追蹤多個廣告活動或產品。
歸因範圍是可選欄位，可在來源和觸發事件登錄期間設定。在歸因期間，只有歸因範圍值包含至少一個觸發條件的歸因範圍值的來源，才會納入歸因考量。如果觸發條件未指定範圍，系統會考量所有來源。請先熟悉 Attribution Reporting API 和高層級篩選器，再繼續操作。
來源登錄期間
選用參數 attribution_scopes 已加入至標頭 Attribution-Reporting-Register-Source，其中包含兩個必要參數：值和限制，以及一個選用參數：max_event_states。
- limit：代表報表來源每個目的地允許的非重複範圍總數。系統會刪除所有現有的已註冊來源，這些來源的報表來源和目的地相同，但限制較低。
- values：代表特定來源的歸因範圍清單。這些值必須為字串，且長度上限為 50。
- max_event_states (選用)：代表 API 呼叫端在所有後續事件來源註冊作業中，預計要使用的事件狀態上限。請注意，如果報表來源和目的地相同，但
max_event_states value不同，則系統會刪除所有現有的已註冊來源。這個選用欄位的預設值為 3。
來源登錄範例
Attribution-Reporting-Register-source: {
//optional
"attribution_scopes":{
"limit": <int>,
"values": <list of strings>,
// optional
"max_event_states": <int>
},
...
}
觸發條件登錄期間
在觸發事件登錄期間，選用參數 attribution_scopes 會新增至標頭 Attribution-Reporting-Register-Trigger。請確認參數值是代表觸發事件範圍的字串清單。觸發事件只會比對 attribution_scopes 值參數中至少包含一個觸發事件的 attribution_scopes (如果有指定的話)。
觸發條件登錄範例
Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}
歸因範圍示例
以下範例說明在使用歸因範圍時，觸發事件歸因於來源的情況。
來源登錄 #1
Attribution-Reporting-Register-source: {
"destination": "https://trigger.example",
"attribution_scopes": {
"limit": 2,
"values": ["advertiser1"],
"max_event_states": 3
},
...
}
來源登錄 #2
Attribution-Reporting-Register-source: {
"destination": "https://trigger.example",
"attribution_scopes": {
"limit": 2,
"values": ["advertiser2"],
"max_event_states": 3
},
...
}
登錄觸發事件
Attribution-Reporting-Register-Trigger: {
"attribution_scopes": ["advertiser1"],
...
}
觸發條件登錄時，API 會選取歸因來源，這些來源的 attribution_scopes 值與觸發條件登錄中的值重疊。相符的來源登錄會繼續進行歸因流程的其餘部分。在這個範例中，API 呼叫端會收到歸因報表，將觸發事件登錄歸因至第一個來源登錄。
歸因範圍與篩選器
雖然歸因範圍和篩選器的功能看起來很相似，但兩者在觸發事件註冊流程中的套用位置有所不同。歸因範圍篩選作業會在歸因之前進行。也就是說，系統會根據來源範圍與觸發條件中所找到的範圍，減少具有相同目的地網站和回報來源的候選來源池。不過，頂層篩選器會在觸發事件歸因於單一來源後才套用。如果來源和觸發條件篩選器不重疊，系統就不會產生報表。
下圖顯示一組來源和觸發事件，這些來源和觸發事件具有相同的目標網站和回報來源，且未過期。我們將簡要說明歸因範圍和篩選器的使用方式，以及系統是否會根據可用的來源和觸發事件產生報表。
<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />
歸因之前
- 由於來源 #1 的歸因範圍與觸發事件的
casualwear範圍不符，因此會遭到篩除。即使優先順序在所有可用來源中最高，系統仍會在檢查優先順序前進行歸因前篩選，因此仍可能遭到篩除。 - 來源 #2 也因與觸發事件的範圍不同而遭到篩除。這個來源也與觸發事件使用相同的篩選器，但高層級篩選器會在歸因後才套用。
歸因期間
- 來源 #3 的優先順序低於來源 #4，因此不會選為歸因來源。
- 系統選取了來源 #4，因為該來源與觸發事件的歸因範圍相符，且優先順序最高。高層級篩選器會在歸因後套用，因此不會在歸因過程中納入考量。
貼文歸因
- 系統不會產生報表，因為所選來源 (來源 #4) 的高層級篩選器和觸發條件不重疊。
上一個範例不會產生報表，不過，如果第四個來源完全移除：
歸因期間
- 系統選取了來源 #3，因為它與觸發事件的歸因範圍重疊。
貼文歸因
- 由於來源 #3 的篩選器與觸發條件中的篩選器重疊，因此不會遭到拒絕。歸因程序接著會進行其他歸因後檢查，如果通過所有檢查，就會產生報表。
歸因範圍可減少歸因考量的來源數量。接著，系統會將剩餘的歸因步驟套用至這個較小的來源集合，並可能產生報表。
歸因範圍在歸因流程中的位置
歸因範圍會在選取歸因來源之前套用。這也優先於頂層篩選器和自訂報表視窗篩選。下圖顯示整體歸因流程的簡化版，其中歸因範圍會在歸因和其他歸因檢查之前發生。
<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="圖片顯示簡化的歸因流程，每個步驟以方塊表示，並以箭頭連結至下一個步驟。步驟順序如下：" and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="簡化版歸因流程圖" />
歸因流程作業
以下是歸因流程中執行的各種作業摘要：
- 來源登錄：當使用者在廣告客戶的網站上與廣告互動時，系統就會登錄來源事件。接著，裝置會向報表來源的端點傳送要求，而端點會回應含有來源事件資料的標頭。
- 觸發事件登錄：當廣告客戶網站發生轉換時，系統就會登錄觸發事件。裝置會將另一項要求傳送至報表來源，後者會回覆包含觸發事件資料的標頭。
- 來源比對：裝置會根據目的地網站、回報來源和到期日等條件，比對來源和觸發事件。
- 歸因範圍檢查：系統會根據來源和觸發事件 attribution_scopes 值的交集來篩選來源。
- 歸因：如果有多個來源符合條件，裝置會選取優先順序最高的來源進行歸因。如果優先順序相同，系統會選取最近的一個。
- 篩選器檢查：裝置會比較來源和觸發事件篩選器，判斷是否相符。如果篩選器不相符，系統就會捨棄歸因。
- 停用其他來源：如果所選來源的篩選器相符，裝置會停用在來源比對階段相符的來源。停用的來源包括歸因範圍不符合觸發事件範圍的來源。
- 歸因後檢查：裝置會對所選歸因進行更多檢查，例如檢查來源是否受到假報表干擾、使用去重複鍵檢查重複歸因、檢查觸發事件是否落在來源的報表時間範圍內，以及檢查頻率限制。
- 產生報表：如果所有檢查項目都通過，裝置就會產生歸因報表並排定傳送時間，以便傳送至報表來源的端點。
後續步驟
- 如要進一步瞭解歸因範圍，請參閱 歸因前篩選 GitHub 說明。
- 如要進一步瞭解篩選器，請參閱「使用篩選器定義客戶規則」一文。