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

ภาพรวม

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

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

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

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

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

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

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

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

  ประเด็นสำคัญ: พร็อพเพอร์ตี้ 1 แห่งมีค่าใช้จ่ายเพิ่มเติมสำหรับแขกได้ไม่เกิน 100 รายการ คุณใช้ข้อความ ExtraGuestCharge เพื่อนำค่าใช้จ่ายเพิ่มเติมสำหรับแขกออกได้

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

ประสิทธิภาพ

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

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

ควบคุม

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

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

ประเด็นสำคัญ: สำหรับห้องพักและแพ็กเกจราคาที่กำหนด พร็อพเพอร์ตี้แต่ละแห่งจะมีอัตราการเข้าพักได้สูงสุด 50 รายการ

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

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

ข้อมูลอ้างอิง 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การอัปเดตราคาสำหรับห้องพักแบบคนเดียว ราคาสำหรับห้องพักแบบคู่จะยังคงเหมือนเดิม

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

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

ประเด็นสำคัญ: สำหรับรูปแบบการกำหนดราคา Per-date และ LOS-based จะมีขีดจำกัดผลิตภัณฑ์ 5,000 รายการสำหรับชุดค่าผสมของประเภทห้องพักและแพ็กเกจต่อที่พัก คุณ สามารถใช้การแจ้งเตือนประเภท Overlay และ Remove เพื่อนำผลิตภัณฑ์ที่กำหนดไว้ก่อนหน้านี้ออก

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

คุณควรรวมภาษีและค่าธรรมเนียมทั้งหมดที่ผู้ใช้ต้องชำระ (VAT, ภาษีที่พัก, ค่าทำความสะอาด, ภาษีเมือง ฯลฯ) แม้ว่าจะไม่ได้ชำระในเวลาที่จอง หรือไม่ได้ชำระให้กับที่พักโดยตรงก็ตาม

ตัวอย่าง

ส่วนนี้แสดงตัวอย่างพื้นฐานของข้อความราคาโดยใช้องค์ประกอบที่ต้องระบุและองค์ประกอบที่ไม่บังคับ หลังจากเตรียมไฟล์แล้ว คุณต้องส่งไฟล์ไปยัง Google โดยใช้ ข้อความ POST ไปยังปลายทางต่อไปนี้ https://www.google.com/travel/hotels/uploads/property_data

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/POST ข้อความได้ที่การพุชข้อความ

หมายเหตุ: ส่งข้อความ Rate ให้ 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