概要

新しいマーチャンダイジングAPIを活用することで、より簡単にお買い得商品を特定し、マシンlearning-poweredレコメンデーションから利益を得ることができます。

Merchandising APIは、Expedia-sourced施設 の割引、関連するキャンペーンやアセット、機械学習によってパーソナライズされたディール、デスティネーション、施設ランキングへの直接アクセスを提供します。Merchandising APIを使用して、プロモーションメール、アプリウィジェット、ウェブサイトバナー、カルーセル体験など、旅行者またはagent-facingのマーケティング体験を入力し、勝算のあるyear-longマーチャンダイジング戦略を実行します。

のマーケティングセクションにもアクセスできます。 パートナーポータル このアカウントでは、今後のキャンペーンを閲覧したり、カスタマイズした案件リストをエクスポートしたり、キャンペーンのコピーや画像を選択したり、旅行の傾向やキャンペーンのパフォーマンスを追跡したりすることができます。ポータルに「マーケティング」セクションが表示されていない場合は、以下のフォームを送信してください。 サポートチケットに従って入力します。

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

キャンペーンコンテンツエンドポイントは、キャンペーンID、予約および滞在の開始日と終了日、参加施設数など、今後のキャンペーンの詳細を配信します。キャンペーンテーマ画像、デスティネーション画像、提案コピーなどのExpedia-curatedキャンペーンアセットに直接アクセスして、プロモーションメール、アプリウィジェット、ウェブサイトバナーなどのtraveler-facingまたはagent-facingマーチャンダイジングエクスペリエンスを作成できます。さらに、6ヶ月以内の予約期間付き期間限定キャンペーン（LTO）や、年間を通してご利用いただけるエバーグリーンキャンペーンの情報もお届けします。

キャンペーンコンテンツエンドポイントを使用すると、次のようなリクエストパラメータを使用して、今後のキャンペーンを検索できます：

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

LTOキャンペーンで予約期間が6ヶ月を超える場合、以下の項目は対象外となります：

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

その他詳細

キャンペーンコンテンツレスポンスのproperty_count フィールドを使用して、キャンペーン内で案件を提供するプロパティの最多up-to-date件を決定できます。マーチャンダイジングキャンペーンへの施設の参加はダイナミックであり、キャンペーン開始が近づくにつれ、物件からの参加は最も完全で信頼できるものになる傾向があるため、キャンペーン予約開始日間近にproperty_count をチェックすることをお勧めします。

キャンペーンコンテンツレスポンスのmin_discount とmax_discount フィールドを使用して、そのキャンペーン内で利用可能な最小と最大のパーセンテージ割引を決定することができます。例えば、そのキャンペーンで施設が提供した最も深い割引が60%オフの場合、APIレスポンスのmax_discount 値は60%になります。一方、そのキャンペーンで施設が提供した最も低い割引が4%の場合、min_discount フィールドは4%になります。

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

よりターゲットを絞ったお得なプロモーションの検索やフィルタリングが簡単に行えるため、旅行者にどのようなお得な情報を提供するかを完全にコントロールすることができます。また、Expedia-definedキャンペーンや関連アセットを使用する代わりに、これらの案件をキュレーションして独自のキャンペーンテーマを構築することもできます。

• 特定のキャンペーンに関連したお得な情報や割引情報を配信します。
• 特定のキャンペーンまたは複数のキャンペーンにまたがる案件をリクエストする機能など、複数のリクエストパラメータを使用して案件を検索およびフィルタリングする機能。
• high-convertingキャンペーンを構築するために、最もup-to-date, 魅力的な 施設 案件を常に表示することができます。

Promotionsエンドポイントを使用すると、次のようなリクエストパラメータを使用して、簡単にお得な情報をフィルタリングして検索できます：

• キャンペーンIDおよび/または施設ID
• 予約可能日
• 滞在日数
• 最低レビュースコア、最低星評価、および/または最低割引の値以上
• 期間限定と常緑の区別
• Member-onlyおよびmobile-onlyディールフラグ
• スーパー地域または特定の目的地
• 機械学習による関連性ランキングのソート順

プロモーションAPIのレスポンスには、以下の詳細が返されます：

• プロモーションID、対応するキャンペーンID、施設ID
• ご予約可能な日付範囲、ご宿泊可能な日付範囲、ブラックアウト日、事前購入枠
• 期間限定と常緑の区別
• 機械learning-poweredレスポンスで返された案件、物件、目的地に対する、お客様のビジネス独自の関連性ランキング
• 特定の目的地とチェーンID情報
• 既存のRapid施設Content APIへのトークン化されたリンクにより、property-levelの画像を取得し、マーチャンダイジング体験で使用することができます。

その他詳細

• もし予約期間のセットで検索したい場合は、bookable_start とbookable_end の日付の両方に値を渡すことができます。例えば、bookable_start の欄に2025-10-15 (2025年10月15日) を入力し、bookable_end の欄に2025-10-30 (2025年10月30日) を入力すると、10月15日から10月30日までの間に予約可能なすべてのディールを受け取ることができます。しかし、より多くの取引を見たい場合は、bookable_start またはbookable_end 日付を使用できます。例 :
  • bookable_startフィールドに2025-10-15 (2025年10月15日) を入力すると、10月15日以降に予約可能なすべてのお得な情報を受け取ることができます。そうすることで、より多くの取引が可能になります。
  • bookable_endの欄に2025-10-30 (2025年10月30日) と入力するだけで、10月30日以前に予約可能なすべてのお得な情報を受け取ることができます。この場合も、より多くの案件を提供することができます。
• お得な情報は、施設のタイムゾーンに合わせて公開されます（i.e.）。そのため、3月21日にオーストラリアのシドニーで施設の取引が開始された場合、その取引はシドニー時間の午前12時1分に世界中のすべてのパートナーに対して予約可能となります。
• Promotionsエンドポイントのinclude リクエストパラメータを使用して、受信するレスポンスのサイズをカスタマイズできます。そのため、すべてのレスポンスフィールドを受け取る代わりに、いくつかのフィールドだけを返す必要がある場合は、include パラメータに特定のフィールド名を追加することができます。
• 事前にプロモーションAPIへのリクエストを開始することができますが、プロパティからのお得な情報を最も正確かつup-to日付で表現するために、キャンペーン予約可能な開始日のできるだけ近くにリクエストする必要があります。キャンペーン開始の約2週間前をお勧めします。これは、キャンペーン開始が近づくにつれ、物件からの参加が最も完全かつ確実になる傾向があるためです。
  • また、キャンペーン開始の数日後にキャンペーンをリクエストし、常に最新のキャンペーンリストを入手することをお勧めします。さらに、プロモーションAPIを毎日リクエストして、プロパティが提供するお得な情報の最新リストを取得することをお勧めします。
• destination-basedマーチャンダイジングキャンペーンの構築に興味がある場合は、Rapid Geography APIから関連するregion_id を使用してregion-specific Promotions APIリクエストを行うことができます。プロモーション・エンドポイントが受け付けるリージョンタイプはcity のみです。multi_city_vicinity、point_of_interest、neighbourhood などの他のリージョンタイプは空白のレスポンスを返します。

機械学習によるおすすめ

プロモーション・レスポンスで配信されるマシンlearning-poweredの関連性ランキングは、各パートナーに固有のものであるため、お客様が受け取るランキングは、他の誰が受け取るランキングとも異なります。機械学習によるレコメンデーションを使用して、マーチャンダイジング・キャンペーンで宣伝するのに最適な情報、物件、目的地を特定できます。Higher-scoringあなたのユニークな旅行者の間でコンバージョンを促進する可能性が高いかもしれません。

• 現在、各キャンペーンの上位1万件の関連性ランキングを受け取ることができます。私たちのテストでは、このランクの価値と影響は、最初の1万件を超えると無視できるほど小さくなることがわかりました。
• ユースケースに基づき、sort_by パラメータを使用して、プロモーションレスポンスのソート順を定義することができます。当社の機械学習モデルによって決定されたディール、施設、または目的地の関連性に基づいてソートすることで、旅行者からの視認性と予約というマーチャンダイジングから最大限の価値を得ることができます。
  • sort_by = promotionを通過すると、当社独自の機械学習アルゴリズムにより、high-to-low (1から10,000) にランク付けされたすべてのディール結果を受け取ることができます。この並べ替えを使用すると、当社のモデルがより多くのコンバージョンを期待する上位の推奨案件を得ることができます。
  • sort_by = propertyを通過すると、当社独自の機械学習アルゴリズムによりhigh-to-lowにランク付けされた物件から、すべての取引結果を受け取ることができます。
  • sort_by = destinationを通過すると、当社独自の機械学習アルゴリズムによりhigh-to-lowにランク付けされた目的地からのすべてのディール結果を受け取ることができます。

注： 機械学習による推奨事項は、以下のページでもご覧いただけます。 ポータルのマーケティングセクションに従って入力します。詳細は アカウントマネージャー までお問い合わせください。

Shopping Availability APIに加えられた変更

在庫状況、ライブ価格、払い戻し可能性、手数料情報などの最新情報を取得するには、RapidShopping APIに標準的なリクエストを行ってください。マーチャンダイジングフローをサポートし、マーチャンダイジングAPIとの統合を可能な限りスムーズにするため、ショッピングAPIに以下の変更を加えました：

• Rapid Shopping Availabilityエンドポイントで利用可能な新しいdeal フィルタを使用して、アクティブなプロモーションを特徴とする料金のみを受信します。これにより、マーチャンダイジングに特化したショッピングリクエストを柔軟に作成し、返されるすべてのレートにdeal 属性を持たせることができます。

注: Shopping Availability APIから一度に最大250件の物件の詳細をリクエストできます。

返信例

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

注: Merchandising APIレスポンスで利用可能なid とdescription は、Shopping APIレスポンスで返されるものとは異なります。マーチャンダイジングAPIから返されるid とdescription を使用することを強くお勧めします。

公開要件

コンプライアンスの責任

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

コンテンツの完全性

Expedia-provided画像は変更しないでください。ただし、適用されるすべての著作権法および知的財産法 施設 を遵守することについては、利用者のみが責任を負うものとします。

API の詳細

このページでmerchandising-relatedのエンドポイント定義を調べ、API Explorerまたは他のテスト・ソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。

その他のリソース

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

API Explorer に移動