プロモーション

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 日前までに変更できます

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

• Integer: チェックイン日までの日数。たとえば、値 30 は、 プロモーションは、 チェックイン日。
• ISO 8601 の期間（日数、時間、分）: チェックイン日までの日数（オプションで時間 / 分）。対象 たとえば、値 P30D は、プロモーションのみが は、チェックイン日の 30 日前までの予約に適用されます。値 P30DT6H は、到着日の 30 日前の 18:00 以降に予約する必要があることを示します。

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

プロモーションでは、必ず <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 より高いという事実は そのプロモーションの場合にのみ有効で、 最小価格になります

割引が適用された後の宿泊料金の最小額。

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

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 または Google Cloud を 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 のいずれか 1 つのみが必要です。

割引率を示す 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。宿泊料金と同じ通貨であるとみなされます。条件 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 のいずれか 1 つのみが必要です。

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 の場合、

  promotion rate = 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 泊あたりの割引料金が適用される場合があります。これは、滞在全体に割引を適用する Discount とは対照的です。

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

Stacking は、次で指定できます。 BestDailyDiscount。次のいずれかに設定する必要があります base または none。「毎日のベスト」割引 各泊で最も割引率の高いデータを組み合わせて 1 泊あたりの割引（例: Discount） 構成済みのスタッキング タイプ。この組み合わせ割引は、他の対象となる <Discount> プロモーションと比較され、併用することもできます。これにより、最も割引率の高いプロモーションまたは組み合わせが見つかります。BestDailyDiscount または 単一の Discount のうち、いずれか低い方の価格が、 base スタッキング タイプに対して選択され、適用されています。

このタイプの割引では StayDates を指定できます。 ただし、application は overlap

percentage、fixed_amount、fixed_price のいずれか 1 つのみが必要です。

割引率を指定する 0～100 の 10 進値。AmountAfterTax（または AmountAfterTax が次の値でない場合は AmountBeforeTax あります）。

例:

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

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

  80.00 = 100 × (1 - 0.2)

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

  プロモーション料金 = AmountBeforeTax x (1 - 割引率) + 税金

  90.00 = 100 × (1 - 0.2) + 10

percentage、fixed_amount、fixed_price のいずれか 1 つのみが必要です。

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

例:

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

  プロモーション料金 = AmountAfterTax - 固定割引

  80.00 = 100 - 20

• 1 泊の AmountBeforeTax が 100、fixed_amount が 20、TaxFeeInfo で税率 8% を指定する場合:

  プロモーション料金 = (AmountBeforeTax - 固定割引) x (1 + 税率)

  86.40 = (100 - 20) × 1.08

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

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

例:

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

  プロモーション料金 = 固定価格 x (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"}。

StayDates の期間を設定して、特定の曜日にプロモーションを許可する場合は、プロモーションが期限切れにならないように、start の日付を現在の日付として設定し、end を指定しないでください。

次の場合は start 値を指定する必要があります。 end の値が指定されていません。

次の場合は end 値を指定する必要があります。 start の値が指定されていません。

日付範囲内の曜日です。回答が「いいえ」の場合 すべての日付を指定できます。文字列の各文字で曜日を指定します。例: 「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 です。