Mesajı Değerlendirme

Genel Bakış

Ücret mesajı (OTA_HotelRateAmountNotifRQ), belirli tarih aralıkları için her oda türü ve ücret planı kombinasyonunun gece başına konaklama ücretlerini tanımlar. Google, ücret mesajının bir parçası olarak doluluk oranına dayalı fiyatlandırmayı destekler. Bu sayede, amaçlanan maksimum kişi sayısına göre farklı gecelik ücretler belirlenebilir.

Aşağıdaki bölümlerde, fiyat ekleme ve güncelleme ile fiyat mesajı göndermeye başlamanıza yardımcı olacak genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları yer almaktadır.

Eşleşme oranı davranışı

Kullanıcılar belirli doluluk oranları talep ettiğinde gördükleri fiyat, fiyatları Fiyat mesajınızda nasıl tanımladığınıza bağlıdır. Bu bölümde, bu kullanıcı isteklerinin, isteklerinin doluluk durumuna ve tanımladığınız fiyatlara bağlı olarak fiyatlarınızla nasıl eşleştirildiği açıklanmaktadır.

Temel ilkeler

  • Belirli bir doluluk oranı için tanımlanan fiyat, aksi tanımlanmadığı sürece daha düşük tüm doluluk oranları için geçerlidir.

  • Tanımlananların üzerinde doluluk oranı istekleri mümkün değildir.

  • Doluluğa dayalı fiyatlandırma, aşağıda açıklanan hem tarihe göre fiyatlandırma hem de KS'ye dayalı fiyatlandırma modelleri için geçerlidir. Bu, her doluluk oranı için fiyat belirleyebileceğiniz anlamına gelir. Belirli bir doluluk için fiyat yoksa bir sonraki en yüksek doluluk için fiyat kullanılır. Ayrıca, bir oda için tanımlanan kapasiteye kadar uygulanan AdditionalGuestAmounts veya ExtraGuestCharges kullanarak ek konuklar ve çocuklar için ücretler de tanımlayabilirsiniz.

Avantajlar ve örnekler

Verimlilik

Aynı ücret tutarına sahip birden fazla doluluk oranı için her doluluk oranı için ayrı bir ücret belirlemeniz gerekmez. Yalnızca oda türü ve fiyat planı tarafından desteklenen 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 her doluluk için bu oranı görür.

Örnek: Bir oda türü ve ücret planı için 1-4 kişilik konaklamalarda ücretler aynıdır. Maksimum 4 kişilik konaklama için tek bir fiyat belirlemek üzere Rate mesajını kullanın. Tek, çift ve üç kişilik konaklama için arama yapan kullanıcılar aynı ücreti görür. 5 ve üzeri puan arayan kullanıcılar puanları görmez.

Kontrol edin

Alternatif doluluk oranları için farklı ücretler açıkça belirtilebilir. Google'ın istekleri 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 oran gönderin.

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

Çeşitli oranlarla ilgili 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ı'nda gerekli ve isteğe bağlı öğelerin açıklamaları yer alır. Özellikler ve alt öğelerle ilgili ayrıntılar için Ücret Öğeleri ve Özellikleri bölümüne bakın.

Söz dizimi ve şemalar

Doğru biçimi kullandığınızdan emin olmak için fiyat mesajını oluştururken Fiyat 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. Fiyat mesajı şeması için Otel Reklamları şemaları başlıklı makaleyi inceleyin.

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 fiyatı elde etmek için konaklama tarihleri boyunca toplanan ücretlerin belirlenmesine dayanır. Bu modelde, Rate öğesi altındaki tüm fiyatlar, <StatusApplicationControl> içinde belirtilen bir konaklama tarihi aralığı için geçerli olarak yorumlanır.

KS'ye dayalı fiyatlandırma

KS'ye (konaklama süresi) dayalı fiyatlandırma modeli, varış tarihi ve konaklama süresi kombinasyonu için belirlenen ücretlere dayanır. KS tabanlı fiyatlandırma modeli altında belirtilen fiyatlar günlük olarak belirlenir. Örneğin, 3 gecelik konaklama için 100 ABD doları fiyat gönderirseniz toplam fiyat 3 x 100 ABD doları=300 ABD doları olarak hesaplanır.

StatusApplicationControl öğelerinde RatePlanType="26" özelliğini belirterek KS'ye dayalı fiyatlandırma modelinden yararlanabilirsiniz. Ayrıca XML'nizdeki Rate öğelerinde RateTimeUnit ve UnitMultiplier özelliklerini de ayarlamanız gerekir. Bu durum, belirtilen Rate öğesindeki tüm fiyatların, <StatusApplicationControl> içinde belirtilen varış tarihleri ve UnitMultiplier için belirtilen KS değeriyle tanımlanan konaklamalar için geçerli olmasına neden olur.

Tek bir hesapta hem tarihe göre hem de KS'ye göre fiyatlandırma modellerini kullanabilirsiniz ancak her tesis yalnızca tek bir fiyatlandırma modeli kullanmalıdır. LOS'a dayalı fiyatlandırmayı uygularken aşağıdaki noktaları göz önünde bulundurun:

  • KS tabanlı fiyatlandırma kullanılırken farklı konaklama sürelerine ait fiyatlar birleştirilmez. Örneğin, 3 günlük bir KS ücreti, 4 günlük bir KS ücretini fiyatlandırmak için 1 günlük bir KS ile birleştirilmez. 4 gün konaklama ücreti açıkça belirtilmelidir.
  • KS tabanlı fiyatlandırmada 1 gecelik fiyat, tarihe göre fiyatlandırmada ayrı bir gece fiyatı olarak kullanılmaz.
  • Her tesis, sisteminizde fiyatların nasıl gösterildiğine bağlı olarak yalnızca KS tabanlı fiyatlandırma veya tarihe göre fiyatlandırma kullanmalıdır.

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

Yönergeler veya İşlemler

Tarihe göre fiyatlandırma

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

  • Fiyat güncellemelerinde varsayılan olarak Delta işlemi kullanılır.
  • Delta güncellemesi, diğer doluluk oranları için daha önce depolanmış fiyatları değiştirmez. Örneğin, tek ve çift kişilik odalar için fiyat belirlediyseniz ve tek kişilik oda için Delta fiyat güncellemesi gönderirseniz çift kişilik oda fiyatı değişmez.

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

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

KS'ye dayalı fiyatlandırma

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

  • Fiyat güncellemelerinde varsayılan olarak Delta işlemi kullanılır.
  • Delta güncellemesi, daha önce depolanmış diğer konaklama sürelerine ait ücretleri değiştirmez. Örneğin, LOS 1 ve 2 için fiyat belirlediyseniz ve LOS 1 için Delta fiyat güncellemesi gönderirseniz LOS 2'nin kişi başına fiyatları değişmez.
  • Delta güncellemesi, verilen konaklama süresi için önceden depolanmış tüm kişi başı fiyatların üzerine yazar. Örneğin, 1 gece konaklama için tek ve çift kişilik fiyatlar belirlediyseniz ve 1 gece konaklama için yalnızca tek kişilik fiyat içeren bir 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 giriş tarihleri için geçerli kişi başı ücretlerin tamamını siler ve yerlerine yeni ücretleri yazar. Örneğin, 1 ve 2 gecelik konaklama için ücretler belirlediyseniz ve 1 gecelik konaklama için Overlay güncellemesi gönderirseniz Google, önceki tüm ücretleri (hem 1 hem de 2 gecelik konaklama) kaldırır ve güncellemeden sonra yalnızca 1 gecelik konaklama ücreti kalır.

Remove: <StatusApplicationControl> öğesinde belirtilen oda türü, ücret planı ve check-in tarihleri için geçerli tüm kalış sürelerine ait mevcut kişi başı ücretlerin tamamını siler.

Vergiyle ilgili

Vergiler ve ücretler basitse toplam tutar AmountAfterTax kullanılarak belirtilebilir. Konaklama başına (gecelik yerine) uygulanan vergi ve ücretler gibi karmaşık vergiler AmountAfterTax içinde gösterilemez.

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

Mümkünse AmountBeforeTax özelliğini eklemeniz gerekir (AmountAfterTax özelliğini belirtmiş olsanız bile). Çünkü belirli yerel ayarlar (ör. ABD) varsayılan olarak vergi öncesi fiyatı gösterir.

Kullanıcının ödemesi gereken tüm vergi ve ücretler (KDV, konaklama vergisi, temizlik ücretleri, şehir vergisi vb.) rezervasyon sırasında ödenmemiş veya doğrudan tesise ödenmemiş olsa bile dahil edilmelidir.

Örnek

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

Mesajı nasıl aktaracağınız/POST edeceğiniz hakkında daha fazla bilgi edinmek için Mesaj aktarma başlıklı makaleyi inceleyin.

HotelCode için, tesisi tanımlamak üzere 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ğiyle eşleşmelidir. <PackageID> 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.

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, derecelendirme mesajları gönderirken karşılaşabileceğiniz senaryoların çözümleri sunulmaktadır.

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

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

Açıklama

Gecelik fiyatlar daha önce yalnızca çift kişilik konaklama için tanımlanıyordu (tek kişilik konaklama için de geçerliydi). Ancak artık tek kişilik konaklama için daha uygun bir fiyat sunuluyor.

Çözüm

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

2. senaryo: Bir tesisin doluluk oranlarını nasıl değiştirebilirim?

Açıklama

Daha önce 1-4 kişi için fiyat tanımlamıştınız ancak artık yalnızca 1 ve 2 kişi için fiyat tanımlayabilirsiniz.

Çözüm

Belirli bir tesis, oda türü, ücret planı ve tarihler için tüm doluluk oranlarını değiştirmek üzere NotifType="Overlay" öğesini kullanın. Bu senaryoda, Overlay işlemi 1 ve 2 kişilik konaklamalar için fiyatları listeler.

3. senaryo: Birden fazla kişi sayısı için aynı ücreti ayarlama

Açıklama

Belirli bir doluluk oranı için belirlenen fiyat, daha az kişiden oluşan bir gruba satılabilir. Bu senaryoda, yalnızca geçerli maksimum doluluk oranı için fiyat güncellemesi göndererek mesajlarınızı basitleştirebilirsiniz.

Çözüm

Birden fazla konaklama için aynı fiyatı kullanıyorsanız oda türü ve fiyat planı tarafından desteklenen en yüksek konaklama değerini ayarlayın. Bu değer, daha düşük konaklama sayıları için otomatik olarak kullanılır. Yani, 1-6 kişilik konaklamalar için gece başına aynı ücret uygulanıyorsa bu ücreti tekrarlamanıza gerek yoktur. Ücreti yalnızca 6 kişilik konaklama için ayarlamanız yeterlidir.