Mesajı Değerlendir

Genel Bakış

Ücret mesajı (OTA_HotelRateAmountNotifRQ) gecelik süreyi tanımlar Belirli bir tarih için her oda türü ve ücret planı kombinasyonuna ait doluluk oranları değerleridir. Google, Ücret mesajının bir parçası olarak doluluk tabanlı fiyatlandırmayı destekler. Maksimum sayıya göre farklı gecelik ücretlerin belirtilmesini sağlayarak yardımcı olan bir özelliktir.

Aşağıdaki bölümlerde, ücret ekleme ve güncelleme ile ücret mesajı gönderme işlemlerine başlamanıza yardımcı olacak genel yönergeler, temel bir örnek ve uygulama senaryoları yer almaktadır.

Eşleşme oranı davranışı

Kullanıcılar belirli doluluk oranını talep ettiğinden, görecekleri ücret duruma göre değişir. Fiyat mesajınızda fiyatları nasıl tanımladığınızı. Bu bölümde, bu süreçlerin Kullanıcı istekleri, ilgili kişilerin doluluk durumuna göre fiyatlarınızla eşleştirilir. ve tanımladığınız ücretleri kapsar.

Temel ilkeler

  • Belirli bir doluluk için tanımlanan ücret, düşük olan tüm doluluk değerleri için geçerlidir. kabul edilmez.

  • Tanımlananın üzerindeki kişi sayısı için yapılan istekler mümkün değildir.

  • Doluluğa dayalı fiyatlandırma, hem tarih başına hem de KS tabanlı fiyatlandırmada geçerlidir. fiyatlandırma modellerine uygulanır. Yani her abonelik için fiyat belirleyebilirsiniz. doluluk oranı. Belirli bir kişi için ücret yoksa bir sonraki en yüksek doluluk oranı kullanılır. Ayrıca şunlar için de ücret tanımlayabilirsiniz: ek konuklar ve AdditionalGuestAmounts kullanan çocuklar veya ExtraGuestCharges Bir oda için tanımlanan kapasiteye kadar uygulanır.

Avantajlar ve örnekler

Verimlilik

Aynı ücret tutarına sahip birden fazla doluluk için ücret alınır. Yalnızca oda türü ve ücret planı tarafından desteklenen en yüksek doluluk değerini ayarlayarak mesajlarınızı basitleştirebilirsiniz. Kullanıcılar, kümenizden küçük veya buna eşit olan her doluluk için bu ücreti görür. değer.

Örnek: Oda türü ve ücret planı fiyatları şunun için aynıdır: bir ila dört kişilik oda. Maks. için bir ücret ayarlamak üzere Ücret mesajını kullanın doluluk oranı 4 kişidir. Tek, çift ve üç kişilik oda arayan kullanıcılar aynı oranı görür. 5 ve üzerini arayan kullanıcılar ücretleri görmez.

Kontrol

Alternatif doluluk değerleri için farklı ücretler açık bir şekilde belirtilebilir. Gönder her doluluk değeri için farklı bir ücret talep edebilirsiniz. Google, istekleri doluluk oranlarıyla eşleştirir.

Örnek: Doluluk oranları 3 ve 1 kişi için tanımlanırsa tek kişilik aramalarda tek kişilik fiyat, çift kişilik aramalarda üç kişilik fiyat gösterilir. 4 ve üzeri kişi için arama yapan kullanıcılar ise fiyatları görmez.

Fiyatlandırmayla 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ı, zorunlu ve isteğe bağlı öğelerin açıklamalarını sağlar. Ayrıntılı bilgi için özellikleri ile alt öğelere bakın. Ücret Öğeleri ve Özellikler.

Söz dizimi ve şemalar

Ücret Söz Dizimi'ni kullanın "Ücret mesajı oluştururken referans olarak bir örnek kullanabilirsiniz. doğru biçimi izleyin.

Feed'lerinizi kontrol etmeniz gerekir. Ücret mesajı için şeması için Otel Reklamları şemaları bölümüne 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 modelinde konaklama tarihlerine göre toplanan fiyatların belirlenmesine toplam fiyata ulaşması gerekir. Bu modelde, Rate öğesinin altındaki tüm fiyatlar belirtilen bir konaklama tarihleri aralığına uygulanması şeklinde yorumlanır. <StatusApplicationControl>.

KS tabanlı fiyatlandırma

KS tabanlı (konaklama süresi) fiyatlandırma modeli, Varış tarihi ve konaklama süresi kombinasyonudur. KS tabanlı fiyatlandırma modeli günlüktür. Örneğin, 100 TL'lik bir ücret gönderirseniz 3 konaklama süresi için toplam fiyat 3x100 TL=300 TL şeklinde hesaplanır.

KS tabanlı fiyatlandırma modelini kullanmak için StatusApplicationControl öğelerinde RatePlanType="26". Ayrıca şunu da yapmanız gerekir: Rate öğelerinde RateTimeUnit ve UnitMultiplier özelliklerini ayarlayın XML. Bu, belirtilen Rate öğesi altındaki tüm ücretlerin konaklamalara uygulanmasına neden olur <StatusApplicationControl> içinde belirtilen varış tarihleri ve UnitMultiplier için KS değeri belirtildi.

Tek bir günde hem tarih başına hem de KS tabanlı fiyatlandırma modellerini kullanabilirsiniz. Ancak her tesis yalnızca tek bir fiyatlandırma modeli kullanmalıdır. KS tabanlı fiyatlandırmayı uygularken aşağıdaki noktaları göz önünde bulundurun:

  • KS tabanlı kullanılırken farklı konaklama süreleri için ücretler birleştirilmez. fiyatlandırma. Örneğin 3 olan KS oranı şu kadar KS ile birleştirilmez: 1 kullanarak KS oranını 4 olarak fiyatlandırabilirsiniz. 4 olan LOS oranı açıkça belirtilmelidir.
  • KS tabanlı fiyatlardaki 1 gecelik fiyat, tek gecelik fiyat olarak kullanılmaz fiyatlandırılır.
  • Her tesis yalnızca KS tabanlı veya tarih başına fiyatlandırmayı kullanmalıdır ücretinin sisteminizde gösterilme şekline göre belirlenir.

Hesabınızda KS tabanlı fiyatlandırmayı etkinleştirmek için THY üzerinden istekte bulunun veya bize ulaşın.

Kurallar veya İşlemler

Tarihe göre fiyatlandırma

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

  • Ücret güncellemeleri varsayılan olarak Delta işlemini kullanır.
  • Delta güncellemesi, diğer kişi sayısını gösterir. Örneğin, tek ve bir tarih aralığı için iki kişilik oda ve tek kişilik oda için Delta fiyat güncellemesi gönderin doluluk oranı farklıysa çift kişilik fiyat değişmez.

Overlay: Oda türü için mevcut kişi başı ücretlerin tamamını silin. ücret planı, <StatusApplicationControl> ve değiştirme için belirtilen tarihler yeni ücretlerle sunun. Örneğin, tek ve bir tarih aralığı için çift kişilik odalar ve tek kişi için Overlay güncellemesi gönderirsiniz odayı doldurmazsanız Google önceki tüm fiyatları (tek ve çift kişilik) kaldırır. kişi sayısı) görürsünüz. Güncellemeden sonra kişi sayısı tek bir kişi olarak kalır.

Remove: Oda türü için mevcut kişi başı ücretlerin tamamını silin. ücret planı ve <StatusApplicationControl> olarak belirtilen tarihler.

KS tabanlı fiyatlandırma

Delta: Yalnızca belirtilen KS değeri başına ücret ekleyin veya güncelleyin belirtilen oda türü, ücret planı ve giriş tarihlerinin kombinasyonlarını <StatusApplicationControl>. İlgili tüm kişi başı ücretleri değiştirir eski KS değerleriyle uyumlu hale getirin.

  • Ücret güncellemeleri varsayılan olarak Delta işlemini kullanır.
  • Delta güncellemesi, diğer sayısını artırır. Örneğin, KS 1 ve 2 için oran belirlediyseniz Ardından KS 1 için Delta ücret güncellemesi, ardından KS 2'nin kişi başı ücretleri gönderin. değişmeden kalır.
  • Delta güncellemesi, toplam konaklama süresidir. Örneğin, tek ve KS 1 için çift doluluk oranı ve KS 1 için Delta fiyat güncellemesi gönderin Tek bir doluluk oranı için "çift kişilik" fiyat seçeneğinden yararlanılmaz.

Overlay: KS, oda için mevcut kişi başı ücretlerin tamamını silin. <StatusApplicationControl> cinsinden belirtilen tür, ücret planı ve giriş tarihleri ve bunları yeni ücretlerle değiştirebilirsiniz. Örneğin, KS 1 ve 2'deyseniz ve KS 1 için Overlay güncellemesi gönderirseniz Google, Önceki tüm fiyatlar (KS 1 ve 2) ve yalnızca KS 1 ücreti geçerli olmaya devam eder. güncellemeden sonra.

Remove: Konaklama süresinin tüm KS'leri için geçerli kişi başı ücretlerin tamamını silin. oda türü, ücret planı ve giriş tarihleri <StatusApplicationControl>.

Vergiyle ilgili

Vergiler ve ücretler basitse toplam tutar AmountAfterTax Karmaşık vergiler, örneğin, her ay için geçerli olan vergiler ve ücretler konaklama (gecelik yerine) AmountAfterTax cinsinden belirtilemez.

Genel olarak Google, TaxFeeInfo AmountAfterTax.

Mümkünse AmountBeforeTax eklemelisiniz ( AmountAfterTax), bazı bölgelerde (örneğin, ABD) gösterildiği için varsayılan olarak vergi öncesi fiyat seçeneğini kullanabilirsiniz.

Kullanıcının ödemesi gereken tüm vergiler ve ücretler (KDV, konaklama vergisi, temizlik ücretleri, şehir) vergi vb.) dahil edilmesi gerekir. Üstelik, rezervasyon sırasında ödenmese bile doğrudan mülke ödeme yaparsınız.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğeler. Dosyanızı hazırladıktan sonra aşağıdaki uç noktaya bir POST mesajı gönderin: https://www.google.com/travel/hotels/uploads/property_data

Mesajın nasıl aktarılacağı/yayınlanacağı hakkında daha fazla bilgi edinmek için Mesaj aktarma bölümüne bakın.

HotelCode için sisteminizde kullandığınız benzersiz Otel Kimliği'ni kullanın: bir mülk tanımlamaktır. Bu değer, <listing> öğesinde <id> otel listesi feed'inde görünür. <PackageID> ve <RoomID> için kullandığınız kimliklerin aynısını kullanın ücret planları ve oda türleri (sırasıyla) için sisteminizde kullanabilirsiniz. Tutarlılık , Google'ın kullanıcılarınıza doğru şekilde gösterilmesini sağlamak açısından kapsamlı bir teklif sunabilir.

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, verileri gönderirken karşılaşabileceğiniz senaryolara Mesajları puanlayın.

Fiyat ekleme, kaldırma ve güncelleme örnekleri için Ücret Örnekler.

1. Senaryo: Kişi başına fiyatlandırmayı değiştirme

Açıklama

Gecelik fiyatlar daha önce yalnızca çift kişilik (aynı zamanda çift kişilik) tek kişi için geçerlidir. Ancak artık tek kişilik konaklama için daha uygun bir ücret doluluk oranı.

Çözüm

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

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

Açıklama

Daha önce 1 ile 4 arası kişi sayısı için oran tanımladınız ancak şimdi yalnızca 1 ve 2 numaralı kişiler geçerlidir.

Çözüm

Belirli bir tesisin tüm doluluk oranlarını değiştirmek için NotifType="Overlay" kullanın. oda türü, ücret planı ve tarihler. Bu senaryoda, Overlay işlemi 1 ve 2 numaralı kişiler için ücretleri listeleyin.

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

Açıklama

Belirli bir kişi için uygulanan ücret, daha az kişi bulunan bir gruba satılabilir. Burada yalnızca sabit bir fiyat güncellemesi göndererek mesajlarınızı basitleştirebilirsiniz. Geçerli maksimum doluluk.

Çözüm

Birden fazla kişi için aynı fiyatı sunuyorsanız en yüksek doluluk değerini ayarlayın. oda türü ve ücret planı tarafından desteklenen bir değere göre ve otomatik olarak bu değeri daha düşük doluluk değerleri için kullanır. Yani, aynı bilgileri tekrar tekrar 1-6 kişi arasındaki doluluk oranı aynıysa gecelik ücret; 6 olarak ayarladım.