預訂歸因概覽
關於贊助內容廣告轉化的報告
由於廣告主會利用贊助型廣告來提升曝光率並促進預訂,因此針對由贊助型廣告驅動或影 響的轉換進行報告,對於闡明其廣告支出的價值至關重要。該數值是由廣告被瀏覽或點擊後所產生的預訂所決定的。我們針對 impression-driven 與 click-driven 的歸因分析,採用 last-touch, 的 7 天歸因方法。
若要與 Rapid Lodging 的「贊助式廣告」API 整合,您必須將歸因於贊助式廣告點擊的轉換資訊傳送給我們——即使點擊後預訂的房價並非 Expedia Group 上的房價。無論預訂前的最後一次點擊是來自贊助廣告還是自然搜尋結果,都應提供預訂資訊。
有兩種方式可將轉換資訊回報給我們:
- 資料潔淨室(首選)
- 預訂通知 API 端點
資料潔淨室
資料潔淨室 (DCR) 提供了一個保險箱環境,讓使用者能在不暴露原始 user-level 資料的情況下,分析共享資料集的效能。此解決方案還能減輕貴組織開發團隊的負擔,因為無需再建置和維護「哪些預訂資訊應傳送至 Expedia Group,哪些則不應傳送」的邏輯。
我們採用 Amazon Web Services (AWS) 的客房解決方案來進行資料傳輸。
AWS 身分與存取管理政策範例
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CleanRoomsCollaborationAccess",
"Effect": "Allow",
"Action": [
"cleanrooms:ListCollaborations",
"cleanrooms:GetCollaboration",
"cleanrooms:GetConfiguredTable",
"cleanrooms:ListConfiguredTables",
"cleanrooms:CreateMembership",
"cleanrooms:GetMembership",
"cleanrooms:ListMemberships",
"cleanrooms:StartAnalysis",
"cleanrooms:GetAnalysisTemplate",
"cleanrooms:ListAnalysisTemplates",
"cleanrooms:GetSchema",
"cleanrooms:ListSchemas"
],
"Resource": "*"
},
{
"Sid": "AllowReadAccessToGlueDataCatalog",
"Effect": "Allow",
"Action": [
"glue:GetDatabase",
"glue:GetDatabases",
"glue:GetTable",
"glue:GetTables",
"glue:GetPartition",
"glue:GetPartitions"
],
"Resource": [
"arn:aws:glue:REGION:YOUR_AWS_ACCOUNT_ID:catalog",
"arn:aws:glue:REGION:YOUR_AWS_ACCOUNT_ID:database/YOUR_DATABASE_NAME",
"arn:aws:glue:REGION:YOUR_AWS_ACCOUNT_ID:table/YOUR_DATABASE_NAME/YOUR_TABLE_NAME"
]
},
{
"Sid": "AllowReadAccessToS3Data",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectAcl",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::YOUR_BUCKET_NAME",
"arn:aws:s3:::YOUR_BUCKET_NAME/YOUR_PREFIX/*"
]
}
]
}客房正確使用檢查清單
在將資料推送至一個空的客房之前,您應確認其中已包含以下資訊:
- 您的 AWS 帳戶資訊
- 已設定的身分與存取管理角色及權限
- 所有旅宿識別碼均已對應至 Expedia Group's 旅宿識別碼。
- 已編製並登錄的 Glue 表格,這些表格定義了用於精確解讀的資料結構
- 合作邀請函
- 已驗證的模式
- 客戶編號
- 經過加密 (雜湊處理) 的個人可識別資訊 (PII),通常為電子郵件地址
轉換資料
廣告主所需的数据包含多項參數,用以報告贊助預訂的價值。
| 欄位 | 必填 | 說明 | 範例值 |
|---|---|---|---|
booking_date_time | 是 | 預訂的日期與時間,採用 UTC 時區格式。 | 2024-12-25T12:30:00Z |
customer_id | 是 | 該使用者的唯一識別碼 (用於與該使用者產生的其他廣告互動事件進行關聯)。這是由發佈商設定並在從所有廣告請求到預訂的整個過程中始終如一地提供的識別碼。 | e4dda90a-f31b-47f2-be4f-7e7289d224fa |
property_id | 是 | Expedia Group 旅宿此預訂的編號。僅接受 Expedia Group 旅宿的帳號。 | 8906878 |
number_of_room_nights | 是 | 預訂的總住宿天數,不論房間數目為何。舉例來說,若旅客預訂了 2 間房,入住 3 晚,則客房的「晚數」值將為 3。 | 3 |
number_of_rooms | — | 已預訂的房間總數。 | 2 |
gross_booking_amount | 是 | 旅客實際支付的最終價格。 | 200.00 |
currency | 是 | gross_booking_amount所使用的貨幣。 | GBP |
customer_email_hash | — | # 客戶電子郵件的 SHA-256 加密。可用於建立「cross-site」連 結 (介於 Expedia Group 與指定發佈者之間),以實現更穩健的成效歸因。該值可以為空。 | — |
預訂通知 API 端點
若您選擇不使用 DCR,或不符合使用 DCR 與 Expedia Group, 通報預訂歸因的資格,則可改用我們的「預訂通知」端點。
端點詳細資料
與 DCR 類似,預訂通知 API 會回報與先前瀏覽或於贊助列表上觸發的點擊信標相關聯的預訂資料。您將在預訂流程結束時,定期向此 API 傳送歸因資訊。我們建議每日進行,但若在贊助式廣告的瀏覽或點擊發生後 8 天內進行,亦屬可接受範圍。
僅在預訂確認成功時,才向「預訂通知 API」發送請求。
事件經過
對於「預訂 通知」端點的結果而言,順序至關重要。向「住宿贊助廣告 API」發出請求時,請勿變更以下列出的事件順序。
- 當旅客在您的網站上進行搜尋時,系統會發出兩項請求:一項是向「住宿贊助列表 API」查詢空房狀況,另一項則是向「住宿購物空房狀況」端點查詢 Expedia Group 的空房狀況與房價。這裡的順序無關緊要,但必須先呼叫這兩項,才能繼續進行。
- 「住宿贊助廣告」API 會針對贊助廣告進行拍賣。
- 若庫存充足,回應中將顯示贊助 結果。該回應中亦將包含點擊、瀏覽及渲染信標。
>> 進一步了解追蹤機制 4. 贊助式廣告會依照從 Expedia Group. 您可以選擇在贊助式列表中顯示「Expedia Group」的價格,或是顯示來自其他來源的價格。 5. 一旦瀏覽器在頁面中渲染出廣告,渲染信標 (若使用) 便會立即觸發。 6. 當贊助式列表進入檢視區時,檢視信標即會被觸發。 7. 當旅客點擊搜尋結果頁面上顯示的贊助廣告時,點擊信標便會被觸發。 8. 在預訂完成並確認後,請向「預訂通知」端點發出請求。若其後取消預訂,則無需採取任何行動。
序列流程圖

API 詳細資料
請瀏覽本頁面的端點,然後使用測試軟體,以了解範例和架構定義與實際輸出結果之間的差異。
注意: 您的發射管理員會提供您在呼叫此端點時,需包含於標頭中的具體參數。若未包含這些參數,您的呼叫將會被拒絕。