Pesan Transaksi (Data Properti)

Ringkasan

Pesan Transaksi (Data Properti) ARI 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 mencakup ID unik (PackageID), nama, deskripsi, hunian, 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 menyetel tindakan untuk melakukan hal berikut:

• Tambahkan jenis dan paket kamar ke properti.

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

• Menghapus jenis kamar dan paket dari properti.

• Tambahkan 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 Anda 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 pedoman berikut untuk pesan Transaksi:

Tindakan:

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

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

Dukungan bahasa:

Tentukan satu hingga dua 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 kamar dan paket:

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 mengirimkan 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 yang "cocok", Google tidak dapat menerima data ini hingga setelah properti yang sesuai "dicocokkan" dalam sistem. Mengirim semua properti dalam feed daftar dapat membantu mencegah error atau penundaan di kemudian hari.

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 lebih lanjut Poin loyalitas.

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 (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 Google menampilkan harga dan data Anda dengan benar.

Catatan: Google menggunakan "ID" untuk ID jenis kamar dan paket (paket tarif); sedangkan, OTA XML menggunakan "code". 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/POSTING pesan, lihat Mengirim pesan.

Contoh berikut menunjukkan cara menyetel 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 tersebut. Semua jenis kamar Queen tidak tersedia selama renovasi dan hanya jenis kamar King yang tersedia saat ini.

Solusi

• Anda tidak perlu memperbarui ketersediaan, tarif, atau inventaris harian untuk ID jenis kamar dan paket yang telah dihapus atau dinonaktifkan.
• Jika jenis kamar atau paket telah dihapus atau dinonaktifkan, kirimkan pesan Transaksi baru dengan action="overlay" yang hanya menyertakan jenis kamar dan paket yang masih aktif dan tidak menyertakan 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 mencakup 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 menyetel 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 kamar Anda dikelompokkan berdasarkan 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 suite Presidential), dan enam paket berbeda, tetapi hanya beberapa paket yang memenuhi syarat untuk suite Presidential, 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 bergantung pada apakah sistem Anda menggunakan hierarki room>package atau package>room. Jika kedua elemen ini tidak 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 suite Penthouse hanya mengizinkan paket all-inclusive Penthouse atau paket Sarapan gratis, sedangkan jenis kamar suite King hanya mengizinkan paket all-inclusive King atau paket Ramah 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 mungkin telah Anda gunakan sebelumnya, tetapi kini tidak diizinkan di sistem Anda, 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) saat jenis kamar dikelompokkan menurut paket?

Catatan: Jika paket Anda dikelompokkan menurut jenis ruangan, 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 ingin menentukan hanya 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 dalam 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>