Tổng quan
Thông báo Khuyến mãi xác định các quy tắc chiết khấu sử dụng
OTA_HotelRateAmountNotifRQ
. Đối với mỗi mức giá, các chương trình khuyến mãi đã xác định
được đánh giá và mức chiết khấu cao nhất được phép áp dụng cho
. Loại thông báo này là không bắt buộc và bạn chỉ cần xác định
khuyến mãi nếu chúng được dùng trong hệ thống của bạn để áp dụng 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 các thuộc tính người dùng khác nhau, 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 trường hợp 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à hướng dẫn về cách thức để 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 đề cập đến các nguyên tắc chung và hướng dẫn đặc biệt để cài đặt chương trình khuyến mãi.
Hãy làm theo các nguyên tắc sau đây cho chương trình khuyến mãi:
Thao tác
- Xoá
- Sử dụng hành động
delete
trong phần tử<Promotion>
để xoá một phần tử quảng bá theo mã nhận dạng. - Lớp phủ
- Sử dụng hành động
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 nào thì tất cả chương trình khuyến mãi được chỉ định
trong
<HotelPromotions>
được thêm hoặc thay thế. Nếu chương trình khuyến mãi có mã đó chưa từng được thêm hoặc bị xoá, thì quảng cáo sẽ được thêm. Nếu một chương trình khuyến mãi có mã đó sẽ bị ghi đè bằng định nghĩa mới.
Giải pháp chung
Mỗi cơ sở lưu trú có thể có một hoặc một nhóm chương trình khuyến mãi và mỗi chương trình khuyến mãi có một nhóm điều kiện. Chương trình khuyến mãi đó chỉ có thể được áp dụng nếu điều kiện được thoả mãn.
Nếu bạn muốn một chương trình khuyến mãi chỉ áp dụng cho một ngày, loại phòng hoặc gói giá cụ thể, hãy chỉ định điều đó 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ể, sau đó bạn không cần thiết lập.
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 bạn sử dụng cùng một chương trình khuyến mãi cho nhiều tài sản, thì bạn phải gửi dữ liệu riêng biệt cho từng tài sản. Người nhận chỉ định mã nhận dạng thuộc tính, hãy sử dụng thuộc tính
hotel_id
của thuộc tính Phần tử<HotelPromotions>
.Bạn có thể thêm tối đa 99 chương trình khuyến mãi. Hãy liên hệ với Nhà quản lý hỗ trợ kỹ thuật cho Google (TAM) của bạn nếu bạn cần bao gồm nhiều nội dung hơn thế.
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 chồngbase
, nghĩa là phương thức chương trình khuyến mãi cơ bản sẽ được chọn và áp dụng trước tiên, trước các chương trình khuyến mãi khác. Ghi chú rằngbase
chỉ có thể kết hợp vớisecond
hoặcany
và không thể kết hợp được với mộtbase
hoặcnone
khác.Ngay cả khi có một nhóm gồm nhiều chương trình khuyến mãi có thể được áp dụng cùng nhau, thì nhóm đó có thể không thực sự là nhóm đượ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 cung cấp mức chiết khấu sâu hơn. Chiến lược phát hành đĩa đơn chương trình khuyến mãi (kết hợp) có mức chiết khấu cao nhất được áp dụng cho lượt đặt trước khi nhiều (kế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 Quảng cáo bất cứ khi nào có thay đổi nào đó làm ảnh hưởng đến chương trình khuyến mãi của mình.
Liên quan đến thuế
Chương trình khuyến mãi tốt nhất (hoặc nhóm chương trình khuyến mãi) được áp dụng cho AmountAfterTax
số tiền. Nếu bạn chỉ chỉ định AmountBeforeTax
thì chương trình khuyến mãi sẽ được
đã áp dụng cho AmountBeforeTax
.
Ví dụ:
Phần này cung cấp ví dụ cơ bản về một thông báo Quảng cáo sử dụng thông báo bắt buộc và các phần tử không bắt buộc. Khi bạn đã chuẩn bị xong tệp, hãy gửi tệp đó cho Google thông qua thông báo POST đến đ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 Thông báo đẩy.
Đố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 đã sử dụng trong hệ thống để xác định thuộc tính. Giá trị này phải khớp
Mã khách sạn được chỉ định bằng <id>
trong <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 là điều rất quan trọng đối với
đảm bảo rằng Google đang 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
cho chương trình khuyến mãi. Nếu được chỉ định, chỉ người dùng ở các quốc gia được liệt kê mới
được hưởng mức giá chiết khấu.
Ví dụ này minh hoạ cách đặt mức 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ề quảng cáo.
Hướng dẫn
Phần này cung cấp giải pháp cho các tình huống mà 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
Mô tả
Bạn muốn cung cấp số đêm chiết khấu vào một số ngày nhất định trong thời gian 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ỳ thuộc vào số đêm lưu trú.
Mẫu
Mẫu này cho biết cách thêm mức 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, Chiết khấu 20% á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 những thiết bị của người dùng đủ điều kiện cho
quảng cáo. Nếu bạn chỉ định, ứng dụng chỉ cung cấp dịch vụ này cho những người dùng trên các thiết bị được liệt kê
mức giá chiết khấu.
Mô tả
Bạn muốn chỉ định loại thiết bị của người dùng đủ điều kiện tham gia 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 trình bày cách đặt mức chiết khấu 25% cho thiết bị di động và người dùng 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
Mô tả
Nhóm chương trình khuyến mãi hiện tại cho một cơ sở lưu trú đã lỗi thời hoặc không chính xác và cần được thay thế bằng một tập hợp hoàn toàn mới.
Giải pháp
Sử dụng thao tác overlay
để thay thế các chương trình khuyến mãi.
Mẫu
Mẫu sau đây trình bày hai mức chiết khấu ban đầu là 20% và 30% cho 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ế
hai chương trình khuyến mãi cùng một chương trình khuyến mãi giảm giá 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
Mô tả
Bạn muốn xoá một hoặc tất cả chương trình khuyến mãi (mà không cần thay thế) vì cơ sở lưu trú đã xoá tất cả chương trình khuyến mãi của mình 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
Sử dụng thao tác delete
nếu bạn chỉ muốn xoá một cá nhân cụ thể
quảng cáo cho cơ sở lưu trú và sử dụng thao tác overlay
(không phải delete
) để xoá
tất 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ế 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 hướng dẫn cách xoá tất cả chương trình khuyến mãi mà không thay thế cho 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 sắp xếp các 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 được chỉ định, type
được giả định là base
, tức là chương trình khuyến mãi cơ sở đủ điều kiện tốt nhất là
đượ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
, thuộc tính này có thể được kết hợp với bất kỳ chương trình khuyến mãi nào khác.
Mô tả
Bạn muốn người dùng có thể chọn sử dụng nhiều chương trình khuyến mãi cùng một lúc cho cùng một thuộc tính.
Giải pháp
Sử dụng tính năng xếp chồng để đặt nhiều mức 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
; và any
có thể
được kết hợp với các loại khác, ngoại trừ none
.
Mẫu
Mẫu này trình bày cách xếp chồng các kiểu xếp chồng base
, second
và any
. Để
Chiết khấu 15%, 25%, 10%, tổng giá trị 100.000 VND là
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 khoản chiết khấu kết hợp cho các chương trình khuyến mãi xếp chồng từ 1 đến 3 là
tốt hơn mức chiết khấu cho chương trình khuyến mãi 4. 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 kiểu xếp chồng (none
). Nếu khuyến mãi 4 có
tỷ lệ chiết khấu 43% trở lên, thì tỷ lệ này sẽ được sử dụng thay cho kết hợp
khuyến mãi 1 đến 3.