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:

• Tambahkan paket dan jenis kamar ke properti.

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

• Menghapus jenis kamar dan paket dari properti.

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

Elemen wajib dan opsional

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

Sintaksis dan skema

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

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

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 set baru. Harus menyertakan informasi untuk semua jenis kamar dan paket tarif yang yang tetap 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 banyak daripada 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 Anda menambahkan Anda juga harus mencantumkan nama dan deskripsinya.

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

Kirim info terbaru pesan Transaksi ke Google setiap kali ada perubahan ruang tipe atau paket, atau detail penting tentang tipe kamar atau paket yang perlu ditambahkan.

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

Contoh

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

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 Anda untuk paket tarif dan jenis kamar (masing-masing). Konsistensi dengan sistem adalah sangat penting untuk memastikan Google menampilkan harga dan data Anda dengan benar.

Catatan: Google menggunakan "ID" untuk ID jenis dan paket kamar (paket tarif); sedangkan, XML OTA menggunakan "code". Anda harus menggunakan tanda pengenal 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 mendorong/MENGPOSTING pesan, lihat Mendorong pesan.

Contoh berikut menunjukkan cara menetapkan pesan Transaksi menggunakan delta tindakan:

<?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, tambahkan jenis kamar dan paket ke data properti yang ada, dan menghapus jenis kamar dan paket, lihat Transaksi (Data Properti) Contoh.

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 sudah ada?

Deskripsi

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

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

Anda kemudian dapat menetapkan overlay untuk menghapus jenis kamar Queen dan mempertahankan King jenis ruang:

  <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 kamar Anda dikelompokkan menurut paket, lihat Skenario 3.

Deskripsi

Anda memiliki paket tertentu yang hanya tersedia untuk jenis kamar tertentu. Sebagai misalnya, jika properti Anda memiliki empat jenis kamar (termasuk Suite Presiden), dan enam paket yang berbeda, tetapi hanya beberapa paket yang memenuhi syarat untuk Presiden, 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 jangan keduanya, dan elemen yang Anda gunakan tergantung pada apakah sistem Anda menggunakan hierarki kamar>paket atau paket>kamar. Jika tak satu pun dari elemen ini didefinisikan 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 tipe kamar tertentu. Di sini, tipe kamar suite Penthouse hanya mengizinkan paket lengkap Penthouse atau paket Sarapan gratis sementara Tipe kamar suite King hanya mengizinkan paket lengkap King atau Paket yang boleh membawa hewan peliharaan.

<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 sebelumnya mungkin telah Anda gunakan tetapi sekarang tidak diizinkan sistem, Anda tidak perlu mengirim ulang ARI untuk semua tanggal hanya untuk menghapus data.

Skenario 3: Cara mengontrol produk menggunakan AllowableRoomIDs

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

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

Deskripsi

Jenis kamar dan kombinasi paket tidak lagi dijual sebagai produk atau yang Anda inginkan untuk mengontrol apa yang termasuk dalam paket baru. Misalnya, Anda ingin menentukan hanya jenis kamar tertentu, seperti kamar King dan Queen dengan pemandangan laut, dengan sebuah paket.

Solusi

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

Contoh

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

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