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 đưa ra những quy tắc ràng buộc về cách kết hợp những thông tin này. ARI cũng cho phép bạn linh hoạt thêm 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ế độ 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 được truy vấn để biết 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 có thay đổi, chẳng hạn như thay đổi về giá, quy định hạn chế và tình trạng phòng.

Lợi ích

ARI mang lại những lợi ích sau:

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

  • Mức độ chính xác về giá: Cải thiện mức độ 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ủ giá lớn hơn: Đạt được phạm vi bao phủ giá cao hơn (số lượng hành trình có mứ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: Giúp bạn linh hoạt hơn trong việc cung cấp các chương trình khuyến mãi và gói dịch vụ.

  • 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 thông báo 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. Sau đó, 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à khoảng không quảng cáo.

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 lưu trú theo ngày hoặc theo thời gian lưu trú theo LOS cho mỗi sản phẩm (tổ hợp loại phòng và gói giá) đối với 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 ưu tiên OTA_HotelInvCountNotifRQ.

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

  • TaxFeeInfo. (Không bắt buộc) Xác định thuế và phí cho mỗi 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 nhất định.

  • RateModifications. (Không bắt buộc) Xác định các quy tắc sửa đổi giá đối với một số lượt đặt phòng, 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à người lớn bổ sung.

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 giá và tình trạng phòng mà người dùng nhìn thấy 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 ARI và thông tin về cơ sở lưu trú, hãy gửi 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 đây khi gửi thông báo:

  • Hãy sử dụng công cụ tự phân phát trên 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 tin nhắn 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 mỗi 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 tài sản): /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à bao gồm một nội dung kèm theo 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 gặp phải cảnh báo hoặc lỗi. Nếu Google phản hồi bằng mã lỗi HTTP, hãy gửi lại tin nhắn. Nếu nội dung phản hồi HTTP chứa cảnh báo hoặc lỗi, thì bạn phải 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 đối với một số thông báo cụ thể trên trang Trạng thái của nguồn cấp dữ liệu trong Hotel Center.

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

Chế độ Xuất hiện trên Google (LoG) cho phép bạn đăng các 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.

Hãy 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. Điều này chỉ áp dụng cho khách sạn chứ không áp dụng cho nhà nghỉ dưỡng cho thuê.

Có 2 cách để đặt giá trị LoG của một 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 chi tiết về LoG, hãy tham khảo phần Trợ giúp của Hotel Center.

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

  • Xem trạng thái của các 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ả khách sạn 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.

  • Xem tóm tắt về các cơ sở lưu trú của một tài khoản cụ thể, bao gồm cả số lượng cơ sở lưu trú đang có trên Google bằng cách sử dụng hotelViews.summary.

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