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

ภาพรวม

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

คำอธิบาย

คุณต้องการนำโปรโมชันรายการเดียวหรือทั้งหมดออก (โดยไม่แทนที่) เนื่องจาก ที่พักได้นำโปรโมชันทั้งหมดออกโดยไม่ตั้งค่าโปรโมชันใหม่ หรือ คุณทำผิดพลาด และต้องแก้ไขให้ถูกต้อง

โซลูชัน

ใช้การดำเนินการ 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 และนำไปรวมกับโปรโมชันอื่นๆ ได้

คำอธิบาย

คุณต้องการให้ผู้ใช้มีตัวเลือกในการใช้โปรโมชันหลายรายการพร้อมกัน สำหรับพร็อพเพอร์ตี้เดียวกัน

โซลูชัน

ใช้การกองซ้อนเพื่อตั้งค่าส่วนลดหลายรายการต่อที่พัก สแต็กมีค่าได้สูงสุด 1 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