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).

Makin banyak itinerari yang Anda dukung, makin 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 umum untuk memperbarui harga menggunakan pesan Transaksi dengan salah satu cara berikut:

  • ARI (Push): Feed pengiriman harga yang menggunakan paket tarif, ketersediaan, dan metadata hotel guna menetapkan strategi penetapan harga yang telah ditentukan untuk properti Anda. Tidak seperti Pull dan Harga yang Diubah, feed ARI tidak mengkueri harga atau itinerari tertentu. Sebaliknya, Anda mengirim pesan yang berisi subkumpulan informasi yang merepresentasikan 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 lebih lanjut mode pengiriman ARI 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 baik jika Anda tidak tahu persis kapan informasi harga berubah, atau jika informasi harga berubah secara tidak teratur sepanjang hari. Harga tetap tersimpan dalam cache sampai algoritma Google menentukan bahwa harga sudah tidak berlaku, berdasarkan histori perubahan harga sebelumnya untuk partner tertentu. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Mode Pengiriman Pull.

  • Harga yang Diubah (sebelumnya Pull dengan Petunjuk): Mirip dengan 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 disimpan dalam cache tanpa batas waktu hingga diperbarui. Untuk mengetahui informasi selengkapnya, baca artikel 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 daripada mengirim Kueri Harga Real Time lainnya di masa mendatang.

Untuk mengetahui informasi selengkapnya, lihat Kueri Harga Real time.

Konteks

Kueri 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 serangkaian kemungkinan pengguna yang lengkap, fitur akan diuji jika konteks pengguna yang populer ditentukan sebagai bagian dari kueri. Konteks pengguna didasarkan pada permintaan pengguna saat Anda memiliki kesempatan 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 rata-rata jumlah konteks pengguna seharusnya kurang dari 10. Anda dapat menampilkan harga tambahan atau mengabaikan konteks pengguna tertentu. Andalah yang menentukan harga yang akan ditampilkan untuk kueri tertentu. Namun, mengabaikan konteks pengguna yang disarankan dapat menyebabkan traffic yang lebih rendah.

Mode pengiriman Push ARI

Dengan mode pengiriman ARI Push, Anda mengirimkan pembaruan bertahap ke Google setiap kali tarif per malam, ketersediaan, jumlah inventaris, atau batasan lainnya berubah. Tidak seperti Pull atau Harga yang Diubah, ARI Push memungkinkan Anda menggunakan model penetapan 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 Push ARI 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 akan 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 merespons dengan HTTP 200 OK jika koneksi ke server berhasil. Rilis ini juga menyertakan 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 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, Anda mengirim pesan XML dengan informasi baru dalam 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 salah, 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 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 harga dan ketersediaan 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. Artinya, Anda mungkin akan 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 mengetahui 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.

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.

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 yang harganya diperbarui ke Google. Google akan merespons dengan pesan Kueri yang hanya meminta harga properti tersebut.

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

Diagram berikut menampilkan 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 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 akan 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 menetapkan atau mengubah frekuensi pesan Permintaan Petunjuk, hubungi kami.

Saat menerima pesan Permintaan Petunjuk dari Google, Anda akan 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 diminta harganya 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.