概要

新しいマーチャンダイジングAPIを活用して、お得な情報をより簡単に見つけ、機械学習（learning-powered）によるレコメンデーションを活用しましょう

Merchandising APIを利用すると、Expedia-sourced施設の割引、それに関連するキャンペーンやアセット、そして機械学習を活用したパーソナライズされたお得な情報、目的地、および施設のランキングに直接アクセスできます。Merchandising APIを使用して、プロモーションメール、アプリウィジェット、ウェブサイトのバナー、カルーセル体験など、旅行者向けまたはagent-facing向けのマーケティング体験を構築し、year-longの効果的なマーチャンダイジング戦略を実行しましょう。

また、ご自身のアカウント内の「マーケティング」セクションにもアクセスできます。パートナーポータルこのアカウントでは、今後のキャンペーンを閲覧したり、カスタマイズした割引リストをエクスポートしたり、使用するキャンペーンのコピーや画像を選んだり、旅行のトレンドやキャンペーンの成果を追跡したりすることができます。ポータルに「マーケティング」セクションが表示されない場合は、サポートチケット。

キャンペーンコンテンツのエンドポイント

キャンペーンコンテンツのエンドポイントでは、キャンペーンID、予約日および滞在開始日・終了日、参加施設数など、今後のキャンペーンの詳細情報を提供します。Expedia-curatedのキャンペーン資産（キャンペーンのテーマ画像、目的地に関する画像、推奨コピーなど）に直接アクセスし、traveler-facingやagent-facingのマーチャンダイジング体験（プロモーションメール、アプリウィジェット、ウェブサイトバナーなど）を作成することができます。さらに、今後6か月以内に実施される「予約期間」付きの期間限定キャンペーン（LTO）に関する情報に加え、年間を通じて実施される常設キャンペーンに関する情報も受け取ることができます。

「Campaign Content」エンドポイントを使用すると、以下のリクエストパラメータなどを指定して、今後実施されるキャンペーンを検索することができます：

予約可能な期間
滞在期間
最低割引率以上の値
LTOとエバーグリーン・オファーの比較

予約期間を含む、6か月を超えるLTOキャンペーンについては、以下のフィールドは除外されます：

予約日および旅行日
割引率の最小値と最大値

その他の詳細

キャンペーンコンテンツのレスポンスにある「property_count」フィールドを使用すると、そのキャンペーン内でディールを提供しているプロパティのup-to-dateな数を特定することができます。property_countについては、キャンペーンの予約開始日が近づいた頃に確認されることをお勧めいたします。施設のマーチャンダイジングキャンペーンへの参加状況は随時更新されるため、キャンペーン開始日が近づくにつれて、各施設の参加情報が最も完全かつ信頼性の高いものとなる傾向があるからです。

キャンペーンコンテンツのレスポンスにある「min_discount」および「max_discount」フィールドを使用することで、そのキャンペーンで適用可能な割引率の最小値と最大値を特定することができます。たとえば、そのキャンペーンにおいて施設が提供する最大の割引率が60% オフの場合、APIレスポンスのmax_discount の値は60% となります。一方、そのキャンペーンにおいて施設が提供する最低の割引率が4% の場合、min_discount フィールドの値は4%となります。

Merchandising APIまたはShopping APIを使用して構築されたサイトにおけるキャンペーンのマーケティングおよびメッセージ発信については、引き続きお客様が責任を負うものとし、かかるマーケティングおよびメッセージ発信のすべてが、適用される法令および規制に準拠していることを確保するものとします。

プロモーションのエンドポイント

「プロモーション」の検索結果から、よりターゲットを絞ったお得な情報を簡単に検索・絞り込むことができるため、旅行者にどの情報を表示するかを完全にコントロールできます。また、Expedia-definedのキャンペーンや関連アセットを使用する代わりに、これらのオファーを組み合わせて、独自のキャンペーンテーマを作成することも可能です。

「Promotions」エンドポイントを使用すると、以下のことが可能です：

特定のキャンペーンに関連するお得な情報や割引を検索する
キャンペーンに関連するお得な情報や割引を検索してください。（ではありません）。
複数のリクエストパラメータを活用してディールを検索・絞り込むことができます。これには、特定のキャンペーンのディールや、複数のキャンペーンにまたがるディールをリクエストする機能も含まれます。
up-to-date, で最も魅力的な施設のオファーを見つけ、high-convertingキャンペーンを展開しましょう

検索と絞り込み

「Promotions」エンドポイントを使用すると、次のようなリクエストパラメータを用いて、お得な情報を簡単に絞り込んだり検索したりすることができます：

キャンペーンIDおよび／または施設ID
予約可能な期間
滞在期間
最低レビュースコア、最低星評価、および／または最低割引率の基準値以上であるもの
期間限定と定番の違い
Member-onlyおよびmobile-onlyのディールフラグ
広域圏または特定の目的地
機械学習による関連性ランキングの並べ替え順序

回答の詳細

以下の詳細情報が、プロモーションAPIのレスポンスとして返されます：

プロモーションID、対応するキャンペーンID、および施設ID
予約可能期間、宿泊期間、利用不可日、および事前購入期間
期間限定と定番の区別
レスポンスに含まれる取引、物件、目的地について、貴社独自の「learning-powered」の関連性ランキング
具体的な宛先およびチェーンIDに関する情報
既存のRapid施設コンテンツAPIへのトークン化されたリンクで、property-levelの画像を取得し、貴社のマーチャンダイジング体験に取り入れることができます
Tokenized Shoppingのリンクを通じて、deal-specificの商品販売用ショッピングAPIを呼び出し、リアルタイムの価格と在庫状況を取得します

その他の詳細

予約期間というセットのお得な情報を検索したい場合は、bookable_start とbookable_end dateの両方に値を指定することができます。たとえば、「bookable_start」フィールドに「2027-10-15」（2027年10月15日）を、「bookable_end」フィールドに「2027-10-30」（2027年10月30日）を指定すると、10月15日から10月30日までの期間（両日を含む）に予約可能なすべてのプランが表示されます。ただし、より多くの割引情報を確認したい場合は、bookable_start またはbookable_end dateのいずれかをご利用いただけます。例 :
- 「bookable_start」フィールドに「2027-10-15（2027年10月15日）」と入力すると、10月15日以降に予約可能なすべてのプランが表示されます。これにより、より多くの取引案件が提供されることになります。
- 「bookable_end」フィールドに「2027-10-30（2027年10月30日）」のみを指定することで、10月30日およびそれ以前に予約可能なすべてのプランを取得できます。繰り返しになりますが、これにより、より多くの取引案件が提供されることになります。
お得なプランは、施設のタイムゾーンに基づいて公開され（i.e. での予約が可能になります）。つまり、オーストラリアのシドニーで3月21日に施設のキャンペーンが開始される場合、シドニー時間の午前0時1分から、世界中のすべてのパートナー向けに予約受付が開始されます。
Promotionsエンドポイントでは、include リクエストパラメータを使用することで、受け取るレスポンスのサイズをカスタマイズすることができます。したがって、すべてのレスポンスフィールドを受け取るのではなく、返されるフィールドが数個だけでよい場合は、include パラメータにそれらの特定のフィールド名を指定することができます。
（）のディール（ではなく）は、キャンペーンに関連付けられたディールと一見同じように見えますが、いくつかの重要な違いがあります：
- キャンペーンに関連付けられていない取引には、キャンペーンIDが割り当てられていません。
- そのほとんどは、最低割引率が10％で、予約の有効期限が2079年となっています。予約終了日が2079年のプランは「常時提供プラン」とみなされますが、予約日が2079年以前のプランは「期間限定プラン」とみなされます。
プロモーションAPIへのリクエストは事前に開始できますが、各宿泊施設のプラン情報を最も正確かつup-toな日付で反映させるためには、キャンペーンの予約開始日にできるだけ近い時期にリクエストを行うことをお勧めします。キャンペーン開始の約2週間前を目安にされることをお勧めいたします。これは、キャンペーンの開始が近づくにつれて、物件からの参加が最も完全かつ信頼性の高いものになる傾向があるためです。
- また、キャンペーン開始から数日後にプロモーションをリクエストすることをお勧めします。そうすることで、常に最新のオファー一覧を入手できるようになります。また、各施設から提供されるお得な情報の最新リストを入手するため、プロモーションAPIを毎日呼び出すことをお勧めいたします。
destination-basedのマーチャンダイジングキャンペーンの構築にご興味をお持ちの場合は、Rapid Geography APIの関連する「region_id」を使用して、region-specificプロモーションAPIへのリクエストを行うことができます。promotionsエンドポイントで受け入れられるリージョンタイプは、city のみです。multi_city_vicinity、point_of_interest、neighbourhood などの他のリジョンの種類については、空のレスポンスが返されます。

ショッピング在庫状況API

プロモーション対象の施設に関するリアルタイムの在庫状況、価格、返金条件、および手数料の詳細を確認したい場合は、次にRapid Shopping Availability APIを呼び出してください。

各プロモーションへの反応には、キャンペーンに関する重要な詳細情報と「施設」というデータを含むショップリンクトークンが含まれており、これはキャンペーンごとに固有のものとなっています。ショップリンクトークンを使えば、プロモーションの発見から購入へとスムーズに移行できます。

プロモーションの回答例

[
  {
    "promotion_id": "123456",
    "campaign_id": "12345",
    "property_id": "123456",
    ...
    "links": {
      "content": {
        "method": "GET",
        "href": "/v3/properties/content?property_id=123456&language=en-US&supply_source=expedia"
      },
      "shop": {
        "method": "GET",
        "href": "/v3/properties/availability?token=XFleAkNUU1YKACg5HcAtdVw8SQVUPUApTAF0CAApdBg==",
        "required_parameters": [
          "checkin",
          "checkout",
          "currency",
          "country_code",
          "occupancy",
          "rate_plan_count",
          "sales_channel",
          "sales_environment"
        ]
      }
    }
  }
]

プロモーションするキャンペーンを選択する際は、ショップリンクトークンを使用して、必要なパラメータを指定し、Availability APIを呼び出してください。その後、Availability APIのレスポンスには、選択した取引に関する通常の詳細情報がすべて表示されます。これにより、deal-specificショッピングAPIへの呼び出しを、目的を絞った形で自動で行うことが可能になります。このトークンを利用することで、同じショッピングAPIリクエスト内で他の物件をさらに検索することができ（1回のショッピング呼び出しにつき合計250件という通常の上限は引き続き適用されます）、ショッピング検索の範囲をさらに広げることができます。

Availability APIへのリクエストを複数回行う際は、各呼び出しごとにショップリンクトークンを使用していただくようお願いいたします。Promotions APIへのリクエストを行うたびに、各ショップリンクごとに新しいトークンが生成されます。これは、すべてのトークンが一意であり、特定のプロモーションAPI呼び出しまで追跡できるためです。したがって、プロモーションデータを毎日更新する場合は、最新に生成されたトークンを使用することが重要です。

トークンを使用したショッピングAPIのリクエスト例

curl -X GET "https://test.ean.com/v3/properties/availability\
?token=XFleAkNUU1YKACg5HcAtdVw8SQVUPUApTAF0CAApdBg==\
&checkin=2026-06-01\
&checkout=2026-06-03\
&currency=USD\
&country_code=US\
&occupancy=2\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only" \
 -H "accept: application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

さらに、「Rapid Shopping Availability」エンドポイントで利用可能な新しい「deal」フィルターを使用することで、現在実施中のプロモーションが適用されている料金のみを受け取ることができます。これにより、マーチャンダイジングのみに焦点を当てたショッピングリクエストを作成する柔軟性が得られ、返されるすべてのレートに「deal」属性が含まれていることを確実にすることができます。

返信例

"promotions": {
. "deal": {
.   "id": "999abc",
.   "description": "Book early and save 15%"
. }
}

注： Merchandising APIのレスポンスに含まれるid およびdescription は、Shopping APIのレスポンスで返されるものとは異なります。Merchandising APIから返されるid およびdescription をご利用いただくことを強くお勧めいたします。

提案されている最低割引率は、税およびサービス料を除いて計算されています。パートナー様は、価格の広告に関して準拠が必要な法律に確実に従って割引を広告する責任があります。

機械学習によるおすすめ

「learning-powered」の機械学習による関連性ランキングは、「プロモーション」のレスポンスで提供されるものであり、各パートナーごとに異なります。そのため、お客様が受け取るランキングは、他の誰かが受け取るものとは異なります。機械学習によるレコメンデーションを活用することで、マーチャンダイジングキャンペーンで宣伝するのに最適なセール情報、物件、旅行先を特定することができます。Higher-scoringお得な情報、物件、旅行先は、貴社の独自の旅行者層の間で予約につながる可能性が高くなるかもしれません。

現在、上位1万件の取引について、関連性ランキングが表示されるようになっています。当社のテストでは、最初の1万件の取引を超えると、このランクの価値と影響はごくわずかになることがわかりました。
ご利用のユースケースに応じて、sort_by パラメータを使用して、Promotionsレスポンスの並べ替え順序を定義することができます。ディール、施設、または当社の機械学習モデルによって決定された目的地との関連性に基づいて並べ替えることを選択することで、旅行者からの露出や予約の観点から、マーチャンダイジングの効果を最大限に引き出すことができます。
- sort_by = promotionを指定すると、当社の独自機械学習アルゴリズムに基づき、high-to-low（1～10,000）の順にランク付けされたすべての取引結果を受け取ることができます。この並べ替え機能を使用すると、当社のモデルがコンバージョン率が高いと予測する、最もおすすめのオファーを確認することができます。
- sort_by = propertyを指定すると、当社の独自機械学習アルゴリズムに基づき、high-to-lowにランク付けされた物件のすべての取引結果が表示されます。
- sort_by = destinationを指定すると、当社の独自機械学習アルゴリズムに基づき、high-to-lowにランク付けされた目的地からのすべての取引結果を受け取ることができます。

注：の機械学習による推奨事項は、ポータル（）の「」の「マーケティング」セクションでもご利用いただけます。詳細については、アカウントマネージャーまでお問い合わせください。

公開要件

コンプライアンスの責任

キャンペーンを実施する際には、適用されるすべての法的要件およびマーケティングガイドラインを遵守することについて、お客様が単独で責任を負うものとします。

コンテンツの完全性

Expedia-provided画像は変更してはいけません。ご希望であれば、ご自身のクリエイティブ資産をご利用いただけますが、適用されるすべての著作権および知的財産権に関する法律の遵守については、ご自身で全責任を負っていただくことになります。施設

API の詳細

このページで「merchandising-related」エンドポイントの定義を確認した後、「API Explorer」やその他のテスト用ソフトウェアを使用して、サンプルやスキーマ定義と実際の出力結果がどのように異なるかを確認してください。

その他のリソース

すべての Rapid API エンドポイントを試してみたい場合でも、OpenAPI 仕様や Postman コレクションをダウンロードしたい場合でも、必要なリソースが用意されています。