Pesan Promosi

Ringkasan

Pesan Promosi menentukan aturan untuk tarif diskon menggunakan OTA_HotelRateAmountNotifRQ. Untuk setiap tarif, promosi yang ditentukan dievaluasi dan diskon terbesar yang diizinkan diterapkan ke tarif. Jenis pesan ini bersifat opsional dan Anda hanya perlu menentukan promosi jika digunakan dalam 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.

Poin Penting: Jika beberapa promosi berlaku untuk tarif produk tertentu (jenis kamar + paket tarif + hunian), pengguna akan menerima promosi atau kombinasi promosi termurah yang diizinkan, dan diskon akan diterapkan secara otomatis.

Untuk contoh berbagai skenario terkait promosi, lihat Cara.

Bagian berikut mencakup panduan umum, contoh dasar, dan skenario cara untuk membantu Anda memulai penambahan dan pembaruan promosi.

Panduan

Bagian ini membahas pedoman umum dan petunjuk khusus untuk menyiapkan promosi.

Gunakan panduan berikut untuk promosi:

Tindakan

Hapus

Gunakan tindakan delete dalam elemen <Promotion> untuk menghapus satu promosi berdasarkan ID-nya.

Overlay

Gunakan tindakan overlay di elemen <HotelPromotions> untuk mengganti semua promosi untuk 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 akan ditambahkan. Jika promosi dengan ID tersebut ada, promosi tersebut akan ditimpa dengan definisi baru.

Umum

• Setiap properti dapat memiliki satu atau serangkaian promosi dan setiap promosi memiliki serangkaian kondisi. Promosi tersebut hanya dapat diterapkan jika kondisinya terpenuhi.

• Promosi berlaku untuk tarif rencana perjalanan. Anda tidak dapat menetapkan diskon maksimum per penghuni.

• Jika Anda ingin promosi hanya berlaku untuk tanggal, jenis kamar, atau paket tarif tertentu, tentukan hal tersebut dalam kondisi untuk promosi tersebut. Jika promosi tidak berlaku untuk tanggal, jenis kamar, atau paket tarif tertentu, maka hal tersebut tidak perlu ditetapkan.

• Setiap promosi dikaitkan dengan properti tertentu. Jika Anda menggunakan promosi yang sama untuk beberapa properti, Anda harus mengirimkannya secara terpisah untuk setiap properti. Untuk menentukan ID properti, gunakan atribut hotel_id dari elemen <HotelPromotions>.

• Anda dapat menyertakan hingga 99 promosi. Hubungi TAM Google Anda jika Anda perlu menyertakan lebih dari ini.

• Gunakan elemen <Stacking> untuk menentukan cara promosi dapat digabungkan. Secara default, Google menggunakan jenis penumpukan base, yang berarti promosi dasar terbaik yang memenuhi syarat dipilih dan diterapkan terlebih dahulu, sebelum promosi lainnya. Perhatikan bahwa base hanya dapat digabungkan dengan second atau any, dan tidak dapat digabungkan dengan base atau none lain.

• Meskipun ada beberapa promosi yang dapat diterapkan bersama-sama, promosi tersebut mungkin tidak digunakan jika ada promosi tunggal atau beberapa promosi lain yang menawarkan diskon lebih besar. Promosi (kombinasi) dengan diskon terbesar diterapkan ke pemesanan saat beberapa promosi (kombinasi) memenuhi syarat.

• Kirim pembaruan pesan Promosi setiap kali terjadi perubahan yang memengaruhi promosi Anda.

  Poin Penting: Ada batas 500 promosi per properti. Anda dapat menggunakan pesan <Promotions> untuk menghapus promosi dari properti.

Terkait pajak

Promosi terbaik (atau tumpukan promosi) diterapkan ke jumlah AmountAfterTax. Jika hanya AmountBeforeTax yang ditentukan, promosi akan diterapkan ke AmountBeforeTax.

Contoh

Bagian ini memberikan contoh dasar pesan Promosi 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.

Poin Penting: Kirim pesan promosi yang diperbarui kepada Google setiap kali promosi Anda berubah.

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 Google menampilkan data Anda dengan benar.

UserCountry adalah untuk mencantumkan lokasi pengguna (negara) yang memenuhi syarat untuk promosi. Jika ditentukan, hanya pengguna di negara tercantum yang ditawari tarif diskon.

Catatan: Kode negara bersifat opsional dan jika tidak ditentukan, pengguna di negara mana pun akan ditawari tarif diskon.

Contoh ini menunjukkan cara menetapkan diskon 15% untuk masa inap yang lebih lama 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 menyiapkan promosi.

Skenario 1: Cara menambahkan promosi diskon untuk masa inap yang lebih lama

Deskripsi

Anda ingin memberikan malam dengan harga diskon pada hari-hari tertentu dalam masa inap yang lebih lama.

Solusi

Gunakan setelan FreeNights untuk menyesuaikan jenis diskon yang diterapkan, bergantung pada jumlah malam menginap.

Contoh

Contoh ini menunjukkan cara menambahkan diskon 20% untuk dua malam untuk setiap 7 malam menginap dalam 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 menyetel 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.

Catatan: Jika tidak ditentukan, pengguna di perangkat mana pun akan 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 tidak berlaku atau salah dan perlu diganti dengan kumpulan promosi yang benar-benar baru.

Solusi

Gunakan tindakan overlay untuk mengganti promosi.

Catatan: Penggunaan overlay (bukan penggunaan delete individual) adalah cara yang direkomendasikan untuk mengganti semua promosi untuk properti. Gunakan tindakan delete jika Anda ingin menghapus hanya promosi tertentu untuk properti.

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 yang baru, atau Anda melakukan kesalahan dan perlu memperbaikinya.

Solusi

Gunakan tindakan delete jika Anda hanya ingin menghapus promosi individual tertentu untuk properti, dan gunakan tindakan overlay (bukan delete) untuk menghapus semua promosi yang ada tanpa penggantian.

Catatan: Penggunaan overlay (bukan tindakan delete individual) adalah cara yang direkomendasikan untuk mengganti semua promosi untuk properti.

Untuk mengetahui detail cara mengganti promosi menggunakan overlay, lihat Skenario 3.

Contoh

Contoh berikut menunjukkan cara menghapus hanya satu promosi untuk suatu 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 suatu 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 menumpuk promosi

Penumpukan menentukan cara promosi dapat digabungkan. Jika tidak ditentukan, type diasumsikan sebagai base, yang berarti promosi dasar terbaik yang memenuhi syarat dipilih dan diterapkan terlebih dahulu, sebelum promosi lainnya. Jika atribut type dari Stacking adalah any, atribut tersebut dapat digabungkan dengan promosi lainnya.

Catatan: Promosi (kombinasi) dengan diskon terbesar akan diterapkan ke pemesanan jika beberapa kombinasi promosi memenuhi syarat.

Deskripsi

Anda ingin pengguna memiliki opsi untuk menggunakan beberapa promosi secara bersamaan untuk properti yang sama.

Solusi

Gunakan penumpukan untuk menetapkan beberapa diskon per properti. Tumpukan dapat memiliki paling banyak satu base dan satu second, tetapi jumlah any tidak terbatas; dan any dapat digabungkan dengan jenis lain kecuali none.

Contoh

Contoh ini menunjukkan cara menumpuk jenis Penumpukan base, second, dan any. Untuk diskon gabungan sebesar 15%, 25%, 10%, harga $100 menjadi 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 gabungan diskon untuk promosi bertumpuk 1 hingga 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 gabungan promosi 1 hingga 3.