Chế độ phân phối giá

Chế độ phân phối xác định cách bạn gửi thông tin cập nhật về giá cho Google của các tổ hợp khách sạn và hành trình. Bạn và Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM) sẽ làm việc cùng nhau trong quá trình định cấu hình ban đầu để thiết lập chế độ phân phối.

Tổng quan về các chế độ phân phối

Theo mặc định, khách sạn có thể được truy vấn tối đa 330 ngày trước khi có phòng và tối đa 30 đêm lưu trú, nhưng bạn có thể xác định số hành trình tối đa (tổ hợp ngày nhận phòng và thời gian lưu trú).

Bạn càng hỗ trợ nhiều hành trình, thì bạn càng tham gia nhiều phiên đấu giá. Tuy nhiên, bạn càng hỗ trợ nhiều hành trình thì bạn càng phải gửi nhiều dữ liệu cho Google để dữ liệu giá của bạn luôn chính xác.

Phương thức cập nhật giá thông thường sử dụng thông báo Giao dịch theo một trong các cách sau:

  • ARI (Đẩy): Một nguồn cấp dữ liệu phân phối giá sử dụng siêu dữ liệu về gói giá, tình trạng phòng và khách sạn để thiết lập các chiến lược giá định sẵn cho các cơ sở lưu trú của bạn. Không giống như chế độ phân phối giá lấy dữ liệu và mức giá đã thay đổi, nguồn cấp dữ liệu ARI không truy vấn giá hoặc hành trình cụ thể. Thay vào đó, bạn đẩy các thông báo chứa một tập hợp con thông tin đại diện cho mô hình đặt giá cho các cơ sở lưu trú của bạn dựa trên nhiều thông tin về giá, quy định hạn chế và tình trạng phòng. Nguồn cấp dữ liệu ARI sử dụng thông số kỹ thuật XML của OTA (OTA_HotelRateAmountNotifRQOTA_HotelAvailNotifRQ) để xác định tình trạng còn phòng và giá. Hãy liên hệ với người quản lý tài khoản của bạn để tìm hiểu thêm về chế độ phân phối ARI và để xác định xem loại nguồn cấp dữ liệu này có phù hợp nhất với tài khoản của bạn hay không. Để biết thêm thông tin, hãy xem bài viết Sử dụng ARI.

  • Lấy dữ liệu: Google sẽ thường xuyên truy vấn dịch vụ của bạn để làm mới bộ nhớ đệm của dữ liệu về giá và tình trạng phòng. Trong mô hình này, Google gửi yêu cầu đến máy chủ của bạn và máy chủ đó sẽ phản hồi bằng dữ liệu đã cập nhật. Mô hình này phù hợp nhất nếu bạn không biết chính xác thời điểm thông tin về giá thay đổi hoặc nếu thông tin về giá thay đổi bất thường trong suốt cả ngày. Giá vẫn được lưu trong bộ nhớ đệm cho đến khi thuật toán của Google xác định rằng giá đã lỗi thời, dựa trên nhật ký thay đổi giá trước đây của từng đối tác. Để biết thêm thông tin, hãy xem bài viết Sử dụng chế độ phân phối lấy dữ liệu.

  • Mức giá đã thay đổi (trước đây là Lấy dữ liệu có chọn lọc): Tương tự như chế độ phân phối giá lấy dữ liệu, ngoại trừ việc Google chỉ yêu cầu dữ liệu cho một tập hợp con các cơ sở lưu trú chứ không phải tất cả các cơ sở lưu trú. Chế độ này có thể làm giảm đáng kể lưu lượng truy cập mạng khi cập nhật giá và tình trạng phòng cho các cơ sở lưu trú của bạn. Giá được lưu vô thời hạn trong bộ nhớ đệm cho đến khi được cập nhật. Để biết thêm thông tin, hãy xem bài viết Sử dụng chế độ Mức giá đã thay đổi.

Ngoài việc cập nhật giá, bạn có thể sử dụng thông báo Giao dịch để xoá cơ sở lưu trú khỏi quỹ phòng của mình. Để biết thêm thông tin, hãy tham khảo bài viết Xóa quỹ phòng.

Để biết thêm thông tin về việc cung cấp thông tin cập nhật về giá, bao gồm cả ví dụ về thông báo Giao dịch, hãy tham khảo bài viết Cập nhật giá.

Truy vấn mức giá hiện tại

Google cũng có thể yêu cầu một số thông tin cập nhật về giá tại thời điểm đấu giá bằng Truy vấn giá hiện tại. Truy vấn giá hiện tại là các yêu cầu về giá mà Google gửi cho một phiên đấu giá hiện tại. Nếu bạn phản hồi trong khung thời gian quy định, thì quảng cáo của bạn sẽ xuất hiện trong phiên đấu giá.

Google sẽ lưu trữ thông tin phản hồi cho một Truy vấn giá hiện tại giống như với mọi thông báo Giao dịch khác. Do đó, Google có thể phân phát giá từ bộ nhớ đệm thay vì gửi một Truy vấn giá hiện tại khác trong tương lai.

Để biết thêm thông tin, hãy tham khảo bài viết Truy vấn về giá hiện tại.

Bối cảnh

Các truy vấn Chế độ phân phối giá lấy dữ liệu và Mức giá đã thay đổi thường không chỉ định thông tin về người dùng vì Google đang dùng phản hồi của bạn để lấp đầy bộ nhớ đệm (có thể được dùng để phục vụ nhiều loại người dùng).

Vì bạn có thể sẽ tốn kém khi trả về giá tương ứng với toàn bộ ngữ cảnh người dùng có thể có, nên một tính năng đang được kiểm thử trong đó ngữ cảnh người dùng phổ biến được chỉ định như một phần của truy vấn. Bối cảnh người dùng dựa trên yêu cầu của người dùng mà trong đó bạn đã có cơ hội hiển thị giá và được tính toán để bao gồm phần lớn yêu cầu của người dùng. Bạn có thể thấy số lượng lớn ngữ cảnh người dùng cho các thuộc tính hoặc hành trình rất phổ biến, nhưng số lượng ngữ cảnh người dùng trung bình sẽ nhỏ hơn 10. Bạn có thể trả về các giá bổ sung hoặc bỏ qua ngữ cảnh người dùng đã chỉ định. Bạn có quyền quyết định giá nào cần trả về cho một truy vấn nhất định. Tuy nhiên, việc bỏ qua ngữ cảnh người dùng được đề xuất có thể dẫn đến lưu lượng truy cập thấp hơn.

Chế độ phân phối Gửi dữ liệu ARI

Khi dùng chế độ phân phối Gửi dữ liệu ARI, bạn sẽ gửi thông tin cập nhật bổ sung cho Google bất cứ khi nào giá mỗi đêm, tình trạng phòng, số lượng quỹ phòng hoặc các quy định hạn chế khác có thay đổi. Không giống như chế độ phân phối giá lấy dữ liệu hoặc mức giá đã thay đổi, chế độ phân phối Gửi dữ liệu ARI cho phép bạn sử dụng một mô hình định giá khác để cập nhật hiệu quả các thành phần của thông tin giá cho Google.

Sơ đồ dưới đây cho thấy quy trình yêu cầu và phản hồi của chế độ phân phối Gửi dữ liệu ARI:

fig1

Bước 1: Gửi thông báo đẩy ARI đến Google

Để cập nhật dữ liệu của bạn bằng chế độ Gửi dữ liệu ARI, hãy gửi thông báo yêu cầu ARI bất cứ khi nào dữ liệu của bạn thay đổi. Chế độ phân phối Gửi dữ liệu ARI hỗ trợ nhiều loại thông báo và chiến lược đặt giá. Để biết thông tin chi tiết về thông báo đẩy, hãy tham khảo bài viết Sử dụng ARI.

Google sẽ phân phát giá của bạn và cho người dùng thấy giá trong vòng 15 đến 20 phút kể từ khi nhận được thông báo.

Bước 2: Xác nhận dữ liệu đã được Google lưu vào bộ nhớ đệm thành công

Đối với mỗi thông báo Gửi dữ liệu ARI nhận được, Google sẽ phản hồi bằng trạng thái kết nối HTTP và kết quả xử lý ARI. Google sẽ phản hồi bằng HTTP 200 OK nếu kết nối thành công với máy chủ. API này cũng bao gồm phần nội dung có thông báo phản hồi cho biết liệu nội dung cập nhật đã được áp dụng thành công hay chưa hay gặp phải cảnh báo hoặc lỗi về chế độ phân phối.

Địa chỉ IP trong danh sách cho phép

Để đưa bất kỳ địa chỉ IP nào vào danh sách cho phép mà bạn dùng để gửi thông báo ARI đến Google, hãy sử dụng trang cài đặt giá ARI của Hotel Center. Tìm hiểu cách cập nhật chế độ cài đặt giá trong Hotel Center.

Cập nhật siêu dữ liệu về Phòng và Gói dịch vụ bằng chế độ Gửi dữ liệu ARI

Sử dụng loại thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) để xác định loại phòng và gói giá (gói) đang hoạt động của từng cơ sở lưu trú. Bạn nên gửi thông tin cập nhật bất cứ khi nào loại phòng hoặc gói giá được thêm, xoá hoặc sửa đổi. Trong trường hợp này, bạn sẽ gửi thông báo XML kèm theo thông tin mới trong các phần tử <RoomData><PackageData>. Các phần tử này là phần tử con của phần tử <PropertyDataSet>.

Lỗi Kết nối hoặc lỗi Nội dung

Nếu bạn gặp lỗi chế độ phân phối do XML không đúng định dạng hoặc không chính xác, hãy tìm cách giải quyết được đề xuất trong phần Thông báo lỗi trạng thái nguồn cấp dữ liệu.

Nếu bạn gặp lỗi kết nối HTTP khi gửi thông báo ARI đến Google, hãy thử gửi lại yêu cầu sau 1, 5 và 20 phút. Nếu vẫn gặp lỗi sau 3 lần thử lại, hãy ngừng gửi thông báo và liên hệ với Nhóm hỗ trợ Google.

Chế độ phân phối dùng phương thức kéo

Với chế độ phân phối Lấy dữ liệu, Google sẽ định kỳ gửi Thông báo truy vấn đến máy chủ của bạn để yêu cầu thông tin cập nhật về giá. Máy chủ của bạn sẽ phản hồi các thông báo đó bằng thông báo Giao dịch chứa dữ liệu mới về giá và tình trạng phòng.

Sơ đồ dưới đây cho thấy quy trình yêu cầu/phản hồi của chế độ Lấy dữ liệu:

fig2

Sau khi nhận được thông tin cập nhật về giá, Google thường sẽ xử lý dữ liệu mới về giá và tình trạng phòng trong vòng khoảng 5 phút.

Phần sau đây sẽ mô tả chi tiết hơn về từng bước này.

Bước 1: Thông báo truy vấn

Theo mặc định, Google sẽ gửi thông báo Truy vấn đối với tất cả các cơ sở lưu trú đã xác định trong Danh sách khách sạn của bạn. Điều này có nghĩa là bạn sẽ nhận được nhiều thông báo Truy vấn trong quá trình định giá lại.

Thông báo Truy vấn giá mà Google gửi đến máy chủ của bạn có các đặc điểm sau:

  • Phần tử gốc là <Query>.
  • Gửi đến điểm cuối được xác định trong quá trình định cấu hình ban đầu của bạn. Để biết thêm thông tin, hãy liên hệ với Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM).
  • Sử dụng phương thức HTTP POST. (Nếu đang sử dụng HTTPS, bạn cần phải yêu cầu miền được ký bởi một tổ chức phát hành chứng chỉ chính thức.)
  • Tiêu đề Content-Type được đặt thành application/xml.
  • Mỗi thông báo bao gồm tối đa 100 cơ sở lưu trú cần Google yêu cầu dữ liệu về giá và tình trạng phòng.
  • Tiêu đề User-Agent được đặt thành Google-HotelAdsPrices.

Bước 2: Thông báo Giao dịch

Khi nhận được thông báo Truy vấn, máy chủ phải phản hồi bằng thông báo Giao dịch chứa thông tin về giá của các hành trình được yêu cầu.

Thành phần gốc của thông báo Giao dịch là <Transaction>. Để biết thêm thông tin, hãy tham khảo bài viết Thông báo giao dịchCập nhật giá.

Cập nhật siêu dữ liệu về Phòng và Gói dịch vụ

Ngoài việc cập nhật dữ liệu giá bằng chế độ Lấy dữ liệu, bạn cũng có thể sử dụng thông báo Giao dịch để cập nhật siêu dữ liệu về phòng và gói dịch vụ của mình. Để biết thêm thông tin, hãy tham khảo bài viết Xác định siêu dữ liệu về phòng và gói.

Chế độ phân phối Mức giá đã thay đổi

Chế độ Mức giá đã thay đổi giúp giảm kích thước và số lượng của các thông báo Truy vấn và Giao dịch cần đến để cập nhật giá. Khi sử dụng chế độ Mức giá đã thay đổi, bạn sẽ gửi cho Google danh sách các cơ sở lưu trú có giá mới cập nhật. Google sẽ phản hồi bằng một thông báo Truy vấn chỉ hỏi giá của các cơ sở lưu trú đó.

Để định cấu hình điểm cuối mà Google sẽ gửi thông báo Yêu cầu gợi ý đến, hãy tham khảo ý kiến của Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM). Bạn nên thiết lập chế độ này trong quá trình định cấu hình ban đầu.

Biểu đồ dưới đây cho thấy quy trình yêu cầu và phản hồi của chế độ Mức giá đã thay đổi:

fig3

Các phần sau đây sẽ mô tả từng bước trong quy trình này.

Bước 1: Thông báo Yêu cầu gợi ý

Thông báo Yêu cầu gợi ý mà Google gửi đến máy chủ của bạn có các đặc điểm sau:

  • Thành phần gốc là <HintRequest>.
  • Gửi đến điểm cuối được xác định trong quá trình định cấu hình ban đầu của bạn. Để biết thêm thông tin, hãy liên hệ với Giám đốc Quản lý Khách hàng về Kỹ thuật (TAM) của bạn.
  • Sử dụng phương thức HTTP POST. (Nếu đang sử dụng HTTPS, bạn sẽ phải yêu cầu miền được một tổ chức phát hành chứng chỉ chính thức ký.)
  • Tiêu đề Content-Type được đặt thành application/xml.
  • Google sẽ gửi dấu thời gian đến máy chủ của bạn theo một tần suất nhất định để xác định lần gần đây nhất bạn phản hồi thông báo Yêu cầu gợi ý.
  • Tiêu đề User-Agent được đặt thành Google-HotelAdsPrices.

Bạn nên đặt tần suất thành 5 phút. Để đặt hoặc sửa đổi tần suất thông báo Yêu cầu gợi ý, hãy liên hệ với chúng tôi.

Khi nhận được thông báo Yêu cầu gợi ý từ Google, bạn sẽ phản hồi bằng cách cung cấp tất cả các mức giá đã được cập nhật kể từ dấu thời gian đó. Để biết thêm thông tin, hãy tham khảo bài viết Thông báo Yêu cầu gợi ý.

Bước 2: Thông báo Phản hồi gợi ý

Máy chủ của bạn sẽ phản hồi thông báo Yêu cầu gợi ý bằng thông báo Phản hồi gợi ý. Thông báo này chứa mã khách sạn và hành trình của những cơ sở lưu trú có giá đã thay đổi kể từ lần gần đây nhất bạn nhận và trả lời thông báo Yêu cầu gợi ý.

Thành phần gốc của thông báo Phản hồi gợi ý là <Hint>. Để biết thêm thông tin, hãy tham khảo bài viết Thông báo Phản hồi gợi ý.

Bước 3: Thông báo truy vấn

Google nhận được thông báo Phản hồi gợi ý và phản hồi bằng thông báo Truy vấn, giống như trong chế độ Lấy dữ liệu tiêu chuẩn. Điểm khác biệt là giờ đây, thông báo Truy vấn chỉ chứa mã khách sạn và hành trình của các cơ sở lưu trú mà bạn đã chỉ định trong thông báo Phản hồi gợi ý. Phần tử gốc của thông báo Truy vấn là <Query>.

Khi xác định mã khách sạn để yêu cầu giá bằng chế độ Mức giá đã thay đổi, Google sẽ bỏ qua nội dung của Nguồn cấp dữ liệu danh sách khách sạn của bạn. Điều này làm giảm đáng kể kích thước của thông báo Truy vấn mà bạn nhận được từ Google cũng như kích thước của thông báo Giao dịch trong phản hồi của bạn.

Bước 4: Thông báo Giao dịch

Bạn gửi một thông báo Giao dịch chứa thông tin cập nhật về giá để phản hồi thông báo Truy vấn của Google. Thành phần gốc của thông báo Giao dịch là <Transaction>. Để biết thêm thông tin, hãy tham khảo Chế độ phân phối dùng tính năng kéo.