登錄歸因觸發條件

瞭解如何登錄歸因觸發條件以便計算轉換。

歸因觸發條件是告知瀏覽器要擷取轉換的事件。

請按照本文件中的步驟登錄觸發事件，以便瀏覽器登錄轉換並歸因給相關來源事件 (即廣告曝光或廣告點擊)。

註冊方式

如要登錄觸發條件，請使用 HTML 元素或 JavaScript 呼叫：

  • <img> 標記
  • <script> 標記
  • fetch 通話
  • XMLHttpRequest

這會產生網路要求，讓您透過觸發事件登錄 HTTP 回應標頭來回應。

登錄觸發條件以歸因轉換

登錄觸發條件的方式與以下類似： 登錄歸因來源事件。完整步驟會在後續章節中說明。摘要如下：

  1. 開始登錄觸發條件。使用像素或 fetch() 呼叫 要求。

  2. 透過回應觸發事件，完成觸發條件登錄 註冊標頭。

    收到像素請求後，系統會傳送 一般 src 屬性中定義的端點，或定義的端點 但如果您在 attributionsrc 中設定了使用 attributionsrc 值 - 回應標頭 Attribution-Reporting-Register-Trigger。

    在這個標頭中，指定您想顯示在這個標頭中的觸發事件資料 。任何回應都可以設定這個標頭。只要直播 如果要求來自符合 destination 的網站， 將會比對來源收到標頭後， 瀏覽器會尋找相符的來源並排定報表。

    事件層級報表範例：

    {
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}

    摘要報表範例：

    {
  ... // existing fields, such as "event_trigger_data"

  "aggregatable_trigger_data": [
   {
     "key_piece": "0x400",
     "source_keys": ["campaignCounts"]
   },
   {
     "key_piece": "0xA80",
     "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
   }
  ],
  "aggregatable_values": {
    "campaignCounts": 32768,
    "geoValue": 1664
  }
}
，瞭解如何調查及移除這項存取權。

處理子網域

如果 destination 為 https://advertiser.example，則兩者的轉換都是 https://advertiser.example 及其子網域 (例如 https://shop.advertiser.example)。

如果 destination 為 https://shop.advertiser.example，則https://advertiser.example和 https://shop.advertiser.example 可歸因。

必要和選用屬性

當您使用 HTML 元素或發出 JavaScript 呼叫來登錄觸發條件時， 可能需要使用 attributionsrc 或 attributionReporting。請參閱下表，進一步瞭解這些頁面 這通常代表交易 不會十分要求關聯語意

如果 attributionsrc 為「選用」，使用時表示這項要求符合歸因報表的資格。如果您使用 attributionsrc，瀏覽器會將 Attribution-Reporting-Eligible 標頭。也非常適合用於應用程式至網頁 測量：如果 attributionsrc 存在，瀏覽器會將 Attribution-Reporting-Support 標頭。

註冊方式 觸發條件
<a> 標記 不適用：錨點無法登錄觸發條件。
<img> 標記 attributionsrc 為選用項目。標題 則足以登錄觸發條件。
<script> 標記 attributionsrc 為選用項目。標題 則足以登錄觸發條件。
fetch 通話 attributionReporting 選項是 必要。
XMLHttpRequest attributionReporting 選項是 必要。
window.open() 不適用： window.open 無法登錄觸發條件。

步驟 1：開始登錄觸發事件

您可以使用像素 (<img> 代碼) 或指令碼代碼登錄觸發條件。

使用新的或現有的轉換像素

下例會新增 attributionsrc 屬性，觸發現有圖片的歸因作業。

attributionsrc 的來源必須與執行來源登錄作業的來源相符。

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

下一個範例新增了一個轉換像素 attributionsrc 屬性，藉此觸發歸因。

src 的來源必須與執行來源登錄作業的來源相符。

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

使用指令碼標記

您可以使用指令碼標記登錄觸發條件；運作方式與 <img> 相同以下程式碼範例說明如何使用 fetch() 和 XMLHttpRequest() (XHR)。

以下程式碼可有效利用 attributionsrc 模擬 HTML 要求的行為：

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();

attributionsrc (無論是否包含值)

您可以新增 attributionsrc，不論是否要包含值。

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

如果設定 attributionsrc 的值，這可以是一或多個以空格分隔的網址。

使用網址會導致瀏覽器發出獨立的保持運作擷取要求，一次 ，包括 Attribution-Reporting-Eligible 要求 標題。

如果您想藉由回應 與元素主要要求之外的要求

舉例來說，如果您在圖片元素上登錄觸發條件， 您可能實際上無法控制圖片回應在這個例子中 這種設定可讓您傳送觸發事件登錄標頭做為要求的回應 這些內容和映像檔，您也可以完全掌控變更者： 指定 attributionsrc 的明確值，就等於指示 以便提出額外要求並設定其目的地

步驟 2：使用標頭回覆

收到瀏覽器要求後，請回覆並加進回應的 Attribution-Reporting-Register-Trigger 標頭：

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

後續步驟

瞭解如何登錄歸因來源。