Ringkasan ARI

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

Tidak seperti mode pengiriman penetapan 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 memiliki data baru atau yang diubah, 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 update untuk berbagai nilai pembelian di awal dan lama menginap.

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

  • Cakupan harga yang lebih besar: 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 selaras dengan cara penyimpanannya 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. Selanjutnya, 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 informasi jenis kamar dan paket (paket tarif).

  • OTA_HotelRateAmountNotifRQ. Menentukan jumlah tingkat keterisian 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 cara tarif 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 lebih lanjut tentang ARI, lihat Referensi XML.

Pesan push

Untuk memperbarui informasi ARI dan 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.

  • Batas update maksimum tingkat akun adalah 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 tersebut. Jika isi respons HTTP berisi peringatan atau error, isi tersebut harus diperbaiki sebelum mengirim ulang pesan. Anda juga dapat melihat masalah yang ditemukan untuk pesan tertentu pada halaman Status Feed di Pusat Pengelolaan Hotel.

Live di Google (LoG)

Live di Google (LoG) memungkinkan Anda menampilkan hotel Anda 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 dan 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 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 tayang di Google dengan menggunakan hotelViews.summary.

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