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

ภาพรวม

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