Ringkasan
Pesan Tarif (OTA_HotelRateAmountNotifRQ
) menentukan tarif jumlah tamu per malam untuk setiap jenis kamar dan kombinasi paket tarif untuk rentang tanggal tertentu. Sebagai bagian dari pesan Tarif, Google mendukung penetapan harga berdasarkan jumlah tamu, sehingga memungkinkan penentuan tarif per malam yang berbeda berdasarkan jumlah maksimum tamu yang dimaksud.
Bagian berikut membahas panduan umum, contoh dasar, dan skenario petunjuk untuk mulai menambahkan dan memperbarui tarif serta mengirim pesan Tarif.
Perilaku tarif yang cocok
Saat pengguna meminta jumlah tamu tertentu, tarif yang mereka lihat bergantung pada cara Anda menentukan harga dalam pesan Tarif. Bagian ini membahas cara mencocokkan permintaan pengguna dengan tarif Anda, bergantung pada jumlah tamu yang memintanya, dan tarif yang ditentukan.
Prinsip utama
Tarif yang ditentukan untuk jumlah tamu tertentu berlaku untuk semua jumlah tamu yang lebih rendah, kecuali jika ditentukan lain.
Permintaan untuk jumlah tamu di atas yang ditetapkan dianggap tidak mungkin.
Harga berdasarkan jumlah tamu berlaku untuk harga per tanggal dan model penetapan harga berbasis LOSS, seperti yang dijelaskan di bawah ini. Artinya, Anda dapat menentukan tarif untuk setiap jumlah tamu. Jika tarif untuk jumlah tamu tertentu tidak ada, tarif untuk jumlah tamu tertinggi berikutnya akan digunakan. Anda juga dapat menetapkan biaya untuk tamu dan anak tambahan menggunakan
AdditionalGuestAmounts
atauExtraGuestCharges
yang diterapkan hingga kapasitas yang ditentukan untuk kamar.
Manfaat dan contoh
- Efisiensi
Untuk beberapa jumlah tamu dengan jumlah tarif yang sama, Anda tidak perlu menetapkan tarif untuk setiap jumlah tamu. Anda dapat menyederhanakan pesan dengan hanya menetapkan nilai jumlah tamu tertinggi yang didukung oleh jenis kamar dan paket tarif. Pengguna akan melihat tarif tersebut untuk setiap jumlah tamu kurang dari atau sama dengan nilai yang Anda tetapkan.
Contoh: Tarif untuk jenis kamar dan paket tarif sama untuk jumlah tamu satu sampai empat. Gunakan pesan Tarif untuk menetapkan satu tarif bagi jumlah tamu maksimal 4 orang. Pengguna yang menelusuri jumlah tamu satu, dua, dan tiga akan melihat tarif yang sama. Pengguna yang menelusuri angka 5 ke atas tidak akan melihat tarif.
- Mengontrol
Tarif yang berbeda untuk jumlah tamu alternatif dapat diberikan secara eksplisit. Kirimkan tarif yang berbeda untuk setiap nilai jumlah tamu jika Anda ingin lebih mengontrol cara Google mencocokkan permintaan dengan tarif jumlah tamu.
Contoh: Jika tarif ditentukan untuk jumlah tamu 3 dan 1, penelusuran jumlah tamu satu orang akan menampilkan tarif untuk jumlah tamu tunggal, penelusuran untuk jumlah tamu dua orang akan menampilkan tingkat jumlah tamu tiga kali, dan pengguna yang menelusuri jumlah tamu 4 ke atas tidak akan melihat tarif.
Untuk contoh lainnya tentang berbagai skenario terkait tarif, lihat Petunjuk.
Elemen wajib dan opsional
Referensi XML memberikan deskripsi elemen wajib dan opsional. Untuk mengetahui detail tentang atribut dan elemen turunan, lihat Elemen & Atribut.
Sintaksis dan skema
Gunakan contoh Sintaksis Tarif sebagai referensi saat 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
Model ini adalah model penetapan harga standar yang digunakan untuk sebagian besar properti. Model harga per-date
didasarkan pada penetapan tarif yang dijumlahkan dari seluruh tanggal menginap untuk tiba dengan harga total. Dalam model ini, semua tarif pada elemen Rate
diinterpretasikan sebagai berlaku untuk rentang tanggal menginap yang ditentukan dalam <StatusApplicationControl>
.
Harga berdasarkan LOS
Model harga berdasarkan LOS (lama menginap) didasarkan pada tarif yang ditetapkan untuk kombinasi tanggal kedatangan dan lama menginap. Tarif yang ditentukan berdasarkan model penetapan harga berbasis LOS adalah per hari. Misalnya, jika Anda mengirim tarif $100 untuk lama menginap 3 orang, harga total dihitung sebagai 3x$100=$300.
Anda dapat menggunakan model penetapan harga berbasis LOS dengan menetapkan RatePlanType="26"
pada elemen StatusApplicationControl
. Anda juga harus
menetapkan atribut RateTimeUnit
dan UnitMultiplier
pada elemen Rate
dalam
XML. Hal ini menyebabkan semua tarif dalam elemen Rate
tertentu diterapkan ke tetap
yang ditentukan oleh tanggal kedatangan yang ditentukan di <StatusApplicationControl>
dan
nilai LOS yang ditentukan untuk UnitMultiplier
.
Anda dapat menggunakan model penetapan harga per tanggal dan berbasis LOS dalam satu akun, tetapi setiap properti hanya boleh menggunakan satu model penetapan harga. Perhatikan hal-hal berikut saat menerapkan harga berdasarkan LOS:
- Tarif untuk lama menginap yang berbeda tidak digabungkan saat menggunakan harga berdasarkan LOS. Misalnya, tarif LOS 3 tidak digabungkan dengan LOS 1 untuk menetapkan harga tarif LOS 4. Rasio LOS 4 harus ditentukan secara eksplisit.
- Tarif 1 malam pada harga berbasis LOS tidak digunakan sebagai tarif per malam individual pada harga per tanggal.
- Setiap properti hanya boleh menggunakan harga berbasis LOS atau harga per tanggal, tergantung cara tarif ditampilkan di sistem Anda.
Untuk mengaktifkan harga berdasarkan LOS di akun Anda, buat permintaan melalui TAM atau hubungi kami.
Pedoman atau Tindakan
- Harga per tanggal
Delta
: Menambahkan atau memperbarui tarif per jumlah tamu hanya untuk kombinasi jenis kamar, paket tarif, dan tanggal menginap yang ditentukan di<StatusApplicationControl>
.- Pembaruan tarif menggunakan tindakan
Delta
secara default. - Update
Delta
tidak mengubah tarif yang disimpan sebelumnya untuk jumlah tamu lainnya. Misalnya, jika Anda telah menentukan tarif untuk kamar dengan jumlah tamu satu dan dua orang, serta mengirim pembaruan tarifDelta
untuk kamar dengan jumlah tamu satu orang, tarif untuk jumlah tamu dua orang tetap tidak berubah.
- Pembaruan tarif menggunakan tindakan
Overlay
: Menghapus semua tarif per jumlah 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, lalu Anda mengirim pembaruanOverlay
untuk kamar dengan jumlah tamu satu orang, Google akan menghapus semua tarif sebelumnya (baik untuk jumlah tamu tunggal maupun ganda), dan hanya tarif untuk jumlah tamu tunggal yang akan tetap ada setelah pembaruan dilakukan.Remove
: Menghapus semua tarif per jumlah tamu yang ada untuk jenis kamar, paket tarif, dan tanggal yang ditentukan di<StatusApplicationControl>
.- Harga berdasarkan 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 jumlah tamu yang terkait dengan nilai LOS terbaru.- Pembaruan tarif menggunakan tindakan
Delta
secara default. - Update
Delta
tidak mengubah tarif yang disimpan sebelumnya untuk lama menginap lainnya. Misalnya, jika Anda telah menentukan tarif untuk LOS 1 dan 2, serta mengirim pembaruan tarifDelta
untuk LOS 1, tarif per jumlah tamu LOS 2 tidak akan berubah. - Update
Delta
akan menimpa semua tarif per tamu yang disimpan sebelumnya untuk lama menginap yang ditentukan. Misalnya, jika Anda telah menentukan tarif jumlah tamu tunggal dan dua untuk LOS 1, dan mengirim pembaruan tarifDelta
untuk LOS 1 hanya dengan satu tarif jumlah tamu satu, tarif jumlah tamu dua orang akan dihapus.
- Pembaruan tarif menggunakan tindakan
Overlay
: Menghapus semua tarif per jumlah 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 mengirim pembaruanOverlay
untuk LOS 1, Google akan menghapus semua tarif sebelumnya (baik LOS 1 maupun 2), dan hanya tarif LOS 1 yang akan tetap ada setelah pembaruan.Remove
: Menghapus semua tarif per jumlah tamu yang ada untuk semua LOSS jenis kamar, paket tarif, dan tanggal check-in yang ditentukan di<StatusApplicationControl>
.- Terkait pajak
Jika pajak dan biaya sederhana, jumlah total dapat ditentukan menggunakan
AmountAfterTax
. Pajak kompleks, seperti pajak dan biaya yang berlaku per kunjungan (bukan per malam) tidak dapat ditampilkan diAmountAfterTax
.Secara umum, Google merekomendasikan penggunaan
TaxFeeInfo
, bukanAmountAfterTax
.Jika memungkinkan, Anda harus menyertakan
AmountBeforeTax
(meskipun jika Anda menentukanAmountAfterTax
) karena lokalitas tertentu (misalnya, AS) menampilkan harga sebelum pajak secara default.Semua pajak dan biaya yang harus dibayar pengguna (PPN, pajak masa inap, biaya pembersihan, pajak kota, dll.) harus disertakan, meskipun tidak dibayar pada saat pemesanan, atau tidak dibayarkan langsung ke properti.
Contoh
Bagian ini memberikan contoh dasar pesan Tarif yang 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. Konsistensi
dengan sistem 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 Memberi rating pesan.
Untuk contoh cara menambahkan, menghapus, dan memperbarui tarif, lihat Contoh Tarif.
Skenario 1: Cara mengubah harga per jumlah tamu
Deskripsi
Tarif per malam sebelumnya ditentukan hanya 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 jumlah tamu 1 baru menggunakan pembaruan cakupan Delta
default. Nilai baru ini tidak memengaruhi tarif jumlah tamu 2.
Skenario 2: Cara mengganti tarif per jumlah tamu untuk properti
Deskripsi
Anda sebelumnya 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 menampilkan tarif untuk jumlah tamu 1 dan 2.
Skenario 3: Cara menetapkan tarif yang sama untuk beberapa jumlah tamu
Deskripsi
Tarif untuk jumlah tamu tertentu dapat dijual ke grup dengan lebih sedikit orang. Dalam skenario ini, Anda dapat menyederhanakan pesan dengan hanya mengirimkan pembaruan tarif untuk jumlah tamu maksimum yang berlaku.
Solusi
Jika Anda memiliki harga yang sama untuk beberapa jumlah tamu, tetapkan nilai jumlah tamu tertinggi yang didukung oleh jenis kamar dan paket tarif, dan nilai tersebut akan otomatis menggunakan nilai tersebut untuk jumlah tamu yang lebih rendah. Artinya, tidak perlu mengulangi tarif per malam yang sama untuk jumlah tamu 1-6 jika semuanya sama; cukup tetapkan untuk 6.