Thông báo khuyến mãi

Tổng quan

Thông báo Chương trình khuyến mãi xác định các quy tắc chiết khấu giá bằng OTA_HotelRateAmountNotifRQ. Đối với mỗi mức giá, các chương trình khuyến mãi đã xác định sẽ được đánh giá và áp dụng mức chiết khấu cao nhất được phép cho mức giá đó. Loại thông báo này là không bắt buộc và bạn chỉ cần xác định chương trình khuyến mãi nếu các chương trình đó được sử dụng trong hệ thống của bạn để áp dụng các khoản chiết khấu theo giá.

Bạn có thể kết hợp các chương trình khuyến mãi và áp dụng cho nhiều thuộc tính người dùng, chẳng hạn như loại thiết bị (điện thoại di động, máy tính bảng, máy tính) và mã quốc gia.

Để biết ví dụ về nhiều tình huống liên quan đến chương trình khuyến mãi, hãy xem Hướng dẫn.

Các phần sau đây trình bày các nguyên tắc chung, ví dụ cơ bản và các trường hợp hướng dẫn để giúp bạn bắt đầu thêm và cập nhật chương trình khuyến mãi.

Nguyên tắc

Phần này trình bày các nguyên tắc chung và hướng dẫn đặc biệt để đặt chương trình khuyến mãi.

Hãy sử dụng các nguyên tắc sau cho chương trình khuyến mãi:

Thao tác

Xoá
Sử dụng thao tác delete trong phần tử <Promotion> để xoá một chương trình khuyến mãi theo mã nhận dạng của chương trình đó.
Lớp phủ
Sử dụng thao tác overlay trong phần tử <HotelPromotions> để thay thế tất cả chương trình khuyến mãi của một cơ sở lưu trú.
Delta
Nếu bạn không chỉ định hành động, thì tất cả các chương trình khuyến mãi được chỉ định trong <HotelPromotions> sẽ được thêm hoặc thay thế. Nếu một chương trình khuyến mãi có mã nhận dạng đó chưa từng được thêm hoặc bị xoá thì chương trình khuyến mãi sẽ được thêm. Nếu tồn tại một chương trình khuyến mãi có mã nhận dạng đó, thì chương trình khuyến mãi đó sẽ bị ghi đè bằng định nghĩa mới.

Giải pháp chung

  • Có thể có một hoặc một nhóm chương trình khuyến mãi cho mỗi cơ sở lưu trú và mỗi chương trình khuyến mãi có một nhóm điều kiện. Bạn chỉ có thể áp dụng chương trình khuyến mãi nếu đáp ứng các điều kiện.

  • Nếu bạn chỉ muốn áp dụng chương trình khuyến mãi cho một ngày, loại phòng hoặc gói giá cụ thể, hãy nêu rõ thông tin đó trong các điều kiện của chương trình khuyến mãi đó. Nếu chương trình khuyến mãi không áp dụng cho một ngày, loại phòng hoặc gói giá cụ thể, thì bạn không cần phải đặt những mục đó.

  • Mỗi chương trình khuyến mãi được liên kết với một cơ sở lưu trú cụ thể. Nếu sử dụng cùng một chương trình khuyến mãi cho nhiều cơ sở lưu trú, bạn phải gửi riêng chương trình khuyến mãi cho từng cơ sở lưu trú. Để chỉ định giá trị nhận dạng thuộc tính, hãy sử dụng thuộc tính hotel_id của phần tử <HotelPromotions>.

  • Bạn có thể thêm tối đa 99 chương trình khuyến mãi. Liên hệ với TAM của Google nếu bạn cần thêm nhiều thông tin hơn.

  • Sử dụng phần tử <Stacking> để chỉ định cách kết hợp các chương trình khuyến mãi. Theo mặc định, Google sử dụng kiểu xếp nhóm base, nghĩa là chương trình khuyến mãi cơ bản đủ điều kiện tốt nhất sẽ được chọn và áp dụng trước, trước các chương trình khuyến mãi khác. Xin lưu ý rằng base chỉ có thể kết hợp với second hoặc any và không thể kết hợp với base hoặc none khác.

  • Ngay cả khi có một tập hợp nhiều chương trình khuyến mãi có thể áp dụng cùng nhau, tập hợp đó có thể không thực sự là tập hợp chương trình khuyến mãi được sử dụng nếu có một chương trình khuyến mãi hoặc nhóm chương trình khuyến mãi khác giảm giá sâu hơn. Chương trình khuyến mãi (tổ hợp) có mức chiết khấu lớn nhất sẽ được áp dụng cho lượt đặt trước khi có nhiều (tổ hợp) chương trình khuyến mãi đủ điều kiện.

  • Gửi thông tin cập nhật về tin nhắn Khuyến mãi mỗi khi có bất kỳ thay đổi nào ảnh hưởng đến chương trình khuyến mãi của bạn.

Chương trình khuyến mãi tốt nhất (hoặc nhiều chương trình khuyến mãi) sẽ được áp dụng cho số tiền AmountAfterTax. Nếu chỉ có AmountBeforeTax được chỉ định thì chương trình khuyến mãi sẽ áp dụng cho AmountBeforeTax.

Ví dụ:

Phần này đưa ra một ví dụ cơ bản về thông báo Khuyến mãi bằng cách sử dụng các phần tử bắt buộc và không bắt buộc. Khi bạn đã chuẩn bị tệp, hãy gửi tệp đó cho Google qua thông báo POST tới điểm cuối này:

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

Để tìm hiểu thêm về cách đẩy/POST thông báo, hãy xem phần Gửi thông báo.

Đối với thuộc tính hotel_id của <HotelPromotions>, hãy sử dụng mã khách sạn duy nhất mà bạn đã dùng trong hệ thống để xác định cơ sở lưu trú. Giá trị này phải khớp với mã khách sạn được chỉ định bằng <id> trong phần tử <listing> trong nguồn cấp dữ liệu Danh sách khách sạn. Tính nhất quán với hệ thống của bạn rất quan trọng để đảm bảo rằng Google hiển thị chính xác dữ liệu của bạn.

UserCountry dùng để liệt kê vị trí của người dùng (quốc gia) đủ điều kiện hưởng chương trình khuyến mãi. Nếu bạn xác định, chỉ người dùng ở các quốc gia trong danh sách mới được hưởng mức giá chiết khấu.

Dưới đây là ví dụ cho biết cách đặt chiết khấu 15% cho thời gian lưu trú dài hạn đối với người dùng ở Hoa Kỳ và Ý:

<?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>

Để biết thêm ví dụ, hãy xem Ví dụ về chương trình khuyến mãi.

Hướng dẫn

Phần này đưa ra giải pháp cho các trường hợp bạn có thể gặp phải khi đặt chương trình khuyến mãi.

Trường hợp 1: Cách thêm chương trình khuyến mãi chiết khấu cho thời gian lưu trú dài hạn

Nội dung mô tả

Bạn muốn cung cấp số đêm giảm giá cho một số ngày lưu trú dài hạn.

Giải pháp

Sử dụng chế độ cài đặt FreeNights để tuỳ chỉnh loại chiết khấu được áp dụng tuỳ theo số đêm lưu trú.

Mẫu

Mẫu này cho biết cách thêm chiết khấu 20% cho 2 đêm đối với mỗi 7 đêm lưu trú trong phạm vi ngày đặt phòng đã chỉ định. Đối với hành trình 15 đêm, mức chiết khấu 20% được áp dụng cho tổng cộng 4 đêm.

<?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>

Trường hợp 2: Cách đặt loại thiết bị

Bạn đặt devices để chỉ định thiết bị của người dùng đủ điều kiện cho chương trình khuyến mãi. Nếu bạn xác định, chỉ những người dùng có trong danh sách mới được hưởng mức giá chiết khấu.

Nội dung mô tả

Bạn muốn chỉ định loại thiết bị của người dùng đủ điều kiện cho chương trình khuyến mãi.

Giải pháp

Đặt loại thiết bị thành một hoặc nhiều giá trị sau: desktop, tablet hoặc mobile.

Mẫu

Mẫu sau đây cho biết cách chỉ định mức chiết khấu 25% cho người dùng thiết bị di động và máy tính bảng:

<?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>

Trường hợp 3: Cách thay thế chương trình khuyến mãi cũ bằng chương trình khuyến mãi mới

Nội dung mô tả

Nhóm chương trình khuyến mãi hiện tại cho một cơ sở lưu trú đã cũ hoặc không chính xác và cần được thay thế bằng một nhóm hoàn toàn mới.

Giải pháp

Sử dụng thao tác overlay để thay thế chương trình khuyến mãi.

Mẫu

Mẫu sau đây cho thấy hai khoản chiết khấu ban đầu là 20% và 30% của cơ sở lưu trú.

<?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>

Sau đó, mẫu này cho biết cách sử dụng overlay để thay thế 2 chương trình khuyến mãi hiện có bằng một chương trình khuyến mãi duy nhất chiết khấu 15% cho cơ sở lưu trú.

<?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>

Trường hợp 4: Cách xoá một hoặc tất cả chương trình khuyến mãi

Nội dung mô tả

Bạn muốn xoá một hoặc tất cả chương trình khuyến mãi (không thay thế) vì cơ sở lưu trú đã xoá tất cả chương trình khuyến mãi mà không đặt chương trình khuyến mãi mới, hoặc bạn đã mắc lỗi và cần sửa lỗi.

Giải pháp

Hãy sử dụng thao tác delete nếu bạn chỉ muốn xoá từng chương trình khuyến mãi riêng lẻ của một cơ sở lưu trú và sử dụng thao tác overlay (không phải delete) để xoá tất cả các chương trình khuyến mãi hiện có mà không cần thay thế.

Để biết thông tin chi tiết về cách thay thế các chương trình khuyến mãi bằng overlay, hãy xem Tình huống 3.

Mẫu

Mẫu sau đây trình bày cách chỉ xoá một chương trình khuyến mãi của một cơ sở lưu trú:

<?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>

Mẫu này cho biết cách xoá tất cả chương trình khuyến mãi mà không cần thay thế một cơ sở lưu trú:

<?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>

Trường hợp 5: Cách xếp nhóm chương trình khuyến mãi

Tính năng xếp chồng chỉ định cách kết hợp các chương trình khuyến mãi. Nếu không chỉ định, type sẽ được giả định là base, nghĩa là chương trình khuyến mãi cơ bản đủ điều kiện tốt nhất sẽ được chọn và áp dụng đầu tiên, trước các chương trình khuyến mãi khác. Khi thuộc tính type của Stacking là any, bạn có thể kết hợp thuộc tính này với bất kỳ chương trình khuyến mãi nào khác.

Nội dung mô tả

Bạn muốn người dùng có thể sử dụng nhiều chương trình khuyến mãi cùng lúc cho cùng một cơ sở lưu trú.

Giải pháp

Hãy sử dụng tính năng xếp nhóm để đặt nhiều khoản chiết khấu cho mỗi cơ sở lưu trú. Một ngăn xếp có thể có tối đa một base và một second nhưng không giới hạn số lượng any; đồng thời có thể kết hợp any với các loại khác ngoại trừ none.

Mẫu

Mẫu này cho thấy cách xếp chồng base, second và any Các loại xếp chồng. Đối với khoản chiết khấu kết hợp 15%, 25%, 10%, giá 100 USD là tổng cộng 57,38 USD (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>

Xin lưu ý rằng mức chiết khấu kết hợp cho các chương trình khuyến mãi gộp từ 1 đến 3 sẽ tốt hơn mức chiết khấu cho chương trình khuyến mãi 4. Bạn không thể kết hợp chương trình khuyến mãi 4 với các chương trình khuyến mãi khác do loại chương trình khuyến mãi (none). Nếu chương trình khuyến mãi 4 có mức chiết khấu từ 43% trở lên, bạn sẽ sử dụng chương trình khuyến mãi này thay vì kết hợp các chương trình khuyến mãi từ 1 đến 3.