Oda Paketleri

Oda Paketleri, tek bir tesis için birden fazla oda türü tanımlamanıza veya bir odanın seyahat planını kullanıcılarınıza standart bir fiyatın ötesindeki ücret özellikleriyle (ücret ve satış koşullarıyla birlikte gelen ek hizmetler) birleştirmenize olanak tanır.

Temel kavramlar ve iş akışı

Oda Paketleri ile farklı hizmet paketlerine sahip ek fiziksel oda kombinasyonları sunabilirsiniz.

Aşağıdaki resimde Oda Paketi örnekleri gösterilmektedir:

Bu örnekte, ilk paket yalnızca bir yetişkin için indirimli taban odadır. İkincisi ise en fazla üç yetişkin için farklı bir oda türüdür. Üçüncüsü, aynı tesisteki başka bir oda türüdür. Dördüncüsü, taban odanın ücretsiz kahvaltı veya daha sonra ödeme gibi imkanları içerebilecek "premium" paketidir.

Aşağıdaki resimlerde ücret özelliklerinin örnekleri gösterilmektedir:

Arama sonuçlarında Oda Paketlerinin ve ücret özelliklerinin gösterilmesi, standart oda fiyatlarıyla aynı seçim sürecine tabidir.

Oda Paketleri

Oda Paketlerini ve ücret özelliklerini Transaction mesajlarında tanımlarsınız. Bir Transaction mesajının kök öğesi <Transaction> şeklindedir.

Transaction mesajının yapısı, yaptığınız işe bağlıdır: Oda Paketi veya ücret özelliğiyle ilgili meta verileri tanımlamak ya da Oda Paketi'nin fiyatlandırmasını veya müsaitlik durumunu güncellemek.

Meta veri
Oda Paketini ve özellik meta verilerini bir <PropertyDataSet> öğesinde <PackageData> ile tanımlayın. Daha fazla bilgi için Oda ve paket meta verilerini tanımlama bölümüne bakın. Oda Paketleri, fiziksel oda açıklamaları için mevcut <RoomData> öğelerini kullanır.
Fiyatlandırma ve müsaitlik
Her paket/seyahat planı kombinasyonu için Oda Paketi fiyatlandırmasını ve müsaitliğini bir <Result> öğesinde <RoomBundle> öğesiyle tanımlayın. Daha fazla bilgi için Fiyatlandırma ve müsaitlik durumunu tanımlama bölümüne bakın.

Temel odanın ücreti, vergileri ve diğer ücretleri, Oda Paketleri ile kullanılmadığında <Result> kapsamında zorunludur ve Oda Paketleri ile birlikte kullanıldığında kaldırılabilir. Oda Paketlerini canlı bir hesap kullanarak uyguluyorsanız aşağıdaki adımları uygulayın:

  1. <Result> altındaki taban odanın ücretini, vergilerini ve diğer ücretleri dahil edip temel Oda Paketi ile eşleşen bir Oda Paketi ekleyin.

  2. Gerekirse ilgili tesisteki diğer oda türleri veya farklı hizmet paketleri için aynı <Result> blokunda ek Oda Paketleri tanımlayın.

  3. Oda Paketi kullanıma sunulduktan sonra taban odanın ücretini, vergilerini ve diğer ücretleri kaldırın.

Oda Paketi meta verileri

Oda Paketleri ve ücret özelliklerini tanımlarken genellikle açıklamayı, ücretin parçası olan ek hizmetleri ve Oda Paketi ile ilgili diğer bilgileri önceden tanımlarsınız. Bu bilgiler, Oda Paketi meta verileri olarak bilinir. Daha sonra fiyatlandırma güncellemelerinizde bu meta verilere başvurursunuz ancak meta verileri fiyatlandırma güncelleme mesajlarına dahil etmezsiniz.

Oda Paketlerini tanımlarken fiziksel oda açıklamaları için mevcut <RoomData> öğelerini, fiziksel oda açıklamasında yer almayan ücret özellikleri ve şartlar için <PackageData> öğelerini kullanın.

<RoomData> ve <PackageData> öğelerinin kullanılması, Transaction mesajlarında gönderilen yinelenen veri miktarını azalttığı için Otel Listenizin ve Otel Fiyatı Feed'inizin boyutunu önemli ölçüde azaltabilir.

Örneğin, oda adı ve açıklama gibi veriler genellikle her seyahat planı için tekrarlanır. Bu tür verileri bir kez tanımlamak için <RoomData> ve <PackageData> öğelerini kullanabilirsiniz. Seyahat planına özgü Oda Paketi verileri daha sonra son kullanıcıya gösterilmek üzere depolanan oda ve paket tanımlarıyla birleştirilir.

Google, reklamlarınızın içeriğini oluşturmak için meta verilerinizi seyahat planınıza özgü verilerle eşleştirir. <RoomData> ve <PackageData> öğelerindeki adların ve açıklamaların birleştirilmesi için özel bir işlem uygulanır. Bu, fiziksel odanın <RoomData> içinde, ücret özellikleri ve paket ayrıntılarının da <PackageData> içinde açıklanmasına olanak tanır.

Tek bir oda veya Oda Paketi için hem oda verileri hem de paket verileri tanımlarsanız Google, bunların her ikisini de kısa çizgiyle ayrılmış olarak reklam çıkışına ekler.

Fotoğraf yönergeleri

Oda fotoğraflarını gönderirken, fotoğraflarınızın kullanıcılara gösterildiğinden emin olmak için uymanız gereken bazı kurallar vardır:

  • Engellilere uygun odaların fotoğrafları da dahil olmak üzere her oda türü için fotoğraf gönderin. Örneğin, duşakabin gibi çeşitli banyo armatürleri bulunan erişilebilir odalara özel olarak yararlanabilirsiniz.

  • Odanın en az dört fotoğrafını ve banyonun en az bir fotoğrafını ekleyin.

  • Fotoğraflar tesise değil, odaya ait olmalıdır. En önemli fotoğraflar; yatağın, tüm odanın, banyonun, oturma alanının, odanın manzarasının (odanın geri kalanı aynı fotoğrafa sahip olacak şekilde) ve varsa balkonun, verandanın veya terasın fotoğraflarıdır.

    Masa, mutfak, kahve/çay makineleri ve odanın farklı özelliklerinin fotoğraflarını çekmek de faydalı olur.

  • İnsanların ve mülklerin fotoğraflarını (örneğin, dış mekan veya tesis olanakları), turistik gezi/turizm ve yemek fotoğraflarından kaçının.

  • Kadeh takımlarının yakın plan çekimleri gibi nesneleri yakından çekmekten kaçının.

  • Marka ve markalardan kaçının, ancak etiketli veya markalı tuvalet malzemelerinin tüm banyo alanını gösteren bir fotoğrafa eklenmesi sorun yaratmaz. Fotoğraflar büyük metin blokları, logolar veya filigranlar içermemelidir.

  • Geniş bir görüş alanına sahip standart, yatay (yatay) fotoğraflar sun; balık gözü ve bozuk fotoğraflardan kaçının. Sıralamayı yükseltmek için fotoğrafları en yüksek çözünürlükte çekin. Aynı fotoğrafı farklı çözünürlüklerde göndermeniz gerekmez.

Veri önceliği

Oda Paketi verileri tüm kaynaklardan toplanır ve belirli bir otel, seyahat planı ve Oda Paketi için nihai verileri üretmek amacıyla öncelik kurallarından yararlanılarak birleştirilir. Sıralama, en düşük öncelikten en yüksek önceliğe doğru aşağıdaki gibidir:

  1. (En düşük) İş ortağı verileri
  2. Tesis verileri
  3. <RoomID> öğesinin <RoomBundle> blokundaki <RoomID> ile eşleştiği <RoomData>
  4. <PackageID> öğesinin <RoomBundle> blokundaki <PackageID> ile eşleştiği <PackageData>
  5. (En yüksek) <RoomBundle>

Fiyatlandırmayı ve müsaitliği tanımlayın

Oda Paketi fiyatlandırmasını ve müsaitlik durumunu tanımlamak için her paket veya seyahat planı kombinasyonunda Transaction mesajında bir <RoomBundle> öğesi kullanın. <RoomBundle> öğesi, <Result> öğesinin içinde olmalıdır. İki <RoomBundle> öğesi için örnek kod aşağıda gösterilmiştir. Bu örnekte, iki <RoomBundle> öğesinin <RoomID> ve <PackageID> kullanarak oda ve paket meta verilerine başvurduğunu unutmayın.

Her <Result> için Oda Paketleri grubu, söz konusu tesis veya seyahat planı kombinasyonunun mevcut grubunun üzerine yazar. <Result> öğesinde herhangi bir Oda Paketi veya ücret özelliği tanımlamazsanız tüm Oda Paketleri kaldırılır ve arama sonuçlarında yalnızca bu otel veya seyahat planı için temel oda gösterilir.

Oda Paketlerinizi potansiyel müşteriler için daha ilgi çekici hale getirmek ve otelin açılış sayfasıyla eşleştiklerinden emin olmak için <Name> gibi öğeler kullandığınızdan emin olun. Bu örnekte, meta verilerde adları ve diğer açıklayıcı bilgileri tanımlarsınız.

<RatePlanID> isteğe bağlıdır ve bir oda-paket kombinasyonunun benzersiz tanımlayıcısını temsil eder. Dinamik açılış sayfanızın (eski adıyla Satış Noktası) URL'sini oluşturmak için RatePlanID değişkenini kullanmanızı kesinlikle öneririz. Ayrıntılar için Değişkenleri ve Koşulları Kullanma bölümüne bakın.

Oda Paketlerinde aşağıdaki öğeler isteğe bağlıdır:

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

Oda Paketi'ni canlı bir hesapta uyguladığınızda, Oda Paketi etkinleştirildikten sonra <Baserate> öğesini kaldırın.

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

Oda ve paket meta verilerini tanımlama

Oda Paketi meta verilerini tanımlamak için bir Transaction mesajının <PropertyDataSet> öğesinin içinde <PackageData> ve <RoomData> öğelerini kullanın.

Oda ve paket meta verilerini, fiyatlandırma ve müsaitlik verilerinden ayrı bir Transaction mesajında tanımlarsınız. Bu verileri önceden tanımladığınızda fiyatlandırma güncellemelerinizin açıklamalar, fotoğraf URL'leri, imkanlar ve her seyahat planı için her oda veya paketle ilgili diğer veriler gibi tekrar eden bilgiler içermesine gerek kalmaz.

Google, meta verileri sizin için depolar ve gösterildiklerinde reklamlarınıza ekler. Oda ve paket meta verilerini istediğiniz zaman yeni bir Transaction mesajıyla güncelleyebilirsiniz.

Transaction mesajında, her blok için bir paket kimliği ve oda kimliği ayarlarsınız. Daha sonra, fiyatlandırma güncellemelerinizin <Result> bloklarında bu bilgilere referans verirsiniz.

Oda ve paket verileri değişirse (örneğin, bir tesise yeni bir oda türü eklerseniz güncellenmiş oda ve paket verilerini içeren yeni bir Transaction mesajı gönderirseniz) Google bir oda veya paketle ilgili mevcut meta verileri yeni verilerle değiştirir.

Google, ilk kurulum sırasında meta verileri tanımlamanızı önerir. Meta verileri önceden tanımladıktan sonra, tüm bu bilgileri tekrar eklemek yerine fiyatlandırma güncellemelerinizde <RoomID> ve <PackageID> değerlerine referans vermeniz gerekir. Google, bu kimlikleri kullanarak odaları ve Oda Paketlerini depolanan meta verilerle eşleştirir. Bu, Transaction mesajlarınızın genel boyutunu önemli ölçüde azaltabilir.

Oda veya seyahat planı kombinasyonlarının fiyatları, oda veya paket açıklamalarından çok daha sık değiştiğinden, meta verileri bir kez tanımlamak ve ardından bunlara referans vermek Transaction mesajlarının çok daha verimli bir kullanımıdır. Ek olarak, oda açıklamalarının uyuşmaması gibi hatalar, verileri satır içinde tanımlamak yerine meta veriler kullanılarak giderilebilir.

Meta verileri ve fiyatlandırmayı ayrı olarak tanımlamak için önerilen ve en verimli yöntem aşağıda gösterilmiştir:

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

Doluluk ve kapasite

Oda Paketlerini tanımlarken, doluluk ve kapasite arasındaki farkı anlamanız gerekir:

Doluluk
Bir Oda Paketinin uygulanması amaçlanan konuk sayısıdır. Örneğin, "Balayı Paketi" için doluluk 2'dir. Bir paketin doluluk değerini, <PackageData> veya <RoomBundle> öğelerinin <Occupancy> alt öğesini kullanarak ayarlarsınız.
Kapasite
Bir odada fiziksel olarak konaklayabilecek kişilerin maksimum sayısıdır. Bir odanın kapasitesi her zaman doluluk değerine eşit veya bundan yüksektir. Örneğin, otelinizdeki "Balayı Paketi" maksimum altı kişiliktir, ancak iki konuk için bir paket fiyatlandırırsınız. Paket kapasitesinin değerini, <RoomData> öğesinin <Capacity> alt öğesini kullanarak ayarlarsınız.

Bir Oda Paketini fiyatlandırırken paketin hedeflediği konuk sayısı için (paketin <Occupancy> öğesinde belirtilen değer) fiyatı vermeniz gerekir. <Occupancy> değeri 2 olarak ayarlanırsa ilgili paketteki fiyat 2 kişi için geçerli olmalıdır. <Occupancy> öğesini dört konuk olarak ayarlayıp paketin fiyatını iki konuk için ayarlayamazsınız.

Paylaşılan odalar

Oda Paketleri'nde Doluluk ve Kapasite değerlerini ortak oda konaklamalarında (ör. hostel) fiyat belirlemek için de kullanırsınız. Örneğin, 8 yataklı bir yatakhane odası için kişi başı fiyatı ayarlamak üzere, Doluluk özelliğini 1, Kapasiteyi de 8 olarak belirleyip <RoomData> adında bu şekilde tanımlarsınız. Örneği inceleyin.

Oda Paketlerini Güncelle

Bu bölümde, artık kullanılmayan bir Oda Paketinin nasıl kaldırılacağı ve mevcut bir Oda Paketi'nin fiyatının nasıl güncelleneceği açıklanmaktadır.

Oda Paketini kaldırma

Oda Paketlerini kaldırma şekli, otel fiyatlarından farklıdır.

Bir oda veya seyahat planı kombinasyonunu envanterden kaldırmak için <Result> öğesinin <Baserate> değerini -1 olarak ayarlarsınız. Belirli bir oda veya seyahat planı için Oda Paketini kaldırmak için Transaction mesajındaki <Result> bloğundan <RoomBundle> öğesini kaldırın.

Veri feed'lerinizdeki Oda Paketleri bir grup olarak kabul edilir. Bu paketler, 0 ila onlarca pakettir. Oda Paketlerini Google'a gönderdiğinizde geçerli ve eksiksiz grubu gönderirsiniz. Daha önce kullanılabilir olan bir paketi kullanılamaz olarak işaretlemek için tek bir Oda Paketinin değerini değiştirmezsiniz. En son Transaction mesajında bulunan paket grubu, geçerli grubun yerini alır.

Örneğin, A, B, C ve D paketleri olsun. Önce A, B, C ve D oda paketleri grubunu tanımlayan bir mesaj gönderirsiniz. Daha sonra, B paketi tükenirse tüm grubu yalnızca A, C ve D paketleriyle yeniden gönderirsiniz. Tüm Oda Paketleri tükendiyse boş bir Oda Paketi grubu gönderin.

Fiyat düzenlemeleri

Bir Oda Paketinin fiyatını değiştirmek için <Result> öğesinde yeni <Baserate> değerini ayarlayın.

Transaction mesajlarınızda bir odanın/seyahat planının <Result> bloğunu her güncellediğinizde, her <Result> için mevcut Oda Paketlerini eksiksiz olarak eklemeniz gerekir. Google, mevcut Oda Paketleri grubunu yeni grupla değiştirir. <Result> öğesine herhangi bir Oda Paketi dahil etmezseniz Google, bu oda veya seyahat planı için tüm Oda Paketlerini kaldırır.

Meta veri güncellemeleri

Oda Paketi meta verilerini, Google'dan gelen bir <Query> yanıtıyla güncellersiniz.

Bir Sorgu mesajına, belirtilen oteller için oda ve paket meta verilerini tanımlayan bir Transaction mesajıyla yanıt verirsiniz. Daha fazla bilgi için Sorgu Mesajları bölümüne bakın.