Pesan Transaksi (Data Properti)

Ringkasan

Pesan Transaksi ARI (Data Properti) menentukan informasi tentang jenis kamar dan paket (atau paket tarif) setiap properti. Setiap data jenis kamar mencakup ID unik (RoomID), nama yang dilokalkan, deskripsi, dan URL ke foto kamar. Setiap data paket menyertakan ID unik (PackageID), nama, deskripsi, jumlah tamu, dan nilai tambah yang dilokalkan.

Anda dapat menggunakan pesan Transaksi untuk melakukan hal berikut:

• Tentukan data untuk satu atau beberapa properti.
• Tentukan jenis kamar dan informasi paket untuk setiap properti.
• Mengontrol penawaran produk.

Selain itu, Anda dapat menetapkan tindakan untuk melakukan hal berikut:

• Menambahkan jenis dan paket kamar ke properti.

  Poin Penting: Jenis kamar memiliki batas 3.000 per properti. Paket juga memiliki batas terpisah sebesar 3.000 per properti. Anda dapat menggunakan pesan <Transaction> untuk menghapus jenis kamar atau paket.

• Menghapus jenis kamar dan paket dari properti.

• Menambahkan Poin loyalitas, program reward ke paket atau properti.

Untuk contoh pesan transaksi, lihat Contoh Transaksi (Data Properti).

Elemen wajib dan opsional

Referensi XML memberikan deskripsi elemen wajib dan opsional. Untuk mengetahui detail tentang atribut dan elemen turunan, lihat Elemen & Atribut Transaksi (Data Properti).

Sintaksis dan skema

Gunakan contoh Sintaksis Transaksi (Data Properti) sebagai referensi saat membuat pesan Transaksi untuk memastikan Anda mengikuti format yang benar.

Anda dapat menggunakan alat XML pihak ketiga seperti xmllint untuk memvalidasi feed dengan skema yang dipublikasikan sebelum mengirimkannya ke Google. Untuk skema pesan Transaksi, lihat Skema Iklan Hotel.

Panduan

Gunakan panduan berikut untuk pesan Transaksi:

Tindakan:

delta: Gunakan untuk menambahkan atau memperbarui jenis kamar dan paket baru (paket tarif).

overlay: Gunakan untuk mengganti semua jenis kamar dan paket untuk properti dengan kumpulan baru. Harus menyertakan informasi untuk semua jenis kamar dan paket tarif yang masih ingin Anda jual.

Dukungan bahasa:

Tentukan satu hingga dua bahasa (bahasa Inggris, dan bahasa lokal untuk properti jika diperlukan) untuk kolom Nama, Deskripsi, dan Teks. Anda dapat menambahkan lebih dari dua bahasa jika diperlukan.

Jenis dan paket kamar:

Saat memperbarui jenis kamar atau paket, Anda harus mengirimkan semua informasi terkait untuk jenis kamar atau paket tersebut. Misalnya, saat menambahkan foto, Anda juga harus menyertakan nama dan deskripsi.

<AllowablePackageIDs> dan <AllowableRoomIDs> bersifat opsional, dan jika tidak ditetapkan, kombinasi jenis kamar dan paket tarif apa pun dapat dibuat. Anda tetap harus mengirim ketersediaan dan tarif dengan ID jenis kamar dan paket tarif. Elemen ini memungkinkan Anda mengontrol produk serta menonaktifkan kombinasi yang tidak lagi didukung sistem Anda.

Kirimkan pembaruan pesan Transaksi ke Google setiap kali ada perubahan pada jenis kamar atau paket, atau detail penting tentang jenis kamar atau paket yang perlu ditambahkan.

Catatan: Karena Google menyimpan data properti yang terhubung ke properti "cocok", Google tidak dapat menerima data ini hingga setelah properti yang sesuai telah "cocok" di sistem. Mengirim semua properti dalam feed daftar dapat membantu mencegah error atau penundaan di lain waktu.

Poin loyalitas:

Untuk menyertakan atau mengecualikan program reward dalam paket Anda, siapkan konfigurasi poin Loyalitas dengan Google. Tindakan ini akan menampilkan poin yang diperoleh yang terkait dengan paket tersebut. Pelajari Poin loyalitas lebih lanjut.

Gunakan elemen <MilesIncluded> untuk menentukan atau memperbarui kampanye loyalitas Anda. Lihat Transaksi(Data Properti) untuk mengetahui informasi selengkapnya. Poin loyalitas dapat disertakan dengan <PackageData>.

Contoh

Bagian ini memberikan contoh dasar pesan Transaksi ARI menggunakan elemen wajib dan opsional. Untuk menambahkan atau memperbarui jenis kamar dan paket, Anda menggunakan tindakan untuk delta guna menambahkan atau memperbarui jenis kamar dan paket, atau overlay untuk mengganti semua definisi jenis kamar dan paket (menghapus entri lama).

Anda harus menentukan satu hingga dua bahasa (bahasa Inggris, dan bahasa lokal untuk properti jika diperlukan) untuk kolom Nama, Deskripsi, dan Teks. Kemudian, tambahkan informasi data properti, termasuk link ke foto.

Untuk <PropertyID> dan<RoomID>, gunakan ID yang sama dengan yang Anda gunakan dalam sistem untuk paket tarif dan jenis kamar (masing-masing). Konsistensi dengan sistem Anda sangat penting untuk memastikan bahwa Google menampilkan harga dan data Anda dengan benar.

Catatan: Google menggunakan "ID" untuk ID jenis kamar dan paket (paket tarif); sedangkan, XML OTA menggunakan "kode". Anda harus menggunakan ID Anda sendiri karena Google tidak membuatnya. Untuk data properti, ID jenis kamar dan paket tarif harus unik per properti.

Setelah menyiapkan file, Anda harus mengirimkannya ke Google melalui pesan POST ke endpoint berikut: https://www.google.com/travel/hotels/uploads/property_data

Untuk mempelajari lebih lanjut cara mengirim/POST pesan, lihat Mengirim pesan.

Contoh berikut menunjukkan cara menetapkan pesan Transaksi menggunakan tindakan delta:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Untuk contoh lainnya, seperti cara menggunakan tindakan overlay, menambahkan jenis kamar dan paket ke data properti yang ada, serta menghapus jenis kamar dan paket yang ada, lihat Contoh Transaksi (Data Properti).

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat mengirim pesan Transaksi.

Skenario 1: Cara menghapus data jenis kamar

Bagaimana cara menghapus data jenis kamar dan/atau paket yang ada?

Deskripsi

Anda telah mengirimkan beberapa jenis kamar, termasuk kamar King dan Queen, untuk properti. Semua jenis kamar Queen tidak tersedia selama renovasi dan saat ini hanya jenis kamar King yang tersedia.

Solusi

• Anda tidak perlu memperbarui ketersediaan, tarif, atau inventaris per malam untuk jenis kamar dan ID paket yang telah dihapus atau dinonaktifkan.
• Jika jenis kamar atau paket telah dihapus atau dinonaktifkan, kirim pesan Transaksi baru dengan action="overlay" yang hanya menyertakan jenis kamar dan paket yang masih aktif dan mengecualikan jenis kamar atau paket yang dihapus.

Contoh

Cuplikan XML ini menunjukkan cara menggunakan tindakan overlay untuk menghapus jenis kamar.

Catatan: Meskipun contoh ini mencakup jenis kamar, Anda juga dapat menggunakan tindakan yang sama untuk menghapus data paket.

Berikut adalah tindakan delta asli yang menyertakan jenis kamar King dan Queen:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Kemudian, Anda dapat menetapkan overlay untuk menghapus jenis kamar Queen dan mempertahankan jenis kamar King:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Skenario 2: Cara mengontrol produk menggunakan AllowablePackageIDs

Bagaimana cara mengontrol produk (kombinasi jenis kamar dan paket) saat paket dikelompokkan menurut jenis kamar?

Catatan: Jika jenis ruangan Anda dikelompokkan menurut paket, lihat Skenario 3.

Deskripsi

Anda memiliki paket tertentu yang hanya tersedia untuk jenis kamar tertentu. Misalnya, jika properti Anda memiliki empat jenis kamar (termasuk Presidential suite), dan enam paket berbeda, tetapi hanya beberapa paket yang memenuhi syarat untuk Presidential suite, Anda dapat menentukan kelayakan.

Solusi

Kirim pesan Transaksi yang diperbarui yang menentukan produk mana yang disertakan dalam paket menggunakan <AllowablePackageIDs>.

Catatan: Gunakan <AllowablePackageIDs> atau <AllowableRoomIDs>, tetapi tidak kedua-duanya, dan elemen yang Anda gunakan bergantung pada apakah sistem Anda menggunakan hierarki room>package atau package>room. Jika tidak satu pun elemen ini ditentukan dalam pesan Transaksi, jenis kamar dapat digabungkan dengan paket apa pun.

Contoh

Cuplikan XML ini menunjukkan cara menggunakan <AllowablePackageIDs> untuk menentukan paket yang digunakan dengan jenis kamar tertentu. Di sini, jenis kamar Penthouse suite hanya mengizinkan paket Penthouse all-inclusive atau paket Sarapan gratis, sedangkan jenis kamar King suite hanya mengizinkan paket King all-inclusive atau paket Hewan peliharaan diizinkan.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Catatan: Jika Anda menggunakan <AllowablePackageIDs> atau <AllowableRoomIDs> untuk menonaktifkan kombinasi yang mungkin telah Anda gunakan sebelumnya, tetapi sekarang tidak diizinkan di sistem, Anda tidak perlu mengirim ulang ARI untuk semua tanggal hanya untuk menghapus data sebelumnya.

Skenario 3: Cara mengontrol produk menggunakan AllowableRoomIDs

Bagaimana cara mengontrol produk (kombinasi jenis kamar dan paket) jika jenis kamar dikelompokkan menurut paket?

Catatan: Jika paket Anda dikelompokkan menurut jenis kamar, lihat Skenario 2.

Deskripsi

Kombinasi jenis kamar dan paket tidak lagi dijual sebagai produk atau Anda ingin mengontrol apa yang disertakan dalam paket baru. Misalnya, Anda hanya ingin menentukan jenis kamar tertentu, seperti kamar King dan Queen dengan pemandangan laut, dengan paket.

Solusi

Kirim pesan Transaksi yang diperbarui yang menentukan produk persis yang disertakan dengan paket menggunakan elemen <AllowableRoomIDs>.

Contoh

Cuplikan XML ini menunjukkan cara menggunakan <AllowableRoomID> untuk menentukan jenis kamar King dan Queen dengan pemandangan laut dalam paket.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>