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 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 stacking base, yang berarti promosi dasar terbaik yang memenuhi syarat akan 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 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.

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.