Beri Rating Pesan

Ringkasan

Pesan Tarif (OTA_HotelRateAmountNotifRQ) menentukan tarif hunian per malam untuk setiap kombinasi jenis kamar dan paket tarif untuk rentang tanggal tertentu. Sebagai bagian dari pesan Tarif, Google mendukung harga berbasis jumlah tamu, sehingga memungkinkan tarif per malam yang berbeda ditentukan berdasarkan jumlah maksimum tamu yang dimaksud.

Bagian berikut mencakup panduan umum, contoh dasar, dan skenario praktis untuk membantu Anda mulai menambahkan dan memperbarui tarif serta mengirim pesan Tarif.

Perilaku tingkat kecocokan

Saat pengguna meminta hunian tertentu, tarif yang mereka lihat bergantung pada cara Anda menentukan harga dalam pesan Tarif. Bagian ini membahas cara permintaan pengguna ini dicocokkan dengan tarif Anda, bergantung pada hunian permintaan mereka dan tarif yang Anda tentukan.

Prinsip utama

  • Tarif yang ditentukan untuk hunian tertentu berlaku untuk semua hunian yang lebih rendah, kecuali jika ditentukan lain.

  • Permintaan untuk hunian di atas yang ditentukan dianggap tidak mungkin.

  • Harga berbasis tingkat hunian berlaku untuk model penetapan harga per tanggal dan berbasis LOS yang dijelaskan di bawah. Artinya, Anda dapat menentukan tarif untuk setiap hunian. Jika tarif untuk jumlah tamu tertentu tidak ada, tarif untuk jumlah tamu tertinggi berikutnya akan digunakan. Anda juga dapat menentukan biaya untuk tamu tambahan dan anak-anak menggunakan AdditionalGuestAmounts atau ExtraGuestCharges yang diterapkan hingga kapasitas yang ditentukan untuk kamar.

Manfaat dan contoh

Efisiensi

Untuk beberapa hunian dengan jumlah tarif yang sama, Anda tidak perlu menetapkan tarif untuk setiap hunian. Anda dapat menyederhanakan pesan dengan menetapkan hanya nilai hunian tertinggi yang didukung oleh jenis kamar dan paket tarif. Pengguna akan melihat tarif tersebut untuk setiap hunian yang kurang dari atau sama dengan nilai yang Anda tetapkan.

Contoh: Tarif untuk jenis kamar dan paket tarif sama untuk hunian satu hingga empat orang. Gunakan pesan Tarif untuk menetapkan satu tarif untuk hunian maksimum 4. Pengguna yang menelusuri kamar untuk satu, dua, dan tiga orang akan melihat tarif yang sama. Pengguna yang menelusuri 5 dan lebih tinggi tidak akan melihat tarif.

Kontrol

Tarif yang berbeda untuk jumlah tamu alternatif dapat diberikan secara eksplisit. Kirim tarif yang berbeda untuk setiap nilai hunian jika Anda menginginkan kontrol yang lebih besar terhadap cara Google mencocokkan permintaan dengan tarif hunian.

Contoh: Jika tarif ditentukan untuk jumlah tamu 3 dan 1, penelusuran untuk satu orang akan menampilkan tarif untuk satu orang, penelusuran untuk dua orang akan menampilkan tarif untuk tiga orang, dan pengguna yang menelusuri jumlah tamu 4 orang atau lebih tidak akan melihat tarif.

Untuk contoh selengkapnya tentang berbagai skenario terkait tarif, lihat Cara.

Elemen wajib dan opsional

Referensi XML memberikan deskripsi elemen wajib dan opsional. Untuk mengetahui detail tentang atribut dan elemen turunan, lihat Elemen & Atribut Tarif.

Sintaksis dan skema

Gunakan contoh Sintaksis Tarif sebagai referensi saat Anda membuat pesan Tarif untuk memastikan Anda mengikuti format yang benar.

Anda dapat menggunakan alat XML pihak ketiga seperti xmllint untuk memvalidasi feed dengan skema yang dipublikasikan sebelum mengirimkannya ke Google. Untuk skema pesan Tarif, lihat Skema Iklan Hotel.

Model penetapan harga

Harga per tanggal

Ini adalah model harga standar yang digunakan untuk sebagian besar properti. Model harga per-date didasarkan pada penetapan tarif yang dijumlahkan di seluruh tanggal menginap untuk mendapatkan harga total. Dalam model ini, semua tarif dalam elemen Rate ditafsirkan sebagai berlaku untuk rentang tanggal menginap yang ditentukan dalam <StatusApplicationControl>.

Harga berbasis LOS

Model harga berbasis LOS (lama menginap) didasarkan pada tarif yang ditetapkan untuk kombinasi tanggal kedatangan dan lama menginap. Tarif yang ditentukan dalam model harga berbasis LOS adalah per hari. Misalnya, jika Anda mengirimkan tarif $100 untuk durasi menginap 3 hari, total harga dihitung sebagai 3x$100=$300.

Anda dapat memanfaatkan model harga berbasis LOS dengan menentukan RatePlanType="26" pada elemen StatusApplicationControl. Anda juga perlu menetapkan atribut RateTimeUnit dan UnitMultiplier pada elemen Rate di XML. Hal ini menyebabkan semua tarif dalam elemen Rate yang diberikan berlaku untuk masa inap yang ditentukan oleh tanggal kedatangan yang ditentukan dalam <StatusApplicationControl> dan nilai LOS yang ditentukan untuk UnitMultiplier.

Anda dapat memanfaatkan model harga per tanggal dan berbasis LOS dalam satu akun, tetapi setiap properti hanya boleh menggunakan satu model harga. Perhatikan poin-poin berikut saat menerapkan harga berbasis LOS:

  • Tarif untuk durasi menginap yang berbeda tidak digabungkan saat menggunakan harga berbasis LOS. Misalnya, tarif LOS 3 tidak digabungkan dengan LOS 1 untuk menentukan harga tarif LOS 4. Tarif LOS 4 harus ditentukan secara eksplisit.
  • Tarif 1 malam dalam penetapan harga berbasis LOS tidak digunakan sebagai tarif per malam dalam penetapan harga per tanggal.
  • Setiap properti hanya boleh menggunakan harga berbasis LOS atau harga per tanggal, bergantung pada cara tarif ditampilkan dalam sistem Anda.

Untuk mengaktifkan harga berbasis LOS di akun Anda, ajukan permintaan melalui TAM Anda atau hubungi kami.

Panduan atau Tindakan

Harga per tanggal

Delta: Menambahkan atau memperbarui tarif per tamu hanya untuk kombinasi jenis kamar, paket tarif, dan tanggal menginap yang ditentukan di <StatusApplicationControl>.

  • Pembaruan tarif menggunakan tindakan Delta secara default.
  • Pembaruan Delta tidak mengubah tarif yang sebelumnya disimpan untuk hunian lain. Misalnya, jika Anda telah menentukan tarif untuk kamar dengan jumlah tamu satu dan dua orang, dan mengirimkan pembaruan tarif Delta untuk kamar dengan jumlah tamu satu orang, tarif untuk jumlah tamu dua orang tetap tidak berubah.

Overlay: Menghapus semua tarif per tamu yang ada untuk jenis kamar, paket tarif, dan tanggal yang ditentukan di <StatusApplicationControl>, lalu menggantinya dengan tarif baru. Misalnya, jika Anda telah menentukan tarif untuk kamar dengan jumlah tamu satu dan dua orang, dan Anda mengirimkan pembaruan Overlay untuk kamar dengan jumlah tamu satu orang, Google akan menghapus semua tarif sebelumnya (jumlah tamu satu dan dua orang) dan hanya tarif jumlah tamu satu orang yang akan tetap ada setelah pembaruan.

Remove: Menghapus semua tarif per tamu yang ada untuk jenis kamar, paket tarif, dan tanggal yang ditentukan di <StatusApplicationControl>.

Harga berbasis LOS

Delta: Menambahkan atau memperbarui tarif per nilai LOS hanya untuk kombinasi jenis kamar, paket tarif, dan tanggal check-in yang ditentukan di <StatusApplicationControl>. Mengganti semua tarif per hunian yang terkait dengan nilai LOS yang diperbarui.

  • Pembaruan tarif menggunakan tindakan Delta secara default.
  • Pembaruan Delta tidak mengubah tarif yang sebelumnya disimpan untuk durasi menginap lainnya. Misalnya, jika Anda telah menentukan tarif untuk LOS 1 dan 2, dan mengirimkan update tarif Delta untuk LOS 1, tarif per hunian LOS 2 tetap tidak berubah.
  • Pembaruan Delta akan menggantikan semua tarif per hunian yang disimpan sebelumnya untuk durasi menginap tertentu. Misalnya, jika Anda telah menentukan tarif jumlah tamu tunggal dan ganda untuk LOS 1, lalu mengirimkan pembaruan tarif Delta untuk LOS 1 dengan hanya tarif jumlah tamu tunggal, tarif jumlah tamu ganda akan dihapus.

Overlay: Menghapus semua tarif per tamu yang ada untuk LOS, jenis kamar, paket tarif, dan tanggal check-in yang ditentukan di <StatusApplicationControl>, lalu menggantinya dengan tarif baru. Misalnya, jika Anda telah menentukan tarif untuk LOS 1 dan 2, lalu Anda mengirimkan update Overlay untuk LOS 1, Google akan menghapus semua tarif sebelumnya (LOS 1 dan 2) dan hanya tarif LOS 1 yang akan tetap ada setelah update.

Remove: Menghapus semua tarif per tamu yang ada untuk semua LOS dari jenis kamar, paket tarif, dan tanggal check-in yang ditentukan di <StatusApplicationControl>.

Terkait pajak

Jika pajak dan biaya sederhana, total jumlah dapat ditentukan menggunakan AmountAfterTax. Pajak yang kompleks, seperti pajak dan biaya yang berlaku per menginap (bukan per malam) tidak dapat ditampilkan di AmountAfterTax.

Secara umum, Google merekomendasikan penggunaan TaxFeeInfo daripada AmountAfterTax.

Jika memungkinkan, Anda harus menyertakan AmountBeforeTax (meskipun Anda menentukan AmountAfterTax) karena bahasa tertentu (misalnya, AS) menampilkan harga sebelum pajak secara default.

Semua pajak dan biaya yang harus dibayar pengguna (PPN, pajak penginapan, biaya pembersihan, pajak kota, dll.) harus disertakan, meskipun tidak dibayarkan pada saat pemesanan, atau tidak dibayarkan langsung ke properti.

Contoh

Bagian ini memberikan contoh dasar pesan Tarif menggunakan elemen wajib dan opsional. Setelah menyiapkan file, Anda harus mengirimkannya ke Google menggunakan pesan POST ke endpoint berikut: https://www.google.com/travel/hotels/uploads/property_data

Untuk mempelajari lebih lanjut cara mengirim/MEMPOSTING pesan, lihat Mengirim pesan.

Untuk HotelCode, gunakan ID Hotel unik yang Anda gunakan dalam sistem untuk mengidentifikasi properti. Nilai ini harus cocok dengan ID Hotel yang ditentukan menggunakan <id> di elemen <listing> di Feed Daftar Hotel. Untuk <PackageID> dan <RoomID>, gunakan ID yang sama dengan yang Anda gunakan dalam sistem untuk paket tarif dan jenis kamar (masing-masing). Konsistensi dengan sistem Anda sangat penting untuk memastikan Google menampilkan harga dan data Anda dengan benar.

Contoh ini menunjukkan cara menetapkan tarif menggunakan tindakan Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat mengirim pesan Rating.

Untuk contoh cara menambahkan, menghapus, dan memperbarui tarif, lihat Contoh Tarif.

Skenario 1: Cara mengubah harga per jumlah tamu

Deskripsi

Tarif per malam sebelumnya hanya ditentukan untuk jumlah tamu dua orang (yang juga berlaku untuk jumlah tamu satu orang), tetapi sekarang ada tarif yang lebih murah untuk jumlah tamu satu orang.

Solusi

Kirim tarif hunian 1 baru menggunakan update cakupan Delta default. Nilai baru ini tidak memengaruhi rasio hunian 2.

Skenario 2: Cara mengganti tarif per hunian untuk properti

Deskripsi

Sebelumnya, Anda menentukan tarif untuk jumlah tamu 1 hingga 4, tetapi sekarang hanya jumlah tamu 1 dan 2 yang valid.

Solusi

Gunakan NotifType="Overlay" untuk mengganti semua tarif jumlah tamu untuk properti, jenis kamar, paket tarif, dan tanggal tertentu. Dalam skenario ini, tindakan Overlay akan mencantumkan tarif untuk hunian 1 dan 2.

Skenario 3: Cara menetapkan tarif yang sama untuk beberapa jumlah tamu

Deskripsi

Tarif untuk hunian tertentu dapat dijual kepada grup dengan jumlah orang yang lebih sedikit. Dalam skenario ini, Anda dapat menyederhanakan pesan dengan hanya mengirimkan pembaruan tarif untuk hunian maksimum yang berlaku.

Solusi

Jika Anda memiliki harga yang sama untuk beberapa hunian, tetapkan nilai hunian tertinggi yang didukung oleh jenis kamar dan paket tarif, lalu nilai tersebut akan otomatis digunakan untuk hunian yang lebih rendah. Artinya, tidak perlu mengulangi tarif harian yang sama untuk hunian 1-6 jika semuanya sama; cukup tetapkan untuk 6.