促銷訊息

總覽

促銷訊息會使用 OTA_HotelRateAmountNotifRQ 定義折扣費率規則。每個費率都有定義的促銷活動 並套用允許的最大折扣 頻率。這種訊息類型為選用項目，因此您只需要定義訊息類型 的促銷活動 (適用於系統) 來套用費率折扣。

您可以結合促銷活動，並將其套用至不同的使用者屬性 例如裝置類型 (行動裝置、平板電腦、桌機) 和國家/地區代碼。

重點： 如果有多個促銷活動適用於特定產品費率 (房型類型 + 房價方案 + 可住人數)，則使用者可享有價格最低的促銷活動，或是 並自動套用折扣。

如需各種與宣傳活動相關的範例，請參閱 操作說明。

下列各節涵蓋一般指南、基本範例和操作說明 情境，協助您開始新增及更新促銷活動。

指南規範

本節說明常見的設定指南和特殊指示 促銷活動。

促銷活動時請遵守下列規範：

動作

刪除

在 <Promotion> 元素中使用 delete 動作刪除單一 按 ID 劃分促銷活動

重疊廣告

在 <HotelPromotions> 元素中使用 overlay 動作進行取代 房源的所有促銷活動

差異

如果沒有指定動作，則指定所有指定的促銷活動 在 <HotelPromotions> 內，系統會自動新增或取代。如果促銷活動有該 ID 使用者可能沒有新增或刪除促銷活動，之後便會新增促銷活動。如果 已有 ID 相同的促銷活動，而是以新的定義覆寫。

一般

• 每個房源可有一項或一組促銷活動 促銷活動設有一組條件。您只能在 條件

• 如果只想將促銷活動套用至特定日期、房型或費率 ，然後在該促銷活動的條件中指定。如果 促銷活動不適用於特定日期、房型或房價方案，那麼 不一定要設定這些項目

• 每個促銷活動都與特定房源相關聯。如有相同的促銷活動 如果有多個資源，您必須分別為每個資源傳送代碼。如要指定房源 ID，請使用 <HotelPromotions> 元素的 hotel_id 屬性。

• 你最多可以加入 99 項促銷活動。如要瞭解詳情，請與 Google TAM 聯絡 其他

• 請使用 <Stacking> 元素指定促銷活動的組合方式。變更者： Google 預設使用 base 堆疊類型，表示最合適的 系統會先選取並套用基本促銷活動，然後才套用其他促銷活動。注意事項 「base」只能與 second 或 any 合併使用，且無法合併 與其他 base 或 none 重複。

• 即使有多個促銷活動可同時套用 不過，如果有其他的堆疊，那可能就不是該堆疊 單次宣傳或多組促銷活動，提供更超值的折扣。 折扣最多的促銷活動 (組合) 會套用到預訂 有多個 (組合) 促銷活動符合資格時。

• 每當發生任何會影響成效的變更時，傳送「促銷內容」訊息更新 你的促銷活動。

  重點： 每個資源最多只能有 500 項促銷活動。您可以使用 <Promotions> 訊息，用於移除資源中的促銷活動。

稅務相關

最好的促銷活動 (或一疊促銷活動) 會套用至AmountAfterTax 金額。如果只指定 AmountBeforeTax，則代表促銷活動會 已套用至「AmountBeforeTax」。

範例

本節提供使用必需的「宣傳」訊息基本範例 以及選用的元素檔案準備就緒後，請透過以下方式將檔案傳送給 Google： 傳送到這個端點的 POST 訊息：

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

如要進一步瞭解如何推送/張貼訊息，請參閱 推送訊息。

重點： 每次促銷活動時，都必須傳送最新的促銷訊息給 Google 變更。

為 <HotelPromotions> 的 hotel_id 屬性請使用專屬飯店 ID 您在系統中識別該屬性時使用的名稱這個值必須相符 在 <listing> 中使用 <id> 指定的飯店 ID 元素。與系統的一致性 確認 Google 能正確顯示您的資料。

UserCountry 是用來列出符合資格的使用者位置 (國家/地區) 廣告活動。指定時，只有下列國家/地區的使用者 並提供折扣費率

注意： 您可以選擇是否要設定國家/地區代碼；如未指定，則位於 提供折扣費率。

本例說明如何設定 85% 的長期住宿折扣 美國和義大利的使用者：

<?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 晚提供 20% 折扣 在指定日期範圍內入住。如果是 15 晚的行程， 8 晚折扣為總計 4 晚。

<?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、 或 mobile。

範例

以下範例說明如何指定 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 動作取代促銷活動。

注意： 使用 overlay (而不是使用個別 delete) 是 覆寫某個房源的所有促銷活動。使用 delete (如果只想刪除特定促銷活動) 資源。

範例

以下範例顯示原始 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 取代現有的 兩項促銷活動：一次宣傳房源 95 折優惠。

<?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：如何移除一項或所有促銷活動

說明

您希望移除一個或所有促銷活動 (而非取代)，因為 房源已移除所有促銷活動，但未設定新的促銷活動；或 您遇到了錯誤，需要加以修正。

解決方案

如果只要刪除特定個別使用者，請使用 delete 動作 房源促銷活動，並使用「overlay」(而非 delete) 動作移除 所有現有促銷活動，而不取代其他促銷活動

注意： 使用 overlay (而非個別 delete 動作) 是 覆寫房源所有促銷活動的建議做法。

如要進一步瞭解如何使用 overlay 取代促銷活動，請參閱 情境 3：

範例

以下範例說明如何只刪除房源的一個促銷活動：

<?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，但可與其他促銷活動合併使用。

注意： 折扣最高的促銷活動 (組合) 會套用至 預訂在多個可組合的促銷活動時預訂。

說明

希望使用者能選擇在同一處刊登多項促銷活動 為相同資源所需的時間

解決方案

使用堆疊功能，即可為每個資源設定多項折扣。一個堆疊最多可以 一個 base 和一個 second，但 any 的數量沒有限制；和「any」 與其他類型合併使用，除了 none 以外。

範例

這個範例說明如何堆疊 base、second 和 any 堆疊類型。適用對象 計算 15%、25%、10%、$100 美元的總折扣價 $57.38 美元 (100 × .85 × 0.75 × .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。