プロモーション

Google 検索にフィードを提供するバックエンドがある場合、 複数のアカウントがある場合、この値は ID <RequestorID> で指定された属性値 <OTA_HotelRateAmountNotifRQ> の要素と 同じメッセージ <OTA_HotelAvailNotifRQ> 件 あります。

宿泊施設のプロモーション。各プロモーションは 1 つの プロパティです。

<Stacking> を使用しない限り、 最も割引率の高いプロモーションが予約に適用されます。 複数のプロモーションが対象になります。

指定する場合、値は "overlay"。値が "overlay" の場合、 保存されているプロモーションは、指定したプロモーションを保存する前に削除される クリックします。

指定しない場合、現在の メッセージは次のいずれかです。

• Added（どの保存済みプロモーションにも 同じ id）
• Updated（保存済みのプロモーションに同じ id)
• Deleted（保存済みのプロモーションに同じ id と action 属性の値 現在のメッセージで指定されたプロモーションに対する "delete")

宿泊施設の 1 件のプロモーション。なお、 action="overlay" と <Promotion> は を指定しなかった場合、宿泊施設のすべてのプロモーションが削除されます。

99 件を超えるプロモーションを利用する必要がある場合は、お問い合わせください。 テクニカルアカウントマネージャー（TAM）にお問い合わせください。

指定する場合、値は delete にする必要があります。回答が「いいえ」の場合 指定され、 同じ id のプロモーションが保存されない場合、この プロモーションが保存されます特に指定しなかった場合、および 同じ id が格納されている場合、既存のプロモーションは 更新しました。

delete が指定されている場合、 同じ id が削除されます。 delete を使用する場合は、子要素を <Promotion>。また、delete は <HotelPromotions action="overlay"/> と組み合わせて使用できます。

開始日または開始日（プロパティのタイムゾーンに基づきます）。 含まれます。

• start で指定された日付または日時は、 が end。
• start が指定されていない場合、範囲は実質的に 開始時間については無制限です
• start が日付「YYYY-MM-DD」として入力されている場合、 日時「YYYY-MM-DDT00:00:00」として解釈されます。

終了日または日時（プロパティのタイムゾーンに基づきます）。 含まれます。

• end には、それ以降の日付または日時を指定する必要があります が start。
• end が指定されていない場合、範囲は実質的に 終了時間については無制限です
• end の日付「YYYY-MM-DD」を指定した場合、 日時「YYYY-MM-DDT23:59:59」として解釈されます。

日付範囲内の曜日です。回答が「いいえ」の場合 すべての日付を指定できます。各 日付を指定します。例: 「MTWHF」指定 指定することもできます。

有効な文字は次のとおりです。

• M（月曜日）
• T（火曜日）
• W（水曜日）
• H（木曜日）
• F（金曜日）
• S（土曜日）
• U（日曜日）

任意の文字の組み合わせが有効です。

有効な値の型は次のとおりです。

• 整数: チェックインまでの日数 できます。たとえば、値 30 は、 プロモーションは、 チェックイン日。
• ISO 8601 の期間（日、時間、分）: チェックイン日の日数（および必要に応じて時間/分）対象 たとえば、値 P30D は、プロモーションのみが は、チェックイン日の 30 日以上前の予約に適用されます。 金額 P30DT6H を利用するには、18:00 までに予約する必要があります 到着の 30 日前までに変更できます

有効な値の型は次のとおりです。

• 整数: チェックインまでの日数 できます。たとえば、値 30 は、 プロモーションは、 チェックイン日。
• ISO 8601 の期間（日、時間、分）: チェックイン日の日数（および必要に応じて時間/分）対象 たとえば、値 P30D は、プロモーションのみが は、チェックイン日の 30 日前までの予約に適用されます。 金額 P30DT6H の場合は 18:00 以降に予約が必要です 到着の 30 日前までに変更できます

レートに設定できる最大値の制限を定義します プロモーション適用後の機能です

プロモーションでは、必ず <Discount> または <BestDailyDiscount>。プロモーションを <Ceiling> のみを適用する場合、オプションの一つは、 <Discount> と percentage 0。

併用が構成されている場合、 <Ceiling> は 1 回の宿泊に適用されます。各プロモーション 割引率が適用され、その直後に上限が適用されます。「 次の例は、各天井が次の プロモーションの計算は スタック内で行われます

例:

AmountBeforeTax の 1 泊の料金 100 であり、次の 2 つのプロモーションがスタックされています。

1. スタッキング タイプ base のプロモーション fixed_amount / 25、上限 amount_per_night / 60
2. スタッキング タイプ second のプロモーション、 fixed_amount / 25、上限 amount_per_night / 90

計算の順序は次のとおりです。

1. base プロモーションが最初に適用され、割引が適用されます AmountBeforeTax が 75 になったが、その後天井が下がる 60 にします。
2. second のプロモーションで AmountBeforeTax（60 ～ 35）。これは天井の下です 90 に設定されるため、2 つ目の上限は適用されません。最終的なレートは 35。

全体の上限が 60 よりも厳しいという事実は、 そのプロモーションの場合にのみ有効で、 プロモーション スタック全体にまたがり制限を設けることができます。

この期間の終了後に 1 泊の料金を設定できる最大額 適用されます。

<Floor> 要素も指定されている場合、 は amount_per_night 属性: <Floor>。

amount_per_night は、以下の場合に税金と手数料に適用されます。 AmountAfterTax を使用して 1 泊の料金に含まれているが、 TaxFeeInfo で指定されたもの以外）。

レートに設定できる最小値の制限を定義します プロモーション適用後の機能です

プロモーションでは、必ず <Discount> または <BestDailyDiscount>。プロモーションを <Floor> のみを適用する場合、オプションの一つは、 <Discount> と percentage 0。

<Floor> のロジックは引き続き適用対象 <FreeNights> の割引（無料宿泊に 100% の割引が適用されます。

併用が構成されている場合、 <Floor> は 1 回の宿泊に適用されます。各プロモーション 割引率が適用され、その直後に下限が続きます。「 次の例は、各階が次の階数にどのように寄与するかを示しています。 プロモーションの計算は スタック内で行われます

例:

AmountBeforeTax の 1 泊の料金 100 であり、次の 2 つのプロモーションがスタックされています。

1. スタッキング タイプ base のプロモーション fixed_amount / 25、階数 amount_per_night / 90
2. スタッキング タイプ second のプロモーション、 fixed_amount / 25、階数 amount_per_night / 60

計算の順序は次のとおりです。

1. base プロモーションが最初に適用され、割引が適用されます AmountBeforeTax が 75 に引き上げられ、 最大 90。
2. second のプロモーションで AmountBeforeTax（90 ～ 65）。階数を超えています 60 なので 2 階には適用されません。最終的なレートは 65。

全体の最小価格が 90 より高いという事実は そのプロモーションの場合にのみ有効で、 最小価格になります

この期間の終了後に 1 泊の料金を設定できる最小金額 適用されます。

<Ceiling> 要素も指定されている場合、 以下の値に設定する必要があります。 amount_per_night 属性: <Ceiling>。

amount_per_night は、以下の場合に税金と手数料に適用されます。 AmountAfterTax を使用して 1 泊の料金に含まれているが、 TaxFeeInfo で指定されたもの以外）。

プロモーションのチェックインが必要な期間を指定する期間 適用されます。1 つ以上のデータを削除する場合、この要素は必要ありません。 。

YearlessDate 形式もサポートされています。

• start または end のいずれかが年なしの場合 両方とも年なしの日付として入力する必要があります。
• 複数年の年なし期間を設定する場合は、翌年を前後に設定することはできません。代わりに 連続する 2 つの期間として表されます。たとえば {"12-29", "01-05"} は {"12-29", "12-31"} で表すことができます。また、 {"01-01", "01-05"}。

日付範囲内の曜日です。回答が「いいえ」の場合 すべての日付を指定できます。各 日付を指定します。例: 「MTWHF」指定 指定することもできます。

有効な文字は次のとおりです。

• M（月曜日）
• T（火曜日）
• W（水曜日）
• H（木曜日）
• F（金曜日）
• S（土曜日）
• U（日曜日）

任意の文字の組み合わせが有効です。

プロモーションのチェックアウトのタイミングを指定する期間 適用されます。Cloud Logging または Cloud Logging を 1 つ以上のプロモーションの削除

YearlessDate 形式もサポートされています。

• start または end のいずれかが年なしの場合 両方とも年なしの日付として入力する必要があります。
• 複数年の年なし期間を設定する場合は、翌年を前後に設定することはできません。代わりに 連続する 2 つの期間として表されます。たとえば {"12-29", "01-05"} は次のように表すことができます。 {"12-29", "12-31"} と {"01-01", "01-05"}。

日付範囲内の曜日です。回答が「いいえ」の場合 すべての日付を指定できます。各 日付を指定します。例: 「MTWHF」指定 指定することもできます。

有効な文字は次のとおりです。

• M（月曜日）
• T（火曜日）
• W（水曜日）
• H（木曜日）
• F（金曜日）
• S（土曜日）
• U（日曜日）

任意の文字の組み合わせが有効です。

Discount または BestDailyDiscount を指定する必要があります。

このプロモーションに適用する割引を指定します。

percentage、 fixed_amount、fixed_amount_per_night、 fixed_price、または fixed_price_per_night: 必要ありません。

割引率を示す 0 ～ 100 の小数値。 AmountAfterTax（または AmountAfterTax が次の値でない場合は AmountBeforeTax あります）。

例:

• AmountAfterTax が 100 で、percentage の場合 20 の場合、

  プロモーション率 = AmountAfterTax × (1 - 割合 割引）

  80.00 = 100 × (1 - 0.2)

• AmountBeforeTax が 100 の場合、 percentage が 20 で、TaxFeeInfo が税金 10 を指定している場合、 次に

  プロモーション率 = AmountBeforeTax × (1 - 割合 （割引）+ 税金

  90.00 = 100 × (1 - 0.2) + 10

percentage、 fixed_amount、fixed_amount_per_night、 fixed_price、または fixed_price_per_night: 必要ありません。

合計金額から差し引かれる定額です。 AmountAfterTax の 1 泊の料金（または 宿泊料金の合計が AmountBeforeTax の場合 AmountAfterTax を指定しない）。想定値: 1 泊あたりの料金と同じ通貨で表示する必要がありますこの値が 宿泊料金の合計を計算する場合、結果としての値は 0 になります。

例:

• 1 泊の料金なら AmountBeforeTax は 90 です。 AmountAfterTax は 100、fixed_amount は 20 の場合、

  プロモーション レート = AmountAfterTax - 固定 割引

  80.00 = 100 - 20

• 1 泊の料金なら AmountBeforeTax は 100、fixed_amount です が 20、TaxFeeInfo で税金 8% が指定されている場合、

  プロモーション率 =（AmountBeforeTax - 固定） 割引）×（1 + 税額）

  86.40 = (100 - 20) × 1.08

• 1 泊の料金なら AmountBeforeTax は 50、fixed_amount は 60、TaxFeeInfo で税金 10 が指定されている場合、

  プロモーション率 =（AmountBeforeTax - 固定） 割引）× 税

  10.00 = 0 + 10 となります。

• 3 泊の滞在で料金が発生する場合、 AmountAfterTax の値は 100、110、120 です。および fixed_amount が 150 の場合、

  プロモーション率 = sum(AmountAfterTax) - (固定) 割引）

  180.00 = (100 + 110 + 120) - 150

percentage、 fixed_amount、fixed_amount_per_night、 fixed_price、または fixed_price_per_night: 必要ありません。

固定割引が各 AmountAfterTax に適用されます 宿泊料金（ applied_nights が指定されている場合は最安の N）。条件 AmountAfterTax の指定がない場合、適用対象です。 AmountBeforeTax。想定値: 1 泊あたりの料金と同じ通貨で表示する必要があります条件 fixed_amount_per_night は次より大きい: 1 泊あたりの宿泊料金はゼロに減り、 割引によって 1 泊の料金がマイナスになることはありません。

例:

• 3 泊の滞在で料金が発生する場合、 AmountAfterTax の値は 100、110、120 です。および fixed_amount_per_night が 10 の場合、

  プロモーション率 = sum(AmountBeforeTax - 固定額 割引）

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• 3 泊の滞在で料金が発生する場合、 AmountAfterTax の値は 10、50、100 です。および fixed_amount_per_night が 20 の場合、

  プロモーション率 = sum(AmountAfterTax - 固定額 割引）

  110.00 = (0 + (50 - 20) + (100 - 20))

percentage、 fixed_amount、fixed_amount_per_night、 fixed_price、または fixed_price_per_night: 必要ありません。

AmountAfterTax の 1 泊の料金が指定されている場合、 は、宿泊料金（税金と手数料を含む）を 表示されます。AmountBeforeTax が指定されている場合、 AmountAfterTax が指定されているかどうかに関係なく、 宿泊の税抜き価格を値上げします想定値: 1 泊あたりの料金と同じ通貨で表示する必要があります

AmountAfterTax がなんらかのイベントを表す 固定価格を設定する場合は AmountBeforeTaxでは不正確な税金や手数料が発生する可能性があります。 通常は、TaxFeeInfo を使用することを強くおすすめします。 宿泊施設の税金と手数料を指定します。

例:

• 1 泊の料金なら AmountBeforeTax は 90 です。 AmountAfterTax は 100、fixed_price は 80 の場合 プロモーションレートは 80 です
• 1 泊の料金なら AmountBeforeTax は 100、fixed_amount です 80 で、TaxFeeInfo で税金 8% が指定されている場合、

  プロモーションレート = 固定価格 × (1 + 税金)

  86.40 = 80 × 1.08

• 3 泊の滞在で料金が発生する場合、 AmountAfterTax の値は 100、110、120 です。および fixed_amount が 300 の場合、

  プロモーション率 = 300

percentage、 fixed_amount、fixed_amount_per_night、 fixed_price、または fixed_price_per_night: 必要ありません。

AmountAfterTax の 1 泊の料金が指定されている場合、 は、1 泊あたりの宿泊料金（税金と手数料を含む）を 表示されます。AmountBeforeTax が指定されている場合、 AmountAfterTax が指定されているかどうかに関係なく、 1 泊あたりの宿泊料金（税抜きの価格）を、指定された値に加算します。内容 1 泊の料金と同じ通貨を使用するものとみなされます。

AmountAfterTax がなんらかのイベントを表す 固定価格を設定する場合は AmountBeforeTaxでは不正確な税金や手数料が発生する可能性があります。 通常は、TaxFeeInfo を使用することを強くおすすめします。 宿泊施設の税金と手数料を指定します。

applied_nights を指定した場合、新しい価格は次のようになります。 適用されます。

例:

• 2 泊の料金なら AmountBeforeTax の値は 90、90 です。 AmountAfterTax の値は 100、100 です。および fixed_price が 80 の場合、プロモーション料金 80 + 80 = 160 となります。
• 2 泊の料金なら AmountBeforeTax は 100、100 です。fixed_amount 80 で、TaxFeeInfo で税金 8% が指定されている場合、プロモーション率は （80 + 80）× 1.08 = 172.8 となります。
• 3 泊の滞在で料金が発生する場合、 AmountAfterTax の値は 100、110、120 です。および fixed_amount が 110 の場合、プロモーション レートは 110 * 3 です = 330。

これは percentage または fixed_amount_per_night。

割引が適用される宿泊日数 最も安価な方法です1 ～ 99 の整数にする必要があります。指定しない場合、 割引はすべての宿泊に適用されます。

割引を適用するために必要な宿泊日数。各 割引は宿泊の別のセグメントに適用されます。

たとえば、10 泊する場合、stay_nights は 4（かつ repeats が true）の場合、2 泊になります。 セグメント：第 1 夜から第 4 夜、第 5 夜から第 8 夜 9 泊と 10 泊は宿泊セグメントに含まれません。

複数連泊に割引を適用できるかどうか 分割しますfalse の場合、滞在の区分のみ 旅行プランの開始時に割引が適用されますtrue の場合: すべての宿泊日数に割引が適用されます。

たとえば、stay_nights が 4 で旅行プランが 10 の場合 泊数、repeats が true の場合: 2 セグメントには割引料金が適用されます（1 ～ 4 泊と 5 ～ 8 泊）。ただし、 repeatsがfalseの場合、セグメントは 1 つだけ 割引料金（1 ～ 4 泊）。

Discount または BestDailyDiscount を指定する必要があります。

以下の 1 泊に対して適用できる 1 日あたりの割引を指定します。 とどまることだ。これは、次の条件に当てはまる Discount とは対照的です。 滞在日数に応じた割引が適用されます

各宿泊施設には、プロモーションの単一のグループが 「毎日ベスト」と見なされます。つまり、1 泊の宿泊日数で、 シングル「毎日ベスト」収益が最も多いプロモーションは 割引が適用されます。

Stacking は、 BestDailyDiscount。「毎日のベスト」割引率を 1 泊あたりの最も割引率の高い割引が組み合わされ、 宿泊割引（例: Discount）の積み重ねタイプを以下に設定する base。この組み合わせ割引は他の割引率と比較され、 他の対象 <Discount> と併用可能新しい P-MAX キャンペーンを 割引率が最も高くなりますまたは BestDailyDiscount または単一の組み合わせ Discount のうち、価格が低い方を選択して、 base スタッキング タイプに適用されています。

このタイプの割引では StayDates を指定できます。 ただし、application は overlap に設定する必要があります

percentage、 fixed_amount または fixed_price は必須です。

割引率を示す 0 ～ 100 の小数値。 AmountAfterTax（または AmountAfterTax が次の値でない場合は AmountBeforeTax あります）。

例:

• 1 泊の AmountAfterTax が 100 で、 percentage が 20 の場合、

  プロモーション率 = AmountAfterTax × (1 - 割合 割引）

  80.00 = 100 × (1 - 0.2)

• 宿泊の AmountBeforeTax が 100 の場合、 percentage が 20 で、TaxFeeInfo が税金 10 を指定している場合、 次に

  プロモーション率 = AmountBeforeTax × (1 - 割合 （割引）+ 税金

  90.00 = 100 × (1 - 0.2) + 10

percentage、 fixed_amount または fixed_price は必須です。

1 回の取引から差し引かれる定額 AmountAfterTax の 1 泊の料金（または 1 泊あたりの料金: AmountBeforeTax AmountAfterTax を指定しない）。想定値: 1 泊あたりの料金と同じ通貨で表示する必要がありますこの値が 宿泊料金の合計を計算する場合、結果としての値は 0 になります。

例:

• 1 泊の AmountBeforeTax が 90 の場合: AmountAfterTax は 100、fixed_amount は 20 の場合、

  プロモーション レート = AmountAfterTax - 固定 割引

  80.00 = 100 - 20

• 1 泊の AmountBeforeTax が 100 の場合、 fixed_amount が 20 で、TaxFeeInfo が次の税金を指定します。 8%、

  プロモーション率 =（AmountBeforeTax - 固定） 割引）×（1 + 税額）

  86.40 = (100 - 20) × 1.08

percentage、 fixed_amount または fixed_price は必須です。

AmountAfterTax の 1 泊の料金が指定されている場合、 は、1 泊の料金（税金と手数料を含む）を 表示されます。AmountBeforeTax が指定されている場合、 AmountAfterTax が指定されているかどうかに関係なく、 宿泊の税抜き価格を値上げします想定値: 1 泊あたりの料金と同じ通貨で表示する必要があります

例:

• 1 泊の AmountBeforeTax が 90 の場合: AmountAfterTax は 100、fixed_price は 80 の場合 プロモーションレートは 80 です
• 1 泊の AmountBeforeTax が 100 の場合、 fixed_amount が 80 で、TaxFeeInfo が次の税金を指定します。 8%、

  プロモーションレート = 固定価格 × (1 + 税金)

  86.40 = 80 × 1.08

特定の UI をトリガーするメンバーシップ料金ルールのコンテナ 割引が適用されます

次の場合を除き、この要素は指定しないでください。 <Discount> も指定されています。

の ID 料金ルールを定義します。

状況に応じて、複数のプロモーションを 1 つの料金に適用できる 次のように設定されます。

• any: 他のプロモーションと組み合わせることができます（ none など）ですが、プロモーションを適用する順序は 保証されません。
• base: 対象となる base のプロモーションの特典は 他のプロモーションより先に選択、適用されますこれは base_only という名前でした。
• second: 有効な second プロモーション base のプロモーションの後に選択され、適用されます （該当する場合）かつ any プロモーションの前。
• none: 他のオブジェクトと組み合わせることはできません。 。

許可されている組み合わせの中で、プロモーションが 最大割引率が適用されます

プロモーションの適用方法を記述します。

指定できる値は次のとおりです。

• all: プロモーションを 旅行プランのすべての日付が重複している場合は旅行プラン 滞在日が表示されます
• any: プロモーションを 旅行プランのいずれかの日付が 滞在期間。
• overlap: 該当するユーザーにのみプロモーションを適用します。 滞在日の日付と重複する宿泊プランの宿泊日数 あります。

この属性は常に指定する必要があります。

• <Discount> で percentage が指定されている場合 かつ、application が all に設定されているか、または any の場合、割引は フル滞在
• <Discount> で percentage が指定されている場合 application が overlap に設定されている場合は、 割引は、重複する 1 泊の料金の割合として適用されます 利用できます。
• <Discount> で fixed_amount を指定 application を overlap に設定すると、 無効な組み合わせです。
• <FreeNights> はすべてをサポート application 値。overlap の場合、 重複する宿泊日数のみが割引の対象となります 提供します。

プロモーションが適用される日付を指定する期間。

YearlessDate 形式もサポートされています。

• start または end のいずれかが年なしの場合 両方とも年なしの日付として入力する必要があります。
• 複数年の年なし期間を設定する場合は、翌年を前後に設定することはできません。代わりに 連続する 2 つの期間として表されます。たとえば {"12-29", "01-05"} は次のように表すことができます。 {"12-29", "12-31"} と {"01-01", "01-05"}。

日付範囲内の曜日です。回答が「いいえ」の場合 すべての日付を指定できます。各 日付を指定します。例: 「MTWHF」指定 指定することもできます。

有効な文字は次のとおりです。

• M（月曜日）
• T（火曜日）
• W（水曜日）
• H（木曜日）
• F（金曜日）
• S（土曜日）
• U（日曜日）

任意の文字の組み合わせが有効です。

有効な値は include と exclude。

UserCountry の type が include の場合、プロモーションは 記載されています。

UserCountry type が exclude の場合、 リストに記載されている国外のユーザーに適用される 。

UserCountry type が設定されていない場合は、 include。プロモーションは、次の期間のユーザーに適用されます: リストされている国によって異なります。

<Success> または <Issues> が 表示されます。

<Success> または <Issues> が 表示されます。

発生した問題の種類。

有効な値は warning、error、 および failure。