Thông báo Phản hồi gợi ý

Khi Google gửi thông báo Yêu cầu cung cấp gợi ý, máy chủ của bạn sẽ phản hồi bằng thông báo Phản hồi gợi ý. Thông báo này xác định những khách sạn đã thay đổi giá kể từ lần gần đây nhất Google nhận được Phản hồi gợi ý thành công từ các máy chủ đó. Nếu có bất kỳ thay đổi nào về giá, Google sẽ gửi <Query> để tìm nạp dữ liệu giá mới cho các khách sạn và hành trình đã xác định.

Để biết thông tin tổng quan về quy trình định giá lại, hãy xem bài viết Tổng quan về giá.

Thông báo Phản hồi gợi ý sử dụng các phương thức sau để định giá lại các khách sạn đã chọn và hành trình của các khách sạn đó:

Phần tử gốc của thông báo Phản hồi gợi ý là <Hint>. Bạn có thể yêu cầu cập nhật khách sạn hoặc hành trình bằng một hoặc nhiều phần tử <Item>. Một thông báo Phản hồi gợi ý duy nhất có thể xác định vô số phần tử <Item>.

Mỗi thông báo Phản hồi gợi ý phải chỉ định ít nhất một phần tử <Property> cho mỗi <Item>. <Property> xác định một khách sạn bằng cách sử dụng cùng một mã nhận dạng với Danh sách khách sạn. Theo mặc định, bạn sẽ chỉ định một mã khách sạn duy nhất cho mỗi khối <Item>. Tuy nhiên, bạn có thể hướng dẫn để Google cho phép nhiều khách sạn trong một khối nếu bạn đang sử dụng phạm vi ngày nhận phòng hoặc phạm vi thời gian lưu trú để định giá lại.

Quy trình yêu cầu và phản hồi đối với hành trình chính xác

Thông báo gợi ý có thể dựa trên các hành trình riêng lẻ, chẳng hạn như tổ hợp ngày nhận phòng và thời gian lưu trú. Trong trường hợp này, bạn cần chỉ định ngày nhận phòng và thời gian lưu trú cho khách sạn của mình và Google sẽ tìm nạp dữ liệu giá mới cho riêng hành trình đó.

Phản hồi của đối tác

Thông báo Phản hồi gợi ý sau đây xác định một cơ sở lưu trú và một hành trình duy nhất:

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

Câu trả lời của Google

Google sẽ phản hồi thông báo Phản hồi gợi ý của bạn bằng <Query> tương tự như sau:

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

Tạo <Transaction>

Sau đó, bạn cần tạo một <Transaction> kèm theo thông tin cập nhật về giá của khách sạn cho lần lưu trú sau đây:

5/20/23 - 5/23/23

Quy trình yêu cầu và phản hồi đối với phạm vi ngày nhận phòng

Thông báo Phản hồi gợi ý có thể chỉ định nhiều ngày nhận phòng, bắt đầu bằng ngày nhận phòng đầu tiên và kết thúc bằng ngày nhận phòng cuối cùng. Khi tìm nạp dữ liệu giá mới, Google sẽ thu thập các hành trình cho mỗi ngày nhận phòng của khách sạn, bắt đầu từ các ngày đó cho đến thời gian lưu trú mà bạn chỉ định.

Phạm vi ngày của đối tác

Thông báo Phản hồi gợi ý mẫu sau đây xác định một cơ sở lưu trú duy nhất kèm theo phạm vi ngày nhận phòng:

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

Câu trả lời của Google

Google sẽ phản hồi thông báo Phản hồi gợi ý này bằng <Query> tương tự như sau:

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

Tạo <Transaction>

Sau đó, bạn cần tạo một <Transaction> kèm theo thông tin cập nhật về giá cho lần lưu trú sau đây của khách sạn đó:

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

Ví dụ này sử dụng thời gian lưu trú là 5 đêm. Thời gian lưu trú mặc định là 30 ngày.

Quy trình yêu cầu và phản hồi đối với thời gian lưu trú theo phạm vi ngày

Thông báo Phản hồi gợi ý có thể bao gồm một phạm vi ngày đã thay đổi. Thông tin này giúp Google biết rằng Google cần tìm nạp những hành trình bị ảnh hưởng bởi bất kỳ ngày nào trong số đó. Tập hợp hành trình thực tế được tìm nạp là một hàm gồm cả tập hợp các ngày có thay đổi và thời gian lưu trú tối đa.

Thời gian lưu trú theo phạm vi ngày của đối tác

Thông báo Phản hồi gợi ý mẫu sau đây sử dụng thời gian lưu trú theo phạm vi ngày:

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

Câu trả lời của Google

Google sẽ phản hồi thông báo Phản hồi gợi ý của bạn bằng <Query> tương tự như sau:

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

Tạo <Transaction>

Sau đó, bạn cần tạo một <Transaction> kèm theo thông tin cập nhật về giá của khách sạn cho lần lưu trú sau đây:

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

Thời gian lưu trú theo phạm vi ngày: Giới hạn theo lô và việc chia nhỏ truy vấn

Google giới hạn mỗi truy vấn kéo tối đa 10.000 tổ hợp Cặp khách sạn-hành trình (một khách sạn, ngày nhận phòng và thời gian lưu trú). Đối với gợi ý Thời gian lưu trú theo phạm vi ngày, số lượng tổ hợp được tính bằng công thức hình thang để tính số lượng tổ hợp cặp Khách sạn – Hành trình cho Truy vấn thời gian lưu trú theo phạm vi ngày:

$$ \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}} $$

Trong trường hợp:

  • Date Span: Số ngày (bao gồm cả ngày đầu và ngày cuối) giữa <FirstDate><LastDate> (Khoảng thời gian = Ngày cuối – Ngày đầu + 1).
  • LOS: Thời gian lưu trú tối đa được yêu cầu trong gợi ý (ví dụ: <AffectedNights>14</AffectedNights>).
  • \(N_{\text{hotel_batch_size}}\): Số lượng tài sản có trong lô truy vấn (được định cấu hình thông qua hotel_batch_size).

Điều gì xảy ra khi một gợi ý vượt quá 10.000 mục?

Nếu số lượng mục được tính toán vượt quá 10.000, Google sẽ tự động chia nhỏ khối lượng công việc của truy vấn:

  1. Lần thử đầu tiên (Phạm vi lưu trú): Một khoảng thời gian nhỏ hơn bao gồm ngày bắt đầu của phạm vi được gửi bằng <AffectedNights>.
  2. Trường hợp dự phòng đầu tiên (Nếu được hỗ trợ – Phạm vi nhận phòng): Chúng tôi sẽ cố gắng gửi phần còn lại nhỏ hơn của phạm vi ngày dưới dạng các truy vấn Phạm vi ngày nhận phòng bằng cách sử dụng <Nights> (truy vấn bên dưới).
  3. Phương án dự phòng cuối cùng (Hành trình chính xác): Chúng tôi sẽ quay lại mở rộng tập hợp truy vấn thành từng hành trình chính xác.
<!-- 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>
  • Duy trì số lượng tài sản theo lô ở mức cân bằng: Nếu bạn cập nhật các khoảng thời gian lớn (chẳng hạn như từ 180 đến 365 ngày) với thời gian lưu trú từ 14 đêm trở lên, hãy yêu cầu Nhà quản lý tài khoản hỗ trợ kỹ thuật của Google đặt hotel_batch_size thành một giá trị thấp hơn để ngăn các gợi ý kích hoạt việc phân chia.
  • Đưa ra gợi ý về phạm vi một cách chặt chẽ: Khi thông báo cho Google về việc thay đổi giá, hãy giới hạn khoảng thời gian <FirstDate><LastDate> trong khoảng thời gian cụ thể mà giá thực sự thay đổi, thay vì gửi toàn bộ năm dương lịch.
  • Nếu gợi ý của bạn bao gồm phạm vi ngày lớn: Đảm bảo trình phân tích cú pháp của bạn chấp nhận hoặc bên trong các khối có chứa <FirstDate><LastDate> để có thể sử dụng nhiều loại truy vấn theo phạm vi nhằm đáp ứng các yêu cầu kéo.