Tổng quan về ARI

Tình trạng phòng, giá và quỹ phòng (ARI) là một chế độ phân phối giá kiểm soát giá mỗi đêm, tình trạng phòng và quỹ phòng, đồng thời đặt ra những quy tắc ràng buộc về cách kết hợp những giá trị này. ARI cũng giúp bạn linh hoạt thêm các khoản thuế, phí và chương trình khuyến mãi.

Không giống như chế độ phân phối giá dựa trên hành trình, chế độ Lấy dữ liệu và Mức giá đã thay đổi, nguồn cấp dữ liệu ARI không được truy vấn để lấy giá hoặc hành trình cụ thể. Thay vào đó, bạn sẽ đẩy thông báo khi mô hình đặt giá có dữ liệu mới hoặc dữ liệu đã thay đổi, chẳng hạn như các thay đổi về mức giá, các quy định hạn chế và tình trạng phòng.

Lợi ích

ARI mang đến những lợi ích sau:

  • Hiệu quả băng thông: Tăng hiệu quả băng thông bằng cách giảm lượng dữ liệu cần truyền. Bằng cách gửi dữ liệu ARI hằng đêm và chỉ các thay đổi tăng dần, Google có thể tính toán giá và thông tin cập nhật cho nhiều loại giá trị mua trước và thời gian lưu trú.

  • Độ chính xác về giá: Cải thiện độ chính xác về giá bằng cách sử dụng mô hình sự kiện đẩy thay đổi để cung cấp thông tin cập nhật trực tiếp.

  • Phạm vi bao phủ của giá lớn hơn: Đạt được phạm vi bao phủ của giá cao hơn (số lượng hành trình có giá) bằng cách sử dụng dữ liệu chi tiết được kết hợp thành nhiều hành trình.

  • Tính linh hoạt: Cho phép linh hoạt hơn khi cung cấp các chương trình khuyến mãi và gói.

  • Dễ sử dụng: Truyền dữ liệu theo cách phù hợp với cách dữ liệu được lưu trữ trên hệ thống của bạn, tránh phải tính toán hoặc lưu giá vào bộ nhớ đệm cho nhiều hành trình.

Loại tin nhắn yêu cầu

Thông báo ARI gửi đến Google được gọi là thông báo "yêu cầu" ARI. Theo đó, Google sẽ trả về các thông báo "phản hồi" cho biết thành công hay không.

ARI tuân theo các giao thức tiêu chuẩn của OpenTravel Alliance (OTA) đối với một số loại thông báo chính để xác định tình trạng còn hàng và quỹ phòng.

ARI sử dụng các thông báo yêu cầu sau:

  • Transaction (Dữ liệu của cơ sở lưu trú). Xác định thông tin về loại phòng và gói (gói giá).

  • OTA_HotelRateAmountNotifRQ. Xác định số tiền cho tỷ lệ kín phòng theo ngày hoặc theo ngày mất khách lưu trú trên mỗi sản phẩm (tổ hợp loại phòng và gói giá) cho các phạm vi ngày cụ thể.

  • OTA_HotelAvailNotifRQ. Xác định tình trạng phòng và quy định hạn chế dựa trên loại phòng và gói giá. Bạn cũng có thể cập nhật quỹ phòng bằng thông báo này, nhưng OTA_HotelInvCountNotifRQ sẽ được ưu tiên.

  • OTA_HotelInvCountNotifRQ. Xác định quỹ phòng thực tế hoặc số phòng còn trống để bán.

  • TaxFeeInfo. (Không bắt buộc) Xác định các khoản thuế và phí cho từng cơ sở lưu trú. Thông báo này là không bắt buộc nếu AmountAfterTax được chỉ định trong thông báo OTA_HotelRateAmountNotifRQ.

  • Promotions. (Không bắt buộc) Xác định giá khuyến mãi cho một số lượt đặt phòng, thời gian lưu trú và người dùng.

  • RateModifications. (Không bắt buộc) Xác định các quy tắc sửa đổi giá cho một số lượt đặt phòng, thời gian lưu trú và người dùng.

  • ExtraGuestCharges. (Không bắt buộc) Xác định cách thiết lập mức giá cho trẻ em và những người lớn khác.

Mỗi thông báo chứa một tập hợp con thông tin mà Google sử dụng để tính toán giá và tình trạng phòng hiển thị cho người dùng khi họ tìm cơ sở lưu trú của bạn kèm theo ngày nhận phòng và trả phòng cụ thể cũng như số người lưu trú mong muốn.

Để biết thêm thông tin về ARI, hãy tham khảo Tài liệu tham khảo XML.

Thông báo đẩy

Để cập nhật thông tin về ARI và cơ sở lưu trú, hãy gửi các thông báo liên quan bất cứ khi nào dữ liệu trong hệ thống của bạn thay đổi.

Hãy làm theo các nguyên tắc sau khi gửi thư:

  • Hãy sử dụng công cụ tự thực hiện trong trang Cài đặt giá của Hotel Center để thêm hoặc cập nhật địa chỉ IP của bạn trong hệ thống của chúng tôi.

  • Sử dụng đường dẫn cơ sở sau đây cho điểm cuối:

    • https://www.google.com hoặc Host: www.google.com Port: 443

  • Gửi thông báo bằng phương thức HTTP POST.

  • Đặt tiêu đề Content-Type thành application/xml.

  • Tốc độ cập nhật tối đa ở cấp tài khoản là 400 tin nhắn/giây. Nếu bạn vượt quá giới hạn này, hệ thống sẽ trả về mã lỗi 6032.

  • Hãy sử dụng các đường dẫn sau, tuỳ thuộc vào dữ liệu đang được cập nhật:

    • Transaction (Dữ liệu của cơ sở lưu trú): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Đối với mỗi thông báo yêu cầu nhận được, Google sẽ phản hồi bằng một HTTP 200 OK nếu kết nối với máy chủ thành công và đính kèm nội dung với thông báo phản hồi cho biết liệu các bản cập nhật được áp dụng thành công hay gặp phải cảnh báo/lỗi. Nếu Google phản hồi bằng mã lỗi HTTP, hãy gửi lại thông báo. Nếu nội dung phản hồi HTTP chứa cảnh báo hoặc lỗi, bạn cần khắc phục các cảnh báo hoặc lỗi đó trước khi gửi lại thông báo. Bạn cũng có thể xem các vấn đề gặp phải với những thông báo cụ thể trên trang Trạng thái nguồn cấp dữ liệu trong Hotel Center.

Xuất hiện trên Google (LoG)

Tính năng Xuất hiện trên Google (LoG) giúp bạn đăng khách sạn của mình trên các trang web của Google. Vì giá trị LoG mặc định của một khách sạn là true, nên mọi khách sạn mới sẽ tự động xuất hiện trên Google.

Sử dụng LoG để bật hoặc tắt quảng cáo và các đường liên kết miễn phí để đặt phòng cho các cơ sở lưu trú của bạn trong tài khoản Hotel Center, bất kể trạng thái của Google Ads hay việc cơ sở lưu trú có đăng giá trên Google hay không. Chính sách này chỉ áp dụng cho các khách sạn chứ không áp dụng cho nhà/căn hộ du lịch.

Có hai cách để đặt giá trị LoG của khách sạn: Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Để biết thêm thông tin về LoG, vui lòng tham khảo bài viết Trợ giúp của Hotel Center.

Sử dụng Travel Partner API, you can do the following:

  • Bạn có thể xem trạng thái của cơ sở lưu trú thông qua Hotel Center hoặc sử dụng điểm cuối hotelViews.list.

  • Truy xuất danh sách tất cả các khách sạn của bạn xuất hiện trên Google bằng cách sử dụng tham số filter với liveOnGoogle = TRUE trong điểm cuối hotelViews.list.

  • Nhận bản tóm tắt về các cơ sở lưu trú cho một tài khoản cụ thể, bao gồm cả số lượng cơ sở lưu trú xuất hiện trên Google bằng cách sử dụng hotelViews.summary.

Để biết thêm thông tin về cách đặt LoG bằng API, hãy tham khảo bài viết hotelViews.list và Tài liệu tham khảo API.