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

ภาพรวม

ข้อความราคา (OTA_HotelRateAmountNotifRQ) จะระบุราคาต่อคืน อัตราการเข้าพักสำหรับชุดค่าผสมของห้องพักแต่ละประเภทและแพ็กเกจราคาสำหรับวันที่ที่ระบุ ในข้อความราคา Google รองรับการกำหนดราคาตามอัตราการเข้าพัก ทำให้ระบุราคาต่อคืนที่แตกต่างกันตามจำนวนสูงสุดได้ ของผู้อยู่อาศัยที่ต้องการ

ส่วนต่อไปนี้ครอบคลุมหลักเกณฑ์ทั่วไป ตัวอย่างพื้นฐาน และวิธีการ เพื่อช่วยให้คุณเริ่มต้นเพิ่มและอัปเดตราคา รวมถึงส่ง ให้คะแนนข้อความ

ลักษณะการทำงานของอัตราการจับคู่

เนื่องจากผู้ใช้ขออัตราการเข้าพักที่เฉพาะเจาะจง ราคาที่ผู้ใช้เห็นจะขึ้นอยู่กับ วิธีกำหนดราคาในข้อความราคา ส่วนนี้จะครอบคลุมวิธีที่ ระบบจะจับคู่คำขอของผู้ใช้กับราคาของคุณ โดยขึ้นอยู่กับอัตราการเข้าพัก และราคาที่คุณกำหนด

หลักการสำคัญ

• ราคาที่กำหนดไว้สำหรับอัตราการเข้าพักหนึ่งๆ จะใช้กับอัตราการเข้าพักที่น้อยกว่าทั้งหมด เว้นแต่จะระบุไว้เป็นอย่างอื่น

• คำขอสำหรับอัตราการเข้าพักที่มากกว่าที่กำหนดไว้ไม่สามารถทำได้

• การกำหนดราคาตามอัตราการเข้าพักจะมีผลกับทั้งราคาต่อวันและตาม LOS รูปแบบการกำหนดราคาที่อธิบายไว้ด้านล่าง ซึ่งหมายความว่าคุณสามารถระบุอัตราสำหรับแต่ละ อัตราการเข้าพัก หากไม่มีราคาสำหรับอัตราการเข้าพักหนึ่งๆ ระบบจะใช้ราคาสำหรับ จะมีการใช้อัตราการเข้าพักสูงสุดลำดับถัดไป นอกจากนี้ คุณอาจกำหนดค่าบริการสำหรับ ผู้เข้าร่วมและบุตรหลานเพิ่มเติมที่ใช้ AdditionalGuestAmounts หรือ ExtraGuestCharges ซึ่งจะมีผลกับความจุที่กำหนดไว้สำหรับห้อง

ประโยชน์และตัวอย่าง

ประสิทธิภาพ

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

ตัวอย่าง: ราคาสำหรับประเภทห้องพักและแพ็กเกจราคาจะเท่ากันสำหรับ อัตราการเข้าพักที่ 1 ถึง 4 ใช้ข้อความ "ให้คะแนน" เพื่อตั้งค่า 1 อัตราสำหรับราคาสูงสุด อัตราการเข้าพัก 4 คน ผู้ใช้ที่ค้นหาอัตราการเข้าพักคนเดียว คู่ และ 3 คน ก็จะเห็นอัตราเดียวกัน ผู้ใช้ที่ค้นหา 5 ขึ้นไปจะไม่เห็นราคา

ควบคุม

คุณระบุอัตราที่แตกต่างกันสำหรับอัตราการเข้าพักอื่นอย่างชัดแจ้งได้ ส่ง อัตราการเข้าพักที่แตกต่างกันสำหรับค่าอัตราการเข้าพักแต่ละค่าหากคุณต้องการควบคุมวิธีการได้มากขึ้น Google จะจับคู่คำขอกับอัตราการเข้าพัก

ตัวอย่าง: หากมีการกำหนดราคาสําหรับอัตราการเข้าพัก 3 และ 1 ไว้ อัตราการเข้าพักคนเดียว การค้นหาจะแสดงราคาสำหรับคนโสด ส่วนการค้นหาอัตราการเข้าพักสำหรับ 2 คนจะแสดง อัตราการเข้าพัก 3 คน และผู้ใช้ที่กำลังค้นหา 4 ขึ้นไปจะไม่เห็น

ดูตัวอย่างเพิ่มเติมของสถานการณ์ต่างๆ ที่เกี่ยวข้องกับราคาได้ที่ วิธีการ

องค์ประกอบที่จำเป็นและไม่บังคับ

การอ้างอิง XML จะให้คำอธิบายขององค์ประกอบที่จำเป็นและที่ไม่บังคับ สำหรับรายละเอียดเกี่ยวกับ และองค์ประกอบย่อย โปรดดูองค์ประกอบราคา & แอตทริบิวต์

ไวยากรณ์และสคีมา

ใช้ไวยากรณ์เกี่ยวกับอัตรา เช่น เป็นข้อมูลอ้างอิงเมื่อคุณสร้างข้อความให้คะแนนเพื่อให้ คุณทำตามรูปแบบที่ถูกต้องแล้ว

คุณสามารถใช้เครื่องมือ XML ของบุคคลที่สาม เช่น xmllint เพื่อตรวจสอบฟีดกับ สคีมาที่เผยแพร่ก่อนส่งไปยัง Google สำหรับข้อความให้คะแนน โปรดดูสคีมา Hotel Ads

รูปแบบการกำหนดราคา

ราคาต่อวัน

นี่คือรูปแบบการกำหนดราคามาตรฐานที่ใช้สำหรับที่พักส่วนใหญ่ per-date รูปแบบการกำหนดราคาจะอิงตามการตั้งค่าราคาซึ่งสรุปในช่วงวันที่เข้าพัก ที่ราคาทั้งหมด ในรูปแบบนี้ ราคาทั้งหมดภายใต้องค์ประกอบ Rate ตีความว่ามีผลกับช่วงวันที่เข้าพักที่ระบุไว้ใน <StatusApplicationControl>

การกำหนดราคาตาม LOS

รูปแบบราคาแบบ LOS (ระยะเวลาในการเข้าพัก) จะอิงตามราคาที่กำหนดไว้สำหรับ ชุดค่าผสมของวันที่เข้าพักและระยะเวลาในการเข้าพัก อัตราที่ระบุไว้ภายใต้ รูปแบบการกำหนดราคาแบบ LOS เป็นแบบต่อวัน เช่น หากส่งอัตราภาษีเป็น $100 สำหรับระยะเวลาในการเข้าพัก 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 สำหรับการเข้าพักคนเดียว สำหรับอัตราการเข้าพัก อัตราการเข้าพักสำหรับ 2 คนจะไม่มีการเปลี่ยนแปลง

Overlay: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน <StatusApplicationControl> และการแทนที่ ด้วยราคาใหม่ๆ เช่น หากคุณระบุราคาสำหรับอัตราเดียวและ ห้องพักสำหรับอัตราการเข้าพัก 2 คน และคุณส่งการอัปเดต Overlay สำหรับอัตราการเข้าพักคนเดียว ห้อง Google จะนำราคาก่อนหน้าทั้งหมดออก (ทั้งแบบราคาเดี่ยวและคู่ อัตราการเข้าพัก) และอัตราการเข้าพักเดียวจะยังคงอยู่หลังจากการอัปเดต

Remove: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน <StatusApplicationControl>

การกำหนดราคาตาม LOS

Delta: เพิ่มหรืออัปเดตอัตราต่อค่า LOS สำหรับค่าที่ระบุเท่านั้น ชุดค่าผสมของประเภทห้องพัก แพ็กเกจราคา และวันที่เช็คอินที่ระบุไว้ใน <StatusApplicationControl> แทนที่ราคาต่ออัตราการเข้าพักทั้งหมดที่เกี่ยวข้อง ด้วยค่า LOS ที่อัปเดตแล้ว

• การอัปเดตราคาจะใช้การดำเนินการ Delta โดยค่าเริ่มต้น
• การอัปเดต Delta จะไม่เปลี่ยนแปลงอัตราที่จัดเก็บไว้ก่อนหน้านี้สำหรับ ระยะเวลาในการเข้าพัก เช่น หากคุณระบุอัตราสำหรับ LOS 1 และ 2 แล้วส่งการอัปเดตราคา Delta สำหรับ LOS 1 จากนั้นส่งราคาต่ออัตราการเข้าพักของ LOS 2 จะไม่มีการเปลี่ยนแปลง
• การอัปเดต Delta จะเขียนทับราคาต่ออัตราการเข้าพักที่จัดเก็บไว้ก่อนหน้านี้ทั้งหมดสำหรับ ระยะเวลาในการเข้าพักที่กำหนด ตัวอย่างเช่น หากคุณระบุโฆษณาเดี่ยวและ อัตราการเข้าพัก 2 คนสำหรับ LOS 1 และส่งการอัปเดตราคา Delta สําหรับ LOS 1 ที่มีอัตราการเข้าพักเพียงอัตราเดียว ระบบจะนำอัตราการเข้าพัก 2 คนออก

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) เนื่องจากบางภาษา (เช่น US) จะแสดงค่า ราคาก่อนหักภาษีโดยค่าเริ่มต้น

ภาษีและค่าธรรมเนียมทั้งหมดที่ผู้ใช้ต้องชำระ (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 วินาที