Mode Pengiriman Harga

Mode pengiriman menentukan cara Anda mengirim pembaruan harga ke Google untuk kombinasi hotel/itinerari.

Anda dan Manajer Akun Teknis (TAM) akan bekerja sama selama konfigurasi awal untuk menyiapkan mode pengiriman.

Ringkasan mode pengiriman

Secara default, partner kami dapat dikueri hingga 330 hari ke depan untuk ketersediaan kamar dan hingga 30 malam menginap, tetapi Anda dapat memilih jumlah itinerari (kombinasi tanggal check in dan lama menginap) untuk setiap hotel.

Semakin banyak itinerari yang Anda dukung, semakin banyak lelang yang akan Anda ikuti. Namun, semakin banyak itinerari yang Anda dukung, semakin banyak data yang harus Anda kirim ke Google agar data harga Anda tetap akurat.

Metode standar dalam memperbarui harga adalah menggunakan pesan Transaksi dengan salah satu cara berikut:

  • ARI (Push): Feed pengiriman harga yang memanfaatkan paket tarif, ketersediaan, dan metadata hotel untuk menetapkan strategi penetapan harga yang telah ditentukan sebelumnya untuk properti Anda. Tidak seperti Pull dan Harga yang Diubah, feed ARI tidak mengkueri harga atau itinerari tertentu. Sebagai gantinya, partner mengirimkan pesan berisi subkumpulan informasi yang mewakili model harga untuk properti Anda berdasarkan berbagai detail tarif, batasan, dan ketersediaan. Feed ARI memanfaatkan spesifikasi XML OTA (OTA_HotelRateAmountNotifRQ dan OTA_HotelAvailNotifRQ) untuk menentukan ketersediaan serta harga. Hubungi manajer akun Anda untuk mempelajari mode pengiriman ARI lebih lanjut dan untuk menentukan apakah jenis feed ini paling cocok untuk akun Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan ARI.
  • Pull: Google mengkueri layanan Anda secara rutin untuk memperbarui cache data harga dan ketersediaan. Dalam model ini, Google mengirimkan permintaan ke server Anda, lalu server Anda merespons dengan data yang diperbarui. Model ini sangat cocok untuk partner yang tidak mengetahui kapan informasi harga berubah, atau apakah informasi harga berubah secara tidak rutin sepanjang hari. Harga tersimpan dalam cache hingga algoritme Google menentukan bahwa harga sudah tidak berlaku (berdasarkan histori perubahan harga sebelumnya untuk partner tertentu). Untuk informasi mengetahui selengkapnya, lihat Menggunakan Mode Pengiriman Pull.
  • Harga yang Diubah (sebelumnya disebut Pull dengan Petunjuk): Sama seperti Pull, tetapi Google hanya meminta data untuk subkumpulan properti, bukan semua properti. Mode ini dapat mengurangi jumlah traffic jaringan secara signifikan saat memperbarui harga dan ketersediaan untuk properti Anda. Harga tetap tersimpan dalam cache tanpa batas waktu hingga diperbarui. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Harga yang Diubah.

Selain memperbarui harga, Anda dapat menggunakan pesan Transaksi untuk menghapus properti dari inventaris Anda. Untuk mengetahui informasi selengkapnya, lihat Menghapus Inventaris.

Untuk mengetahui informasi selengkapnya tentang memberikan pembaruan harga, termasuk contoh pesan Transaksi, lihat Memperbarui Harga.

Kueri Harga Real Time

Google juga dapat meminta beberapa pembaruan harga pada saat lelang dengan Kueri Harga Real Time. Kueri Harga Real Time adalah permintaan harga dari Google untuk lelang saat ini. Jika Anda merespons dalam jangka waktu yang ditentukan, iklan Anda akan muncul di lelang.

Google menyimpan respons terhadap Kueri Harga Real Time seperti yang dilakukan pada pesan Transaksi lainnya. Hasilnya, Google dapat menampilkan harga dari cache-nya daripada mengirim Kueri Harga Real Time lainnya di masa mendatang.

Untuk mengetahui informasi selengkapnya, lihat Kueri Harga Real Time.

Menggunakan ARI Push

Dengan mode pengiriman ARI Push, Anda mengirimkan pembaruan inkremental ke Google setiap kali tarif per malam, ketersediaan, jumlah inventaris, atau pembatasan lainnya berubah. Tidak seperti Pull atau Harga yang Diubah, ARI Push memungkinkan Anda memanfaatkan model harga yang berbeda untuk secara efisien memperbarui berbagai komponen informasi harga ke Google.

Diagram berikut menunjukkan alur permintaan/respons untuk mode pengiriman ARI Push:

Langkah 1: Mengirim pesan ARI Push ke Google

Untuk memperbarui data dengan ARI Push, kirim pesan permintaan ARI setiap kali data Anda berubah. Mode pengiriman ARI Push mendukung berbagai jenis pesan dan strategi harga. Untuk mengetahui informasi mendetail tentang mengirim pesan, lihat Menggunakan ARI.

Harga Anda akan ditampilkan oleh Google dan dapat dilihat oleh pengguna dalam 15 hingga 20 menit setelah pesan diterima.

Langkah 2: Mengonfirmasi data berhasil di-cache oleh Google

Untuk setiap pesan ARI Push yang diterima, Google akan merespons dengan status koneksi HTTP dan hasil pemrosesan ARI. Google akan merespons dengan HTTP 200 OK jika koneksi ke server berhasil. Ini juga mencakup isi dengan pesan respons yang menunjukkan apakah pembaruan berhasil diterapkan atau mengalami peringatan/error mode pengiriman.

Mengizinkan Daftar Alamat IP

Untuk mengizinkan daftar alamat IP yang Anda gunakan untuk mengirimkan pesan ARI ke Google, gunakan halaman setelan harga ARI Pusat Pengelolaan Hotel. Pelajari cara memperbarui setelan harga di Pusat Pengelolaan Hotel.

Memperbarui metadata Kamar dan Paket dengan ARI Push

Gunakan jenis pesan Transaksi (Data Properti) untuk menentukan jenis kamar dan paket tarif (paket) yang aktif untuk setiap properti. Anda harus mengirimkan pembaruan setiap kali jenis kamar atau paket tarif ditambahkan, dihapus, atau diubah. Dalam hal ini, kirimkan pesan XML dengan informasi baru di elemen <RoomData> dan <PackageData>. Elemen ini adalah turunan dari elemen <PropertyDataSet>.

Error Koneksi atau Konten

Jika Anda menerima error mode pengiriman karena format XML salah atau tidak benar, temukan penyelesaian yang direkomendasikan di Pesan Error Status Feed.

Jika Anda menerima error koneksi HTTP saat mengirim pesan ARI ke Google, coba lagi permintaan tersebut pada interval 1, 5, dan 20 menit. Jika masalah berlanjut setelah 3 percobaan ulang, hentikan pengiriman pesan dan hubungi Dukungan Google.

Menggunakan Pull

Dengan mode pengiriman Pull, Google mengirimkan pesan Kueri secara berkala ke server Anda untuk meminta pembaruan harga. Server Anda merespons pesan tersebut dengan pesan Transaksi yang berisi data harga dan ketersediaan yang diperbarui.

Diagram berikut menunjukkan alur permintaan/respons Pull:

Setelah menerima pembaruan harga, Google biasanya memproses data ketersediaan dan harga baru kurang lebih dalam 5 menit.

Bagian berikut menjelaskan setiap langkah ini secara lebih detail.

Langkah 1: Pesan Kueri

Secara default, Google mengirimkan pesan Kueri untuk semua properti yang ditentukan di Daftar Hotel Anda. Hal ini dapat berarti Anda akan menerima beberapa pesan Kueri selama proses pengaturan ulang harga.

Pesan Kueri harga yang dikirimkan Google ke server Anda memiliki karakteristik berikut:

  • Elemen root-nya adalah <Query>.
  • Dikirim ke endpoint yang ditentukan selama konfigurasi awal Anda. Untuk mengetahui informasi selengkapnya, hubungi Manajer Akun Teknis (TAM) Anda.
  • Menggunakan metode POST HTTP. (Jika menggunakan HTTPS, Anda harus mendapatkan domain yang ditandatangani oleh certificate authority resmi.)
  • Header Content-Type ditetapkan ke "application/xml".
  • Setiap pesan mencakup hingga 100 properti yang data ketersediaan dan harganya diminta oleh Google.
  • Header User-Agent ditetapkan ke "Google-HotelAdsPrices".

Langkah 2: Pesan Transaksi

Saat menerima pesan Kueri, server Anda harus merespons dengan pesan Transaksi yang berisi informasi harga untuk itinerari yang diminta.

Elemen root pesan Transaksi adalah <Transaction>. Untuk mengetahui informasi selengkapnya, lihat Pesan Transaksi dan Memperbarui Harga.

Memperbarui Metadata Kamar dan Paket

Selain memperbarui data harga dengan Pull, Anda juga dapat menggunakan pesan Transaksi untuk memperbarui metadata kamar dan paket. Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata paket dan kamar.

Menggunakan Harga yang Diubah

Harga yang Diubah membantu mengurangi ukuran dan kuantitas pesan Transaksi dan Kueri untuk pembaruan harga. Saat menggunakan Harga yang Diubah, Anda mengirimkan daftar properti yang harganya diperbarui ke Google. Google akan merespons dengan pesan Kueri yang hanya meminta harga properti tersebut.

Untuk mengonfigurasi endpoint yang menerima pesan Permintaan Petunjuk oleh Google, hubungi Manajer Akun Teknis (TAM) Anda. Anda akan menyiapkannya selama konfigurasi awal.

Diagram berikut menunjukkan alur permintaan/respons untuk Harga yang Diubah:

Bagian berikut ini menjelaskan setiap langkah dalam alur permintaan/respons ini.

Langkah 1: Pesan Permintaan Petunjuk

Pesan Permintaan Petunjuk yang dikirimkan Google ke server Anda memiliki karakteristik berikut:

  • Elemen root-nya adalah <Query>.
  • Dikirim ke endpoint yang ditentukan selama konfigurasi awal Anda. Untuk mengetahui informasi selengkapnya, hubungi Manajer Akun Teknis (TAM) Anda.
  • Menggunakan metode POST HTTP. (Jika menggunakan HTTPS, Anda harus mendapatkan domain yang ditandatangani oleh certificate authority resmi.)
  • Header Content-Type ditetapkan ke "application/xml".
  • Pada frekuensi yang ditentukan, Google mengirimkan stempel waktu ke server Anda yang menentukan kapan terakhir kali Anda merespons pesan Permintaan Petunjuk.
  • Header User-Agent ditetapkan ke "Google-HotelAdsPrices".

Google merekomendasikan agar Anda menyetel frekuensi ke 5 menit. Untuk menyetel atau mengubah frekuensi pesan Permintaan Petunjuk, hubungi kami.

Saat menerima pesan Permintaan Petunjuk dari Google, Anda merespons dengan semua harga yang telah diperbarui sejak stempel waktu tersebut. Untuk mengetahui informasi selengkapnya, lihat Pesan Permintaan Petunjuk.

Langkah 2: Pesan Respons Petunjuk

Server Anda merespons pesan Permintaan Petunjuk dengan pesan Respons Petunjuk. Pesan ini berisi ID hotel dan itinerari untuk properti yang harganya telah berubah sejak terakhir kali Anda menerima dan merespons pesan Permintaan Petunjuk.

Elemen root pesan Respons Petunjuk adalah <Hint>. Untuk mengetahui informasi selengkapnya, lihat Pesan Respons Petunjuk.

Langkah 3: Pesan Kueri

Google menerima pesan Respons Petunjuk dan merespons dengan pesan Kueri, sama seperti mode Pull standar. Perbedaannya adalah pesan Kueri sekarang hanya berisi ID hotel dan itinerari untuk properti yang Anda tentukan di pesan Respons Petunjuk. Elemen root pesan Kueri adalah <Query>.

Saat menentukan ID hotel mana yang akan meminta harga menggunakan Harga yang Diubah, Google mengabaikan isi Feed Daftar Hotel Anda. Ini akan sangat mengurangi ukuran pesan Kueri yang Anda terima dari Google dan ukuran pesan Transaksi respons Anda.

Langkah 4: Pesan Transaksi

Anda mengirim pesan Transaksi dengan pembaruan harga sebagai respons atas pesan Kueri Google. Elemen root pesan Transaksi adalah <Transaction>. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Pull.