プロモーション メッセージ

概要

プロモーション メッセージでは、 OTA_HotelRateAmountNotifRQ。料金ごとに定義されたプロモーションは 評価され、最大許容割引が 。このメッセージ タイプはオプションです。定義する必要があるのは、 システムでプロモーションが使用されている場合は、プロモーションを割引料金で適用できます。

プロモーションを組み合わせて、さまざまなユーザー属性に適用することができます。 デバイスの種類（モバイル、タブレット、パソコン）や国コードなどです。

プロモーションに関連するさまざまなシナリオの例については、以下をご覧ください。 ハウツー。

以降のセクションでは、一般的なガイドライン、基本的な例、 プロモーションの追加と更新を開始する方法を紹介します。

ガイドライン

このセクションでは、設定に関する一般的なガイドラインと特別な手順について説明します。 。

プロモーションについては、次のガイドラインに従ってください。

操作

削除
1 つの要素を削除するには、<Promotion> 要素で delete アクションを使用します。 プロモーションを ID で指定できます。
オーバーレイ
<HotelPromotions> 要素で overlay アクションを使用して、 すべてのプロモーションが表示されます
Delta
アクションを指定しない場合、指定したすべてのプロモーション 追加または置換されます。<HotelPromotions>その ID を持つプロモーションが または削除されていない場合、プロモーションは追加されます。もし その ID のプロモーションが存在する場合は、新しい定義で上書きされます。

全般

  • 宿泊施設と宿泊施設ごとに、1 つまたは複数のプロモーション セットを作成できます。 プロモーションには一連の条件がありますこのプロモーションは 条件が満たされます

  • プロモーションを特定の日付、客室タイプ、料金にのみ適用する場合 そのプロモーションの条件でそれを指定します。もし プロモーションが特定の日付、客室タイプ、料金プランに適用されない場合は、 それらを設定する必要はありません。

  • 各プロモーションは特定の宿泊施設に関連付けられます。同じプロモーションを使用する場合 プロパティが複数ある場合は、プロパティごとに個別に送信する必要があります。宛先 プロパティ ID を指定するには、hotel_id <HotelPromotions> 要素。

  • 最大 99 個のプロモーションを含めることができます。必要に応じて、Google のテクニカル アカウント マネージャー（TAM）にお問い合わせください。 これだけではありません

  • <Stacking> 要素を使用して、プロモーションの組み合わせ方法を指定します。方法 デフォルトでは、Google は base スタックタイプを使用します。つまり、最も適格な 他のプロモーションの前に基本プロモーションが最初に選択されて適用されます。備考 base は second または any とのみ組み合わせることができ、組み合わせることはできません。 別の base または none に置き換えます。

  • 同時に適用できるプロモーションが複数ある場合でも そのスタックが実際に使用されているものとは 異なる場合があります より大幅な割引を提供する、単一のプロモーションまたはプロモーションのスタック「 最も割引が大きいプロモーション（組み合わせ）が予約に適用されます 複数（組み合わせ）のプロモーションの対象となる場合。

  • 影響する変更が発生した場合に、プロモーション メッセージの更新情報を送信します。 追加できます

最適なプロモーション（またはプロモーションのスタック）が AmountAfterTax の金額に適用されます。AmountBeforeTax のみを指定すると、プロモーションは次のようになります。 AmountBeforeTax に適用しました。

例

このセクションでは、必須のプロモーション メッセージの基本的な例を示します。 オプション要素です。ファイルの準備ができたら、 POST メッセージをこのエンドポイントに送信します。

https://www.google.com/travel/hotels/uploads/promotions

メッセージを push/POST する方法の詳細については、 メッセージの push。

<HotelPromotions> の hotel_id 属性には、一意のホテル ID を使用します システム内で使用したプロパティを識別します。この値は一致している必要があります <listing> で <id> を使用して指定されたホテル ID 要素を記録します。Google でデータが正しく表示されるようにするには、システムとの整合性が重要です。

UserCountry は、対象となるユーザーの所在地（国）を表示するために使用します。 選択します指定した場合、リストに含まれる国のユーザーのみが 割引料金を提示していました

この例では、長期滞在に対する 15% の割引を設定する方法を示しています。 米国とイタリアのユーザーの場合:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

その他の例については、 プロモーションの例。

入門ガイド

このセクションでは、プロモーションを設定する際に発生する可能性のあるシナリオの解決策について説明します。

シナリオ 1: 長期滞在向けの割引プロモーションを追加する方法

説明

長期滞在の特定の日に割引料金を適用したい。

解決策

FreeNights 設定を使用すると、適用される割引のタイプをカスタマイズできます。 決定します

サンプル

このサンプルでは、7 泊ごとに 2 泊の 20% 割引を追加する方法を示します。 特定の予約期間に滞在した ユーザーが含まれます15 泊の旅行プランの場合、合計 4 泊に 20% の割引が適用されます。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

シナリオ 2: デバイスタイプを設定する方法

devices を設定して、対象となるユーザー デバイスを指定します。 。指定した場合、リストにあるデバイスのユーザーのみが提供されます 割引料金が適用されます

説明

プロモーションの対象となるユーザー デバイスの種類を指定したい。

解決策

デバイスタイプを次の値（desktop、tablet、1 つ以上）に設定します。 または mobile。

サンプル

次のサンプルは、モバイルと Google のデバイスの 25% 割引を指定する方法を示しています。 タブレット ユーザー:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

シナリオ 3: 古いプロモーションを新しいプロモーションに交換する方法

説明

宿泊施設の現在のプロモーション セットが古くなっているか正しくない まったく新しいセットに置き換えられます。

解決策

overlay アクションを使用してプロモーションを置き換えます。

サンプル

次の例は、元の 2 つの割引である 20% と プロパティの 30% になります

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

次に、このサンプルは、overlay を使用して既存の 宿泊施設の 15% 割引のプロモーションを 1 つ含む、2 つのプロモーション。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

シナリオ 4: 1 つまたはすべてのプロモーションを削除する方法

説明

以下の理由で、1 つまたはすべてのプロモーション（交換なし）を削除したいと考えています。 プロパティで新しいプロモーションを設定せずにすべてのプロモーションを削除した場合 誤りがあり、修正が必要です。

解決策

特定のユーザーのみを削除するには、delete アクションを使用します。 プロパティのプロモーション、および（delete ではなく）overlay アクションを使用して削除する 既存のプロモーションがすべて適用されます

overlay を使用してプロモーションを置き換える方法について詳しくは、以下をご覧ください。 シナリオ 3:

サンプル

次のサンプルは、宿泊施設の 1 つのプロモーションのみを削除する方法を示しています。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

このサンプルは、置き換えなしですべてのプロモーションを削除する方法を示しています プロパティの場合:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

シナリオ 5: プロモーションのスタック方法

スタッキングは、プロモーションを組み合わせる方法を指定します。指定しない場合、type は base とみなされます。つまり、最適な基本プロモーションは 他のプロモーションより先に選択、適用されますtype 属性の のうち、Stacking が any の場合は、他のプロモーションと組み合わせることができます。

説明

ユーザーが同じ宿泊施設で複数のプロモーションを同時に使用できるようにしたい。

解決策

併用により、宿泊施設ごとに複数の割引を設定できます。1 つのスタックに最大 1 つの base と 1 つの second ですが、any の数に制限はありません。、any は none を除く他の型と組み合わせる。

サンプル

このサンプルは、base、second、any のスタッキング タイプをスタックする方法を示しています。対象 15%、25%、10%の合計割引率を $100 とすると 57.38 ドル（100 × 0.85 × 0.75 × 0.9）。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

プロモーション 1～3 の重複割引の合計額は、プロモーション 4 の割引額よりも大きいことに注意してください。プロモーション 4 は次のキャンペーンと組み合わせることはできません 他のプロモーションの積み重ねタイプ（none）が原因です。プロモーション 4 に 43% 以上の割引がある場合は、次の組み合わせではなく プロモーション 1 ～ 3