ให้คะแนนข้อความ

ภาพรวม

ข้อความราคา (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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/โพสต์ข้อความที่หัวข้อข้อความพุช

หมายเหตุ: ส่งข้อความอัตราให้กับ Google เมื่อใดก็ตามที่ราคาต่อคืนมีการเปลี่ยนแปลง

สำหรับ 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 คน

หมายเหตุ: ค่าอัตราการเข้าพักเริ่มต้นคือ 2 หากไม่ได้ตั้งค่า NumberOfGuests