ข้อความโปรโมชัน

ภาพรวม

ข้อความโปรโมชันจะกำหนดกฎสำหรับการลดราคาโดยใช้ 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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/POST ข้อความได้ที่ การพุชข้อความ

สำหรับแอตทริบิวต์ 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 เพื่อระบุอุปกรณ์ของผู้ใช้ที่มีสิทธิ์รับโปรโมชัน หากระบุไว้ ระบบจะเสนอราคาที่มีส่วนลดให้เฉพาะผู้ใช้ในอุปกรณ์ที่ระบุ

คำอธิบาย

คุณต้องการระบุประเภทอุปกรณ์ของผู้ใช้ที่มีสิทธิ์รับโปรโมชัน

โซลูชัน

ตั้งค่าประเภทอุปกรณ์เป็นค่าใดค่าหนึ่งต่อไปนี้ 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% ขึ้นไป ระบบจะใช้โปรโมชัน 4 แทนการใช้ร่วมกันของโปรโมชัน 1 ถึง 3