Tổng quan về ARI

Tình trạng phòng, giá phòng 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 các quy tắc ràng buộc về cách kết hợp các yếu tố này. ARI cũng linh hoạt trong việc 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 theo 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ẽ gửi thông báo khi mô hình đặt giá của bạn có dữ liệu mới hoặc thay đổi dữ liệu, chẳng hạn như thay đổi về đơn giá, quy định hạn chế và tình trạng phòng.

Lợi ích

ARI mang lại các 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ỉ những thay đổi gia tăng, Google có thể tính toán giá và cập nhật cho nhiều giá trị về thời gian lưu trú và đặt phòng trước.

  • 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 khi thay đổi để cung cấp thông tin cập nhật trực tiếp.

  • Mức độ phù hợp về giá cao hơn: Đạt được mức độ phù hợp về 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 vào nhiều hành trình.

  • Linh hoạt: Cho phép 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ễ sử dụng: Truyền dữ liệu theo cách phù hợp với cách lưu trữ dữ liệu trên hệ thống, giúp bạn không cần 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ề 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 chuẩn của OpenTravel Alliance (OTA) cho một số loại thông báo chính để xác định tình trạng phò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ơ 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 theo tỷ lệ lấp đầy theo ngày hoặc LOS cho mỗi sản phẩm (kiểu phòng và tổ hợp gói giá) cho các phạm vi ngày cụ thể.

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

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

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

  • Promotions. (Không bắt buộc) Xác định mức 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 định cấu hình 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 dùng để tính giá và tình trạng phòng để cung cấp cho người dùng khi họ tìm kiếm cơ sở lưu trú của bạn bằng thông tin về ngày nhận phòng, trả phòng và sức chứa mong muốn.

Để biết thêm thông tin về ARI, hãy tham khảo bài viết 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 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ông báo:

  • Bạn có thể sử dụng công cụ tự phục vụ trong trang Cài đặt giá trong Hotel Center để thêm hoặc cập nhật địa chỉ IP 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 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 sẽ được cập nhật:

    • Transaction (Dữ liệu 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 thông báo HTTP 200 OK nếu kết nối với máy chủ thành công và đưa vào phần nội dung một thông báo phản hồi cho biết thông tin 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 thông báo. Nếu nội dung của thông báo phản hồi HTTP chứa cảnh báo hoặc lỗi, bạn phải xử lý trước khi gửi lại thư. 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 trên trang Trạng thái của nguồn cấp dữ liệu trong Hotel Center.

Live on Google (LoG)

Tính năng Trực tiếp trên Google (LoG) cho phép bạn đăng thông tin về khách sạn của mình trên các trang web của Google. Vì giá trị LoG mặc định cho 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 tính năng Xuất hiện trên Google để 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.

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 chi tiết về LoG, hãy tham khảo phần Trợ giúp về Hotel Center.

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

  • 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ả 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.

  • Xem thông tin tóm tắt về các tài sản của một tài khoản cụ thể, bao gồm cả số lượng tài sản 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 về hotelViews.list và Tài liệu tham khảo API.