ภาพรวม
ข้อความโปรโมชันจะกำหนดกฎสำหรับการลดราคาโดยใช้ OTA_HotelRateAmountNotifRQ
สำหรับแต่ละราคา ระบบจะประเมินโปรโมชันที่ระบุไว้ และจะใช้ส่วนลดสูงสุดที่อนุญาตกับอัตราดังกล่าว ข้อความประเภทนี้เป็นตัวเลือกที่ไม่บังคับ และคุณจะต้องกำหนดโปรโมชันเฉพาะในกรณีที่ใช้ในระบบของคุณเพื่อใช้ส่วนลดราคา
คุณรวมโปรโมชันและนำไปใช้กับแอตทริบิวต์ผู้ใช้ต่างๆ ได้ เช่น ประเภทอุปกรณ์ (มือถือ แท็บเล็ต เดสก์ท็อป) และรหัสประเทศ
ดูตัวอย่างสถานการณ์ต่างๆ ที่เกี่ยวข้องกับโปรโมชันได้ในวิธีการ
ส่วนต่อไปนี้จะอธิบายถึงหลักเกณฑ์ทั่วไป ตัวอย่างพื้นฐาน และสถานการณ์วิธีการเพื่อเริ่มต้นเพิ่มและอัปเดตโปรโมชัน
หลักเกณฑ์
ส่วนนี้ครอบคลุมหลักเกณฑ์ทั่วไปและคำแนะนำพิเศษในการตั้งค่าโปรโมชัน
ใช้หลักเกณฑ์ต่อไปนี้สำหรับโปรโมชัน
การดำเนินการ
- ลบ
- ใช้การดำเนินการ
delete
ในองค์ประกอบ<Promotion>
เพื่อลบโปรโมชันเดียวโดยใช้รหัสโปรโมชัน - ซ้อนทับ
- ใช้การดำเนินการ
overlay
ในองค์ประกอบ<HotelPromotions>
เพื่อแทนที่โปรโมชันทั้งหมดสำหรับพร็อพเพอร์ตี้ - เดลต้า
- หากไม่ได้ระบุการดำเนินการ ระบบจะเพิ่มหรือแทนที่โปรโมชันทั้งหมดที่ระบุภายใน
<HotelPromotions>
หากโปรโมชันที่มีรหัสดังกล่าวยังไม่เคยมีการเพิ่มหรือลบไปแล้ว ระบบจะเพิ่มโปรโมชันนั้น หากมีโปรโมชันที่มีรหัสนั้นอยู่ ระบบจะเขียนทับโปรโมชันดังกล่าวด้วยคำจำกัดความใหม่
ทั่วไป
พร็อพเพอร์ตี้แต่ละรายการอาจมีโปรโมชันเพียงชุดเดียวหรือชุดเดียว โดยแต่ละโปรโมชันจะมีชุดเงื่อนไข คุณจะใช้โปรโมชันดังกล่าวได้ก็ต่อเมื่อเป็นไปตามเงื่อนไขเท่านั้น
หากต้องการใช้โปรโมชันกับวันที่ ประเภทห้องพัก หรือแพ็กเกจราคาที่เจาะจงเท่านั้น ให้ระบุในเงื่อนไขของโปรโมชันนั้นๆ หากโปรโมชันไม่มีผลกับวันที่ ประเภทห้องพัก หรือแพ็กเกจราคาที่เจาะจง คุณก็ไม่จำเป็นต้องตั้งค่าโปรโมชันเหล่านั้น
โปรโมชันแต่ละรายการเชื่อมโยงกับพร็อพเพอร์ตี้ที่เฉพาะเจาะจง หากใช้โปรโมชันเดียวกันสำหรับที่พักหลายรายการ คุณต้องส่งโปรโมชันดังกล่าวสำหรับแต่ละที่พักแยกกัน หากต้องการระบุตัวระบุที่พัก ให้ใช้แอตทริบิวต์
hotel_id
ขององค์ประกอบ<HotelPromotions>
คุณเพิ่มโปรโมชันได้สูงสุด 99 รายการ โปรดติดต่อ TAM ของ Google หากคุณต้องการใส่มากกว่านี้
ใช้องค์ประกอบ
<Stacking>
เพื่อระบุวิธีรวมโปรโมชัน โดยค่าเริ่มต้น Google จะใช้ประเภทการซ้อนbase
ซึ่งหมายความว่าระบบจะเลือกและใช้โปรโมชันฐานที่มีสิทธิ์ที่ดีที่สุดก่อนโปรโมชันอื่นๆ โปรดทราบว่าbase
ใช้ร่วมกับsecond
หรือany
ได้เท่านั้น และจะใช้ร่วมกับbase
หรือnone
อื่นไม่ได้แม้จะมีกลุ่มโปรโมชันหลายรายการที่ใช้ด้วยกันได้ แต่จริงๆ แล้วกลุ่มดังกล่าวอาจไม่ได้ใช้อยู่หากมีโปรโมชันรายการเดียวหรือโปรโมชันกลุ่มอื่นที่ให้ส่วนลดน้อยกว่า ระบบจะใช้โปรโมชัน (ชุดค่าผสม) ที่มีส่วนลดมากที่สุดกับการจองเมื่อโปรโมชันหลายรายการ (ชุดค่าผสมของ) มีสิทธิ์
ส่งข้อความอัปเดตเมื่อมีการเปลี่ยนแปลงที่ส่งผลกระทบต่อการโปรโมต
เกี่ยวกับภาษี
โปรโมชันที่ดีที่สุด (หรือกลุ่มโปรโมชัน) ใช้กับจำนวนเงิน AmountAfterTax
หากระบุเพียง AmountBeforeTax
เท่านั้น ระบบจะใช้โปรโมชันกับ AmountBeforeTax
ตัวอย่าง
ส่วนนี้เป็นตัวอย่างพื้นฐานของข้อความโปรโมชันที่ใช้องค์ประกอบที่จำเป็นและที่ไม่บังคับ เมื่อเตรียมไฟล์เรียบร้อยแล้ว ให้ส่งไฟล์ไปยัง Google ผ่านข้อความ POST ไปยังปลายทางนี้
https://www.google.com/travel/hotels/uploads/promotions
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/โพสต์ข้อความได้ที่ข้อความพุช
สำหรับแอตทริบิวต์ hotel_id
ของ <HotelPromotions>
ให้ใช้รหัสโรงแรมที่ไม่ซ้ำกันที่คุณใช้ในระบบเพื่อระบุที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id>
ในองค์ประกอบ <listing>
ในฟีดข้อมูลโรงแรม ความสอดคล้องกันของระบบของคุณเป็นสิ่งสำคัญที่ทำให้มั่นใจได้ว่า Google จะแสดงข้อมูลของคุณอย่างถูกต้อง
UserCountry
มีไว้สำหรับการแสดงสถานที่ตั้งของผู้ใช้ (ประเทศ) ที่มีสิทธิ์สำหรับโปรโมชัน หากระบุไว้ เฉพาะผู้ใช้ในประเทศที่ระบุไว้เท่านั้นที่จะได้รับข้อเสนอราคาหลังหักส่วนลด
ตัวอย่างนี้แสดงวิธีตั้งค่าส่วนลด 15% สำหรับการเข้าพักระยะยาวสำหรับผู้ใช้ในสหรัฐอเมริกาและอิตาลี
<?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
เพื่อปรับแต่งประเภทส่วนลดที่จะใช้โดยขึ้นอยู่กับจำนวนคืนการเข้าพัก
ตัวอย่าง
ตัวอย่างนี้แสดงวิธีเพิ่มส่วนลด 20% สำหรับ 2 คืนสำหรับการเข้าพัก 7 คืนในช่วงวันที่การจองที่ระบุไว้ สำหรับแผนการเดินทาง 15 คืน ส่วนลด 20% สำหรับห้องพักทั้งหมด 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
เพื่อระบุอุปกรณ์ของผู้ใช้ที่มีสิทธิ์สำหรับโปรโมชัน หากระบุไว้ เฉพาะผู้ใช้ในอุปกรณ์ที่ระบุไว้เท่านั้นที่จะได้รับส่วนลด
คำอธิบาย
คุณต้องการระบุประเภทอุปกรณ์ของผู้ใช้ที่มีสิทธิ์สำหรับโปรโมชัน
โซลูชัน
ตั้งค่าประเภทอุปกรณ์เป็นค่าต่อไปนี้อย่างน้อย 1 ค่า: 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
เพื่อแทนที่โปรโมชัน
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงส่วนลด 2 รายการเดิม 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
เพื่อแทนที่โปรโมชัน 2 รายการที่มีอยู่ด้วยโปรโมชันเดียว นั่นคือส่วนลด 15% สำหรับที่พัก
<?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: วิธีนำโปรโมชัน 1 รายการหรือทั้งหมดออก
คำอธิบาย
คุณต้องการนำโปรโมชันอย่างน้อย 1 รายการออก (ไม่มีการแทนที่) เนื่องจากพร็อพเพอร์ตี้ได้นำโปรโมชันของพร็อพเพอร์ตี้ทั้งหมดออกโดยไม่ได้ตั้งค่าโปรโมชันใหม่ หรือคุณมีข้อผิดพลาดและจำเป็นต้องแก้ไข
โซลูชัน
ใช้การดำเนินการ 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
ได้สูงสุด 1 รายการ แต่ไม่จำกัดจำนวน any
และรวม any
กับประเภทอื่นๆ ได้ ยกเว้น none
ตัวอย่าง
ตัวอย่างนี้แสดงวิธีกองซ้อนประเภท base
, second
และ any
สำหรับส่วนลดรวม 15%, 25%, 10% ราคา $100 จะเท่ากับ
$57.38 (100 × .85 × .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