Mode Pengiriman Harga

Mode pengiriman menentukan cara Anda mengirim pembaruan harga ke Google untuk kombinasi hotel dan itinerari. Anda dan Manajer Akun Teknis (TAM) bekerja sama selama konfigurasi awal untuk menyiapkan mode pengiriman.

Ringkasan mode pengiriman

Secara default, hotel dapat dikueri hingga 330 hari sebelum ketersediaan kamar dan menginap hingga 30 malam, tetapi Anda dapat menentukan jumlah maksimum itinerari (kombinasi tanggal check-in dan lama menginap).

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 untuk memperbarui harga adalah menggunakan pesan Transaksi dengan salah satu cara berikut:

  • ARI (Push): Feed pengiriman harga yang menggunakan paket tarif, ketersediaan, dan metadata hotel untuk menetapkan strategi harga yang telah ditentukan untuk properti Anda. Tidak seperti Harga Pull dan Harga yang Diubah, feed ARI tidak mengkueri harga atau itinerari tertentu. Sebagai gantinya, Anda mengirim pesan yang berisi subkumpulan informasi yang mewakili model harga untuk properti Anda berdasarkan berbagai detail tarif, batasan, dan ketersediaan. Feed ARI menggunakan spesifikasi XML OTA (OTA_HotelRateAmountNotifRQ dan OTA_HotelAvailNotifRQ) untuk menentukan ketersediaan dan harga. Hubungi Account Manager Anda untuk mempelajari mode pengiriman ARI lebih lanjut dan menentukan apakah jenis feed ini paling sesuai 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 mengirim permintaan ke server Anda, dan server Anda merespons dengan data yang diperbarui. Model ini paling cocok jika Anda tidak tahu persis kapan informasi harga berubah, atau apakah informasi harga berubah secara tidak teratur sepanjang hari. Harga tetap tersimpan dalam cache hingga algoritma Google menentukan bahwa harga sudah tidak berlaku, berdasarkan histori perubahan harga sebelumnya khusus partner. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Mode Pengiriman Pull.

  • Harga yang Diubah (sebelumnya Pull dengan Petunjuk): Serupa dengan Pull, kecuali bahwa Google hanya meminta data untuk sebagian 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 cara memberikan pembaruan harga, termasuk contoh pesan Transaksi, lihat Memperbarui Harga.

Kueri Harga Real Time

Google juga dapat meminta beberapa pembaruan harga pada waktu 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 dengan pesan Transaksi lainnya. Akibatnya, Google dapat menampilkan harga dari cache-nya, bukan mengirim Kueri Harga Real Time lainnya di masa mendatang.

Untuk mengetahui informasi selengkapnya, lihat Kueri Harga Real Time.

Konteks

Kueri Harga Pull dan Harga yang Diubah umumnya tidak menentukan informasi tentang pengguna karena Google menggunakan respons Anda untuk mengisi cache yang mungkin digunakan untuk melayani berbagai pengguna yang berbeda.

Karena mungkin mahal bagi Anda untuk menampilkan harga yang sesuai dengan rangkaian lengkap konteks pengguna yang memungkinkan, fitur sedang diuji dengan konteks pengguna yang populer ditentukan sebagai bagian dari kueri. Konteks pengguna didasarkan pada permintaan pengguna saat Anda memiliki peluang untuk menampilkan harga dan dihitung untuk mencakup sebagian besar permintaan pengguna. Anda mungkin melihat banyak konteks pengguna untuk properti atau itinerari yang sangat populer, tetapi jumlah rata-rata konteks pengguna harus kurang dari 10. Anda dapat menampilkan harga tambahan atau mengabaikan konteks pengguna tertentu. Anda dapat menentukan harga yang akan ditampilkan untuk kueri tertentu. Namun, mengabaikan konteks pengguna yang disarankan dapat mengakibatkan traffic yang lebih rendah.

Mode pengiriman ARI Push

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

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

fig1

Langkah 1: Kirim 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 selengkapnya tentang mengirim pesan, lihat Menggunakan ARI.

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

Langkah 2: Pastikan 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 update berhasil diterapkan atau mengalami peringatan atau error mode pengiriman.

Daftar Alamat IP yang Diizinkan

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

Mengupdate metadata Room 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 mengirim pembaruan setiap kali jenis kamar atau paket tarif ditambahkan, dihapus, atau diubah. Dalam hal ini, Anda mengirim 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 resolusi 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 kali percobaan ulang, hentikan pengiriman pesan dan hubungi dukungan Google.

Mode pengiriman pull

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

Diagram berikut menunjukkan alur permintaan/respons Pull:

fig2

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

Bagian berikut menjelaskan setiap langkah ini secara lebih mendetail.

Langkah 1: Pesan kueri

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

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

  • Elemen root-nya adalah <Query>.
  • Dikirim ke endpoint yang ditentukan selama konfigurasi awal Anda. Untuk informasi selengkapnya, hubungi Manajer Akun Teknis (TAM).
  • Menggunakan metode POST HTTP. (Jika menggunakan HTTPS, Anda harus mendapatkan domain yang ditandatangani oleh certificate authority resmi.)
  • Header Content-Type disetel ke application/xml.
  • Setiap pesan berisi hingga 100 properti yang data harga dan ketersediaannya diminta oleh Google.
  • Header User-Agent disetel 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.

Mengupdate metadata Room dan Package

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.

Mode pengiriman Harga diubah

Harga yang Diubah membantu mengurangi ukuran dan kuantitas pesan Kueri dan Transaksi untuk pembaruan harga. Saat menggunakan Harga yang Diubah, Anda mengirimkan daftar properti dengan harga terbaru ke Google. Google 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 dan respons untuk Harga yang Diubah:

fig3

Bagian berikut menjelaskan setiap langkah dalam alur ini.

Langkah 1: Pesan Permintaan Petunjuk

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

  • Elemen root-nya adalah <HintRequest>.
  • Dikirim ke endpoint yang ditentukan selama konfigurasi awal Anda. Untuk mengetahui informasi selengkapnya, hubungi Manajer Akun Teknis (TAM).
  • Gunakan metode POST HTTP. (Jika menggunakan HTTPS, Anda harus mendapatkan domain yang ditandatangani oleh certificate authority resmi.)
  • Header Content-Type disetel 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 disetel ke Google-HotelAdsPrices.

Sebaiknya tetapkan 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 dalam pesan Respons Petunjuk. Elemen root pesan Kueri adalah <Query>.

Saat menentukan ID hotel mana yang akan dimintai harga dengan Harga yang Diubah, Google mengabaikan konten Feed Daftar Hotel Anda. Hal ini 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 terhadap pesan Kueri Google. Elemen root pesan Transaksi adalah <Transaction>. Untuk mengetahui informasi selengkapnya, lihat Mode pengiriman pull.