Ringkasan ARI

Ketersediaan, Tarif, dan Inventaris (ARI) adalah mode pengiriman harga yang mengontrol tarif, ketersediaan, dan inventaris per malam, serta memberikan batasan terkait cara penggabungan keduanya. ARI juga memberikan fleksibilitas untuk menyertakan pajak, biaya, dan promosi.

Tidak seperti mode pengiriman harga berbasis itinerari, Pull dan Harga yang Diubah, feed ARI tidak dikueri untuk harga atau itinerari tertentu. Sebagai gantinya, Anda mengirim pesan saat model harga Anda memiliki data baru atau yang berubah, seperti perubahan pada detail tarif, batasan, dan ketersediaan.

Manfaat

ARI menawarkan manfaat berikut:

  • Efisiensi bandwidth: Meningkatkan efisiensi bandwidth dengan mengurangi volume data yang perlu dikirim. Dengan mengirimkan data ARI per malam dan hanya perubahan inkremental, Google dapat menghitung harga dan info terbaru untuk berbagai nilai pembelian di muka dan lama menginap.

  • Akurasi harga: Meningkatkan akurasi harga dengan menggunakan model peristiwa push-on-change untuk memberikan info terbaru langsung.

  • Cakupan harga yang lebih luas: Mencapai cakupan harga yang lebih tinggi (jumlah itinerari dengan harga) menggunakan data terperinci yang digabungkan ke dalam berbagai itinerari.

  • Fleksibilitas: Memungkinkan fleksibilitas yang lebih besar dengan menawarkan promosi dan paket.

  • Kemudahan Penggunaan: Mengirimkan data dengan cara yang sesuai dengan cara data disimpan di sistem Anda, sehingga tidak perlu menghitung atau meng-cache harga untuk banyak itinerari.

Jenis pesan permintaan

Pesan ARI yang dikirim ke Google disebut sebagai pesan "permintaan" ARI. Kemudian, Google akan menampilkan pesan "respons" yang menunjukkan keberhasilan atau kegagalan.

ARI mengikuti protokol standar OpenTravel Alliance (OTA) untuk beberapa jenis pesan utama guna menentukan ketersediaan dan inventaris.

ARI menggunakan pesan permintaan berikut:

  • Transaction (Data Properti). Menentukan jenis kamar dan informasi paket (paket tarif).

  • OTA_HotelRateAmountNotifRQ. Menentukan jumlah tarif jumlah tamu per tanggal atau berdasarkan LOS per produk (kombinasi jenis kamar dan paket tarif) untuk rentang tanggal tertentu.

  • OTA_HotelAvailNotifRQ. Menentukan ketersediaan dan batasan berdasarkan jenis kamar dan paket tarif. Inventaris juga dapat diperbarui menggunakan pesan ini, tetapi OTA_HotelInvCountNotifRQ lebih disarankan.

  • OTA_HotelInvCountNotifRQ. Menentukan inventaris kamar fisik atau jumlah kamar yang tersedia untuk dijual.

  • TaxFeeInfo. (Opsional) Menentukan pajak dan biaya per properti. Pesan ini tidak diperlukan jika AmountAfterTax ditentukan dalam pesan OTA_HotelRateAmountNotifRQ.

  • Promotions. (Opsional) Menentukan tarif promosi untuk pemesanan, penginapan, dan pengguna tertentu.

  • RateModifications. (Opsional) Menentukan aturan perubahan tarif untuk pemesanan, penginapan, dan pengguna tertentu.

  • ExtraGuestCharges. (Opsional) Menentukan bagaimana tarif harus dikonfigurasi untuk anak-anak dan orang dewasa tambahan.

Setiap pesan berisi subkumpulan informasi yang digunakan Google untuk menghitung harga dan ketersediaan yang ditampilkan kepada pengguna saat mereka menelusuri properti Anda dengan tanggal check-in dan check-out tertentu serta jumlah tamu yang diinginkan.

Untuk mengetahui informasi selengkapnya tentang ARI, lihat Referensi XML.

Pesan push

Untuk memperbarui ARI dan informasi properti, kirim pesan terkait setiap kali data berubah di sistem Anda.

Gunakan panduan berikut saat mengirim pesan:

  • Gunakan alat layanan mandiri di halaman Setelan Harga Pusat Pengelolaan Hotel untuk menambahkan atau memperbarui alamat IP Anda di sistem kami.

  • Gunakan jalur dasar berikut untuk endpoint:

    • https://www.google.com atau Host: www.google.com Port: 443

  • Kirim pesan menggunakan metode HTTP POST.

  • Tetapkan header Content-Type ke application/xml.

  • Ada tingkat pembaruan maksimum tingkat akun sebanyak 400 pesan per detik. Jika Anda melebihi batas ini, kode error 6032 akan ditampilkan.

  • Gunakan jalur berikut, bergantung pada data yang diperbarui:

    • Transaction (Data Properti): /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

Untuk setiap pesan permintaan yang diterima, Google akan merespons dengan HTTP 200 OK jika koneksi ke server berhasil dan menyertakan isi dengan pesan respons yang menunjukkan apakah update berhasil diterapkan atau mengalami peringatan atau error. Jika Google merespons dengan kode error HTTP, kirim ulang pesan. Jika isi respons HTTP berisi peringatan atau error, respons tersebut harus diperbaiki sebelum mengirim ulang pesan. Anda juga dapat melihat masalah yang dialami untuk pesan tertentu pada halaman Status Feed di Pusat Pengelolaan Hotel.

Live di Google (LoG)

Live di Google (LoG) memungkinkan Anda menampilkan hotel di situs Google. Karena nilai LoG default untuk hotel adalah true, semua hotel baru akan otomatis ditampilkan di Google.

Gunakan LoG untuk mengaktifkan dan menonaktifkan properti Anda untuk iklan dan link pemesanan gratis di akun Pusat Pengelolaan Hotel, terlepas dari status Google Ads atau apakah properti memiliki tarif di Google atau tidak. Ini hanya berlaku untuk hotel, bukan rental akomodasi.

Ada dua cara untuk menetapkan nilai LoG hotel: 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.

Untuk mengetahui detail selengkapnya tentang LoG, lihat Bantuan Pusat Pengelolaan Hotel.

Menggunakan Travel Partner API, you can do the following:

  • Lihat status properti Anda melalui Pusat Pengelolaan Hotel atau gunakan endpoint hotelViews.list.

  • Ambil daftar semua hotel Anda yang ditampilkan di Google menggunakan parameter filter dengan liveOnGoogle = TRUE di endpoint hotelViews.list.

  • Dapatkan ringkasan properti untuk akun tertentu, termasuk jumlah properti yang tersedia di Google menggunakan hotelViews.summary.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan LoG menggunakan API, lihat artikel hotelViews.list dan Referensi API.