Mesajı Değerlendir

Genel bakış

Ücret mesajı (OTA_HotelRateAmountNotifRQ), belirli tarih aralıklarında her oda türü ve ücret planı kombinasyonu için gecelik doluluk oranını tanımlar. Google, ücret mesajının bir parçası olarak doluluk tabanlı fiyatlandırmayı destekler. Böylece, hedeflenen maksimum kişi sayısına göre farklı gecelik ücretlerin belirlenmesine olanak tanır.

Aşağıdaki bölümlerde fiyat ekleme, güncelleme ve fiyat mesajı göndermeye başlamanız için genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları ele alınmaktadır.

Eşleşme oranı davranışı

Kullanıcılar belirli doluluk değerleri için istekte bulunduğunda gördükleri ücret, Ücret mesajınızda fiyatları nasıl tanımladığınıza bağlıdır. Bu bölümde, bu kullanıcı isteklerinin doluluk durumuna ve tanımladığınız ücretlere bağlı olarak bu kullanıcı isteklerinin fiyatlarınızla nasıl eşleştirildiği ele alınmaktadır.

Temel ilkeler

  • Belirli bir doluluk için tanımlanan ücret, aksi belirtilmediği sürece daha az doluluk oranı olan tüm odalar için geçerlidir.

  • Tanımlanan bu sınırların üzerindeki doluluk talepleri mümkün değildir.

  • Doluluğa dayalı fiyatlandırma, aşağıda açıklanan tarih başına ve KS tabanlı fiyatlandırma modelleri için geçerlidir. Yani her doluluk için ücret belirtebilirsiniz. Belirli bir kişi için ücret bilgisi yoksa sonraki en yüksek doluluk oranı kullanılır. Ayrıca AdditionalGuestAmounts veya ExtraGuestCharges kullanarak ek konuklar ve çocuklar için ücret tanımlayabilirsiniz. Bu ücretler, oda için tanımlanan kapasiteye kadar uygulanır.

Avantajlar ve örnekler

Verimlilik

Aynı ücret tutarına sahip birden fazla kişi için her doluluk oranı için bir ücret belirlemenize gerek yoktur. Yalnızca oda türü ve ücret planının desteklediği en yüksek doluluk değerini ayarlayarak mesajlarınızı basitleştirebilirsiniz. Kullanıcılar, belirlediğiniz değerden düşük veya bu değere eşit olan her doluluk için bu ücreti görür.

Örnek: Oda türü ve ücret planının ücretleri, birden dörte kadar olan kişiler için aynıdır. Maksimum 4 kişilik oda için bir ücret ayarlamak üzere "Ücret" mesajını kullanın. Tek, çift ve üç kişilik doluluk için arama yapan kullanıcılar aynı fiyatı görür. 5 ve üzerini arayan kullanıcılar ücretleri görmez.

Kontrol işlemleri

Alternatif doluluk oranları için ayrı ücretler açıkça belirtilebilir. Google'ın talepleri doluluk oranlarıyla nasıl eşleştirdiği üzerinde daha fazla kontrol sahibi olmak istiyorsanız her doluluk değeri için farklı bir ücret gönderin.

Örnek: 3 ve 1 numaralı kişiler için fiyat tanımlanmışsa tek kişilik aramalarında tek kişilik ücret gösterilir, çift kişilik aramada üçlü doluluk oranı gösterilir ve 4 ve üzeri için arama yapan kullanıcılar ücretleri görmez.

Ücretle ilgili çeşitli senaryolara dair daha fazla örnek için Nasıl yapılır? bölümüne bakın.

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

XML Referansı, gerekli ve isteğe bağlı öğelerin açıklamalarını sağlar. Özellikler ve alt öğelerle ilgili ayrıntılar için Ücret Öğeleri ve Özellikler bölümüne bakın.

Söz dizimi ve şemalar

Doğru biçimi uyguladığınızdan emin olmak için Rate mesajı oluştururken referans olarak Ücret Söz Dizimi örneğini kullanın.

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

Fiyatlandırma modelleri

Tarihe göre fiyatlandırma

Bu, çoğu tesis için kullanılan standart fiyatlandırma modelidir. per-date fiyatlandırma modeli, toplam fiyata ulaşmak için konaklama tarihleri genelinde toplanan ayar ücretlerini temel alır. Bu modelde, bir Rate öğesindeki tüm fiyatlar, <StatusApplicationControl> öğesinde belirtilen konaklama tarihleri aralığına uygulanıyor olarak yorumlanır.

KS tabanlı fiyatlandırma

KS tabanlı (konaklama süresi) fiyatlandırma modeli, varış tarihi ve konaklama süresi kombinasyonu için belirlenen ücretlere dayanır. KS tabanlı fiyatlandırma modelinde belirtilen ücretler günlüktir. Örneğin, 3 konaklama süresi için 100 TL ücret gönderirseniz toplam fiyat 3x100 TL=300 TL şeklinde hesaplanır.

StatusApplicationControl öğelerinde RatePlanType="26" belirterek KS tabanlı fiyatlandırma modelinden yararlanabilirsiniz. Ayrıca, XML'inizdeki Rate öğelerinde RateTimeUnit ve UnitMultiplier özelliklerini ayarlamanız gerekir. Bu işlem, belirtilen Rate öğesi altındaki tüm ücretlerin, <StatusApplicationControl> için belirtilen varış tarihleri ve UnitMultiplier için belirtilen KS değeriyle tanımlanan konaklamalara uygulanmasını sağlar.

Tek bir hesap altında hem tarihe hem de KS tabanlı fiyatlandırma modellerinden yararlanabilirsiniz ancak her tesis yalnızca tek bir fiyatlandırma modeli kullanmalıdır. KS tabanlı fiyatlandırma uygularken aşağıdakileri göz önünde bulundurun:

  • KS tabanlı fiyatlandırma kullanılırken farklı konaklama süreleri için ücretler birleştirilmez. Örneğin, 3 değerindeki KS oranı, 4 değerindeki KS oranını fiyatlandırmak için 1 değerindeki KS ile birleştirilmez. 4 olan KS oranı açıkça belirtilmelidir.
  • KS tabanlı fiyatlandırmadaki 1 gecelik fiyat, tarih başına fiyatlandırmada bağımsız gece ücreti olarak kullanılmaz.
  • Her tesis, ücretlerin sisteminizde nasıl gösterildiğine bağlı olarak yalnızca KS tabanlı fiyatlandırmayı veya tarihe göre fiyatlandırmayı kullanmalıdır.

Hesabınızda KS tabanlı fiyatlandırmayı etkinleştirmek için isteği THY'niz aracılığıyla gönderin veya bize ulaşın.

Kurallar veya İşlemler

Tarihe göre fiyatlandırma

Delta: Yalnızca <StatusApplicationControl> öğesinde belirtilen oda türü, ücret planı ve konaklama tarihleri kombinasyonları için kişi başı ücretleri ekleyin veya güncelleyin.

  • Ücret güncellemeleri, varsayılan olarak Delta işlemini kullanır.
  • Delta güncellemesi, diğer doluluk değerleri için daha önce saklanan ücretleri değiştirmez. Örneğin, tek ve çift kişilik odalar için fiyat belirttiyseniz ve tek kişilik oda için Delta ücret güncellemesi gönderirseniz çift kişilik oda fiyatı değişmeden kalır.

Overlay: <StatusApplicationControl> öğesinde belirtilen oda türü, ücret planı ve tarihler için kişi başı ücretlerin tamamını silin ve yeni fiyatlarla değiştirin. Örneğin, tek ve çift kişilik odalar için ücretler belirlediyseniz ve tek kişilik oda için Overlay güncellemesi gönderirseniz Google, önceki tüm ücretleri (hem tek hem de çift kişilik) kaldırır ve güncellemeden sonra yalnızca tek kişilik fiyat geçerli kalır.

Remove: <StatusApplicationControl> öğesinde belirtilen oda türü, ücret planı ve tarihler için kişi başı ücretlerin tamamını silin.

KS tabanlı fiyatlandırma

Delta: Yalnızca <StatusApplicationControl> öğesinde belirtilen oda türü, ücret planı ve check-in tarihleri kombinasyonları için KS değeri başına ücret ekleyin veya güncelleyin. Güncellenen KS değerleriyle ilişkili tüm kişi başı ücretleri değiştirir.

  • Ücret güncellemeleri, varsayılan olarak Delta işlemini kullanır.
  • Delta güncellemesi, daha önce depolanan ücretleri diğer konaklama süreleri için değiştirmez. Örneğin, 1. ve 2. KS için ücret belirlediyseniz ve 1. KS için Delta ücret güncellemesi gönderirseniz KS 2'nin kişi başına ücretleri değişmeden kalır.
  • Delta güncellemesi, belirtilen konaklama süresi için önceden depolanan tüm kişi başı ücretlerin üzerine yazar. Örneğin, KS 1 için tek ve çift kişilik fiyat belirttiyseniz ve KS 1 için yalnızca tek bir doluluk oranıyla Delta fiyat güncellemesi gönderirseniz çift kişilik fiyat kaldırılır.

Overlay: <StatusApplicationControl> öğesinde belirtilen KS, oda türü, ücret planı ve check-in tarihleri için mevcut kişi başı ücretlerin tamamını silin ve yeni fiyatlarla değiştirin. Örneğin, 1. ve 2. KS için ücretler belirttiyseniz ve 1. KS için Overlay güncellemesi gönderirseniz Google, önceki tüm ücretleri (hem 1. hem de 2. KS 1) kaldırır ve yalnızca KS 1 ücreti güncellemeden sonra kalır.

Remove: <StatusApplicationControl> öğesinde belirtilen oda türü, ücret planı ve giriş tarihlerinin tüm KS'leri için mevcut kişi başı ücretlerin tamamını silin.

Vergiyle ilgili

Vergiler ve ücretler basitse toplam tutar, AmountAfterTax kullanılarak belirtilebilir. Konaklama başına (gecelik değil) uygulanan vergiler ve ücretler gibi karmaşık vergiler AmountAfterTax üzerinden temsil edilemez.

Genel olarak Google, AmountAfterTax yerine TaxFeeInfo kullanılmasını önerir.

Bazı yerel ayarlar (ör. ABD) varsayılan olarak vergi öncesi fiyatı gösterdiğinden mümkünse AmountBeforeTax (AmountAfterTax değerini belirtseniz bile) eklemeniz gerekir.

Rezervasyon sırasında ödenmese veya doğrudan tesise ödenmese bile kullanıcının ödemesi gereken tüm vergiler ve ücretler (KDV, konaklama vergisi, temizlik ücretleri, şehir vergisi vb.) dahil edilmelidir.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğelerin kullanıldığı bir Rate mesajının temel örneği verilmiştir. Dosyanızı hazırladıktan sonra POST mesajı kullanarak aşağıdaki uç noktaya Google'a göndermeniz gerekir: https://www.google.com/travel/hotels/uploads/property_data

Mesaj aktarma/YAYINLAMA hakkında daha fazla bilgi edinmek için Mesaj aktarma başlıklı makaleyi inceleyin.

HotelCode için, tesisi tanımlamak amacıyla sisteminizde kullandığınız benzersiz Otel Kimliğini kullanın. Bu değer, Otel Listesi Feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. <PackageID> ve <RoomID> için, ücret planları ve oda türleri için sisteminizde kullandığınız kimlikleri (sırayla) kullanın. Sisteminizle tutarlılık, Google'ın fiyatlarınızı ve verilerinizi doğru bir şekilde görüntülemesini sağlamak için çok önemlidir.

Bu örnekte, Delta işlemi kullanılarak ücretlerin nasıl ayarlanacağı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

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

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

Ücret ekleme, kaldırma ve güncelleme örnekleri için Ücret Örnekleri bölümüne bakın.

1. Senaryo: Kişi başı fiyatlandırma nasıl değiştirilir?

Açıklama

Gecelik ücretler daha önce yalnızca çift kişilik oda için (tek kişilik için de geçerli) tanımlanıyordu. Ancak artık tek kişilik için daha ucuz bir fiyat var.

Çözüm

Varsayılan Delta kapsamlı güncellemeyi kullanarak yeni kişi sayısı 1 oranını gönderin. Bu yeni değer, 2. doluluk oranını etkilemez.

2. Senaryo: Tesis için kişi başı ücretleri değiştirme

Açıklama

Daha önce 1 ile 4 arasındaki yolcular için ücret tanımlamıştınız ancak şu anda yalnızca 1 ve 2 numaralı kapasite geçerli.

Çözüm

Belirli bir tesis, oda türü, ücret planı ve tarihlerde tüm doluluk oranlarını değiştirmek için NotifType="Overlay" özelliğini kullanın. Bu senaryoda, Overlay işleminde 1 ve 2 numaralı doluluk için ücretler listelenir.

3. Senaryo: Birden fazla doluluk için aynı ücreti ayarlama

Açıklama

Belirli bir doluluk için fiyat, daha az kişinin bulunduğu bir gruba satılabilir. Bu senaryoda, yalnızca geçerli maksimum doluluk için ücret güncellemesini göndererek mesajlarınızı basitleştirebilirsiniz.

Çözüm

Birden fazla doluluk için aynı fiyatı sunuyorsanız oda türü ve ücret planının desteklediği en yüksek doluluk değerini belirleyin. Daha düşük bir doluluk durumu için otomatik olarak bu değer kullanılır. Yani hepsi aynıysa 1-6 arasındaki kişiler için aynı gecelik ücreti tekrarlamanıza gerek yoktur. 6 kişilik olarak ayarlamanız yeterlidir.