為贊助式廣告設定追蹤功能

利用信標傳輸精確的互動資訊，並計算營收

為了向廣告主回報成效，必須掌握贊助列表何時被瀏覽與點擊，以及該廣告點擊何時促成轉化——無論該轉化是來自 Expedia Group 的轉化率，還是來自其他廣告庫存來源的轉化率。「住宿贊助廣告」API 會使用信標來實現此追蹤功能及廣告成效報告。

追蹤信標是一組加密資訊，可讓我們的系統正確擷取廣告互動事件、將您的預訂歸因於相應的廣告主，並處理來自您網站的廣告收益。

追蹤信標的詳細資訊

追蹤信標將由我們的配送 API 產生，並以 URL 的形式附加於每個回應中。追蹤信標將與每個贊助列表關聯獨特的資訊，因此無法重複使用，且必須在適當的時機觸發。

注意： 所有信標都包含一個用於實際位置的佔位符，其順序需在信標觸發時由您填入。

部分指標是我們進行報告所必需的，而其他指標則有助於您制定自身策略 decision-making.

點擊信標

顧名思義，點擊信標會在使用者點擊贊助廣告時觸發。它們是贊助式廣告中至關重要的一部分，因為它們正是為您創造收益的機制。

實施點擊信標時的最佳實務：

• 請僅將其設定在商品列表卡片中，能引導使用者開啟旅宿詳情頁面的部分
• 右鍵點擊應僅在住宿卡中的 non-image 元素上觸發點擊信標

渲染並檢視信標

乍看之下，「渲染」和「檢視」似乎是同一個資料點，但兩者觸發的時間卻不盡相同。渲染信標會在廣告一經渲染至頁面時立即觸發，但檢視信標僅會在廣告至少 50% 的像素於瀏覽器視窗中連續顯示 1 秒時才會觸發。

舉例來說，請考慮以下情境：

您的網站會收到一份包含 10 項房產的清單，並將其納入頁面搜尋結果中。當頁面載入時，瀏覽器會渲染所有 10 張旅宿卡片，無論它們是否實際位於檢視區內。搜尋結果的版面配置使得只有位於頁面頂端的 2 項會實際顯示給使用者。如果所有物體都裝有信標，則所有 10 個渲染信標都會被觸發，但只有 2 個檢視信標會被觸發。當使用者向下捲動，且其餘的旅宿卡片逐漸顯示出來時，剩餘的檢視信標便會被觸發。

將「瀏覽信標」與「渲染信標」結合使用，將能揭示更細緻的數據，並可用於作為決定贊助式列表定位的依據。我們建議您同時實作「瀏覽」和「渲染」信標，儘管採用「住宿贊助列表 API」僅需「瀏覽」和「點擊」信標即可。

無論是檢視型還是渲染型信標，都會在 URL 中使用 ``position 參數，該參數應填入贊助式列表在整體搜尋結果中的序號。頁面的編號通常從 1 開始 (即頁面頂端的第 1 張旅宿卡片)，並依序向下編號。在分頁結果中，項目順序會跨頁連續顯示——編號不會在每頁重新開始。

資料去重

追蹤信標事件會根據拍賣 ID 和旅宿 ID 進行去重。例如，若針對某個經過篩選的搜尋未提交新的廣告請求，則不會產生新的拍賣 ID。若在「預設排序」與「篩選搜尋」中皆顯示並點擊了相同的旅宿，您僅會因其中 1 次點擊獲得收益。

機器人偵測

除非偵測到機器人流量並加以抑制，否則可能會產生諸如瀏覽次數和點擊次數等欺詐性廣告事件。由於這些並非有效的事件，且不應向廣告主收取相關費用，因此應將其識別並過濾掉。

我們仰賴您的協助，以防止廣告顯示給已知的機器人，並避免因機器人活動而觸發廣告追蹤事件。突如其來的攻擊可能產生數百萬美元的詐騙廣告收入，這筆款項最終必須退還給廣告主。

為避免詐騙流量，我們已建立防護機制，當未滿足特定條件時，系統會自動拒絕相關事件。

「住宿贊助列表 API」的機器人偵測安全指引：

• 在推送通話時，請將客戶的真實 IP 位址傳送給我們。若來自同一 IP 位址的事件在一小時內超過預設數量，該等事件將被拒絕。
  註： 這是使用客戶 IP 的唯一方式，且嚴格的資料存取政策可確保客戶的 IP 資料不會被濫用。
• 請確保已正確設定 user-agent 及 origin HTTP 標頭。若值不正確或缺失，可能會導致被我們的機器人過濾器拒收，或引發 cross-origin 的資源共用 (CORS) 問題。
• 在正式上線之前，您必須向我們提供一份將顯示贊助廣告的所有網域清單。如有需要，您可以使用萬用字元。任何來自未識別網域所觸發的事件，都將被自動拒絕。