Paket Kamar

Paket Kamar memungkinkan Anda menetapkan beberapa tipe kamar untuk satu properti, atau menggabungkan itinerari kamar dengan fitur tarif—layanan tambahan yang dilengkapi dengan tarif dan ketentuan penjualan—kepada pengguna Anda di luar harga standar.

Konsep utama dan alur kerja

Dengan Paket Kamar, Anda dapat menawarkan kombinasi tambahan jenis kamar fisik dengan berbagai paket layanan.

Gambar berikut menampilkan contoh Paket Kamar:

Dalam contoh ini, paket pertama adalah kamar standar, dengan diskon hanya untuk satu tamu dewasa. Yang kedua adalah jenis kamar berbeda yang tersedia untuk hingga tiga tamu dewasa. Yang ketiga adalah jenis kamar lain di dalam properti yang sama. Yang keempat adalah paket "premium" dari kamar standar, yang mungkin mencakup fasilitas seperti sarapan gratis atau checkout setelahnya.

Gambar berikut menunjukkan contoh fitur tarif:

Tampilan Paket Kamar dan fitur tarif di hasil penelusuran diatur oleh proses pemilihan yang sama seperti tarif kamar standar.

Paket Kamar

Anda menentukan Paket Kamar dan fitur tarif di pesan Transaksi. Elemen root pesan Transaksi adalah <Transaction>.

Struktur pesan Transaksi bergantung pada tindakan Anda: menentukan metadata tentang Paket Kamar atau fitur tarif, atau memperbarui harga atau ketersediaan Paket Kamar.

Metadata
Tentukan metadata Paket Kamar dan fitur tarif dengan <PackageData> dalam elemen <PropertyDataSet>. Untuk mengetahui informasi selengkapnya, lihat Menentukan metadata paket dan kamar. Paket Kamar menggunakan elemen <RoomData> yang sudah ada untuk deskripsi kamar fisiknya.
Harga dan ketersediaan
Tentukan harga dan ketersediaan Paket Kamar dengan elemen <RoomBundle> dalam <Result> untuk setiap kombinasi paket/itinerari. Untuk mengetahui informasi selengkapnya, lihat Menentukan harga dan ketersediaan.

Tarif, pajak, dan biaya lain kamar dasar bersifat wajib di bawah <Result> jika tidak digunakan dengan Paket Kamar, dan dapat dihapus jika digunakan dengan Paket Kamar. Jika Anda menerapkan Paket Kamar menggunakan akun aktif, ikuti langkah-langkah berikut:

  1. Sertakan tarif kamar dasar, pajak, dan biaya lainnya di bagian <Result>, lalu tambahkan satu Paket Kamar yang cocok dengan Paket Kamar dasar.

  2. Jika diperlukan, tentukan Paket Kamar tambahan dalam blok <Result> yang sama untuk jenis kamar lain di properti tersebut atau paket layanan yang berbeda.

  3. Setelah Paket Kamar diluncurkan, hapus tarif kamar dasar, pajak, dan biaya lainnya.

Metadata Paket Kamar

Saat menentukan Paket Kamar dan fitur tarif, Anda biasanya menentukan deskripsi, layanan tambahan yang merupakan bagian dari tarif, dan informasi lain tentang Paket Kamar sebelumnya. Informasi ini dikenal sebagai metadata Paket Kamar. Anda kemudian mereferensikan metadata ini dalam pembaruan harga, tetapi tidak menyertakannya dalam pesan pembaruan harga.

Saat menentukan Paket Kamar, gunakan elemen <RoomData> yang ada untuk deskripsi kamar fisik dan elemen <PackageData> untuk fitur tarif dan persyaratan yang bukan bagian dari deskripsi kamar fisik.

Menggunakan elemen <RoomData> dan <PackageData> dapat mengurangi ukuran Daftar Hotel dan Feed Harga Hotel Anda secara signifikan karena mengurangi jumlah data berulang yang dikirim dalam pesan Transaksi.

Misalnya, data seperti nama dan deskripsi kamar biasanya diulang untuk setiap itinerari. Anda dapat menggunakan elemen <RoomData> dan <PackageData> untuk menentukan jenis data ini sekali. Data Paket Kamar khusus itinerari kemudian digabungkan dengan definisi paket dan kamar yang disimpan untuk ditampilkan kepada pengguna akhir.

Google mencocokkan metadata Anda dengan data spesifik per itinerari untuk merender konten iklan Anda. Ada pemrosesan khusus untuk menggabungkan nama dan deskripsi dari elemen <RoomData> dan <PackageData>, sehingga memungkinkan kamar fisik dijelaskan dalam <RoomData> serta fitur tarif dan detail paket berada di <PackageData>.

Jika Anda menentukan data kamar dan data paket untuk satu kamar atau Paket Room, Google akan menyertakan keduanya dalam output iklan, dipisahkan dengan tanda hubung.

Pedoman foto

Saat mengirim foto ruang, berikut beberapa panduan yang harus Anda ikuti untuk memastikan foto ditampilkan kepada pengguna:

  • Kirim foto untuk setiap jenis kamar, termasuk foto kamar khusus difabel—misalnya, kamar khusus khusus difabel dengan berbagai perlengkapan kamar mandi, seperti shower gantung.

  • Sertakan setidaknya empat foto kamar dan setidaknya satu foto kamar mandi.

  • Foto harus dari kamar itu sendiri, bukan properti. Foto yang paling penting adalah tempat tidur, seluruh kamar, kamar mandi, ruang keluarga, dan pemandangan dari kamar (dengan bagian ruangan yang lain dalam foto yang sama), dan, jika ada, balkon, teras, atau teras.

    Sebaiknya Anda juga mengambil foto meja, dapur, alat pembuat kopi/teh, dan fitur kamar yang berbeda.

  • Hindari foto orang dan properti—misalnya, fasilitas eksterior atau properti—wisata/pariwisata, dan makanan.

  • Hindari foto objek yang dekat, seperti gambar gelas tangkai dari jarak dekat.

  • Hindari branding dan merek, meskipun perlengkapan mandi berlabel atau bermerek boleh disertakan dalam foto yang menampilkan seluruh area kamar mandi. Foto tidak boleh menampilkan blok teks, logo, atau watermark yang besar.

  • Berikan foto standar lanskap (horizontal) dengan ruang pandang yang lebar; hindari foto fish eye dan terdistorsi. Ambil foto dengan resolusi tertinggi untuk menaikkan peringkat. Anda tidak perlu mengirimkan foto yang sama dalam berbagai resolusi.

Prioritas data

Data Paket Kamar dikumpulkan dari semua sumber dan digabungkan, menggunakan aturan prioritas, guna menghasilkan data akhir untuk hotel, itinerari, dan Paket Kamar tertentu. Urutannya adalah sebagai berikut, dari prioritas terendah hingga tertinggi:

  1. (Terendah) Data partner
  2. Data properti
  3. <RoomData>, dengan <RoomID> cocok dengan <RoomID> dalam blok <RoomBundle>
  4. <PackageData>, dengan <PackageID> cocok dengan <PackageID> dalam blok <RoomBundle>
  5. (Tertinggi) <RoomBundle>

Menentukan harga dan ketersediaan

Untuk menentukan harga dan ketersediaan Paket Kamar, gunakan elemen <RoomBundle> dalam pesan Transaksi untuk setiap kombinasi paket atau itinerari. Elemen <RoomBundle> harus berada di dalam elemen <Result>. Kode contoh untuk dua elemen <RoomBundle> ditampilkan di bawah ini. Perlu diperhatikan bahwa dalam contoh ini, dua elemen <RoomBundle> mereferensikan metadata paket dan kamar menggunakan <RoomID> dan <PackageID>.

Untuk setiap <Result>, kumpulan Paket Kamar yang terdapat akan menimpa kumpulan yang ada untuk kombinasi properti atau itinerari tersebut. Jika Anda tidak menentukan Paket Kamar atau fitur tarif di elemen <Result>, semua Paket Kamar akan dihapus dan hanya kamar standar untuk hotel atau itinerari tersebut yang akan ditampilkan di hasil penelusuran.

Pastikan untuk menggunakan elemen seperti <Name> agar Paket Kamar Anda lebih menarik bagi calon pelanggan dan pastikan paket tersebut cocok dengan halaman landing hotel. Dalam contoh ini, Anda akan menentukan nama dan informasi deskriptif lainnya dalam metadata.

<RatePlanID> bersifat opsional dan merepresentasikan ID unik untuk kombinasi kamar dan paket. Sebaiknya gunakan RatePlanID sebagai variabel untuk membuat URL halaman landing dinamis (sebelumnya disebut Tempat Penjualan). Untuk mengetahui detailnya, lihat Menggunakan Variabel dan Ketentuan.

Elemen berikut bersifat opsional dalam Paket Kamar:

<Baserate>
<Tax>
<OtherFees>
<RoomID>
<PackageID>
<Occupancy>
<OccupancyDetails>

Saat menerapkan Paket Kamar di akun aktif, hapus <Baserate> setelah Paket Kamar diaktifkan.

<Result>
  <!-- Note: When using Room Bundles, the top level result price is no
       longer necessary. -->
  <Property>180054</Property>
  <Checkin>2017-10-07</Checkin>
  <Nights>2</Nights>
  <!-- Base Room Bundle -->
  <RoomBundle>
    <RoomID>060773</RoomID>
    <PackageID>P54321</PackageID>
    <Baserate currency="USD">199.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
    <!-- RatePlanID is optional and represents the unique identifier for a
    room and package data combination. We strongly recommend using RatePlanID
    as a variable to build your dynamic landing page (formerly Point of Sale)
    URL. For details, see Using Variables and Conditions. -->
    <RatePlanID>060773-P54321</RatePlanID>
  </RoomBundle>
  <!-- Premium Room Bundle -->
  <RoomBundle>
    <RoomID>436233</RoomID>
    <PackageID>P12345</PackageID>
    <!-- Price for 4 ("occupancy") -->
    <Baserate currency="USD">298.88</Baserate>
    <Tax currency="USD">42.12</Tax>
    <OtherFees currency="USD">10.00</OtherFees>
    <RatePlanID>436233-P12345</RatePlanID>
  </RoomBundle>
</Result>

Menentukan metadata kamar dan paket

Untuk menentukan metadata Paket Kamar, gunakan elemen <PackageData> dan <RoomData> di dalam elemen <PropertyDataSet> pesan Transaksi.

Anda menentukan metadata paket dan kamar dalam pesan Transaksi yang terpisah dari data harga dan ketersediaan. Dengan menentukan data ini terlebih dahulu, pembaruan harga Anda tidak perlu menyertakan informasi berulang seperti deskripsi, URL foto, fasilitas, dan data lain tentang setiap kamar atau paket untuk setiap itinerari.

Google menyimpan metadata untuk Anda dan memasukkannya ke dalam iklan saat ditampilkan. Anda dapat memperbarui metadata kamar dan paket kapan saja dengan pesan Transaksi baru.

Dalam pesan Transaksi, Anda menetapkan ID paket dan ID kamar pada setiap blok yang kemudian Anda referensikan dalam blok <Result> pembaruan harga.

Jika data kamar dan paket berubah—misalnya, jika Anda menambahkan jenis kamar baru di properti, kirim pesan Transaksi baru yang berisi data paket dan kamar yang diperbarui—Google akan mengganti metadata yang ada tentang kamar atau paket dengan data baru.

Google merekomendasikan agar Anda menentukan metadata selama penyiapan awal. Setelah menentukan metadata, Anda hanya perlu mereferensikan nilai <RoomID> dan <PackageID> dalam pembaruan harga, bukan menyertakan semua informasi tersebut lagi. Google menggunakan ID tersebut untuk mencocokkan kamar dan Paket Kamar dengan metadata yang disimpan. Hal ini dapat mengurangi ukuran keseluruhan pesan Transaksi Anda secara signifikan.

Karena harga untuk kombinasi kamar atau itinerari berubah jauh lebih sering daripada deskripsi kamar atau paket, menentukan metadata satu kali lalu merujuk ke sana adalah penggunaan pesan Transaksi yang jauh lebih efisien. Selain itu, error seperti deskripsi kamar yang tidak cocok dapat dihilangkan menggunakan metadata, bukan menentukan data secara inline.

Metode yang direkomendasikan dan paling efisien untuk menentukan metadata dan harga secara terpisah ditampilkan di bawah ini:

<!-- Efficient method of defining Room Bundles -->
<!----- Occupancy of 2 and 4 example ------>

<Transaction timestamp="2019-04-18T16:20:00-04:00" id="12345678">
  <!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
  <!-- Note: Once defined it does not have to be repeated for future Transaction Messages. -->
  <!--       PropertyDataSets can also be defined and sent in their own Transaction Message -->
  <!--       separately from pricing. Google can be configured to pull just PropertyDataSets -->
  <!--       once per day (or on a predefined frequency). -->
  <PropertyDataSet>
    <Property>180054</Property>
    <!-- Can be reused by multiple Room Bundles -->
    <RoomData>
      <RoomID>060773</RoomID>
      <Name>
        <Text text="Single Queen Room - Non-Smoking" language="en"/>
        <Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <!-- Room can accommodate 4, but bundle is for 2 -->
      <Capacity>4</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/imageQueen.jpg</URL>
        <Caption>
          <Text text="A bright and breezy way to enjoy your mornin'
            cuppa tea." language="en"/>
          <Text text="Une façon lumineuse et aérée pour profiter
            de votre journée tasse de thé." language="fr"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <RoomData>
      <RoomID>436233</RoomID>
      <Name>
        <Text text="Premium King Room - Non-Smoking" language="en"/>
        <Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
      </Name>
      <!-- Room can accommodate 4 and bundle is for 4 -->
      <Capacity>4</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/imageKing.jpg</URL>
        <Caption>
          <Text text="A bright and breezy way to enjoy your mornin'
            cuppa tea." language="en"/>
          <Text text="Une façon lumineuse et aérée pour profiter
            de votre journée tasse de thé." language="fr"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <!-- Can be reused by multiple Room Bundles -->
    <PackageData>
      <PackageID>P54321</PackageID>
      <Occupancy>2</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="7"
           refundable_until_time="18:00:00"/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
    <PackageData>
      <PackageID>P12345</PackageID>
      <Occupancy>4</Occupancy>
      <ChargeCurrency>web</ChargeCurrency>
      <Refundable available="1" refundable_until_days="1"
           refundable_until_time="18:00:00"/>
      <BreakfastIncluded/>
      <ParkingIncluded>1</ParkingIncluded>
      <InternetIncluded>1</InternetIncluded>
    </PackageData>
  </PropertyDataSet>

    <!-- Efficient method of defining Room Bundles -->
    <!-- Part 2: Reference RoomData and PackageData through ID -->
  <Result>
    <Property>180054</Property>
    <Checkin>2017-10-07</Checkin>
    <Nights>2</Nights>

    <!-- Base Room Bundle -->
    <RoomBundle>
      <RoomID>060773</RoomID>
      <PackageID>P54321</PackageID>
      <Baserate currency="USD">199.99</Baserate>
      <Tax currency="USD">25.12</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>060773-P54321</RatePlanID>
    </RoomBundle>
    <!-- Premium Room Bundle -->
    <RoomBundle>
      <RoomID>436233</RoomID>
      <PackageID>P12345</PackageID>
      <!-- Price for 4 ("occupancy") -->
      <Baserate currency="USD">298.88</Baserate>
      <Tax currency="USD">42.12</Tax>
      <OtherFees currency="USD">10.00</OtherFees>
      <RatePlanID>060773-P12345</RatePlanID>
    </RoomBundle>
    <!-- Continue providing all available RoomBundle rates under matched
         property for any other occupancies -->
  </Result>
</Transaction>

Okupansi dan kapasitas

Saat menentukan Paket Kamar, Anda harus memahami perbedaan antara jumlah tamu dan kapasitas:

Kehadiran
Jumlah tamu yang dimaksudkan untuk diterapkan pada Paket Kamar. Misalnya, "Paket Bulan Madu" memiliki jumlah tamu dua. Anda menetapkan nilai jumlah tamu paket menggunakan elemen turunan <Occupancy> dari elemen <PackageData> atau <RoomBundle>.
Capacity
Jumlah maksimum orang yang dapat diakomodasi oleh ruangan secara fisik. Kapasitas kamar selalu sama dengan atau lebih tinggi dari jumlah tamu. Misalnya, "Suite Bulan Madu" di hotel Anda memiliki kapasitas maksimum enam orang, tetapi Anda dapat menetapkan harga paket untuk dua tamu. Anda menetapkan nilai kapasitas paket menggunakan elemen turunan <Capacity> elemen <RoomData>.

Saat menetapkan harga Paket Kamar, Anda harus memberikan harga untuk jumlah tamu yang dituju paket tersebut (nilai yang ditentukan dalam elemen <Occupancy> paket). Jika <Occupancy> ditetapkan ke dua, maka harga dalam paket tersebut harus untuk dua orang. Anda tidak dapat menetapkan <Occupancy> ke empat tamu, dan menetapkan harga paket untuk dua tamu.

Kamar bersama

Anda juga menggunakan Occupancy dan Capacity dalam Paket Kamar untuk menetapkan harga akomodasi kamar bersama—misalnya, hostel. Misalnya, guna menetapkan harga per orang untuk kamar asrama yang memiliki 8 tempat tidur, Anda perlu menetapkan Occupancy ke 1 dan Capacity ke 8, serta mengidentifikasinya seperti itu dalam nama <RoomData>. Lihat contoh.

Memperbarui Paket Kamar

Bagian ini menjelaskan cara menghapus Paket Kamar yang tidak lagi tersedia dan cara memperbarui harga Paket Kamar yang ada.

Penghapusan Paket Kamar

Paket Kamar berbeda dengan harga hotel dalam cara menghapusnya.

Untuk menghapus kombinasi kamar atau itinerari dari inventaris, tetapkan <Baserate> elemen <Result> ke -1. Untuk menghapus Paket Kamar bagi kamar atau itinerari tertentu, hapus elemen <RoomBundle> dari blok <Result> dalam pesan Transaksi.

Paket Kamar di feed data Anda dianggap sebagai kumpulan, yang jumlahnya berkisar antara 0 hingga puluhan. Saat mengirimkan Paket Kamar ke Google, Anda mengirim kumpulan lengkap saat ini. Anda tidak mengubah nilai setiap Paket Kamar untuk menandai yang tersedia sebelumnya sebagai tidak tersedia. Apa pun kumpulan paket yang ada dalam pesan Transaksi terbaru akan menggantikan kumpulan saat ini.

Misalnya, ada paket A, B, C, dan D. Pertama-tama, Anda harus mengirim pesan yang menentukan kumpulan paket kamar A, B, C, dan D. Kemudian, jika paket B terjual habis, Anda akan mengirim ulang seluruh set hanya dengan paket A, C, dan D. Jika semua Paket Kamar telah terjual habis, kirim kumpulan Paket Kamar kosong.

Penyesuaian harga

Untuk mengubah harga Paket Kamar, tetapkan <Baserate> baru di elemen <Result>.

Setiap kali memperbarui blok <Result> kamar/itinerari dalam pesan Transaksi, Anda harus menyertakan kumpulan lengkap Paket Kamar yang tersedia untuk setiap <Result>. Google mengganti kumpulan Paket Kamar yang ada dengan kumpulan baru. Jika Anda tidak menyertakan Paket Kamar di <Result>, Google akan menghapus semua Paket Kamar untuk kamar atau itinerari tersebut.

Pembaruan metadata

Anda memperbarui metadata Paket Kamar dengan respons terhadap <Query> dari Google.

Anda merespons pesan Kueri dengan pesan Transaksi yang menentukan metadata paket dan kamar untuk hotel tertentu. Untuk mengetahui informasi selengkapnya, lihat Pesan Kueri.