ภาพรวม
ข้อความราคา (OTA_HotelRateAmountNotifRQ
) จะเป็นตัวกำหนดอัตราการเข้าพักต่อคืนสำหรับชุดค่าผสมของห้องพักและแพ็กเกจราคาแต่ละประเภทในช่วงวันที่ที่เฉพาะเจาะจง Google รองรับราคาตามอัตราการเข้าพัก ซึ่งเป็นส่วนหนึ่งของข้อความอัตรา ซึ่งทําให้ระบุราคาต่อคืนที่แตกต่างกันตามจำนวนสูงสุดของผู้เข้าพักที่ต้องการได้
ส่วนต่อไปนี้จะครอบคลุมหลักเกณฑ์ทั่วไป ตัวอย่างพื้นฐาน และวิธีดำเนินการต่างๆ เพื่อช่วยให้คุณเริ่มต้นเพิ่มและอัปเดตราคาและส่งข้อความเกี่ยวกับราคา
ลักษณะอัตราการจับคู่
เมื่อผู้ใช้ขออัตราการเข้าพักที่เฉพาะเจาะจง อัตราที่ผู้ใช้เห็นจะขึ้นอยู่กับวิธีที่คุณกําหนดราคาในข้อความราคา ส่วนนี้จะครอบคลุมวิธีจับคู่คำขอของผู้ใช้เหล่านี้กับราคาของคุณโดยขึ้นอยู่กับอัตราการเข้าพักของคำขอและราคาที่คุณกำหนด
หลักการสำคัญ
ราคาที่กำหนดไว้สำหรับอัตราการเข้าพักที่เฉพาะเจาะจงจะมีผลกับอัตราการเข้าพักน้อยกว่าทั้งหมด เว้นแต่จะกำหนดไว้เป็นอย่างอื่น
คำขออัตราการเข้าพักที่สูงกว่าที่กำหนดไว้จะถือว่าไม่มีสิทธิ์
โดยการกำหนดราคาตามอัตราการเข้าพักจะใช้กับทั้งรูปแบบการกำหนดราคาตามวันที่และรูปแบบราคาตาม LOS ตามที่อธิบายไว้ด้านล่าง ซึ่งหมายความว่าคุณจะระบุราคาสำหรับอัตราการเข้าพักแต่ละรายการได้ หากไม่มีราคาสำหรับอัตราการเข้าพักที่เฉพาะเจาะจง ระบบจะใช้ราคาสำหรับอัตราการเข้าพักสูงสุดถัดไป นอกจากนี้ คุณอาจกำหนดค่าบริการสำหรับแขกที่เข้าพักเพิ่มเติมและเด็กโดยใช้
AdditionalGuestAmounts
หรือExtraGuestCharges
ซึ่งคิดตามจำนวนความจุที่กำหนดไว้สำหรับห้องพัก
ข้อดีและตัวอย่าง
- ประสิทธิภาพ
สำหรับอัตราการเข้าพักหลายรายการที่มีราคาเท่ากัน คุณไม่จำเป็นต้องกำหนดราคาสำหรับอัตราการเข้าพักแต่ละรายการ คุณลดความซับซ้อนของข้อความได้โดยการตั้งค่าเฉพาะค่าอัตราการเข้าพักสูงสุดซึ่งประเภทห้องพักและแพ็กเกจราคารองรับ ผู้ใช้จะเห็นราคาสำหรับอัตราการเข้าพักแต่ละรายการน้อยกว่าหรือเท่ากับค่าที่คุณตั้งไว้
ตัวอย่าง: ราคาสำหรับประเภทห้องพักและแพ็กเกจราคาเหมือนกันสำหรับอัตราการเข้าพักตั้งแต่ 1-4 ใช้ข้อความราคาเพื่อตั้ง 1 อัตราสำหรับอัตราการเข้าพักสูงสุด 4 คน ผู้ใช้ที่ค้นหาอัตราการเข้าพักคนเดียว คู่ และ 3 คน จะเห็นราคาเดียวกัน ผู้ใช้ที่ค้นหาตั้งแต่ 5 ขึ้นไปจะไม่เห็นราคา
- ควบคุม
คุณระบุราคาที่แตกต่างกันสำหรับอัตราการเข้าพักทางเลือกได้อย่างชัดแจ้ง ส่งราคาที่แตกต่างกันสำหรับค่าอัตราการเข้าพักแต่ละรายการหากต้องการควบคุมวิธีที่ Google จับคู่คำขอกับอัตราการเข้าพักได้มากขึ้น
ตัวอย่าง: หากกําหนดราคาสําหรับอัตราการเข้าพัก 3 และ 1 การค้นหาอัตราการเข้าพักคนเดียวจะแสดงราคาสําหรับคนโสด การค้นหาอัตราการเข้าพักแบบคู่จะแสดงอัตราการเข้าพัก 3 คน และผู้ใช้ที่กำลังค้นหา 4 คนขึ้นไปจะไม่เห็นราคา
ดูตัวอย่างสถานการณ์ต่างๆ ที่เกี่ยวข้องกับราคาเพิ่มเติมได้ในวิธีการ
องค์ประกอบที่จำเป็นและไม่บังคับ
การอ้างอิง XML ให้คำอธิบายขององค์ประกอบที่จำเป็นและที่ไม่บังคับ ดูรายละเอียดเกี่ยวกับแอตทริบิวต์และองค์ประกอบย่อยได้ที่องค์ประกอบราคาและแอตทริบิวต์
ไวยากรณ์และสคีมา
ใช้ตัวอย่างไวยากรณ์ราคาเป็นข้อมูลอ้างอิงเมื่อคุณสร้างข้อความราคาเพื่อให้แน่ใจว่าคุณทำตามรูปแบบที่ถูกต้อง
คุณจะใช้เครื่องมือ XML ของบุคคลที่สาม เช่น xmllint เพื่อตรวจสอบฟีดด้วยสคีมาที่เผยแพร่ก่อนส่งไปยัง Google ได้ สำหรับสคีมาข้อความราคา โปรดดูสคีมา Hotel Ads
รูปแบบการกำหนดราคา
ราคาต่อวัน
นี่คือรูปแบบราคามาตรฐานที่ใช้สำหรับที่พักส่วนใหญ่ รูปแบบราคา per-date
จะอิงตามการกำหนดราคาซึ่งสรุปจากวันที่เข้าพักเพื่อให้ถึงราคารวม ในรูปแบบนี้ ระบบจะตีความราคาทั้งหมดภายใต้องค์ประกอบ Rate
ว่ามีผลกับช่วงวันที่เข้าพักที่ระบุใน <StatusApplicationControl>
ราคาที่อิงตาม LOS
รูปแบบราคาตาม LOS (ระยะเวลาเข้าพัก) จะอิงตามราคาที่กำหนดไว้สำหรับชุดค่าผสมของวันที่มาถึงและระยะเวลาในการเข้าพัก ราคาที่ระบุภายใต้รูปแบบการกำหนดราคาตาม LOS จะเป็นราคาต่อวัน เช่น หากคุณส่งราคา 3,000 บาทสำหรับการเข้าพัก 3 คน ระบบจะคำนวณราคารวมเป็น 3x$100=$300
คุณใช้รูปแบบการกำหนดราคาแบบ LOS ได้โดยการระบุ RatePlanType="26"
ในองค์ประกอบ StatusApplicationControl
นอกจากนี้คุณยังต้องตั้งค่าแอตทริบิวต์ RateTimeUnit
และ UnitMultiplier
ในองค์ประกอบ Rate
ใน XML อีกด้วย การดำเนินการนี้จะทำให้ราคาทั้งหมดภายใต้องค์ประกอบ Rate
ที่ระบุมีผลกับการเข้าพักซึ่งระบุตามวันที่เข้าพักที่ระบุไว้ใน <StatusApplicationControl>
และค่า LOS ที่ระบุไว้สำหรับ UnitMultiplier
คุณสามารถใช้ทั้งรูปแบบการกำหนดราคาตามวันและแบบ LOS ภายใต้บัญชีเดียว อย่างไรก็ตาม แต่ละพร็อพเพอร์ตี้ควรใช้รูปแบบการกำหนดราคาเพียงรูปแบบเดียว โปรดคำนึงถึงประเด็นต่อไปนี้เมื่อใช้การกำหนดราคาแบบ LOS
- ระบบจะไม่รวมราคาสำหรับระยะเวลาในการเข้าพักที่แตกต่างกันเมื่อใช้การกำหนดราคาแบบ LOS ตัวอย่างเช่น อัตรา LOS ที่ 3 ไม่ได้นำไปรวมกับ LOS เป็น 1 เพื่อกำหนดราคาอัตรา LOS เป็น 4 ต้องระบุอัตรา LOS เป็น 4 อย่างชัดเจน
- ราคาห้องพัก 1 คืนในการกำหนดราคาตาม LOS จะไม่ใช้เป็นราคาคืนสำหรับการเข้าพักแต่ละคืนในการกำหนดราคาตามวัน
- ที่พักแต่ละรายการควรใช้ราคาแบบอิงตาม LOS หรือราคาตามวันที่เท่านั้น โดยขึ้นอยู่กับวิธีแสดงราคาในระบบ
หากต้องการเปิดใช้การกำหนดราคาตาม LOS ในบัญชี โปรดส่งคำขอผ่าน TAM หรือติดต่อเรา
หลักเกณฑ์หรือการดำเนินการ
- ราคาต่อวัน
Delta
: เพิ่มหรืออัปเดตราคาต่ออัตราการเข้าพักสำหรับชุดค่าผสมที่ระบุของประเภทห้องพัก แพ็กเกจราคา และวันที่เข้าพักที่ระบุใน<StatusApplicationControl>
- การอัปเดตราคาจะใช้การดำเนินการ
Delta
โดยค่าเริ่มต้น - การอัปเดต
Delta
จะไม่เปลี่ยนแปลงอัตราที่เก็บไว้ก่อนหน้านี้สำหรับอัตราการเข้าพักอื่นๆ เช่น หากคุณระบุราคาสำหรับห้องพักแบบเดี่ยวและแบบคู่ และส่งการอัปเดตราคาDelta
สำหรับห้องพักแบบเดี่ยว อัตราการเข้าพักแบบคู่จะไม่เปลี่ยนแปลง
- การอัปเดตราคาจะใช้การดำเนินการ
Overlay
: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน<StatusApplicationControl>
แล้วแทนที่ด้วยราคาใหม่ เช่น หากคุณระบุราคาสำหรับห้องพักแบบเดี่ยวและแบบคู่ และส่งข้อมูลอัปเดตOverlay
สำหรับห้องพักแบบเดี่ยว Google จะนำราคาก่อนหน้าทั้งหมดออก (ทั้งอัตราการเข้าพักคนเดียวและคู่) และเฉพาะอัตราการเข้าพักคนเดียวเท่านั้นที่จะยังคงอยู่หลังจากการอัปเดตRemove
: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน<StatusApplicationControl>
- ราคาที่อิงตาม LOS
Delta
: ระบุหรืออัปเดตราคาต่อค่า LOS สำหรับชุดค่าผสมที่ระบุของประเภทห้องพัก แพ็กเกจราคา และวันที่เช็คอินที่ระบุใน<StatusApplicationControl>
เท่านั้น แทนที่ราคาต่ออัตราการเข้าพักทั้งหมดที่เชื่อมโยงกับค่า LOS ที่อัปเดตแล้ว- การอัปเดตราคาจะใช้การดำเนินการ
Delta
โดยค่าเริ่มต้น - การอัปเดต
Delta
จะไม่เปลี่ยนแปลงราคาที่จัดเก็บไว้ก่อนหน้านี้สำหรับระยะเวลาการเข้าพักอื่นๆ เช่น หากคุณระบุราคาสำหรับ LOS 1 และ 2 และส่งการอัปเดตราคาDelta
สำหรับ LOS 1 ราคาต่ออัตราการเข้าพักของ LOS 2 จะไม่เปลี่ยนแปลง - การอัปเดต
Delta
จะเขียนทับราคาต่ออัตราการเข้าพักที่จัดเก็บไว้ก่อนหน้านี้ทั้งหมดสำหรับระยะเวลาในการเข้าพักที่กำหนด เช่น หากคุณระบุอัตราการเข้าพักคนเดียวและคู่สําหรับ LOS 1 และส่งการอัปเดตราคาDelta
สําหรับ LOS 1 ที่มีอัตราการเข้าพักรายการเดียวเท่านั้น ระบบจะนำอัตราการเข้าพักแบบคู่ออก
- การอัปเดตราคาจะใช้การดำเนินการ
Overlay
: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับ LOS, ประเภทห้องพัก, แพ็กเกจราคา และวันที่เช็คอินที่ระบุใน<StatusApplicationControl>
แล้วแทนที่ด้วยราคาใหม่ เช่น หากคุณระบุอัตรา LOS 1 และ 2 ไว้ แล้วส่งการอัปเดตOverlay
สําหรับ LOS 1 ไว้ Google จะนําราคาก่อนหน้าทั้งหมดออก (ทั้ง LOS 1 และ 2) และเฉพาะอัตรา LOS 1 เท่านั้นที่จะยังคงอยู่หลังการอัปเดตRemove
: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับ LOS ทั้งหมดของประเภทห้องพัก แพ็กเกจราคา และวันที่เช็คอินที่ระบุใน<StatusApplicationControl>
- เกี่ยวกับภาษี
หากภาษีและค่าธรรมเนียมไม่ซับซ้อน ให้ระบุจำนวนเงินทั้งหมดได้โดยใช้
AmountAfterTax
ภาษีที่ซับซ้อน เช่น ภาษีและค่าธรรมเนียมที่คิดต่อการเข้าพัก (ไม่ใช่ต่อคืน) จะแสดงเป็นAmountAfterTax
ไม่ได้โดยทั่วไป Google แนะนำให้ใช้
TaxFeeInfo
แทนAmountAfterTax
หากเป็นไปได้ คุณควรใส่
AmountBeforeTax
(แม้ว่าจะระบุAmountAfterTax
) เนื่องจากบางประเทศ (เช่น สหรัฐอเมริกา) จะแสดงราคาก่อนหักภาษีโดยค่าเริ่มต้นคุณควรรวมภาษีและค่าธรรมเนียมทั้งหมดที่ผู้ใช้ต้องชำระ (VAT, ภาษีการเข้าพัก ค่าธรรมเนียมการทำความสะอาด, ภาษีเมือง ฯลฯ) แม้จะไม่ได้ชำระในเวลาจองหรือไม่ได้ชำระให้ที่พักโดยตรง
ตัวอย่าง
ส่วนนี้จะแสดงตัวอย่างพื้นฐานของข้อความอัตราค่าจัดส่งที่ใช้องค์ประกอบที่จำเป็นและไม่บังคับ หลังจากเตรียมไฟล์แล้ว คุณต้องส่งไปยัง Google โดยใช้ข้อความ POST ไปยังปลายทางต่อไปนี้
https://www.google.com/travel/hotels/uploads/property_data
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/โพสต์ข้อความที่หัวข้อข้อความพุช
สำหรับ HotelCode
ให้ใช้รหัสโรงแรมที่ไม่ซ้ำกันที่คุณใช้ในระบบเพื่อระบุที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id>
ในองค์ประกอบ <listing>
ในฟีดข้อมูลโรงแรม สำหรับ <PackageID>
และ <RoomID>
ให้ใช้รหัสเดียวกันกับที่คุณใช้ในระบบสำหรับแพ็กเกจราคาและประเภทห้องพัก (ตามลำดับ) ความสอดคล้องกับระบบของคุณเป็นสิ่งสำคัญในการตรวจสอบว่า Google แสดงราคาและข้อมูลของคุณอย่างถูกต้อง
ตัวอย่างนี้แสดงวิธีกำหนดราคาโดยใช้การดำเนินการ Delta
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-02-25T20:50:37-05:00"
Version="3.0"
NotifType="Delta">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<RateAmountMessages HotelCode="HotelID">
<RateAmountMessage>
<StatusApplicationControl Start="2022-12-01"
End="2022-12-31"
InvTypeCode="RoomID"
RatePlanCode="PackageID" />
<Rates>
<Rate>
<BaseByGuestAmts>
<BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
<BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
<BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
<BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
</BaseByGuestAmts>
</Rate>
</Rates>
</RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>
วิธีการ
ส่วนนี้จะแสดงวิธีแก้ไขสถานการณ์ที่คุณอาจพบขณะส่งข้อความราคา
ดูตัวอย่างวิธีเพิ่ม นำออก และอัปเดตราคาได้ที่ตัวอย่างราคา
สถานการณ์ที่ 1: วิธีเปลี่ยนราคาต่ออัตราการเข้าพัก
คำอธิบาย
ก่อนหน้านี้มีการกำหนดราคาต่อคืนสำหรับอัตราการเข้าพัก 2 คนเท่านั้น (ซึ่งมีผลกับอัตราการเข้าพักคนเดียวด้วย) แต่ตอนนี้มีราคาที่ถูกลงสำหรับอัตราการเข้าพักคนเดียว
โซลูชัน
ส่งราคาอัตราการเข้าพัก 1 ใหม่โดยใช้การอัปเดตขอบเขต Delta
เริ่มต้น ค่าใหม่นี้จะไม่ส่งผลต่อราคาอัตราการเข้าพัก 2
สถานการณ์ที่ 2: วิธีแทนที่ราคาต่ออัตราการเข้าพักของที่พัก
คำอธิบาย
คุณเคยกำหนดอัตราการเข้าพักที่ 1 ถึง 4 ไว้ แต่ตอนนี้มีเพียงอัตราการเข้าพัก 1 และ 2 ที่ใช้ได้
โซลูชัน
ใช้ NotifType="Overlay"
เพื่อแทนที่อัตราการเข้าพักทั้งหมดสำหรับที่พัก ประเภทห้องพัก แพ็กเกจราคา และวันที่หนึ่งๆ ในสถานการณ์นี้ การดำเนินการ Overlay
จะแสดงรายการราคาของอัตราการเข้าพัก 1 และ 2
สถานการณ์ที่ 3: วิธีตั้งค่าอัตราเดียวกันสำหรับอัตราการเข้าพักหลายรายการ
คำอธิบาย
ราคาสำหรับอัตราการเข้าพักหนึ่งๆ จะขายให้กับกลุ่มที่มีจำนวนคนน้อยกว่าได้ ในสถานการณ์นี้ คุณลดความซับซ้อนของข้อความได้โดยส่งเฉพาะการอัปเดตราคาสำหรับอัตราการเข้าพักสูงสุดที่เกี่ยวข้อง
โซลูชัน
หากคุณมีราคาเดียวกันสำหรับอัตราการเข้าพักหลายรายการ ให้กำหนดค่าอัตราการเข้าพักสูงสุดที่ประเภทห้องพักและแพ็กเกจราคารองรับ แล้วระบบจะใช้ค่าดังกล่าวสำหรับอัตราการเข้าพักที่ต่ำลงโดยอัตโนมัติ คือคุณไม่จำเป็นต้องแสดงอัตราต่อคืนที่เหมือนกันสำหรับอัตราการเข้าพัก 1-6 คนหากอัตราการเข้าพักเหมือนกันทั้งหมด เพียงตั้งค่าไว้ที่ 6 คน