住宿赞助列表入门指南
设置实施方案所需了解的内容
我们的集成和发布管理团队将与您的团队紧密合作，帮助您实施住宿赞助列表 API。通过密切合作，实施通常预计需要 8 周，其中包括 2 周的 end-to-end 测试。
实施步骤
要实现住宿赞助列表 API，您需要按照以下步骤操作：
- 通过 Expedia Group B2B 网关与住宿赞助列表 API 集成。
- 设置广告信标跟踪。
>> 了解广告跟踪 3. 实施预订归因，以便向我们提供转化信息。
>> 了解预订归因 4. 决定在搜索结果中的哪些位置显示赞助商广告，并设计您的徽章。**注意：**请勿更改住宿赞助列表响应中广告的排名顺序。
>>查看有关用户界面要求的信息 5. 在正式上线之前，请先测试您的实现。
每次符合条件的搜索，您都会向我们发送一个预先选定的 Expedia Group 房产 ID 列表。利用这个机会来控制哪些房产可以出现在您网站上的赞助列表中。
从总体上看，以下是旅客端发生的事件顺序，以及您的系统将要执行的操作：
API 集成
步骤 1：使用搜索上下文数据向住宿赞助列表 API 发送调用
**注意：**此通话与您可能进行的比价通话没有任何关联，可以在获取费率和可用性之前、期间或之后进行。
- 像往常一样汇总并排序可用性结果。
- 确保客户 ID 在所有请求中保持一致。
客户 ID 说明： 投资点击广告的广告商希望清楚地了解他们的支出所产生的价值。对于住宿赞助列表，此价值是通过广告展示或点击带来的预订量来衡量的。但是，当住宿库存来自多个渠道时，我们无法提供全面的预订归因数据，因此我们需要在所有广告请求中提供持久的客户 ID。在整个广告跟踪过程中必须保留该 ID，并将其包含在预订归因信息中，以便我们能够准确地将广告互动与最终预订联系起来。
步骤 2：在可用性结果中查找关联的属性
为了获得最大的广告覆盖率和最佳的盈利能力，即使您没有通过 Expedia 购买房产，也必须将您的房产 ID 映射到 Expedia 房产 ID。这两组房产之间不太可能存在完全的映射关系，因为并非所有房产都参与了赞助房源计划。
- 将广告投放响应中返回的 Expedia 属性 ID 与您的可用性结果进行比较。
- 将房源信息与赞助商广告合并。住宿赞助列表 API 的结果仅返回房源 ID 和广告内容，不返回其他内容。
步骤 3：将赞助商广告穿插到房源搜索结果中（可选）
赞助商提供的房源信息可以显示在搜索结果的顶部，也可以分散显示在自然搜索结果中。只要保持秩序，对商品列表的放置位置没有要求。
- 选择您希望如何显示赞助商广告。
- 请确保赞助商广告的显示顺序不变。
虽然广告排名和广告位置都与广告的展示位置有关，但它们并不是同一回事。
- **广告排名决定了广告在竞价后的排名。**获胜的广告排名第 1，次高的广告排名第 2，依此类推，直到排名第 25（返回的广告的最大数量）。
- 另一方面，广告位置指的是广告在页面上的实际位置，通常从 1（顶部）向下编号。在分页结果中，排名会按顺序跨页延续。例如，如果您每页显示 10 个房源列表，并在每页的第 1 位和第 10 位放置广告，则第 2 页上的第一个广告应分配到第 11 位。为了确保准确的衡量和报告，务必在所有跟踪信标中包含广告位置信息。
|
OpenAPI 广告定义
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"
}
]
}重要指南
房源 ID： 调用住宿赞助列表 API 时，仅识别 Expedia 房源 ID。任何 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 请求中排除该房源 ID。
**广告覆盖 范围：**其他搜索参数（例如筛选条件）可以限制符合特定搜索条件的房源数量。我们建议您在请求中包含尽可能多的房产信息。在旅行者输入信息之外应用任何其他筛选条件都可能导致错失广告收入机会。
**房产主图：**使用通过 API 响应发送的 property-selected 主图并非强制性要求，但我们建议您这样做。
**付费推广和自然搜索结果中房源重复：**行业惯例是，在付费推广列表中出现的房源也应该出现在搜索结果的第二个自然搜索结果中。为了在排序中获得更高的曝光率，房产经纪人愿意出价更高。
例如，您将搜索结果的第 1 位预留给赞助商列表，而 A 酒店赢得了竞标，并以赞助商列表的形式出现在第 1 位。在您的自然搜索结果选择和排序中，A 酒店第二次出现在搜索结果中，位于页面下方的第 7 位。
赞助广告很少会出现在搜索结果中与其对应的自然搜索结果的正上方或正下方——这种情况只发生在 2% 到 3% 的搜索结果顶部。如果发生这种情况，一种方法是将自然搜索结果向下移动几个位置，调整偏移量，使其保持在良好的用户体验水平。
赞助商列表示例
由于广告拦截器有时会检测并从搜索结果中删除赞助列表，因此删除自然重复内容意味着 high-quality 房源不会向旅行者展示。
**与购物 API 请求的一致性：**住宿赞助列表 API 旨在与快速住宿购物 API 配合使用。API 请求顺序无关紧要——住宿赞助列表 API 和购物可用性 API 请求可以并行或顺序发出。
直播前
在正式上线住宿赞助列表 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。