啟用轉換評估

轉換歸因評估可能涉及多方，包括發布商、廣告主、廣告技術服務供應商 (提供廣告的實體) 和評估供應商等。本文件將說明常見的轉換評估情境，但一般來說，如要從Attribution Reporting API (ARA) 接收歸因報表，請務必遵循本文件所述的整合步驟。

舉例來說，發布商通常會聘請一或多個廣告技術供應商負責放送廣告，包括負責為廣告素材提供標記的供應商、負責在廣告素材中提供曝光或追蹤像素的供應商，以及負責為發布商網頁上的廣告版位提供 SDK 或代碼的供應商。這些廣告技術可能會或不會想接收 ARA 的歸因報表，但必須確保下游廣告技術能接收歸因報表。

此外，廣告客戶也可能會使用第三方轉換評估服務供應商，用於跨聯播網歸因和其他報表功能。廣告主會利用這些資料，瞭解多個獨立發布商和管道的廣告投資報酬率，因此 DSP 或廣告伺服器必須瞭解如何啟用 Attribution Reporting API，以便支援這些用途。如果廣告主想繼續使用第三方，可以使用第三方評估服務供應商，或是設定內部伺服器來登錄及接收來自 API 的報表。

Attribution Reporting API 可讓多項廣告技術為相同曝光或轉換登錄歸因來源和觸發事件，並從 API 接收個別報表。舉例來說，需求端平台可以從 Attribution Reporting API 接收自己的歸因報表，並允許廣告客戶的第三方評估服務供應商另行製作報表。廣告技術必須同時登錄歸因來源和觸發事件，才能接收來自 API 的報表，而系統則會依據廣告技術使用該 API 登錄的歸因來源和觸發事件完成歸因作業。

常見的轉換評估情境

在本節中，我們將檢視兩種常見的轉換評估情境。

情境 1：放送廣告技術和第三方評估服務供應商都需要接收 Attribution Reporting API 提供的報表

廣告主希望使用第三方評估服務供應商，將轉換歸因於廣告空間，而代管廣告素材的廣告技術也希望將轉換歸因於廣告空間。這類情況常見於 DSP 或廣告主廣告伺服器 (第三方廣告伺服器 - 3PAS)，因為他們會為廣告素材提供標記、執行歸因報表，並與整合第三方評估或數據分析供應商的廣告主合作。

在這種情況下，廣告技術服務供應商也是在目前設定中負責觸發點擊和曝光事件的一方。放送廣告技術應在適當位置設定新的 attributionsrc，並確保重新導向設定正確無誤。此外，放送廣告技術和第三方評估供應商也應確保已註冊，且伺服器已準備好接收並回應 Attribution Reporting API 要求。

典型的廣告活動設定如下：

  1. 廣告主廣告伺服器 (3PAS) 會將廣告素材的標記提供給 DSP，其中包含第三方評估供應商的曝光和點擊追蹤像素。廣告伺服器應確保廣告素材標記中包含 attributionsrc。

  2. 需求端平台提供額外評估曝光和點擊追蹤像素的功能，並應確保 attributionsrc 包含在他們出價的最終廣告素材標記中。

情境 2：只有第三方評估服務供應商需要接收 Attribution Reporting API 的報表

廣告客戶希望使用第三方評估服務供應商，為廣告空間中的轉換進行歸因，但代管廣告素材的廣告技術沒有歸因評估要求。這類情況常見於代管廣告素材，且不打算自行使用歸因報表的發布商、SSP 或發布商廣告伺服器，但想為 DSP 合作夥伴或評估標記公司 (例如第三方廣告伺服器、評估或分析供應商) 啟用 Attribution Reporting API。

在這種情況下，負責在目前設定中觸發點擊和曝光事件的一方，需要在廣告素材中加入新的 attributionsrc 屬性，並確保重新導向正常運作。這取決於各個發布商的整合方式，但就點擊事件而言，這可能是供應方平台、放送廣告技術或發布商本身。就曝光事件而言，這通常是指第三方評估服務供應商。

在情境 1 的典型廣告活動設定範例中，發布商廣告伺服器、賣方平台或發布商本身可能只需要確保需求端平台提供的 attributionsrc 屬性會顯示在發布商網頁上。

實作詳情

下表概略說明 Attribution Reporting API 的導入步驟：

步驟 工作責任 範例
步驟 1：為現有廣告素材和評估程式碼啟用歸因來源 負責觸發曝光事件或處理點擊事件的實體會新增 attributionsrc 屬性。 對於點擊事件，通常是呈現廣告素材的買家 (DSP/廣告客戶廣告伺服器) 會加入屬性。

曝光事件的屬性是由需求端平台 (DSP)、供應端平台 (SSP)、發布商、廣告伺服器或評估服務供應商新增，具體取決於發布商的設定。

如果影片廣告採用 VAST 格式，則由發布商和影片 SDK 新增屬性。
步驟 2：為第三方來源啟用歸因報表 如果您使用現有的重新導向路徑搭配 302 重新導向，這項功能就能立即使用。

如果無法使用 302 重新導向，您可以使用 attributionsrc 屬性列出多個廣告技術伺服器。

 一般來說，只要將 attributionsrc 屬性新增至廣告素材，第三方重新導向應會收到 Attribution Reporting API 呼叫。
步驟 3：設定 Attribution Reporting API 要求的回應 任何想接收 Attribution Reporting API 報表的實體 廣告客戶使用的 DSP 和第三方評估服務供應商

請注意，每個步驟的具體操作方式取決於發布商網頁上如何算繪及放送廣告素材，以及哪些廣告技術實體會收到歸因報表 API 傳送的報表。

步驟 1：為現有廣告素材和評估代碼啟用歸因來源

在第一步中，系統會啟用歸因來源。

attributionsrc 屬性的運作方式

新的 attributionsrc 屬性會指定 Attribution Reporting API 要求的傳送位置。負責觸發曝光和點擊事件的實體必須使用 attributionsrc 屬性更新廣告素材。attributionsrc 應加入現有的點擊和曝光事件，且可以為空白或非空白。

如果是使用重新導向的點擊事件，請將 attributionsrc 屬性新增至導覽選單。導覽後的任何 302 重新導向都不需要新增 attributionsrc 屬性，只要初始導覽已新增 attributionsrc，就符合 ARA 資格。

如果 attributionsrc 為空白，系統會將 ARA 要求傳送至錨點標記 href 屬性中定義的網址 (到達網址)。定義 attributionsrc 屬性後，系統會將 ARA 要求傳送至 attributionsrc 屬性中定義的網址。到達網址也可以用於登錄來源。

一般來說，如果主機代管到達網址的伺服器可以接收並回應 Attribution Reporting API 要求，請使用空白的 attributionsrc 屬性。如要將 Attribution Reporting API 要求傳送至其他伺服器，請自行定義 attributionsrc 網址。

空白 attributionsrc 屬性的範例：

現有設定 使用 ARA 整合
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

如果 attributionsrc 屬性為空白，Attribution Reporting API 要求會傳送至錨點標記的 href 屬性定義的網址。

非空 attributionsrc 屬性的範例：

現有設定 使用 ARA 整合
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

如果 attributionsrc 非空白，Attribution Reporting API 要求會傳送至 attributionsrc 標記定義的網址。到達網址也可以用於登錄來源。

新增 attributionsrc 以記錄點擊和曝光事件

  • 點擊事件：
    • 負責新增 attributionsrc 的實體通常是廣告技術供應商。
    • 含有點擊事件的錨點標記應加入 attributionsrc 屬性。
    • 使用 window.open 的點擊應使用 window.open 呼叫的 windowFeatures 引數，指定歸因來源。
  • 曝光事件：

如要瞭解點擊和曝光事件需要進行哪些修改，請參閱下表：

活動 標記 現有設定 ARA 整合完成後
點擊 HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
曝光 HTML <img> 標記 <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
HTML <script> 標記 <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

在 Protected Audience 競價中啟用歸因來源登錄

如要評估 Protected Audience 競價中的轉換，您可以使用 registerAdBeacon/registerAdMacro 和 setReportEventDataForAutomaticBeacons/reportEvent，而非 attributionsrc，啟用歸因來源註冊功能。

如要回報 Protected Audience 信號，請在報表工作區中使用 registerAdBeacon 函式，在買方勝出報表工作區中使用 registerAdMacro。接著，您可以使用 Fenced Frame Ads Reporting API 的 reportEvent 和 setReportEventDataForAutomaticBeacons 函式，將廣告框內的事件資料新增至已註冊的信標和巨集。這樣一來，Protected Audience 回報工作片段和廣告素材框架事件酬載的信號就能彼此關聯。

如果信標和巨集是由框架中的 reportEvent 呼叫觸發，或是由瀏覽器觸發自動信標，系統就會在要求中加入 Attribution-Reporting-Eligible HTTP 標頭。您可以使用信標的回應來註冊歸因來源。信標要求可能會重新導向，以便進行第三方評估。

如需進一步瞭解，請參閱 Fenced Frame Ad Reporting API 說明中的「支援歸因報表」一節。

啟用 VAST 格式的歸因報表

VAST 是影片廣告廣告空間放送和評估的常見格式，而該標準定義的許多事件應視為潛在的來源事件，可透過 Attribution Reporting API 註冊。歸因報表支援的 VAST 附錄詳細說明這項資訊，簡而言之，所有 <Tracking>、<Impression>、<*ClickThrough> 和 <*ClickTracking> 事件都是潛在歸因來源事件。所有 VAST 導入作業都應提供這些事件的註冊資格涵蓋範圍。

VAST 附加條款為這些元素定義了新的屬性，可設定專門用於歸因註冊的次要網址。當事件包含 attributiontype="DOUBLE_PING" 和 attributionsrc="[URL]" 時，啟用 Attribution Reporting API 後，觸發該事件的程式碼應使用 [URL] 做為 attributionsrc 屬性的值。VAST 附錄中包含各個情境的範例。

為確保涵蓋率達到最高，在觸發事件 ping 時，VAST 實作應讓所有列出的事件預設為可註冊。舉例來說，在觸發 <Impression> 事件網址時，應在用於傳送要求的 <img> 元素 (或擷取呼叫的等效元素) 上使用 (空白) attributionsrc 屬性，以便接收方能透過 Attribution Reporting API 登錄該事件。

步驟 2：為第三方來源啟用歸因報表

如要讓第三方使用 Attribution Reporting API，您可以使用現有的重新導向，或是在 attributionsrc 屬性中新增第三方清單。在多數情況下，每個廣告技術都有各自的獨立曝光追蹤器，因此重新導向功能更適合點擊追蹤器。

處理現有重新導向鏈結中的第三方來源

在典型的廣告點擊後，許多點擊追蹤程式可能會以鏈結形式出現，並在導覽至最終到達網頁時，將 302 重新導向。如果原始點擊目標已標記 attributionsrc，或已在 Protected Audience API 中登錄 registerAdBeacon/registerAdMacro，則重新導向鏈結中的每個要求都符合 Attribution Reporting API 的登錄資格。重新導向鏈中的廣告技術也必須註冊。

請注意，系統不會在重新導向時傳送初始要求的主體。針對目標對象受保護競價，如果 eventData 傳入 reportEvent，且需要將 setReportEventDataForAutomaticBeacons 用於重新導向，則必須明確將其傳遞為重新導向網址的一部分。

在以下範例中，我們會使用廣告放送技術 (serving-adtech.example) 和第三方成效評估服務供應商 (3p-measurement.example) 做為兩個不同的實體，用來產生及接收歸因報表。這個範例中的放送廣告技術可以是 DSP，在發布商網站上算繪廣告素材，並擁有自己的報表產品。第三方評估服務供應商可以是廣告主用於轉換報表的實體。

圖表說明第一方如何註冊來源，然後第三方註冊

在來源註冊期間，會執行下列步驟：

  1. serving-adtech.example 會在廣告素材中設定 attributionsrc 屬性。使用者造訪發布商網頁時，瀏覽器會傳送要求給 serving-adtech.example.
  2. serving-adtech.example 會以 Attribution-Reporting-Register-Source 標頭和 Location 標頭回應。
    1. serving-adtech.example 會使用 Attribution-Reporting-Register-Source 標頭，以中繼資料回應要註冊的來源。
    2. serving-adtech.example 會使用 Location 標頭，加入重新導向至 3p-measurement.example 的連結。請注意，Location 標頭可能已用於現有的點擊追蹤流程，以支援將 302 重新導向至第三方。
  3. 瀏覽器會收到 serving-adtech.example 的回應，並剖析 Attribution-Reporting-Register-Source 標頭。瀏覽器會使用 serving-adtech.example 做為報表來源，儲存來源事件。
  4. 由於這項要求是重新導向，因此瀏覽器也會向 3p-measurement.example 發出新的要求。
  5. 3p-measurement.example 會傳回包含 Attribution-Reporting-Register-Source 標頭的回應。
  6. 瀏覽器會從 3p-measurement.example 接收這項回應，並讀取 Attribution-Reporting-Register-Source。瀏覽器會使用 3p-measurement.example 做為報表來源，儲存來源事件。

針對不在重新導向鏈結中的第三方來源使用 attributionsrc

如果有多個回報來源想要在導覽事件中登錄來源，但因故無法顯示在重新導向鏈結中，您可以改為在 attributionsrc 中將多個網站列為歸因來源。

現有設定 含 ARA 修訂內容
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

在本例中，符合 Attribution Reporting API 要求的請求會同時傳送至 REPORTING_URL_1 和 REPORTING_URL_2。傳送至到達網址的導覽要求也可以登錄歸因來源。

步驟 3：設定 Attribution Reporting API 要求的回應

對於所有收到 Attribution Reporting API 要求的原始來源，請確保伺服器會傳回適當的 Attribution-Reporting-Register-Source 標頭。請參閱「註冊來源」指南和說明，瞭解如何建構回應。

註冊多個觸發事件

您可以在轉換端新增多個像素元素 (每個觸發事件一個)，藉此登錄多個歸因觸發事件。attributionsrc 元素是觸發登錄的選用元素。

您也可以使用重新導向要求，或在 attributionsrc 元素中列出多個網址，以與來源登錄相同的方式，從單一像素元素登錄多個觸發事件。系統會比對由相同來源產生的來源事件和觸發事件。