啟用轉換評估

轉換歸因評估可涉及多方，包括發布商、廣告客戶、廣告放送技術 (放送廣告的實體)、評估服務供應商等。本文說明常見的轉換評估情境，但在一般情況下，凡是想透過 Attribution Reporting API (ARA) 接收歸因報表的任一方，都必須按照本文件所述的整合步驟操作。

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

此外，廣告客戶也可能與第三方轉換評估服務供應商，執行跨聯播網歸因及其他報表功能。廣告客戶會利用這項資料瞭解多個不重複發布商和管道的廣告投資報酬率，因此請需求端平台或廣告伺服器瞭解如何啟用 Attribution Reporting API 來支援這些用途。廣告主想採用第三方評估服務，可以透過第三方評估服務供應商或設定內部伺服器，透過 API 登錄及接收報表。

Attribution Reporting API 可讓多項廣告技術登錄同一次曝光或轉換的歸因來源和觸發事件，並透過 API 接收個別報表。舉例來說，需求端平台可以從 Attribution Reporting API 取得自己的歸因報表，並為廣告主的第三方評估服務供應商另外提供報表。廣告技術必須同時登錄歸因來源和觸發事件，才能接收 API 報表，而系統則會依據廣告技術向 API 個別登錄的歸因來源和觸發事件完成歸因作業。

常見的轉換評估情境

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

情境 1：廣告放送技術和第三方評估服務供應商，都必須接收來自 Attribution Reporting API 的報表

廣告主希望透過第三方評估服務供應商，將廣告空間的轉換歸因，且代管廣告素材的廣告技術會想將廣告空間的轉換歸因。如果需求端平台或廣告客戶廣告伺服器 (第三方廣告伺服器，即 3PAS) 提供廣告素材標記、自行執行歸因報表，或是與整合第三方評估服務或分析服務供應商的廣告客戶合作，就常會發生這種情況。

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

一般廣告活動設定看起來像這樣：

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

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

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

廣告主想透過第三方評估服務供應商將轉換歸因於廣告空間，但代管廣告素材的廣告技術沒有歸因評估規定。如果發布商、賣方平台或發布商廣告伺服器代管廣告素材，但不打算自行使用歸因報表，但想為其需求端平台合作夥伴或評估標記公司 (例如第三方廣告伺服器、評估或分析服務供應商) 啟用 Attribution Reporting API，就會相當常見。

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

在情境 1 的一般廣告活動設定範例中，發布商廣告伺服器、賣方平台或發布商本身可能只需要確認需求端平台提供的 attributionsrc 屬性，即可將該屬性新增到發布商頁面上。

實作詳情

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

步驟	工作的責任	示例
步驟 1：為現有廣告素材和評估程式碼啟用歸因來源	負責觸發曝光事件或處理點擊事件的實體會加入 attributionsrc 屬性。	如果是點擊事件，顯示廣告素材的買方 (DSP/廣告客戶廣告伺服器) 通常會加入屬性。 如果是曝光事件、需求端平台 (DSP)、供應端平台 (SSP)、發布商、廣告伺服器或評估服務供應商，系統就會根據發布商的設定加入該屬性。 如果是使用 VAST 格式的影片廣告，發布商和影片 SDK 會新增這個屬性。
步驟 2：為第三方來源啟用 Attribution Reporting	方法是搭配 302 重新導向使用現有的重新導向路徑。 如果無法使用 302 重新導向，attributionsrc 屬性可用於列出多個廣告技術伺服器。	一般來說，只要在廣告素材中加入 attributionsrc 屬性，第三方重新導向應該就會收到 Attribution Reporting API 呼叫。
步驟 3：設定 Attribution Reporting API 要求的回應	想接收 Attribution Reporting API 報表的實體	廣告客戶使用的需求端平台和第三方評估服務供應商

請注意，每個步驟的具體情況取決於廣告素材在發布商網頁上的顯示及放送方式，以及哪些廣告技術實體會收到由 Attribution Reporting API 傳送的報表。

重要事項： 第三方評估服務供應商必須註冊，且其伺服器已準備就緒，可接收及回應 Attribution Reporting 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 屬性所定義的網址。

非空白歸因 src 屬性範例：

現有設定	整合 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 引數指定歸因來源。
• 曝光事件：
  • 負責新增 attributionsrc 的實體通常是廣告放送技術和評估服務供應商。
  • 透過 <img> 代碼或 <script> 代碼觸發的曝光事件應包含 attributionsrc 屬性。
  • 使用 Fetch API 的曝光事件應在傳遞至擷取 API 呼叫的 options 引數中加入 attributionReporting 物件。

請參閱下表摘要，瞭解點擊和曝光事件所需的修改內容：

活動	標記	現有設定	整合 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 Ads Reporting API 同時支援 iframe 和圍欄頁框

詳情請參閱 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

如要允許第三方使用 Attribution Reporting API，您可以使用現有的重新導向，或是在 attributionsrc 屬性中新增第三方清單。在大多數情況下，每項廣告技術都有專屬的曝光追蹤程式，因此重新導向與點擊追蹤程式的關聯性更高。

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

在一般廣告點閱中，許多點擊追蹤程式可能當做 302 重新導向的鏈結，隨著使用者前往最終到達網頁而進行瀏覽。如果原始點擊目標已加上 attributionsrc 註解或在 Protected Audience API 中註冊 registerAdBeacon/registerAdMacro，則重新導向鏈結中的每項要求都符合透過 Attribution Reporting API 登錄的資格。您也必須註冊重新導向鏈結中的廣告技術。

請注意，初始要求的主體不會在重新導向時傳送。在 Protected Audience 競價中，如果傳遞至 reportEvent 和 setReportEventDataForAutomaticBeacons 的 eventData 需做為重新導向的一部分使用，則必須在重新導向網址中明確傳遞。

在以下範例中，我們將使用廣告放送技術 (serving-adtech.example) 和第三方評估服務供應商 (3p-measurement.example) 做為兩個不同的實體，以便產生及接收歸因報表。本例中的廣告放送技術可以是需求端平台，可在發布商網站上顯示廣告素材，且擁有自身的報表產品。第三方評估服務供應商可以是廣告客戶用來製作轉換報表的實體，

來源登錄時，系統會執行下列步驟：

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。傳送到到達網址的導覽要求也可以登錄歸因來源。

警告： 這些要求只會在支援 Attribution Reporting API 的瀏覽器上傳送，且在不支援的環境中可能會遺失。

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

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

登錄多個觸發條件

您可以在轉換端新增多個像素元素 (每個觸發條件一個)，藉此登錄多個歸因觸發條件。觸發事件登錄作業時，不一定要使用 attributionsrc 元素。

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