ข้อความตอบกลับคำแนะนำ

เมื่อ Google ส่งข้อความขอคำแนะนำเซิร์ฟเวอร์ของคุณ ควรตอบกลับด้วยข้อความตอบกลับคำแนะนำซึ่งระบุโรงแรมที่มีการเปลี่ยนแปลงราคา นับจากครั้งล่าสุดที่ Google ได้รับการตอบกลับคำแนะนำที่สำเร็จ จากเซิร์ฟเวอร์นี้ หากมีการเปลี่ยนแปลงราคา Google จะส่ง <Query> ซึ่งดึงข้อมูลราคาที่อัปเดตสำหรับโรงแรมและแผนการเดินทางที่ระบุ

ดูภาพรวมของกระบวนการกำหนดราคาใหม่ได้ที่ ภาพรวมการกำหนดราคา

**ประเด็นสำคัญ:** หากคุณไม่ได้ใช้ การกำหนดราคาที่เปลี่ยนแปลง Google จะดึงข้อมูลโรงแรมทั้งหมดในข้อมูลโรงแรมของคุณ

ข้อความตอบกลับคำแนะนำจะใช้วิธีต่อไปนี้เพื่อกำหนดราคาใหม่ของโรงแรมที่เลือกและแผนการเดินทางของโรงแรมเหล่านั้น

• แผนการเดินทางที่แน่นอน
• ช่วงวันที่เช็คอิน
• การเข้าพักตามช่วงเวลา

หมายเหตุ: ระยะเวลาในการเข้าพักเริ่มต้นเมื่อใช้การกำหนดราคาที่เปลี่ยนแปลงคือ 30 วัน

องค์ประกอบรูทของข้อความตอบกลับคำแนะนำคือ <Hint>. คุณขอให้อัปเดตโรงแรมหรือ แผนการเดินทางโดยใช้องค์ประกอบ <Item> อย่างน้อย 1 รายการ ข้อความตอบกลับคำแนะนำ รายการเดียวจะกำหนดองค์ประกอบ <Item> กี่รายการก็ได้

ข้อความตอบกลับคำแนะนำแต่ละรายการจะต้องระบุองค์ประกอบ <Property> อย่างน้อย 1 รายการสำหรับ แต่ละ <Item> <Property> จะระบุโรงแรมโดยใช้รหัสเดียวกับ ข้อมูลโรงแรม โดยค่าเริ่มต้น คุณจะระบุรหัสโรงแรมรายการเดียวสำหรับ <Item> บล็อก แต่คุณจะสั่งให้ Google อนุญาตโรงแรมหลายแห่งในบล็อกรายการได้ หากใช้ช่วงวันที่เช็คอินหรือการเข้าพักตามช่วงเวลาสำหรับการปรับราคา

ขั้นตอนการตอบกลับ/ส่งคำขอสำหรับแผนการเดินทางที่แน่นอน

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

การตอบกลับของพาร์ทเนอร์

ข้อความตอบกลับคำแนะนำต่อไปนี้ระบุที่พักและแผนการเดินทางเดียว

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

การตอบกลับของ Google

Google จะตอบกลับข้อความตอบกลับคำแนะนำของคุณโดยมี <Query> คล้ายกับข้อความต่อไปนี้

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

สร้าง <Transaction>

จากนั้นให้คุณสร้าง <Transaction> ที่มีการอัปเดตราคาสำหรับ โรงแรมของการเข้าพักต่อไปนี้

5/20/23 - 5/23/23

ขั้นตอนการตอบกลับ/ส่งคำขอสำหรับช่วงวันที่เช็คอิน

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

วันที่ตามช่วงเวลาของพาร์ทเนอร์

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

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

การตอบกลับของ Google

Google จะตอบกลับข้อความตอบกลับคำแนะนำนี้โดยมี <Query> ที่คล้ายกับ ข้อความต่อไปนี้

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

สร้าง <Transaction>

จากนั้นให้คุณสร้าง <Transaction> ที่มีการอัปเดตราคา สำหรับการเข้าพักต่อไปนี้ของโรงแรมดังกล่าว

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23

ตัวอย่างนี้ใช้ระยะเวลาในการเข้าพัก 5 คืน ระยะเวลาในการเข้าพักเริ่มต้นคือ 30 วัน

ขั้นตอนการตอบกลับ/ส่งคำขอสำหรับการเข้าพักตามช่วงเวลา

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

การเข้าพักตามช่วงเวลาของพาร์ทเนอร์

ตัวอย่างข้อความตอบกลับคำแนะนำต่อไปนี้ใช้การเข้าพักตามช่วงเวลา

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

การตอบกลับของ Google

Google จะตอบกลับข้อความตอบกลับคำแนะนำของคุณโดยมี <Query> คล้ายกับข้อความต่อไปนี้

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

สร้าง <Transaction>

จากนั้นให้คุณสร้าง <Transaction> ที่มีการอัปเดตราคาสำหรับ โรงแรมของการเข้าพักต่อไปนี้

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23

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

การเข้าพักตามช่วงเวลา: ขีดจำกัดการจัดกลุ่มและการแยกคำค้นหา

Google จำกัดคำค้นหาแบบดึงข้อมูลแต่ละรายการไว้ที่ชุดค่าผสมคู่โรงแรม-แผนการเดินทาง (โรงแรม วันที่เช็คอิน และระยะเวลาในการเข้าพัก) สูงสุด 10,000 รายการ สำหรับคำแนะนำการเข้าพักตามช่วงเวลา ระบบจะคำนวณจำนวนชุดค่าผสมโดยใช้สูตรสี่เหลี่ยมคางหมูเพื่อคำนวณจำนวนชุดค่าผสมคู่โรงแรม-แผนการเดินทางสำหรับคำค้นหาการเข้าพักตามช่วงเวลา

$$ \text{Total Items} = \left( \text{Date Span} \times \text{LOS} + \frac{\text{LOS} \times (\text{LOS} + 1)}{2} \right) \times N_{\text{hotel_batch_size}} $$

โดยที่

• Date Span: จำนวนวันรวมระหว่าง <FirstDate> กับ <LastDate> (Date span = LastDate - FirstDate + 1)
• LOS: ระยะเวลาในการเข้าพักสูงสุดที่ขอในคำแนะนำ (เช่น <AffectedNights>14</AffectedNights>)
• \(N_{\text{hotel_batch_size}}\): จำนวนที่พักที่รวมอยู่ในกลุ่มคำค้นหา (กำหนดค่าผ่าน hotel_batch_size)

จะเกิดอะไรขึ้นเมื่อคำแนะนำมีรายการเกิน 10,000 รายการ

หากรายการที่คำนวณเกิน 10,000 รายการ Google จะแยกปริมาณงานของคำค้นหาโดยอัตโนมัติ ดังนี้

1. ความพยายามครั้งแรก (การเข้าพักตามช่วงเวลา): ระบบจะส่งกรอบเวลาที่สั้นลงซึ่งครอบคลุมจุดเริ่มต้นของช่วงโดยใช้ <AffectedNights>
2. การสำรองข้อมูลครั้งแรก (หากรองรับ - ช่วงวันที่เช็คอิน): เราจะพยายามส่งส่วนที่เหลือของช่วงวันที่เป็นคำค้นหาช่วงวันที่เช็คอินโดยใช้ <Nights> (คำค้นหาด้านล่าง)
3. การสำรองข้อมูลครั้งสุดท้าย (แผนการเดินทางที่แน่นอน): เราจะกลับไปขยายชุดคำค้นหาเป็นแผนการเดินทางที่แน่นอนแต่ละรายการ

<!-- Example: Remainder batch dispatched after a split -->
<Query>
  <FirstDate>2026-10-01</FirstDate>
  <LastDate>2026-10-31</LastDate>
  <Nights>14</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

แนวทางปฏิบัติแนะนำเพื่อป้องกันการลดระดับคำค้นหาโดยไม่ตั้งใจ

• รักษาสมดุลของขนาดกลุ่มที่พัก: หากคุณอัปเดตกรอบเวลาขนาดใหญ่ (เช่น 180 ถึง 365 วัน) ที่มีระยะเวลาในการเข้าพักตั้งแต่ 14 คืนขึ้นไป โปรดขอให้ผู้จัดการฝ่ายดูแลลูกค้าทางเทคนิคของ Google ตั้งค่า hotel_batch_size เป็นค่าที่ต่ำลงเพื่อป้องกันไม่ให้คำแนะนำทริกเกอร์การแยก
• กำหนดขอบเขตคำแนะนำอย่างเข้มงวด: เมื่อแจ้งให้ Google ทราบถึงการเปลี่ยนแปลงราคา ให้จำกัดช่วง <FirstDate> และ <LastDate> ไว้ที่ช่วงวันที่เฉพาะที่มีการเปลี่ยนแปลงราคาจริง แทนที่จะส่งทั้งปีปฏิทิน
• หากคำแนะนำครอบคลุมช่วงวันที่ขนาดใหญ่: ตรวจสอบว่าตัวแยกวิเคราะห์ยอมรับทั้ง หรือ ภายใน บล็อกที่มี <FirstDate> และ <LastDate> เพื่อให้สามารถใช้คำค้นหาตามช่วงเวลาหลายประเภทเพื่อตอบสนองคำขอแบบดึงข้อมูล