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 ötesinde ücret özellikleriyle (ücret ve satış koşullarıyla gelen ek hizmetler) birleştirmenize olanak tanır.

Temel kavramlar ve iş akışı

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

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

Bu örnekte, ilk paket taban odadır ve yalnızca bir yetişkin için indirim uygulanır. İkincisi, en fazla üç yetişkin için farklı bir oda türü. Üçüncüsü, aynı tesisteki başka bir oda türüdür. Dördüncü adım, ana odanın "premium" paketidir. Ücretsiz paket kahvaltı veya daha sonra ödeme gibi imkanlara sahip olabilir.

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ımlama veya Oda Paketinin fiyatlandırmasını veya müsaitlik durumunu güncelleme.

Meta veri
Oda Paketini tanımlayın ve özellik meta verilerini bir <PropertyDataSet> öğesinde <PackageData> ile değerlendirin. Daha fazla bilgi için Oda ve paket meta verilerini tanımlama konusuna 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üsaitlik durumunu <Result> içindeki <RoomBundle> öğesiyle tanımlayın. Daha fazla bilgi için Fiyatlandırmayı ve stok durumunu tanımlama konusuna bakın.

Taban oda fiyatı, vergiler ve diğer ücretler, Oda Paketleri ile birlikte kullanılmazlarsa <Result> altında zorunlu tutulur ve Oda Paketleriyle birlikte kaldırılabilir. Oda Paketlerini canlı bir hesap kullanarak kullanıyorsanız şu adımları uygulayın:

  1. Taban oda ücreti, vergiler ve diğer ücretleri <Result> altına ekleyin ve taban Oda Paketi ile eşleşen bir Oda Paketi ekleyin.

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

  3. Oda Paketi başlatıldıktan sonra taban oda fiyatını, vergileri ve diğer ücretleri kaldırın.

Oda Paketi meta verileri

Oda Paketlerini 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 ve fiziksel oda açıklamasına dahil olmayan ücret özellikleri ve şartlar için <PackageData> öğelerini kullanın.

<RoomData> ve <PackageData> öğelerini kullanmak, Transaction mesajlarında gönderilen tekrarlanan 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örüntülenmek ü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> öğelerinin adlarını ve açıklamalarını birleştirmek için özel işleme vardır. Bu sayede, fiziksel oda <RoomData> dilinde, ücret özellikleri ve paket ayrıntıları ise <PackageData> içinde açıklanır.

Tek bir oda veya Oda Paketi için hem oda verileri hem de paket verileri tanımlarsanız Google, her ikisini de kısa çizgiyle ayırarak reklam çıkışına dahil eder.

Fotoğraf yönergeleri

Oda fotoğrafları gönderirken fotoğraflarınızın kullanıcılara gösterildiğinden emin olmak için uymanız gereken bazı kurallar aşağıda verilmiştir:

  • Erişilebilir 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 donanımları bulunan erişilebilir odalar.

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

  • Fotoğraflar tesise değil odanın kendisine ait olmalıdır. En önemli fotoğraflar; yatak, tüm oda, banyo, oturma alanı ve odanın görünümü (odanın geri kalanı aynı fotoğrafla birlikte) ve mümkünse balkon, veranda veya terastır.

    Masa, mutfak, çay-kahve makinesi ve farklı oda özelliklerinin fotoğraflarını çekmek de yararlıdır.

  • İnsanların ve tesislerin (örneğin dış cephe veya tesisler) gezi/turizm ve yiyecek fotoğraflarından kaçının.

  • Damlalıkların yakından çekimleri gibi nesnelerin yakın çekimlerinden kaçının.

  • Etiketli veya markalı tuvalet malzemelerini kullanmaktan kaçının. Banyo alanının tamamını kapsayan bir fotoğrafta bu tür öğelerin yer alması uygundur. Fotoğrafların büyük metin, logo veya filigran blokları içermemelidir.

  • Geniş bir görüş alanına sahip standart, yatay (yatay) fotoğraflar sağlayın; balık gözü ve distorsiyonlu fotoğraflardan kaçının. Sıralamayı iyileştirmek için fotoğrafları en yüksek çözünürlükte çekin. Aynı fotoğrafı çeşitli çö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 oluşturmak üzere öncelik kuralları kullanılarak birleştirilir. Sıralama, en düşük öncelikli olandan en yüksek öncelikli olana doğru aşağıdaki gibidir:

  1. (En düşük) İş ortağı verileri
  2. Mülk verileri
  3. <RoomData> (<RoomID> değeri, <RoomBundle> bloğundaki <RoomID> ile eşleşir)
  4. <PackageData> (<PackageID> değeri, <RoomBundle> bloğundaki <PackageID> ile eşleşir)
  5. (En yüksek) <RoomBundle>

Fiyatlandırmayı ve müsaitlik durumunu tanımlayın

Oda Paketi fiyatlandırmasını ve müsaitlik durumunu tanımlamak üzere, her paket veya seyahat planı kombinasyonu için bir Transaction mesajında <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 Paketi grubu, söz konusu tesis veya seyahat planı kombinasyonu için mevcut grubun ü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ının temel odası gösterilir.

Oda Paketlerinizi potansiyel müşteriler için daha çekici hale getirmek ve otelin açılış sayfasıyla eşleştiklerinden emin olmak için <Name> gibi öğeleri kullanın. Bu örnekte, meta verilerde adlar ve diğer açıklayıcı bilgiler tanımlanır.

<RatePlanID> isteğe bağlıdır ve bir oda ve 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>

Canlı Yayında bir hesapta Oda Paketi'ni 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üncellemelerinizde açıklamalar, fotoğraf URL'leri, imkanlar ve her seyahat planı için her bir oda veya paketle ilgili diğer veriler gibi tekrar eden bilgiler bulunması gerekmez.

Google, meta verileri sizin için depolar ve görüntülendiğinde 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 bunlara fiyatlandırma güncellemelerinin <Result> bloklarında referans verirsiniz.

Oda ve paket verileri değişirse (örneğin, bir tesise yeni bir oda türü eklerseniz güncellenen oda ve paket verilerini içeren yeni bir Transaction mesajı gönderin) 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 tanımladıktan sonra, tüm bu bilgileri tekrar eklemek yerine fiyatlandırma güncellemelerinizde <RoomID> ve <PackageID> değerlerine referans vermeniz yeterlidir. Google, bu kimlikleri kullanarak odaları ve Oda Paketlerini depolanan meta verilerle eşleştirir. Bu, işlem mesajlarınızın toplam 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. Ayrıca, oda açıklamalarının uyuşmaması gibi hatalar, verileri satır içi tanımlamak yerine meta veriler kullanılarak ortadan kaldırılabilir.

Meta verileri ve fiyatlandırmayı ayrı olarak tanımlamak için önerilen ve en etkili 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 geçerli olduğu 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 odanın fiziksel olarak ağırlayabileceği maksimum kişi sayısıdır. Bir odanın kapasitesi her zaman doluluk oranına eşit veya bundan yüksektir. Örneğin, otelinizdeki "Balayı Paketi" en fazla altı kişi kapasitelidir ancak iki konuk için bir paket fiyatı belirlersiniz. Bir paketin kapasitesini, <RoomData> öğesinin <Capacity> alt öğesini kullanarak ayarlarsınız.

Bir Oda Paketi için fiyatlandırma yaparken paketin amaçlandığı konuk sayısına (paketin <Occupancy> öğesinde belirtilen değer) fiyat vermeniz gerekir. <Occupancy> değeri iki olarak ayarlanırsa bu paketteki fiyat iki kişi için olmalıdır. <Occupancy> değerini 4 konuk ve paketin fiyatını 2 konuk için ayarlayamazsınız.

Paylaşılan odalar

Oda paketlerinde Doluluk ve Kapasite değerlerini de (ör. hostel) için fiyat belirlemek amacıyla kullanırsınız. Örneğin, 8 yataklı bir yatakhane için kişi başı fiyat belirlemek üzere Doluluğu 1, Kapasiteyi de 8 olarak ayarlayıp <RoomData> adında bu şekilde tanımlarsınız. Örneğe bakın.

Oda Paketlerini Güncelle

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

Oda Paketi kaldırma

Oda paketleri, bunları kaldırma şekillerinden otel fiyatlarından farklıdır.

Bir oda veya seyahat planı kombinasyonunu envanterden kaldırmak için <Result> öğesinin <Baserate> özelliğini -1 olarak ayarlayın. Belirli bir oda veya seyahat planı için Oda Paketi'ni kaldırmak istiyorsanız Transaction mesajında <Result> blokundan <RoomBundle> öğesini kaldırın.

Veri feed'lerinizdeki Oda Paketleri, 0 ila onlarca paket içeren bir grup olarak kabul edilir. Oda Paketlerini Google'a gönderirken geçerli ve eksiksiz grubu gönderirsiniz. Önceden kullanılabilir olan bir paketi kullanılamaz olarak işaretlemek için tek bir Oda Paketinin değerlerini değiştirmezsiniz. En son Transaction mesajında bulunan paket grubu, mevcut grubun yerini alır.

Örneğin; A, B, C ve D grupları vardır. Önce A, B, C ve D oda paketlerini 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ükenmişse boş bir Oda Paketi grubu gönderin.

Fiyat ayarlamaları

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 bir Oda Paketi grubunu da dahil etmeniz gerekir. Google, mevcut Oda Paketleri grubunu yeni grupla değiştirir. <Result> bölümüne herhangi bir Oda Paketi eklemezseniz Google, bu oda veya seyahat planının tüm Oda Paketlerini kaldırır.

Meta veri güncellemeleri

Oda Paketi meta verilerini Google'dan gelen bir <Query> mesajına yanıt vererek 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.