Ringkasan
Pesan Promosi menentukan aturan untuk tarif diskon menggunakan OTA_HotelRateAmountNotifRQ
. Untuk setiap tarif, promosi yang ditentukan dievaluasi dan diskon terbesar yang diizinkan diterapkan pada tarif tersebut. Jenis pesan ini bersifat opsional dan Anda hanya perlu menentukan promosi jika digunakan di sistem Anda untuk menerapkan diskon tarif.
Anda dapat menggabungkan promosi dan menerapkannya ke berbagai atribut pengguna, seperti jenis perangkat (seluler, tablet, desktop) dan kode negara.
Untuk contoh berbagai skenario terkait promosi, lihat Petunjuk.
Bagian berikut membahas pedoman umum, contoh dasar, dan skenario petunjuk untuk mulai menambahkan dan memperbarui promosi.
Panduan
Bagian ini membahas panduan umum dan petunjuk khusus untuk menetapkan promosi.
Gunakan panduan berikut untuk promosi:
Tindakan
- Hapus
- Gunakan tindakan
delete
di elemen<Promotion>
untuk menghapus satu promosi berdasarkan ID-nya. - Overlay
- Gunakan tindakan
overlay
di elemen<HotelPromotions>
untuk mengganti semua promosi untuk sebuah properti. - Delta
- Jika tidak ada tindakan yang ditentukan, semua promosi yang ditentukan dalam
<HotelPromotions>
akan ditambahkan atau diganti. Jika promosi dengan ID tersebut belum pernah ditambahkan atau telah dihapus, promosi tersebut akan ditambahkan. Jika sudah ada, promosi dengan ID tersebut akan ditimpa dengan definisi baru.
Umum
Dapat ada satu atau kumpulan promosi untuk setiap properti dan setiap promosi memiliki kumpulan kondisi. Promosi tersebut hanya dapat diterapkan jika kondisinya terpenuhi.
Jika Anda ingin promosi hanya berlaku pada tanggal, jenis kamar, atau paket tarif tertentu, tentukan dalam ketentuan untuk promosi tersebut. Jika promosi tidak berlaku untuk tanggal, jenis kamar, atau paket tarif tertentu, promosi tidak harus ditetapkan.
Setiap promosi dikaitkan dengan properti tertentu. Jika menggunakan promosi yang sama untuk beberapa properti, Anda harus mengirimkannya secara terpisah untuk setiap properti. Untuk menentukan ID properti Anda, gunakan atribut
hotel_id
dari elemen<HotelPromotions>
.Anda dapat menyertakan maksimal 99 promosi. Hubungi TAM Google jika Anda perlu menyertakan lebih dari ini.
Gunakan elemen
<Stacking>
untuk menentukan cara promosi dapat digabungkan. Secara default, Google menggunakan jenis stackingbase
, yang berarti promosi dasar terbaik yang memenuhi syarat akan dipilih dan diterapkan terlebih dahulu, sebelum promosi lainnya. Perhatikan bahwabase
hanya dapat digabungkan dengansecond
atauany
, dan tidak dapat digabungkan denganbase
ataunone
lain.Meskipun ada stack beberapa promosi yang dapat diterapkan bersama, stack tersebut mungkin sebenarnya bukan stack yang digunakan jika ada satu promosi atau stack promosi lain yang menawarkan diskon yang lebih besar. Promosi (kombinasi) dengan diskon terbesar diterapkan ke pemesanan saat beberapa (kombinasi) promosi memenuhi syarat.
Kirim pembaruan pesan Promosi setiap kali terjadi perubahan yang memengaruhi promosi Anda.
Terkait pajak
Promosi (atau tumpukan promosi) terbaik diterapkan ke jumlah
AmountAfterTax
. Jika hanya AmountBeforeTax
yang ditentukan, promosi
akan diterapkan ke AmountBeforeTax
.
Contoh
Bagian ini memberikan contoh dasar pesan Promosi yang menggunakan elemen wajib dan opsional. Setelah Anda menyiapkan file, kirimkan ke Google melalui pesan POST ke endpoint ini:
https://www.google.com/travel/hotels/uploads/promotions
Untuk mempelajari lebih lanjut cara mengirim/Memposting pesan, lihat Mengirim pesan.
Untuk atribut hotel_id
dari <HotelPromotions>
, 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. Konsistensi dengan sistem Anda sangat penting untuk
memastikan bahwa Google menampilkan data Anda dengan benar.
UserCountry
digunakan untuk mencantumkan lokasi pengguna (negara) yang memenuhi syarat untuk promosi. Jika ditentukan, hanya pengguna di negara tercantum yang
ditawarkan tarif diskon.
Contoh ini menunjukkan cara menetapkan diskon 15% untuk masa inap yang diperpanjang bagi pengguna di Amerika Serikat dan Italia:
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123_abc"
timestamp="2022-05-30T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1">
<Promotion id="1">
<Discount percentage="15"/>
<UserCountries>
<Country code="US"/>
<Country code="IT"/>
</UserCountries>
</Promotion>
</HotelPromotions>
</Promotions>
Untuk contoh lainnya, lihat Contoh promosi.
Petunjuk
Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat menetapkan promosi.
Skenario 1: Cara menambahkan promosi diskon untuk masa inap yang diperpanjang
Deskripsi
Anda ingin memberikan diskon untuk masa inap yang diperpanjang pada hari-hari tertentu.
Solusi
Gunakan setelan FreeNights
untuk menyesuaikan jenis diskon yang diterapkan bergantung pada jumlah malam menginap.
Contoh
Sampel ini menunjukkan cara menambahkan diskon 20% untuk dua malam untuk setiap 7 malam yang menginap selama rentang tanggal pemesanan yang ditentukan. Untuk itinerari 15 malam, diskon 20% berlaku untuk total 4 malam.
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-05T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1">
<Promotion id="1">
<BookingDates>
<DateRange start="2022-02-01" end="2022-06-30"/>
</BookingDates>
<Discount>
<FreeNights stay_nights="7"
discount_nights="2"
discount_percentage="20"
night_selection="cheapest"
repeats="true"/>
</Discount>
</Promotion>
</HotelPromotions>
</Promotions>
Skenario 2: Cara menetapkan jenis perangkat
Anda menetapkan devices
untuk menentukan perangkat pengguna yang memenuhi syarat untuk promosi. Jika ditentukan, hanya pengguna di perangkat tercantum yang ditawari tarif diskon.
Deskripsi
Anda ingin menentukan jenis perangkat pengguna yang memenuhi syarat untuk promosi.
Solusi
Tetapkan jenis perangkat ke satu atau beberapa nilai berikut: desktop
, tablet
,
atau mobile
.
Contoh
Contoh berikut menunjukkan cara menentukan diskon 25% untuk pengguna seluler dan tablet:
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-20T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1">
<Promotion id="1">
<Discount percentage="25"/>
<Devices>
<Device type="mobile"/>
<Device type="tablet"/>
</Devices>
</Promotion>
</HotelPromotions>
</Promotions>
Skenario 3: Cara mengganti promosi lama dengan promosi baru
Deskripsi
Kumpulan promosi saat ini untuk properti sudah usang atau salah dan harus diganti dengan kumpulan yang benar-benar baru.
Solusi
Gunakan tindakan overlay
untuk mengganti promosi.
Contoh
Contoh berikut menunjukkan dua diskon asli sebesar 20% dan 30% untuk properti.
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-20T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1">
<Promotion id="1">
<BookingDates>
<DateRange start="2022-06-01" end="2022-07-31"/>
</BookingDates>
<Discount percentage="20"/>
</Promotion>
<Promotion id="2">
<BookingDates>
<DateRange start="2022-08-01" end="2022-08-31"/>
</BookingDates>
<Discount percentage="30"/>
</Promotion>
</HotelPromotions>
</Promotions>
Kemudian, contoh ini menunjukkan cara menggunakan overlay
untuk mengganti dua promosi yang ada dengan satu promosi diskon 15% untuk properti.
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-25T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1" action="overlay">
<Promotion id="1">
<BookingDates>
<DateRange start="2022-06-01" end="2022-07-31"/>
</BookingDates>
<Discount percentage="15"/>
</Promotion>
</HotelPromotions>
</Promotions>
Skenario 4: Cara menghapus satu atau semua promosi
Deskripsi
Anda ingin menghapus satu atau semua promosi (tanpa penggantian) karena properti telah menghapus semua promosinya tanpa menetapkan promosi baru, atau Anda melakukan kesalahan dan harus memperbaikinya.
Solusi
Gunakan tindakan delete
jika Anda hanya ingin menghapus masing-masing promosi tertentu untuk properti, dan gunakan tindakan overlay
(bukan delete
) untuk menghapus semua promosi yang ada tanpa penggantian.
Untuk mengetahui detail tentang cara mengganti promosi menggunakan overlay
, lihat
Skenario 3.
Contoh
Contoh berikut menunjukkan cara menghapus hanya satu promosi untuk sebuah properti:
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-20T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1">
<Promotion id="1" action="delete"/>
</HotelPromotions>
</Promotions>
Contoh ini menunjukkan cara menghapus semua promosi tanpa penggantian untuk properti:
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-20T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>
Skenario 5: Cara mengelompokkan promosi
Penumpukan menentukan cara promosi dapat digabungkan. Jika tidak ditentukan, type
diasumsikan sebagai base
, yang berarti promosi dasar terbaik yang memenuhi syarat akan dipilih dan diterapkan terlebih dahulu, sebelum promosi lainnya. Jika atribut type
dari Stacking
adalah any
, atribut tersebut dapat digabungkan dengan promosi lainnya.
Deskripsi
Anda ingin pengguna memiliki opsi untuk menggunakan beberapa promosi sekaligus untuk properti yang sama.
Solusi
Gunakan penumpukan untuk menetapkan beberapa diskon per properti. Tumpukan dapat memiliki maksimal
satu base
dan satu second
, tetapi jumlah any
yang tidak terbatas; dan any
dapat
dikombinasikan dengan jenis lain kecuali untuk none
.
Contoh
Contoh ini menunjukkan cara menumpuk jenis Penumpukan base
, second
, dan any
. Untuk
diskon gabungan sebesar 15%, 25%, 10%, harga $100 adalah total
$57,38 (100 × 0,85 × 0,75 × 0,9).
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
id="123"
timestamp="2022-05-20T16:20:00-04:00">
<HotelPromotions hotel_id="Property_1">
<Promotion id="1">
<Discount percentage="15"/>
<Stacking type="base"/>
</Promotion>
<Promotion id="2">
<Discount percentage="25"/>
<Stacking type="second"/>
</Promotion>
<Promotion id="3">
<Discount percentage="10"/>
<Stacking type="any"/>
</Promotion>
<Promotion id="4">
<Discount percentage="40"/>
<Stacking type="none"/>
</Promotion>
</HotelPromotions>
</Promotions>
Perhatikan bahwa diskon gabungan untuk promosi susunan 1 sampai 3
lebih baik daripada diskon untuk promosi 4. Promosi 4 tidak dapat digabungkan dengan promosi lain karena jenis penumpukannya (none
). Jika promosi 4 memiliki diskon 43% atau lebih tinggi, promosi tersebut akan digunakan, bukan kombinasi promosi 1 sampai 3.