概要

新しいマーチャンダイジングAPIを活用することで、より簡単にお買い得商品を特定し、機械学習技術の恩恵を受けることができます。

機械学習を活用して、Expedia Group'sの膨大なグローバルプロモーションの在庫から、旅行者に最も関連性の高いお得な情報や割引を特定できます。マーチャンダイジングAPIを使用することで、様々なキャンペーンコンテンツにアクセスし、勝てるyear-long戦略や、プロモーションメール、アプリウィジェット、ウェブサイトバナー、カルーセル体験などのtraveler-facing体験を構築するためのデータを扱うことができます。

また、マーチャンダイジング戦略を構築し、キャンペーンを計画、実行、追跡するために使用できる新しいアプリをパートナーポータルに追加しました。このアプリは、ポータル・マーケティング・ハブと呼ばれる新しいセクションにあります。詳しくはアカウントマネージャーまでお問い合わせください。

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

• キャンペーンID、予約・宿泊開始日、終了日、参加施設数など、今後のキャンペーン詳細をお届けします。
• キャンペーンテーマ画像、デスティネーション画像、提案コピーなど、Expedia-curatedキャンペーンアセットに直接アクセスできます。
• 6ヶ月以内の予約期間付き期間限定キャンペーン（LTO）や、年間を通してご利用いただけるエバーグリーンキャンペーンの情報をお届けします。

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

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

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

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

その他詳細

キャンペーンコンテンツエンドポイントは、Expedia-curatedアセットを活用して、プロモーションメール、アプリウィジェット、ウェブサイトバナーなどのtraveler-facingマーチャンダイジングエクスペリエンスを作成するのに役立ちます。

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

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

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

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

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

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

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

その他詳細

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

もし予約期間のセットで検索したい場合は、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日付で表現するために、キャンペーン予約可能な開始日のできるだけ近くにリクエストする必要があります。これは、キャンペーン開始が近づくにつれ、物件からの参加が最も完全かつ確実になる傾向があるためです。

また、キャンペーン開始の数日後にキャンペーンをリクエストし、常に最新のキャンペーンリストを入手することをお勧めします。さらに、プロモーションAPIを毎日リクエストして、プロパティが提供するお得な情報の最新リストを取得することをお勧めします。

destination-basedマーチャンダイジングキャンペーンの構築に興味がある場合は、Rapid Geography APIから関連するregion_id を使用してregion-specific Promotions APIリクエストを行うことができます。プロモーション・エンドポイントが受け付けるリージョンタイプはcity のみです。multi_city_vicinity、point_of_interest、neighbourhood などの他のリージョンタイプは空白のレスポンスを返します。

機械学習によるおすすめ

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

現在、各キャンペーンの上位10k件の関連性スコアを受け取ることができます。テストでは、このスコアの価値と影響は、最初の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に加えられた変更

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

• Rapid Shopping Availabilityエンドポイントで利用可能な新しいdeal フィルタを使用して、アクティブなプロモーションを特徴とする料金のみを受信します。これにより、マーチャンダイジングに特化したショッピングリクエストを柔軟に作成し、返されるすべてのレートにdeal 属性を持たせることができます。
• RapidのShopping Availabilityエンドポイントでは、Campaign-Id という新しいリクエストヘッダが利用可能です。このヘッダを使用すると、特定のShopping Availability API呼び出しが通常の呼び出しではなく、マーチャンダイジングのプロモーション活動によるものであることを示すことができます（言い換えると、キャンペーンプロモーションにより旅行者がShop体験に入ったときにShopping Availability APIリクエストが行われたことを示します）。ショッピングAPIコール1回につき1つのキャンペーンIDのみ受け付けます。このキャンペーンIDは、お客様のキャンペーンパフォーマンスを追跡し、より良い機械学習モデルとAPI拡張機能を設計するのに役立ちます。
• ポータルマーケティングハブでキャンペーンのパフォーマンスを確認したい場合は、ショッピングAPIコールでキャンペーンIDパラメータを渡す必要があります。ご不明な点がございましたら、アカウントマネージャーまでお問い合わせください。

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

返信例

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

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

API の詳細

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

その他のリソース

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

API Explorer に移動