Transaction (Tesis Verileri) Mesajı

Genel Bakış

ARI Transaction (Tesis Verileri) mesajı, her tesisin oda türleri ve paketleri (veya ücret planları) hakkındaki bilgileri tanımlar. Her oda türü verisi; benzersiz bir tanımlayıcı (RoomID), yerelleştirilmiş ad, açıklama ve oda fotoğraflarının URL'lerini içerir. Her paket verisi; benzersiz bir tanımlayıcı (PackageID), yerelleştirilmiş ad, açıklama, doluluk ve katma değerler içerir.

İşlem mesajını kullanarak şunları yapabilirsiniz:

• Bir veya daha fazla mülk için verileri tanımlayın.
• Her tesis için oda türü ve paket bilgilerini tanımlayın.
• Ürün tekliflerini kontrol edin.

Ayrıca, aşağıdaki işlemleri yapacak şekilde eylemler ayarlayabilirsiniz:

• Bir tesise oda türü ve paket ekleyin.

  Önemli nokta: Oda türü başına tesis başına 3.000 sınırı vardır. Paketler için de mülk başına 3.000 sınırı vardır. Oda türlerini veya paketleri kaldırmak için <Transaction> mesajını kullanabilirsiniz.

• Bir tesisten oda türü ve paket kaldırma.

• Pakete veya tesise bağlılık puanları ya da ödül programı ekleyin.

İşlem mesajı örnekleri için İşlem (Tesis Verileri) Örnekleri başlıklı makaleyi inceleyin.

Zorunlu ve isteğe bağlı öğeler

XML Referansı'nda gerekli ve isteğe bağlı öğelerin açıklamaları yer alır. Özellikler ve alt öğelerle ilgili ayrıntılar için İşlem (Tesis Verileri) Öğeleri ve Özellikleri başlıklı makaleyi inceleyin.

Söz dizimi ve şemalar

Doğru biçimi kullandığınızdan emin olmak için İşlem mesajını oluştururken İşlem (Tesis Verileri) Söz Dizimi örneğini referans olarak kullanın.

Feed'lerinizi Google'a göndermeden önce yayınlanan şemalarla doğrulamak için xmllint gibi bir üçüncü taraf XML aracı kullanabilirsiniz. İşlem mesajı şeması için Otel Reklamları şemaları konusuna bakın.

Yönergeler

İşlem mesajı için aşağıdaki yönergeleri kullanın:

Eylemler:

delta: Yeni oda türleri ve paketler (ücret planları) eklemek veya güncellemek için kullanılır.

overlay: Bir tesisteki tüm oda türlerini ve paketleri yeni bir grupla değiştirmek için kullanılır. Hâlâ satmak istediğiniz tüm oda türleri ve ücret planlarıyla ilgili bilgileri içermelidir.

Dil desteği:

Ad, Açıklama ve Altyazı alanları için bir veya iki dil (gerekirse İngilizce ve tesisin yerel dili) belirtin. Gerekirse ikiden fazla dil ekleyebilirsiniz.

Oda türleri ve paketler:

Bir oda türünü veya paketi güncellerken söz konusu oda türü ya da paketle ilgili tüm bilgileri göndermeniz gerekir. Örneğin, fotoğraf eklerken adı ve açıklamayı da eklemeniz gerekir.

<AllowablePackageIDs> ve <AllowableRoomIDs> isteğe bağlıdır ve ayarlanmamışsa oda türü ile ücret planının herhangi bir kombinasyonu oluşturulabilir. Müsaitlik durumunu ve fiyatları oda türü ve ücret planı kimlikleriyle birlikte göndermeye devam etmeniz gerekir. Bu öğeler, ürünleri kontrol etmenize ve sisteminizin artık desteklemediği kombinasyonları devre dışı bırakmanıza olanak tanır.

Oda türlerinde veya paketlerde bir değişiklik olduğunda ya da oda türleri veya paketlerle ilgili eklenmesi gereken önemli ayrıntılar olduğunda Google'a bir Transaction mesajı güncellemesi gönderin.

Not: Google, "eşleşen" bir mülke bağlı mülk verilerini sakladığı için, ilgili mülk sistemde "eşleşene" kadar Google bu verileri kabul edemez. Liste feed'inizdeki tüm tesislerinizi göndermek, daha sonraki hataları veya gecikmeleri önlemeye yardımcı olabilir.

Bağlılık puanları:

Ödül programını paketinize dahil etmek veya paketinize dahil etmemek için Google ile bir bağlılık puanı yapılandırması oluşturun. Bu işlem, söz konusu paketle ilişkili kazanılan puanları gösterir. Bağlılık puanları hakkında daha fazla bilgi edinin.

Sadakat kampanyanızı tanımlamak veya güncellemek için <MilesIncluded> öğesini kullanın. Daha fazla bilgi için Transaction(Property Data) başlıklı makaleyi inceleyin. Bağlılık puanları <PackageData> ile birlikte kullanılabilir.

Örnek

Bu bölümde, gerekli ve isteğe bağlı öğelerin kullanıldığı bir ARI Transaction mesajının temel örneği verilmektedir. Oda türleri ve paketleri eklemek veya güncellemek için delta ile oda türleri ve paketleri ekleme ya da güncelleme veya overlay ile tüm oda türü ve paket tanımlarını değiştirme (eski girişleri siler) işlemlerinden birini kullanırsınız.

Ad, Açıklama ve Altyazı alanları için bir veya iki dil (İngilizce ve gerekirse tesisin yerel dili) belirtmeniz gerekir. Ardından, fotoğrafların bağlantıları da dahil olmak üzere tesis verileri bilgilerini ekleyin.

<PropertyID> ve <RoomID> için sisteminizde ücret planları ve oda türleri (sırasıyla) için kullandığınız kimlikleri kullanın. Google'ın fiyatlarınızı ve verilerinizi doğru şekilde göstermesini sağlamak için sisteminizle tutarlılık çok önemlidir.

Not: Google, oda türü ve paket (ücret planı) tanımlayıcısı için "kimlik" kullanırken OTA XML'de "kod" kullanılır. Google, kimlik oluşturmadığı için kendi kimliklerinizi kullanmanız gerekir. Tesis verileri için oda türü ve ücret planı kimlikleri tesis başına benzersiz olmalıdır.

Dosyanızı hazırladıktan sonra aşağıdaki uç noktaya POST mesajı aracılığıyla Google'a göndermeniz gerekir: https://www.google.com/travel/hotels/uploads/property_data

Mesajı nasıl göndereceğiniz/POST edeceğiniz hakkında daha fazla bilgi edinmek için Mesaj gönderme başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, delta işlemi kullanılarak Transaction mesajının nasıl ayarlanacağı gösterilmektedir:

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

overlay işleminin nasıl kullanılacağı, mevcut tesis verilerine oda türü ve paket ekleme, mevcut oda türlerini ve paketleri kaldırma gibi daha fazla örnek için Transaction (Tesis Verileri) Örnekleri başlıklı makaleyi inceleyin.

"Nasıl yapılır" kılavuzları

Bu bölümde, İşlem mesajları gönderirken karşılaşabileceğiniz senaryolarla ilgili çözümler sunulmaktadır.

Senaryo 1: Oda türü verileri nasıl kaldırılır?

Mevcut oda türü ve/veya paket verilerini nasıl kaldırabilirim?

Açıklama

Tesis için King ve Queen odalar da dahil olmak üzere birden fazla oda türü gönderdiniz. Tadilat sırasında tüm Queen oda türleri kullanılamaz ve şu anda yalnızca King oda türleri kullanılabilir.

Çözüm

• Kaldırılan veya devre dışı bırakılan oda türü ve paket kimlikleri için gece müsaitliğini, ücretleri ya da envanteri güncellemeniz gerekmez.
• Oda türü veya paket kaldırıldıysa ya da devre dışı bırakıldıysa yalnızca hâlâ etkin olan oda türlerini ve paketleri içeren, kaldırılan oda türünü veya paketi içermeyen yeni bir action="overlay" ile Transaction mesajı gönderin.

Örnek

Bu XML snippet'inde, bir oda türünü kaldırmak için overlay işleminin nasıl kullanılacağı gösterilmektedir.

Not: Bu örnekte oda türü ele alınsa da paket verilerini kaldırmak için aynı işlemi kullanabilirsiniz.

Aşağıda, King ve Queen oda türlerini içeren orijinal delta işlemi verilmiştir:

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

Ardından, overlay ayarını kraliçe yataklı oda türünü kaldıracak ve kral yataklı oda türünü koruyacak şekilde ayarlayabilirsiniz:

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

Senaryo 2: Ürünleri AllowablePackageIDs kullanarak kontrol etme

Paketler oda türüne göre gruplandırıldığında ürünleri (oda türü ve paket kombinasyonları) nasıl kontrol edebilirim?

Not: Oda türleriniz paketlere göre gruplandırılmışsa 3. Senaryo'ya bakın.

Açıklama

Yalnızca belirli oda türlerinde kullanılabilen belirli paketleriniz var. Örneğin, mülkünüzde dört oda türü (Başkanlık süiti dahil) ve altı farklı paket varsa ancak yalnızca birkaç paket başkanlık süiti için uygunsa uygunluğu belirtebilirsiniz.

Çözüm

<AllowablePackageIDs> kullanarak pakete hangi ürünlerin dahil edildiğini belirten güncellenmiş bir Transaction mesajı gönderin.

Not: <AllowablePackageIDs> veya <AllowableRoomIDs> kullanın ancak ikisini birden kullanmayın. Kullandığınız öğe, sisteminizin oda>paket veya paket>oda hiyerarşisini kullanıp kullanmadığına bağlıdır. Bu öğelerden hiçbiri Transaction mesajında tanımlanmamışsa oda türleri herhangi bir paketle birleştirilebilir.

Örnek

Bu XML snippet'inde, belirli bir oda türüyle kullanılan paketleri belirtmek için <AllowablePackageIDs> öğesinin nasıl kullanılacağı gösterilmektedir. Burada, Penthouse süit oda türü yalnızca Penthouse her şey dahil paketine veya ücretsiz kahvaltı paketine izin verirken King süit oda türü yalnızca King her şey dahil paketine veya evcil hayvan dostu paketine izin verir.

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

Not: Daha önce kullanmış olabileceğiniz ancak artık sisteminizde izin verilmeyen bir kombinasyonu devre dışı bırakmak için <AllowablePackageIDs> veya <AllowableRoomIDs> kullanırsanız önceki verileri kaldırmak için tüm tarihler için tekrar ARI göndermeniz gerekmez.

Senaryo 3: Ürünleri AllowableRoomIDs kullanarak kontrol etme

Oda türleri pakete göre gruplandırıldığında ürünleri (oda türü ve paket kombinasyonları) nasıl kontrol edebilirim?

Not: Paketleriniz oda türüne göre gruplandırılıyorsa 2. Senaryo'ya bakın.

Açıklama

Bir oda türü ve paket kombinasyonu artık ürün olarak satılmıyor veya yeni bir pakete nelerin dahil edileceğini kontrol etmek istiyorsunuz. Örneğin, yalnızca belirli oda türlerini (ör. okyanus manzaralı King ve Queen odalar) bir paketle birlikte belirtmek istiyorsunuz.

Çözüm

<AllowableRoomIDs> öğesini kullanarak pakete dahil edilen ürünleri tam olarak belirten güncellenmiş bir Transaction mesajı gönderin.

Örnek

Bu XML snippet'inde, paketteki okyanus manzaralı King ve Queen oda türlerini belirtmek için <AllowableRoomID> öğesinin nasıl kullanılacağı gösterilmektedir.

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