「Lodging」のスポンサー掲載の始め方
導入を設定するために知っておくべきこと
Lodging Sponsored Listings APIの導入にあたっては、当社の統合およびローンチ管理チームが、貴社のチームと緊密に連携して対応いたします。緊密な連携のもと、実装には通常8週間を要すると見込まれており、これにはend-to-endによるテストに要する2週間が含まれています。
実施手順
Lodging Sponsored Listings APIを実装するには、以下の手順に従ってください：
- Expedia GroupのB2Bゲートウェイを通じて、Lodging Sponsored Listings APIと連携してください。
- 広告ビーコンのトラッキン グを設定します。
>> 広告トラッキングについて詳しくはこちら 3. 予約アトリビューションを導入し、コンバージョン情報を弊社へフィードバックしてください。
>> 予約アトリビューションについて詳しくはこちら 4. 検索結果のどの位置にスポンサー掲載を表示するかを決め、バッジをデザインしてください。注：「宿泊施設スポンサー掲載」のレスポンス内で、広告の順位を変更しないでください。
>> UI要件に関する情報はこちらをご覧ください 5. 本番環境に公開する前に、実装内容をテストしてください。
対象となる検索が行われるたびに、事前に選択されたExpedia Group施設IDのリストを弊社へお送りいただきます。この機会を活用して、ご自身のサイト上でスポンサー掲載の対象となる物件を管理してください。
大まかに言えば、旅行者側で発生する一連の流れと、御社のシステムが実行する処理は以下の通りです：
API 統合
手順1：検索コンテキストデータを使用して、Lodging Sponsored Listings APIにリクエストを送信します
注： この呼び出しは、お客様が行う可能性のある料金比較のための呼び出しとは一切関係がなく、料金や空室状況の取得前、取得中、取得後のいずれの時点でも実行可能です。
- 通常どおり、可用性の結果を集計し、並べ替えてください。
- すべてのリクエストを通じて、顧客IDが保持されるようにしてください。
顧客IDに関する注記： クリック広告に投資する広告主は、その支出から生み出される価値について、明確な洞察を求めています。宿泊施設のスポンサー掲載については、この数値は、広告のインプレッションまたはクリックから生じた予約数によって測定されます。ただし、宿泊施設の在庫が複数のチャネルから調達されている場合、包括的な予約アトリビューションデータをご提供することができません。そのため、すべての広告リクエストにおいて、一意の顧客IDの記載をお願いしております。そのIDは、広告追跡プロセス全体を通じて維 持され、予約のアトリビューション情報に含める必要があります。これにより、広告とのインタラクションと、その結果として発生した予約を正確に紐づけることが可能となります。
ステップ2：利用状況の結果から、関連する 施設 を探します
広告のリーチを最大化し、収益化を最適化するためには、Expedia経由で予約を受け付けていない宿泊施設であっても、施設IDをExpediaの施設IDに紐付けることが極めて重要です。2つのプロパティのセット間には完全な対応関係はないと思われます。というのも、すべてのプロパティがスポンサー付きリスティングプログラムに参加しているわけではないからです。
- 広告配信の応答で返されたエクスペディアの 施設IDを、ご自身の空室状況の結果と照らし合わせてご確認ください。
- 施設 の掲載内容とスポンサー掲載を統合してください。Lodging Sponsored Listings APIからの結果には、施設というIDと広告コンテンツのみが返され、その他のコンテンツは含まれません。
ステップ3：スポンサー掲載を在庫検索結果に織り交ぜる（任意）
スポンサー掲載物件は、検索結果の上部に表示される場合もあれば、自然検索結果の中に散りばめられる場合もあります。順序さえ守られていれば、掲載位置に制限はありません。
- スポンサー掲載の表示方法をお選びください。
- スポンサー掲載の表示順序が変更されないよう、ご確認ください。
広告ランクも広告の位置も、いずれも広告の掲載位置に関係していますが、これらは同じものではありません。
- 広告ランク（）は、オークション終了後の広告の順位を決定します。優勝した広告にはランク1が、次に高い広告にはランク2が、というように、最大25位（表示される広告の最大数）まで順次ランクが割り当てられます。
- 一方、広告位置（）とは、ページ上の広告の実際の配置位置を指し、通常は1（最上部）から順に番号が付けられます。ページ分けされた検索結果では、順位はページをまたいで連続して表示されます。たとえば、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"
}
]
}重要なガイドライン
施設ID：「Lodging Sponsored Listings API」を呼び出す際は、Expediaの施設IDのみが認識されます。non-ExpediaのグループIDについては、広告在庫が返されないか、あるいは誤って別の、関連性のないExpedia Group施設.
施設 の件数制限： 1回のリクエストにつき、最大700個の 施設IDを指定できます。
施設 の料金と空室状況：「Lodging Sponsored Listings API」では、空室状況を想定したり確認したりすることはありません。これは、検索結果のスポンサー掲載枠において、Expedia Groupの料金を表示するか、あるいは他のソースからの料金を表示するかを選択できるためです。そのため、「Lodging Sponsored Listings API」と「Shopping Availability API」の両方にリクエストを送信し、その結果を組み合わせるのです。
バッチ処理とキャッシュ：「Lodging Sponsored Listings API」ではバッチリクエストはサポートされておらず、Expedia Groupでは、スポンサー付きリスティングの在庫情報のキャッシュを推奨していません。
スポンサー掲載のオークションは検索ごとに実行する必要があり、再利用することはできませんので、お客様が検索を行うたびに、「Lodging Sponsored Listings」エンドポイントへのリクエストを行ってください。お客様の検索条件（旅行日程や客室数など）に変更があった場合は、情報が確実に反映されるよう、追加のリクエストを行ってください。up-to-date.
オーガニック検索向けに料金や空室状況をキャッシュしておくことは可能ですが、Lodging Sponsored Listings APIへの呼び出しはリアルタイムで行う必要があります。広告掲載先は通常、1日あたりの最大予算を設定してお り、その予算はリアルタイムで消費されます。広告の詳細情報が頻繁に更新されない場合、クリックが行われる頃には、広告主の予算が底をついている可能性があります。これは「オーバースペンド」と呼ばれ、広告が表示され、顧客がクリックしたとしても、収益は発生しません。
広告の表示順： 検索結果内のどの位置にスポンサーリンクを表示するかは選択できますが、Shopping APIのレスポンスの場合のように、re-sortを行ったり、選択アルゴリズムを適用したりすることはできません。これは、APIを通じて配信されるスポンサー掲載の順序が、各物件が掲載順位を得るためにcost-per-clickの一定額を入札するライブオークションの結果を反映しているためです。
特定の 施設 をスポンサー掲載に表示させたくない場合は、Lodging Sponsored Listings APIのリクエストにおいて、その 施設IDを除外することができます。
広告掲載範囲： フィルターなどの追加の検索条件を設定すると、特定の検索条件に合致する物件の数が制限されます。リクエストに含める物件数は、できるだけ多くすることをお勧めいたします。旅行者の入力内容以外に追加のフィルターを適用すると、広告収入の機会を逃す恐れがあります。
施設 ヒーロー画像： APIのレスポンスを通じて送信されるproperty-selectedのヒーロー画像の使用は必須ではありませんが、ご利用いただくことをお勧めいたします。
施設 スポンサー掲載と自然検索結果における重複： スポンサー掲載で紹介されている物件は、検索結果内の別の自然検索結果にも表示されることが業界の標準となっています。各物件は、検索結果での露出を増やす見返りとして、より高い入札額を提示する意向です。
例えば、検索結果の1位をスポンサー掲載用に確保し、ホテルAがオークションに落札して、スポンサー掲載として1位に表示されるといった具合です。オーガニック検索の検索結果の表示順序において、ホテルAはページの下方にある7番目の位置で、2度目として表示されています。
検索結果において、スポンサー掲載が対応する自然検索結果のすぐ上または下に表示されることはめったにありません。検索結果の最上部に表示されるのは、全検索のわずか2％から3％にすぎません。そのような状況になった場合、一つの選択肢として、オーガニック検索結果の順位を数位下げて、ユーザー体験を損なわない範囲でオフセットを調整 する方法があります。
sortにおけるスポンサー掲載の例
広告ブロッカーによって、検索結果からスポンサー掲載が検出・削除されることがあるため、オーガニック検索結果の重複を削除してしまうと、high-qualityに掲載されている物件が旅行者に表示されなくなってしまいます。
Shopping APIのリクエストとの連携： Lodging Sponsored Listings APIは、Rapid Lodging Shopping APIと組み合わせて使用するように設計されています。APIリクエストの順序は問いません。「Lodging Sponsored Listings API」と「Shopping Availability API」へのリクエストは、並行して、あるいは順次行うことができます。
>>「Lodging Shopping API」の詳細はこちら
本番運用を開始する前に
Lodging Sponsored Listings APIの実装を本番環境で公開する前の最後のステップは、テスト用エンドポイントから本番用エンドポイントへ移行することを確認することです：
- Ad Delivery 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。