Pesan Promosi

Ringkasan

Pesan Promosi menentukan aturan tarif diskon menggunakan OTA_HotelRateAmountNotifRQ. Untuk setiap tarif, promosi yang ditentukan akan dievaluasi dan diskon terbesar yang diizinkan diterapkan ke besar. Jenis pesan ini bersifat opsional dan Anda hanya perlu mendefinisikan 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 + jumlah tamu), pengguna akan menerima promosi termurah yang diizinkan atau kombinasi promosi, dan diskon akan otomatis diterapkan.

Untuk contoh berbagai skenario terkait promosi, lihat Petunjuk.

Bagian berikut mencakup pedoman umum, contoh dasar, dan petunjuk skenario untuk membantu Anda mulai menambahkan dan memperbarui promosi.

Panduan

Bagian ini mencakup pedoman umum dan petunjuk khusus untuk 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 properti.

Delta

Jika tidak ada tindakan yang ditentukan, maka semua promosi yang ditentukan dalam <HotelPromotions> akan ditambahkan atau diganti. Jika promosi dengan ID tersebut belum pernah ditambahkan atau dihapus, maka promosi ditambahkan. Jika promosi dengan ID tersebut sudah ada, maka akan ditimpa dengan definisi baru.

Umum

• Masing-masing properti dapat berisi satu atau beberapa promosi promosi memiliki serangkaian ketentuan. Promosi tersebut hanya dapat diterapkan jika kondisi terpenuhi.

• Jika Anda ingin promosi hanya berlaku untuk tanggal, jenis kamar, atau tarif tertentu rencana Anda, lalu tetapkan dalam ketentuan untuk promosi tersebut. Jika promosi tidak berlaku untuk tanggal, jenis kamar, atau paket tarif tertentu, maka yang tidak harus diatur.

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

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

• Gunakan elemen <Stacking> untuk menentukan cara penggabungan promosi. Menurut secara default, Google menggunakan jenis tumpukan base, artinya kumpulan data terbaik promosi dasar dipilih dan diterapkan terlebih dahulu, sebelum promosi lainnya. Catatan bahwa base hanya dapat digabungkan dengan second atau any, dan tidak dapat digabungkan dengan base atau none lain.

• Meskipun ada setumpuk promosi yang dapat diterapkan bersamaan, tumpukan itu mungkin bukan tumpukan yang digunakan jika ada lapisan satu promosi atau tumpukan promosi yang menawarkan diskon lebih dalam. Tujuan promosi (kombinasi) dengan diskon terbesar diterapkan ke pemesanan jika beberapa (kombinasi) promosi valid.

• Kirim pembaruan pesan Promosi setiap kali ada 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 AmountAfterTax jumlah tersebut. Jika hanya AmountBeforeTax yang ditentukan, promosi akan diterapkan ke AmountBeforeTax.

Contoh

Bagian ini memberikan contoh dasar pesan Promosi yang menggunakan atribut dan elemen opsional. Setelah Anda menyiapkan file Anda, 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 Mendorong pesan.

Poin Penting: Kirim pesan promosi yang diperbarui ke Google setiap kali promosi Anda perubahan.

Untuk atribut hotel_id <HotelPromotions>, gunakan ID Hotel unik yang digunakan di dalam sistem Anda 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 adalah untuk mencantumkan lokasi pengguna (negara) yang memenuhi syarat untuk promosi. Jika ditentukan, hanya pengguna di negara yang tercantum yang menawarkan tarif diskon.

Catatan: Menetapkan 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 diperpanjang untuk 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 hadapi saat menetapkan promosi.

Skenario 1: Cara menambahkan promosi diskon untuk masa inap tambahan

Deskripsi

Anda ingin memberikan diskon malam pada hari tertentu dengan perpanjangan masa inap.

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 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 ditawarkan tarif diskon.

Catatan: Jika tidak ditentukan, pengguna di perangkat apa 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 menetapkan diskon 25% untuk perangkat seluler dan pengguna 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 memerlukan untuk diganti dengan set yang sama sekali baru.

Solusi

Gunakan tindakan overlay untuk mengganti promosi.

Catatan: Menggunakan overlay (bukan menggunakan delete individual) adalah cara yang direkomendasikan untuk menimpa semua promosi untuk properti. Gunakan Tindakan delete jika Anda hanya ingin menghapus promosi tertentu untuk Anda.

Contoh

Contoh berikut menunjukkan dua diskon awal 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 menggantikan yang sudah ada dua promosi 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 pengganti) karena telah menghapus semua promosinya tanpa menetapkan promosi 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: Menggunakan overlay (bukan tindakan delete individual) adalah cara yang direkomendasikan untuk menimpa semua promosi untuk sebuah properti.

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 menyusun promosi

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

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

Deskripsi

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

Solusi

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

Contoh

Contoh ini menunjukkan cara menumpuk jenis base, second, dan any. Sebagai diskon gabungan 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 bertumpuk 1 hingga 3 adalah lebih baik daripada diskon untuk promosi 4. Promosi 4 tidak dapat digabungkan dengan promosi lain karena jenis tumpukannya (none). Jika promosi 4 memiliki dengan diskon sebesar 43% atau lebih tinggi, itu akan digunakan sebagai pengganti kombinasi promosi 1 sampai 3.