「住宿贊助廣告」入門指南
設定您的部署時需要了解的事項
在您實施「住宿贊助列表 API」的過程中，我們的整合與上線管理團隊將與貴方團隊密切合作。在緊密合作的情況下，實施時間通常預估為 8 週，其中包含 2 週的 end-to-end 測試時間。
實施步驟
要實作「住宿贊助廣告」API，請依照以下步驟操作：
- 透過 Expedia Group B2B 閘道，與「住宿贊助列表」API 進行整合。
- 設定廣告信標追蹤。
>> 瞭解廣告追蹤 3. 請實施預訂歸因功能，以便將轉換資訊回傳給我們。
>> 了解預訂歸因相關資訊 4. 決定要在搜尋結果的哪個位置顯示贊助廣告，並設計您的標章。注意： 請勿變更「住宿贊助列表」回應中廣告的排序。
>> 查看使用者介面要求相關資訊 5. 在將程式上線前，請先測試您的實作。
每次進行符合資格的搜尋時，您將向我們傳送一份預先選定的 Expedia Group 旅宿 ID 清單。請善用這個機會，來控制哪些房源符合在您的網站上刊登贊助廣告的資格。
從高層次來看，以下是旅客端發生的事件順序，以及貴系統將執行的操作：
API 整合
步驟 1：使用搜尋上下文資料向「住宿贊助列表」API 發出呼叫
註： 此呼叫與您可能進行的比價查詢完全無關，且可在查詢費率與空房狀況之前、期間或之後進行。
- 請照常彙總並排序可用性結果。
- 請確保客戶 ID 在所有請求中均能保持不變。
關於客戶 ID 的說明： 投資點擊的廣告主期望能清楚了解其廣告支出所創造的價值。對於「住宿贊助廣告」，此數值是以廣告曝光或點擊所產生的預訂量來衡量。但是，當住宿庫存來自多個管道時，我們無法提供完整的預訂歸因數據，因此我們要求所有廣告請求中都必須包含一個恆定的客戶識別碼。該識別碼必須在整個廣告追蹤過程中予以保留，並包含在預訂歸因資訊中，以便我們能準確地將廣告互動與隨後的預訂建立關聯。
步驟 2：在可用性結果中找出對應的旅宿
為了獲得最大的廣告覆蓋率與最佳的變現效果，您務必將您的旅宿 ID 與 Expedia 的旅宿 ID 進行對應，即使是那些您未透過 Expedia 進行預訂的住宿設施也不例外。這兩組屬性之間不太可能存在完全的對應關係，因為並非所有屬性都參與贊助廣告計畫。
- 請將廣告投放回應中回傳的 Expedia 旅宿識別碼，與您的房源空房狀況結果進行比對。
- 將旅宿的商品列表內容與贊助商品列表合併。Lodging 贊助式列表 API 傳回的結果僅包含旅宿這個 ID 及廣告內容，不含其他內容。
步驟 3：將贊助廣告穿插於庫存搜尋結果中 (可選)
贊助式 房源可顯示在搜尋結果的頂端，或分散在自然搜尋結果之中。對於清單的排列位置並無特定要求，只要維持順序即可。
- 選擇您希望如何顯示贊助式廣告。
- 請確保贊助連結的顯示順序不會被更改。
雖然廣告排名和廣告位置都與廣告的展示位置有關，但兩者並非同一回事。
- 廣告排名 () 決定廣告在競價結束後的排名。獲勝的廣告將獲得第 1 名，其次為第 2 名，依此類推，依序排列至第 25 名 (即返回的廣告最大數量)。
- 另一方面，廣告位置 () 則指廣告在頁面上的實際位置，通常從 1 (最上方) 開始依序編號。在分頁顯示的結果中，項目編號會跨頁連續編排。舉例來說，若每頁顯示 10 則旅宿刊登資訊，並在每頁的第 1 位與第 10 位放置廣告，則第 2 頁的第一則廣告應被分配至第 11 位。為了確保測量和報告的準確性，務必在所有追蹤信標中包含廣告位置資訊。
|
OpenAPI Ads 的定義
openapi: 3.0.1
info:
title: Ad Delivery API
version: v1
description: Retrieves ads.
contact:
name: 'Media Solutions'
email: 'MediaSolutionsAPI1@expedia.com'
url: 'https://test.developers.expediagroup.com/docs/'
tags:
- name: Ad Delivery
description: API to retrieve ads
servers:
- url: https://test.ean.com/v1
- url: https://api.ean.com/v1
paths:
/ads:
post:
tags:
- Ad Delivery
description: Returns relevant ads.
operationId: getAds
parameters:
- name: Accept
in: header
description: Specifies the response format that the client would like to receive back. This must be application/json
required: true
schema:
type: string
example: 'application/json'
- name: Authorization
in: header
description: EAN token, format is <pre>EAN APIKey=<APIKey>,Signature=<Encoded Signature>,timestamp=<timestamp></pre>
required: true
schema:
type: string
- name: Accept-Encoding
in: header
description: Specifies the response encoding that the client would like to receive back. This must be gzip.
required: true
schema:
type: string
example: 'gzip'
- name: User-Agent
in: header
description: The User-Agent header string from the customer's request, as captured by your integration.
required: true
schema:
type: string
example: 'Mozilla/5.0 (Linux; Android 13; SM-S901B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Mobile Safari/537.36'
- name: Customer-Ip
in: header
description: IP address of the customer, as captured by your integration.
Ensure your integration passes the customer's IP, not your own. Used for fraud recovery and other important analytics.
required: false
schema:
type: string
example: '192.168.123.132'
- name: Customer-Session-Id
in: header
description: Insert your own unique value for each user session, beginning with the first API call.
Continue to pass the same value for each subsequent API call during the user's session, using a new value for every new customer session.
required: false
schema:
type: string
example: '7f9a24ea-2145-4819-a7b7-2a4cbe1165ab'
- name: Customer-Id
in: header
description: An obfuscated unique identifier for each customer. This should not contain any personal information such as email, first or last name.
required: true
schema:
type: string
example: '7f9a24ea-2145-4819-a7b7-2a4cbe1165ab'
- name: Test
in: header
description: Ads calls have a test header that can be used to return set responses with the following keywords:<br>
* `standard`
* `service_unavailable`
* `unknown_internal_error`
schema:
type: string
enum:
- standard
- service_unavailable
- unknown_internal_error
- name: billing_terms
in: query
description: This parameter is to specify the terms of how a resulting booking should be billed. If this field is
needed, the value for this will be provided to you separately.
schema:
type: string
- name: partner_point_of_sale
in: query
description: This parameter is to specify what point of sale is being used to shop and book. If this field is needed,
the value for this will be provided to you separately.
schema:
type: string
- name: payment_terms
in: query
description: This parameter is to specify what terms should be used when being paid for a resulting booking. If this
field is needed, the value for this will be provided to you separately.
schema:
type: string
- name: platform_name
in: query
description: This parameter is to specify what platform is being used to shop and book. If this field is needed, the
value for this will be provided to you separately.
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AdsRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AdsResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'invalid_input'
message: 'An invalid request was sent in, please check the nested errors for details.'
errors:
- type: 'language.required'
message: 'A language is required. Supported languages are:
[ar-SA, cs-CZ, da-DK, de-DE, el-GR, en-US, es-ES, es-MX, fi-FI, fr-CA, fr-FR, hr-HR, hu-HU, id-ID,
is-IS, it-IT, ja-JP, lt-LT, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ru-RU, sk-SK, sv-SE,
th-TH, tr-TR, uk-UA, vi-VN, zh-CN, zh-TW]'
fields:
- name: 'language'
type: 'request'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'request_unauthenticated'
message: 'Data required to authenticate your request is missing or inaccurate.
Ensure that your request follows the guidelines in our documentation.'
fields:
- name: 'apikey'
type: 'header'
value: 'jaj3982k239dka328e'
- name: 'signature'
type: 'header'
value: '129d75332614a5bdbe0c7eb540e95a65f9d85a5b53dabb38d19b37fad6312a2bd25c12ee5a82831d55112087e1b'
- name: 'timestamp'
type: 'header'
value: '198284729'
- name: 'servertimestamp'
type: 'server'
value: '198284729'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'request_unauthorized'
message: 'Your request could not be authorized.'
'426':
description: Upgrade Required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'upgrade_required'
message: 'This service requires the use of TLS.'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'too_many_requests'
message: 'You have reached your capacity for this type of request.'
'500':
description: Unknown Internal Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'unknown_internal_error'
message: 'An internal server error has occurred.'
'503':
description: Service Unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
type: 'service_unavailable'
message: 'This service is currently unavailable.'
components:
schemas:
PageType:
type: string
enum:
- other
- search_results
- details
- confirmation
example: 'search_results'
description: The type of page the ads will be rendered on.
SortType:
type: string
enum:
- default
example: default
description: The sort type selected for the organic results.
ProductLine:
type: string
enum:
- car
- flight
- lodging
example: lodging
description: The different types of travel product lines a traveler can search for.
SalesChannel:
type: string
enum:
- website
- mobile_app
- mobile_web
example: 'mobile_app'
description: The sales channel for the request.
GuestCounts:
type: object
required:
- adult_count
properties:
adult_count:
type: integer
format: int32
example: 2
child_count:
type: integer
format: int32
example: 1
AdsRequest:
type: object
required:
- sales_channel
- language
- country_code
- page_type
- search_product_lines
- checkin
- checkout
- occupancies
- property_ids
properties:
country_code:
type: string
example: 'US'
pattern: '^[A-Z]{2}$'
description: "The country code of the traveler's point of sale, in ISO 3166-1 alpha-2 format.
This should represent the country where the shopping transaction is taking place.
For more information see: https://www.iso.org/obp/ui/#search/code/"
language:
type: string
example: 'en-US'
pattern: '^[a-z]{2}-[A-Z]{2}$'
description: 'Desired language for the response as a subset of BCP47 format that only uses hyphenated pairs of two-digit language and country codes.
Use only ISO 639-1 alpha-2 language codes and ISO 3166-1 alpha-2 country codes.
See https://www.w3.org/International/articles/language-tags/
Language Options: https://developers.expediagroup.com/docs/rapid/resources/reference/language-options'
sales_channel:
$ref: '#/components/schemas/SalesChannel'
page_type:
$ref: '#/components/schemas/PageType'
sort_type:
$ref: '#/components/schemas/SortType'
search_product_lines:
example: [ 'lodging', 'flight' ]
description: The product lines the traveler is searching for. lodging indicates hotel_standalone. lodging and
flight would indicate a lodging_package.
type: array
items:
$ref: '#/components/schemas/ProductLine'
checkin:
type: string
description: Check-in date, in ISO 8601 format (YYYY-MM-DD).
pattern: '^\d{4}-\d{2}-\d{2}$'
example: '2025-01-01'
checkout:
type: string
description: Check-out date, in ISO 8601 format (YYYY-MM-DD).
pattern: '^\d{4}-\d{2}-\d{2}$'
example: '2025-01-05'
occupancies:
type: array
items:
$ref: '#/components/schemas/GuestCounts'
description: Each array item represents guests of one room.
focused_property_id:
type: string
description: The property id the ranking of ads should be based on. Examples of a focused property are a
customer searching for a specific property and it being pinned to the top of a page or the property
recommendation carousel based on the currently or previously viewed property. The focused_property_id itself
will be excluded from the ranking.
example: '23433'
property_ids:
type: array
items:
type: string
example: [ '2717582', '16159546', '2025453' ]
description: The list of property ids eligible for returning sponsored listings. These are the potential
candidates that could be included in the auction. The maximum number of property_ids that can be sent in a
request is 700.
experiment_ids:
description: A list of experiment ids that can be used for testing different behavior. The ids can be associated
with different tests ran by the publisher and are completely arbitrary. The experiment ids will
be included reports back to the publisher.
type: array
items:
type: string
example: [ '324324.1', '2423423.3', '3242343.5' ]
additionalProperties: false
Image:
type: object
properties:
caption:
type: string
description: The image caption.
example: 'Hotel Lobby'
link:
type: object
additionalProperties:
$ref: '#/components/schemas/Link'
description: The url to retrieve the image.
example:
"70px":
method: GET
href: https://i.travelapi.com/hotels/1000000/20000/15300/15237/bef1b976_t.jpg
description: An individual image.
Creative:
type: object
properties:
image:
$ref: '#/components/schemas/Image'
description: The image to be rendered for the sponsored listing.
additionalProperties: false
Link:
type: object
properties:
method:
type: string
description: The request method used to access the link.
example: 'POST'
href:
type: string
description: The URL for the link. This can be absolute or relative. Placeholders will be need to be populated by the client.
example: 'https://advertising.expedia.com/sponsoredcontent/v1/View?position=[position]&data=AAAAAQAAAAEAAA'
expires:
type: string
description: If the link expires, this will be the UTC date the link will expire, in ISO 8601 format.
example: '2025-07-10 15:00:00.000'
description: An individual link.
Beacons:
type: object
required:
- view
- render
- click
properties:
view:
$ref: '#/components/schemas/Link'
render:
$ref: '#/components/schemas/Link'
click:
$ref: '#/components/schemas/Link'
SponsoredListing:
description: The sponsored listing which advertises a specific property.
type: object
required:
- rank
- property_id
- beacons
properties:
rank:
type: integer
pattern: int32
minimum: 0
example: 1
description: The sponsored listing should adhere to the rank and not be re-ranked. This field is 0-based.
property_id:
type: string
example: '13243534'
creative:
$ref: '#/components/schemas/Creative'
beacons:
$ref: '#/components/schemas/Beacons'
ad_transparency_url:
type: string
example: 'https://advertising.expedia.com/sponsoredcontent/dsa/id=123'
description: The url used to retrieve digital services act information regarding why the ad was selected.
additionalProperties: false
AdsResponse:
type: object
properties:
sponsored_listings:
type: array
items:
$ref: '#/components/schemas/SponsoredListing'
additionalProperties: false
Error:
type: object
properties:
type:
type: string
description: The error type.
message:
type: string
description: A human readable message giving details about this error.
fields:
type: array
description: Details about the specific fields that had an error.
items:
$ref: '#/components/schemas/Field'
errors:
type: array
description: An array of all the actual errors that occured.
items:
$ref: '#/components/schemas/ErrorIndividual'
description: The overall class of error that occured.
Field:
type: object
properties:
name:
type: string
description: The field that had an error.
type:
type: string
description: The type of the field that had an error.
value:
type: string
description: The value of the field that had an error.
description: An individual field that had an error.
ErrorIndividual:
type: object
properties:
type:
type: string
description: The error type.
message:
type: string
description: A human readable message giving details about this error.
fields:
type: array
description: Details about the specific fields that had an error.
items:
$ref: '#/components/schemas/Field'
description: An individual error.廣告請求與回應範例
範例請求
{
"checkin": "2026-01-01",
"checkout": "2026-01-05",
"country_code": "US",
"focused_property_id": null,
"language": "en-US",
"occupancies": [
{
"adult_count": 1,
"child_count": 0
}
],
"page_type": "search_results",
"property_ids": [
"2717582", "16159546", "2025453"
],
"sales_channel": "website",
"search_product_lines": [
"LODGING"
],
"experiment_ids": [
"{324324.1", "2423423.3", "3242343.5}"
]
}範例回應
{
"sponsored_listings": [
{
"rank": 1,
"property_id": "2717582",
"creative": {
"image": {
"caption": "",
"link": {
"default": {
"method": "GET",
"href": ""
}
}
}
},
"beacons": {
"view": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Impr?position=[position]&data=AAAAAQAAAAEAAAAQ2euB7ETb213laXnCHsDH8DfYinPDz967XfOY-Kkvai1sjhK0ma4rVkll-c7ePLtjxB9phtWOHSCAQBUFNc1AzF1dgcjFrttWAhNfcrsUlt-yiyoLv2wiSiibmqHIiuH_udjDrJYZULFx0xq4dTuy-yn0IyYkCByZqBxdnOaE-m1V48fkxnrVKZiD1zcxbowZ6OcxbyFyO_AOeMX3Zfv5B2dadosYonJ3sGROdFsmPvDaJobBef5O007ppzBV-ghMU0t56fMjIKqkUinHs75jxi7aSB2Om_ORtxwQ5MhSN3UTFzaJAO9fdQc9h4GzgXToxtIb7vySpesR929s4q87tD5inQS186D5e2N9KJufVId1trxfoFKt6Ct0T_MnkxRJSWRLa_iGeE1pnrCU_MTYCLxTRK5oojKqQjjEeqOdKII3V75wp-EPzNo9sSpsVpxKGfcSLqtaHES5KhN_-RItF8GsO_H-qNGii8OA9IejcZnZlGEtPuekusMtGH8GZMqqRU4oxQ04w1vRLlgwyhGuALp_bvHRfRQrsp--StMXdM72EzhmC2cDZCRp5Mk0XQHm9p9ixuJgyT7zxkwqng_mNpev6NkM7a0TLZqdBQtsTHXlOtF_3kMyHWhGCQuPhgBNOMAJODnt8ncPtYYgu5RQ9SAvVFdh0bSwV13uhDgV6-vy02l0h0exvfoT0zzWZOoOIics8PmA8npACRhrDvcXbMeHpsAVyoElFjD4mM0MjUhq0NJejn0tTBnYVlKREHz3Cn-uQ-PDMNn-k2TZ-U9JhF36h3Kye15ZQsYKqtlta9FUeVR7ee2ozxu9HDykskzqCpCCwDrb0aHuQ1QonEhgshfYr9HDHTcMMKvXSk7IjSYpcaEqlOAB2sRevEi8sah8A0MIcvU66bke9MiotlPwZ14I3Dgy8T_sA6_EklnSvTQlpCtUpefpG6hTxEEPhW1ZYS_LWiKE98eUe2o6S_NtWUQaqQZD20C_IkKawqgRR7LS4CiQfqScDRv0bzJLN7XoRRV0o5-dFoCJfCrCRx7DRa7mYVfWrn62x7IAPUlaYePHnRrr9c9vvvTtZ7i7Dr4lh_vyrbsqIlkY2XJSLu6NTdhh2NuSLsR1dkYItXZuM8yvSiekelYB-63GsAs5LTVKnxfpECNaP1GaSaoXLoVAQKWbe9hpktV1g4zgBCW3wlA4e2QVT1depR0Jd-nxcnFTZFMkJjOXFy-AyXsbKL4HCXJ6HlbVCYTktOuyrF933Q3ybQxUpB3DUZd9RqfmFP26vG-j5iNkdWZt3WurI83pjg=="
},
"render": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Render?position=[position]&data=AAAAAQAAAAEAAAAQ2euB7ETb213laXnCHsDH8DfYinPDz967XfOY-Kkvai1sjhK0ma4rVkll-c7ePLtjxB9phtWOHSCAQBUFNc1AzF1dgcjFrttWAhNfcrsUlt-yiyoLv2wiSiibmqHIiuH_udjDrJYZULFx0xq4dTuy-yn0IyYkCByZqBxdnOaE-m1V48fkxnrVKZiD1zcxbowZ6OcxbyFyO_AOeMX3Zfv5B2dadosYonJ3sGROdFsmPvDaJobBef5O007ppzBV-ghMU0t56fMjIKqkUinHs75jxi7aSB2Om_ORtxwQ5MhSN3UTFzaJAO9fdQc9h4GzgXToxtIb7vySpesR929s4q87tD5inQS186D5e2N9KJufVId1trxfoFKt6Ct0T_MnkxRJSWRLa_iGeE1pnrCU_MTYCLxTRK5oojKqQjjEeqOdKII3V75wp-EPzNo9sSpsVpxKGfcSLqtaHES5KhN_-RItF8GsO_H-qNGii8OA9IejcZnZlGEtPuekusMtGH8GZMqqRU4oxQ04w1vRLlgwyhGuALp_bvHRfRQrsp--StMXdM72EzhmC2cDZCRp5Mk0XQHm9p9ixuJgyT7zxkwqng_mNpev6NkM7a0TLZqdBQtsTHXlOtF_3kMyHWhGCQuPhgBNOMAJODnt8ncPtYYgu5RQ9SAvVFdh0bSwV13uhDgV6-vy02l0h0exvfoT0zzWZOoOIics8PmA8npACRhrDvcXbMeHpsAVyoElFjD4mM0MjUhq0NJejn0tTBnYVlKREHz3Cn-uQ-PDMNn-k2TZ-U9JhF36h3Kye15ZQsYKqtlta9FUeVR7ee2ozxu9HDykskzqCpCCwDrb0aHuQ1QonEhgshfYr9HDHTcMMKvXSk7IjSYpcaEqlOAB2sRevEi8sah8A0MIcvU66bke9MiotlPwZ14I3Dgy8T_sA6_EklnSvTQlpCtUpefpG6hTxEEPhW1ZYS_LWiKE98eUe2o6S_NtWUQaqQZD20C_IkKawqgRR7LS4CiQfqScDRv0bzJLN7XoRRV0o5-dFoCJfCrCRx7DRa7mYVfWrn62x7IAPUlaYePHnRrr9c9vvvTtZ7i7Dr4lh_vyrbsqIlkY2XJSLu6NTdhh2NuSLsR1dkYItXZuM8yvSiekelYB-63GsAs5LTVKnxfpECNaP1GaSaoXLoVAQKWbe9hpktV1g4zgBCW3wlA4e2QVT1depR0Jd-nxcnFTZFMkJjOXFy-AyXsbKL4HCXJ6HlbVCYTktOuyrF933Q3ybQxUpB3DUZd9RqfmFP26vG-j5iNkdWZt3WurI83pjg=="
},
"click": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Cl?position=[position]&data=AAAAAQAAAAEAAAAQ2euB7ETb213laXnCHsDH8DfYinPDz967XfOY-Kkvai1sjhK0ma4rVkll-c7ePLtjxB9phtWOHSCAQBUFNc1AzF1dgcjFrttWAhNfcrsUlt-yiyoLv2wiSiibmqHIiuH_udjDrJYZULFx0xq4dTuy-yn0IyYkCByZqBxdnOaE-m1V48fkxnrVKZiD1zcxbowZ6OcxbyFyO_AOeMX3Zfv5B2dadosYonJ3sGROdFsmPvDaJobBef5O007ppzBV-ghMU0t56fMjIKqkUinHs75jxi7aSB2Om_ORtxwQ5MhSN3UTFzaJAO9fdQc9h4GzgXToxtIb7vySpesR929s4q87tD5inQS186D5e2N9KJufVId1trxfoFKt6Ct0T_MnkxRJSWRLa_iGeE1pnrCU_MTYCLxTRK5oojKqQjjEeqOdKII3V75wp-EPzNo9sSpsVpxKGfcSLqtaHES5KhN_-RItF8GsO_H-qNGii8OA9IejcZnZlGEtPuekusMtGH8GZMqqRU4oxQ04w1vRLlgwyhGuALp_bvHRfRQrsp--StMXdM72EzhmC2cDZCRp5Mk0XQHm9p9ixuJgyT7zxkwqng_mNpev6NkM7a0TLZqdBQtsTHXlOtF_3kMyHWhGCQuPhgBNOMAJODnt8ncPtYYgu5RQ9SAvVFdh0bSwV13uhDgV6-vy02l0h0exvfoT0zzWZOoOIics8PmA8npACRhrDvcXbMeHpsAVyoElFjD4mM0MjUhq0NJejn0tTBnYVlKREHz3Cn-uQ-PDMNn-k2TZ-U9JhF36h3Kye15ZQsYKqtlta9FUeVR7ee2ozxu9HDykskzqCpCCwDrb0aHuQ1QonEhgshfYr9HDHTcMMKvXSk7IjSYpcaEqlOAB2sRevEi8sah8A0MIcvU66bke9MiotlPwZ14I3Dgy8T_sA6_EklnSvTQlpCtUpefpG6hTxEEPhW1ZYS_LWiKE98eUe2o6S_NtWUQaqQZD20C_IkKawqgRR7LS4CiQfqScDRv0bzJLN7XoRRV0o5-dFoCJfCrCRx7DRa7mYVfWrn62x7IAPUlaYePHnRrr9c9vvvTtZ7i7Dr4lh_vyrbsqIlkY2XJSLu6NTdhh2NuSLsR1dkYItXZuM8yvSiekelYB-63GsAs5LTVKnxfpECNaP1GaSaoXLoVAQKWbe9hpktV1g4zgBCW3wlA4e2QVT1depR0Jd-nxcnFTZFMkJjOXFy-AyXsbKL4HCXJ6HlbVCYTktOuyrF933Q3ybQxUpB3DUZd9RqfmFP26vG-j5iNkdWZt3WurI83pjg=="
}
},
"ad_transparency_url": "https://www.expedia.com/sponsoredcontent/v2/ad-transparencies/ad_transparency_id=fbafb4d1-595f-4e30-984d-4f6c0c1a2d55"
},
{
"rank": 2,
"property_id": "2025453",
"creative": {
"image": {
"caption": "",
"link": {
"default": {
"method": "GET",
"href": "https://a.travel-assets.com/media/meso_cm/PAPI/Images/hotels/3000000/2030000/2025500/2025453/58aa28d9_b.jpg"
}
}
}
},
"beacons": {
"view": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Impr?position=[position]&data=AAAAAQAAAAEAAAAQI5YM4uOmx5g2PXWgfKiYQsb8LKHHt-Qc3YN1Fm__-04dNL97pv1wj-FmV1vYI87OrsX9b0_8U3GgtVjgspVW11Jdhx-SZbG47alX1zV7jihfFCBKGKDqh6dh3ydxvfVBCSRIciK0Hw43xnstq0ArvnkhxyqXV3BwVsrkhXDJDiyUcB0q_Jitlu4LknpR0JqojkwIgOo6sGTeIVmqN8bbidUQTkekQ7K7aJ0sMd5xBVZF7lo_e-dr9in46BllcwYWBmFM2Nna6xKN_xfIZc36UbLEkY5CERjHOwIg3_jjqIM9jro4R6ta1xh3POQexDdxyTFYrh8xc9toxrQCi4_LZoQDCtTa5UIMG3EhznGn4jTFyiHCQnMzKAX6SlRnw05tIrmeRyVcI4v1hVBJdTZj3X2hFlEHI33AXUH8K2x9jiwnjrSUQpLct_9gd4HuD0b4EdYTLO0xRiRygTjOil5T__LySUs0iFGAHybe5KfqQZkOmtOh6hYMMzP8pWSZuy93zvRbKhjqg7tUh4vVA4SOlwg02tGTCu34-TSOhppgJmGRTYNh-JNpxFy_gaur_w4YnMNFgwxXv1JU4H-sqqxZhTjgVGV_RgsUG_nnqmJoSOBJix8ju7_yYU9CLS-3XlMaEKXzeXo1yHM1rICeoMTo381qMfP8N-uKRYs0KuXCp-ywda-yNQ5vXBZ-BG88nM2os4OtEgHaTjXa1zQN7iBhGK1SVk-s0dYsdg9SXRGyweun9hNSTgGQjH6vSewuW0NagzQsFbbXf4AiYn6rc1iBBgudE-UWKg8vg1FqghpxawRjNvkj_CsOBVsXGZgGLyg9wV9PFuRBiagRdPaHJ-ar19cD9GvnEEJiZ_SJTTYDU2J0EUoVyJyPIw9QpSMPDu4h2XkklvhSH-xmJ9fkbKSzLb-CeAzsN77OznctwYwGrMKBYSQachKFuuES0dtlIqOEBnmGQMFK1HO427hUOrQ700kAhSIKPR7T8KPgcU04PT4mbvTPnelPJ1Uuq-jt1fvUCsx1Dq_dLtiqB2hQxCHIrUyJzrwm50sH355KkS8QfbBUjX1MLZLoGY8gQpvAbGHN4zMqLV4uXBY2fJMVaxsaPzQwktfiP1TgHDnDFCjGrN7KwxHCHqi0bNdHyC6WZnTVXjJD-uq0cYgJQ04sHRsIzewqizMFLhauRjBo2V00KAt00dhWV0L8PA6kAVvtoymPQEb-8kze9jHDjkXZ2oDUGp8vs3KajmInsZ1YwV9aFd7pBKLRsAts2ucH_3rpcHlOCfp9YFFegP_7FPNGbf0aoA=="
},
"render": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Render?position=[position]&data=AAAAAQAAAAEAAAAQI5YM4uOmx5g2PXWgfKiYQsb8LKHHt-Qc3YN1Fm__-04dNL97pv1wj-FmV1vYI87OrsX9b0_8U3GgtVjgspVW11Jdhx-SZbG47alX1zV7jihfFCBKGKDqh6dh3ydxvfVBCSRIciK0Hw43xnstq0ArvnkhxyqXV3BwVsrkhXDJDiyUcB0q_Jitlu4LknpR0JqojkwIgOo6sGTeIVmqN8bbidUQTkekQ7K7aJ0sMd5xBVZF7lo_e-dr9in46BllcwYWBmFM2Nna6xKN_xfIZc36UbLEkY5CERjHOwIg3_jjqIM9jro4R6ta1xh3POQexDdxyTFYrh8xc9toxrQCi4_LZoQDCtTa5UIMG3EhznGn4jTFyiHCQnMzKAX6SlRnw05tIrmeRyVcI4v1hVBJdTZj3X2hFlEHI33AXUH8K2x9jiwnjrSUQpLct_9gd4HuD0b4EdYTLO0xRiRygTjOil5T__LySUs0iFGAHybe5KfqQZkOmtOh6hYMMzP8pWSZuy93zvRbKhjqg7tUh4vVA4SOlwg02tGTCu34-TSOhppgJmGRTYNh-JNpxFy_gaur_w4YnMNFgwxXv1JU4H-sqqxZhTjgVGV_RgsUG_nnqmJoSOBJix8ju7_yYU9CLS-3XlMaEKXzeXo1yHM1rICeoMTo381qMfP8N-uKRYs0KuXCp-ywda-yNQ5vXBZ-BG88nM2os4OtEgHaTjXa1zQN7iBhGK1SVk-s0dYsdg9SXRGyweun9hNSTgGQjH6vSewuW0NagzQsFbbXf4AiYn6rc1iBBgudE-UWKg8vg1FqghpxawRjNvkj_CsOBVsXGZgGLyg9wV9PFuRBiagRdPaHJ-ar19cD9GvnEEJiZ_SJTTYDU2J0EUoVyJyPIw9QpSMPDu4h2XkklvhSH-xmJ9fkbKSzLb-CeAzsN77OznctwYwGrMKBYSQachKFuuES0dtlIqOEBnmGQMFK1HO427hUOrQ700kAhSIKPR7T8KPgcU04PT4mbvTPnelPJ1Uuq-jt1fvUCsx1Dq_dLtiqB2hQxCHIrUyJzrwm50sH355KkS8QfbBUjX1MLZLoGY8gQpvAbGHN4zMqLV4uXBY2fJMVaxsaPzQwktfiP1TgHDnDFCjGrN7KwxHCHqi0bNdHyC6WZnTVXjJD-uq0cYgJQ04sHRsIzewqizMFLhauRjBo2V00KAt00dhWV0L8PA6kAVvtoymPQEb-8kze9jHDjkXZ2oDUGp8vs3KajmInsZ1YwV9aFd7pBKLRsAts2ucH_3rpcHlOCfp9YFFegP_7FPNGbf0aoA=="
},
"click": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Cl?position=[position]&data=AAAAAQAAAAEAAAAQI5YM4uOmx5g2PXWgfKiYQsb8LKHHt-Qc3YN1Fm__-04dNL97pv1wj-FmV1vYI87OrsX9b0_8U3GgtVjgspVW11Jdhx-SZbG47alX1zV7jihfFCBKGKDqh6dh3ydxvfVBCSRIciK0Hw43xnstq0ArvnkhxyqXV3BwVsrkhXDJDiyUcB0q_Jitlu4LknpR0JqojkwIgOo6sGTeIVmqN8bbidUQTkekQ7K7aJ0sMd5xBVZF7lo_e-dr9in46BllcwYWBmFM2Nna6xKN_xfIZc36UbLEkY5CERjHOwIg3_jjqIM9jro4R6ta1xh3POQexDdxyTFYrh8xc9toxrQCi4_LZoQDCtTa5UIMG3EhznGn4jTFyiHCQnMzKAX6SlRnw05tIrmeRyVcI4v1hVBJdTZj3X2hFlEHI33AXUH8K2x9jiwnjrSUQpLct_9gd4HuD0b4EdYTLO0xRiRygTjOil5T__LySUs0iFGAHybe5KfqQZkOmtOh6hYMMzP8pWSZuy93zvRbKhjqg7tUh4vVA4SOlwg02tGTCu34-TSOhppgJmGRTYNh-JNpxFy_gaur_w4YnMNFgwxXv1JU4H-sqqxZhTjgVGV_RgsUG_nnqmJoSOBJix8ju7_yYU9CLS-3XlMaEKXzeXo1yHM1rICeoMTo381qMfP8N-uKRYs0KuXCp-ywda-yNQ5vXBZ-BG88nM2os4OtEgHaTjXa1zQN7iBhGK1SVk-s0dYsdg9SXRGyweun9hNSTgGQjH6vSewuW0NagzQsFbbXf4AiYn6rc1iBBgudE-UWKg8vg1FqghpxawRjNvkj_CsOBVsXGZgGLyg9wV9PFuRBiagRdPaHJ-ar19cD9GvnEEJiZ_SJTTYDU2J0EUoVyJyPIw9QpSMPDu4h2XkklvhSH-xmJ9fkbKSzLb-CeAzsN77OznctwYwGrMKBYSQachKFuuES0dtlIqOEBnmGQMFK1HO427hUOrQ700kAhSIKPR7T8KPgcU04PT4mbvTPnelPJ1Uuq-jt1fvUCsx1Dq_dLtiqB2hQxCHIrUyJzrwm50sH355KkS8QfbBUjX1MLZLoGY8gQpvAbGHN4zMqLV4uXBY2fJMVaxsaPzQwktfiP1TgHDnDFCjGrN7KwxHCHqi0bNdHyC6WZnTVXjJD-uq0cYgJQ04sHRsIzewqizMFLhauRjBo2V00KAt00dhWV0L8PA6kAVvtoymPQEb-8kze9jHDjkXZ2oDUGp8vs3KajmInsZ1YwV9aFd7pBKLRsAts2ucH_3rpcHlOCfp9YFFegP_7FPNGbf0aoA=="
}
},
"ad_transparency_url": "https://www.expedia.com/sponsoredcontent/v2/ad-transparencies/ad_transparency_id=16d9da19-df5b-4db4-9d10-5f6d291d6257"
},
{
"rank": 3,
"property_id": "16159546",
"creative": {
"image": {
"caption": "",
"link": {
"default": {
"method": "GET",
"href": "https://ewe-assets-staging.s3.amazonaws.com/media/meso_cm/PAPI/Images/hotels/17000000/16160000/16159600/16159546/4ea1058e_b.jpg"
}
}
}
},
"beacons": {
"view": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Impr?position=[position]&data=AAAAAQAAAAEAAAAQPurrXQjwFJKRRtQk2A_VBq3AdiMU75TvYNRcccr4JkL6G-YaMlzv642R2o5J1xB7smzDpjTTdoy8IRypNYqj1yYmhEoPCEYVhVRmT8Tn_vM4aInUquiBEKy88X6lgjuG5Rb26z6tRjNHpon9ODXmLk8YlK4OubiN7h0gNK0B-FamwZxN38dDrEu_A7MsXxc9HuAqkda6qGRokII42P3e_X8MSVbxaKE6Q_3_z7g4hnOo3CR_l60BiPTFaQG2dOD6m9vQEbewmquH_EWvF-JDJoyBKx2z438b53V-Ee7KJXB7sX3hIGtUoQbqGd58oaTbiJn75xcFVeFlBAmAYgzieaNWDCQ4SD2cxPMaxUCmZkDx723y_wcfDkKv8sFA14cO5O7OyZbFzn0dyDv4nneiIMczsA87z-d5y5Buol40T_YPWRrw4cm7emcK55Fhn6jV3LVWCcxYyUjTJSo8sIe2IoS0I74NXTGG_YjUCoP3FyarPWbxBFEcv3uY_gFZG10w0HAJ3CxEFRdB692Zm7joDbAVHqMIi5w6ClDRcTsXcz0g0PP-n6qKa_Gby0f_GD9AbN7YVeizmyPxyjruYmR11pWf9jlE-VsTmetf5KjsIay66VyhdVPfTb0ZbIEEZLvje7QWCfYnQfqZhOh4Gpw69fM4WtnrbkZRWMC2xwW4FpBoUXs3q1fWVG1SPry3F4I27C_mENx5C4sh3vrP-oD766ROyR1GGZ39zuapGjM5zPgtuP5ay6R6L5kAznPPk8N62LMAy_JHBOfnmTpvkf-sOZ-0QMb_chi5wp_yuJ5jHBrmNEPNkKZXtrtFBvPRTlBJHALF8zcvPaZpWy-PBxPcFc7STKQi9bW49E9CyZyfLAx1jy-FrP9l-arOn0G7-2hfUKesJLPds2CyvroCMCpcA2w0VFkKlBhEPmR1rPJeUb-O-biULdpilmkzW_5Bu3IJQdoGJ7xlbfbLZ1pMOkJNhnNis3Zld369VpJ6a0J6uCktDovYzsxi4m7Bkas_SYplkOoHtvg-WwG7uCJjhbsVNmMBeILiCI5wnv8hztoSkrSiqptFd_vlYygTxCJKATlKLiaWEMcMkhZ6-zAsbyduci2JCt802AvrMeuxZWb78811LBeRcUb2uxAVTqoUUHvsGEKU1FhKs3GQBDe321Noq6ZpMF0ihWEyfT4cdv7JuZZHIaVXtjKn-ktr8P44MfGfmucaaDsN9NJXPy5ts-j0Doi62vjtZgwtJ8FWH-qBB8SH42jY0iWUXzUV1teo0Om2xMdK7jH-DIHGGjz_85as_A=="
},
"render": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Render?position=[position]&data=AAAAAQAAAAEAAAAQPurrXQjwFJKRRtQk2A_VBq3AdiMU75TvYNRcccr4JkL6G-YaMlzv642R2o5J1xB7smzDpjTTdoy8IRypNYqj1yYmhEoPCEYVhVRmT8Tn_vM4aInUquiBEKy88X6lgjuG5Rb26z6tRjNHpon9ODXmLk8YlK4OubiN7h0gNK0B-FamwZxN38dDrEu_A7MsXxc9HuAqkda6qGRokII42P3e_X8MSVbxaKE6Q_3_z7g4hnOo3CR_l60BiPTFaQG2dOD6m9vQEbewmquH_EWvF-JDJoyBKx2z438b53V-Ee7KJXB7sX3hIGtUoQbqGd58oaTbiJn75xcFVeFlBAmAYgzieaNWDCQ4SD2cxPMaxUCmZkDx723y_wcfDkKv8sFA14cO5O7OyZbFzn0dyDv4nneiIMczsA87z-d5y5Buol40T_YPWRrw4cm7emcK55Fhn6jV3LVWCcxYyUjTJSo8sIe2IoS0I74NXTGG_YjUCoP3FyarPWbxBFEcv3uY_gFZG10w0HAJ3CxEFRdB692Zm7joDbAVHqMIi5w6ClDRcTsXcz0g0PP-n6qKa_Gby0f_GD9AbN7YVeizmyPxyjruYmR11pWf9jlE-VsTmetf5KjsIay66VyhdVPfTb0ZbIEEZLvje7QWCfYnQfqZhOh4Gpw69fM4WtnrbkZRWMC2xwW4FpBoUXs3q1fWVG1SPry3F4I27C_mENx5C4sh3vrP-oD766ROyR1GGZ39zuapGjM5zPgtuP5ay6R6L5kAznPPk8N62LMAy_JHBOfnmTpvkf-sOZ-0QMb_chi5wp_yuJ5jHBrmNEPNkKZXtrtFBvPRTlBJHALF8zcvPaZpWy-PBxPcFc7STKQi9bW49E9CyZyfLAx1jy-FrP9l-arOn0G7-2hfUKesJLPds2CyvroCMCpc100 14796 100 14281 100 515 11770 424 0:00:01 0:00:01 --:--:-- 12228oGJ7xlbfbLZ1pMOkJNhnNis3Zld369VpJ6a0J6uCktDovYzsxi4m7Bkas_SYplkOoHtvg-WwG7uCJjhbsVNmMBeILiCI5wnv8hztoSkrSiqptFd_vlYygTxCJKATlKLiaWEMcMkhZ6-zAsbyduci2JCt802AvrMeuxZWb78811LBeRcUb2uxAVTqoUUHvsGEKU1FhKs3GQBDe321Noq6ZpMF0ihWEyfT4cdv7JuZZHIaVXtjKn-ktr8P44MfGfmucaaDsN9NJXPy5ts-j0Doi62vjtZgwtJ8FWH-qBB8SH42jY0iWUXzUV1teo0Om2xMdK7jH-DIHGGjz_85as_A=="
},
"click": {
"method": "GET",
"href": "https://www.expedia.com/sponsoredcontent/v1/Cl?position=[position]&data=AAAAAQAAAAEAAAAQPurrXQjwFJKRRtQk2A_VBq3AdiMU75TvYNRcccr4JkL6G-YaMlzv642R2o5J1xB7smzDpjTTdoy8IRypNYqj1yYmhEoPCEYVhVRmT8Tn_vM4aInUquiBEKy88X6lgjuG5Rb26z6tRjNHpon9ODXmLk8YlK4OubiN7h0gNK0B-FamwZxN38dDrEu_A7MsXxc9HuAqkda6qGRokII42P3e_X8MSVbxaKE6Q_3_z7g4hnOo3CR_l60BiPTFaQG2dOD6m9vQEbewmquH_EWvF-JDJoyBKx2z438b53V-Ee7KJXB7sX3hIGtUoQbqGd58oaTbiJn75xcFVeFlBAmAYgzieaNWDCQ4SD2cxPMaxUCmZkDx723y_wcfDkKv8sFA14cO5O7OyZbFzn0dyDv4nneiIMczsA87z-d5y5Buol40T_YPWRrw4cm7emcK55Fhn6jV3LVWCcxYyUjTJSo8sIe2IoS0I74NXTGG_YjUCoP3FyarPWbxBFEcv3uY_gFZG10w0HAJ3CxEFRdB692Zm7joDbAVHqMIi5w6ClDRcTsXcz0g0PP-n6qKa_Gby0f_GD9AbN7YVeizmyPxyjruYmR11pWf9jlE-VsTmetf5KjsIay66VyhdVPfTb0ZbIEEZLvje7QWCfYnQfqZhOh4Gpw69fM4WtnrbkZRWMC2xwW4FpBoUXs3q1fWVG1SPry3F4I27C_mENx5C4sh3vrP-oD766ROyR1GGZ39zuapGjM5zPgtuP5ay6R6L5kAznPPk8N62LMAy_JHBOfnmTpvkf-sOZ-0QMb_chi5wp_yuJ5jHBrmNEPNkKZXtrtFBvPRTlBJHALF8zcvPaZpWy-PBxPcFc7STKQi9bW49E9CyZyfLAx1jy-FrP9l-arOn0G7-2hfUKesJLPds2CyvroCMCpcA2w0VFkKlBhEPmR1rPJeUb-O-biULdpilmkzW_5Bu3IJQdoGJ7xlbfbLZ1pMOkJNhnNis3Zld369VpJ6a0J6uCktDovYzsxi4m7Bkas_SYplkOoHtvg-WwG7uCJjhbsVNmMBeILiCI5wnv8hztoSkrSiqptFd_vlYygTxCJKATlKLiaWEMcMkhZ6-zAsbyduci2JCt802AvrMeuxZWb78811LBeRcUb2uxAVTqoUUHvsGEKU1FhKs3GQBDe321Noq6ZpMF0ihWEyfT4cdv7JuZZHIaVXtjKn-ktr8P44MfGfmucaaDsN9NJXPy5ts-j0Doi62vjtZgwtJ8FWH-qBB8SH42jY0iWUXzUV1teo0Om2xMdK7jH-DIHGGjz_85as_A=="
}
},
"ad_transparency_url": "https://www.expedia.com/sponsoredcontent/v2/ad-transparencies/ad_transparency_id=7ac49eb0-e2f7-4e61-b342-168590f44fa8"
}
]
}重要指引
旅宿識別碼： 呼叫「住宿贊助列表 API」時，僅會識別 Expedia 的旅宿識別碼。任何 non-Expedia 群組 ID 不是會返回零廣告庫存，就是可能會錯誤地匹配到另一個無關的 Expedia Group 旅宿.
旅宿數量限制： 單次請求中最多可包含 700 個旅宿 ID。
旅宿價格與空房狀況：「住宿贊助列表 API」不會預設或檢查空房狀況，因為您可以在搜尋結果中的贊助列表中，選擇顯示 Expedia Group 的價格，或是來自其他來源的價格。這就是為什麼您需要同時向「住宿贊助廣告 API」和「購物庫存狀況 API」發送請求，並將結果合併起來。
批次處理與快取：「住宿贊助廣告」API 不支援批次請求，且 Expedia Group 不建議對贊助廣告庫存進行快取。
每項搜尋都必須進行一次贊助列表拍賣，且無法重複使用，因此每次客戶進行搜尋時，都應發送一次「住宿贊助列表」端點請求。若客戶的搜尋條件有所變更 (例如：旅行日期或客房的數量)，請發送額外請求以確保相關資訊 up-to-date.
雖然您可能已將房價和空房狀況儲存至快取以供自然搜尋使用，但「住宿贊助廣告」API 呼叫仍應以即時方式進行。廣告平台通常會設定每日最高預算，並以即時方式進行支出。如果廣告詳情未能頻繁更新，等到點擊發生時，廣告主可能已經沒有剩餘預算了。這稱為「超支」，即使廣告已顯示且顧客點擊了該廣告，也不會產生任何收益。
排名廣告順序： 您可以選擇在搜尋結果中預留哪些位置給贊助廣告，但無法像處理「購物 API」回應時那樣，re-sort 或套用選取演算法。這是因為 API 中呈現的贊助廣告排序，代表即時競標的結果，各房源會出價特定金額 cost-per-click 來爭取排名。
如果您不希望特定的旅宿出現在贊助列表中，可以在您的「住宿贊助列表 API」請求中排除該旅宿識別碼。
廣告報導： 其他搜尋參數 (例如篩選條件) 會限制符合特定搜尋條件的房源數量。我們建議您在請求中盡可能多地包含房源數量。若在旅客的輸入資料之外再套用任何額外的篩選條件，可能會導致錯失廣告收入的機會。
旅宿主圖： 雖然無須強制使用透過 API 回應傳送的 property-selected 主圖，但我們仍建議您使用。
旅宿贊助廣告與自然搜尋結果中的重複內容： 根據業界標準，出現在贊助廣告中的房源，也應在搜尋結果中以第二個自然搜尋結果的形式出現。各物業業主願意出價更高，以換取在排序結果中獲得更高的曝光率。
舉例來說，您將搜尋結果的第 1 位保留給贊助廣告，而飯店 A 在競標中勝出，並以贊助廣告的身分出現在第 1 位。在您的自然搜尋結果選取與排序中，飯店 A 再次出現在搜尋結果的 第 7 個位置，位於頁面較下方。
在搜尋結果中，贊助廣告直接出現在其對應的自然搜尋結果正上方或正下方的情況相當罕見——僅有 2% 至 3% 的搜尋結果會出現在搜尋結果的最頂端。一旦發生這種情況，其中一個做法是將自然搜尋結果往下推移幾個名次，並將偏移量調整至能維持良好使用者體驗的程度。
「sort」中的贊助式列表範例
由於廣告攔截程式有時會偵測並移除搜尋結果中的贊助廣告，若刪除自然搜尋結果中的重複內容，將導致 high-quality 上的房源無法呈現在旅客面前。
與購物 API 請求的對應關係： 住宿贊助列表 API 旨在與 Rapid Lodging 購物 API 配合使用。API 請求的順序並不重要——「住宿贊助列表 API」與「購物庫存狀況 API」的請求可並行或依序進行。
上線前
在將您的「Lodging 贊助廣告」API 實作上線前的最後一步，是確保您已從測試端點切換至正式運作端點：
- 將廣告投放 API 從
https://test.ean.com/v1/ads變更為https://api.ean.com/v1/ads. - 若已使用預訂通知端點，請將其從
https://test.ean.com/v1/ads/booking-notification變更為https://api.ean.com/v1/ads/booking-notification.