概要

新しいマーチャンダイジング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の参加物件数を決定できます。マーチャンダイジングキャンペーンへの施設の参加はダイナミックなものなので、キャンペーンの一環としてどれくらいの数のプロパティがお得な情報を提供するか、より正確な感覚を得るために、キャンペーン開始の約4～6週間前にproperty_count を評価することをお勧めします。

プロモーション・エンドポイントが受け付けるリージョンタイプは city.multi_city_vicinity、point_of_interest、neighbourhood などの他のリージョンタイプは空白のレスポンスを返します。

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

• 特定のキャンペーンに関連する利用可能なすべてのお得な情報や割引を配信します。
• 特定のキャンペーンまたは複数のキャンペーンにまたがる案件をリクエストする機能など、複数のリクエストパラメータを使用して案件を検索およびフィルタリングする機能。
• 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キャンペーンや関連アセットを使用する代わりに、これらの案件をキュレーションして独自のキャンペーンテーマを構築することもできます。

Promotionsエンドポイントのinclude リクエストパラメータを使用して、受信するレスポンスのサイズをカスタマイズできます。そのため、レスポンスのすべてのフィールドを受け取る代わりに、いくつかのフィールドだけを返す必要がある場合は、include パラメータに特定のフィールド名を追加することができます。

キャンペーンコンテンツ」レスポンスのproperty_count フィールドを使用して、最もup-to-dateの参加物件数を決定できます。マーチャンダイジングキャンペーンへの施設の参加はダイナミックなものなので、キャンペーンの一環としてどれくらいの数のプロパティがお得な情報を提供するか、より正確な感覚を得るために、キャンペーン開始の約4～6週間前にproperty_count を評価することをお勧めします。

up-to-dateキャンペーンコンテンツのガイダンスと同様に、プロモーションのリクエストは、キャンペーン予約開始日のできるだけ近くに行うことをお勧めします。

destination-basedマーチャンダイジングキャンペーンの構築に興味がある場合は、Rapid Geography APIから関連するregion_id を使用してregion-specific Promotions APIリクエストを行うことができます。

機械学習によるおすすめ

プロモーションの回答で提供される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 に移動