Promosyon Mesajı

Genel bakış

Promosyonlar mesajı, OTA_HotelRateAmountNotifRQ kullanarak fiyat indirimi kurallarını tanımlar. Her ücret için tanımlanan promosyonlar değerlendirilir ve izin verilen en yüksek indirim ücrete uygulanır. Bu mesaj türü isteğe bağlıdır ve yalnızca sisteminizde ücret indirimi uygulamak için kullanılıyorsa promosyon tanımlamanız gerekir.

Promosyonları birleştirebilir ve cihaz türleri (mobil, tablet, masaüstü) ve ülke kodları gibi farklı kullanıcı özelliklerine uygulayabilirsiniz.

Promosyonlarla ilgili çeşitli senaryoların örneklerini Nasıl Yapılır? bölümünde bulabilirsiniz.

Aşağıdaki bölümlerde, promosyon ekleyip güncellemeye başlamanıza yardımcı olacak genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları ele alınmaktadır.

Yönergeler

Bu bölümde, promosyon oluşturmayla ilgili genel kurallar ve özel talimatlar ele alınmaktadır.

Promosyonlar için aşağıdaki kuralları kullanın:

İşlemler

Sil
Tek bir promosyonu kimliğine göre silmek için <Promotion> öğesinde delete işlemini kullanın.
Video içi yer paylaşımlı reklamlar
Bir tesisin tüm promosyonlarını değiştirmek için <HotelPromotions> öğesinde overlay işlemi kullanın.
Delta
Herhangi bir işlem belirtilmezse <HotelPromotions> içinde belirtilen tüm promosyonlar eklenir veya değiştirilir. Bu kimliğe sahip bir promosyon daha önce hiç eklenmemişse veya silinmişse promosyon eklenir. Bu kimliğe sahip bir promosyon varsa yeni tanım bu promosyonun üzerine yazılır.

Genel

  • Her tesis için tek bir promosyon grubu veya bir promosyon grubu olabilir ve her promosyonun bir dizi koşulu vardır. Bu promosyon yalnızca koşulların karşılanması durumunda uygulanabilir.

  • Bir promosyonun yalnızca belirli bir tarih, oda türü veya ücret planı için geçerli olmasını istiyorsanız bunu promosyonun koşullarında belirtin. Promosyon belirli bir tarih, oda türü veya ücret planı için geçerli değilse bunların ayarlanması gerekmez.

  • Her promosyon belirli bir tesise bağlıdır. Aynı promosyonu birden fazla tesis için kullanıyorsanız her tesis için ayrı ayrı göndermeniz gerekir. Mülk tanımlayıcınızı belirtmek için <HotelPromotions> öğesinin hotel_id özelliğini kullanın.

  • En fazla 99 promosyon ekleyebilirsiniz. Daha fazla etiket eklemeniz gerekirse Google THY ile iletişime geçin.

  • Promosyonların nasıl birleştirilebileceğini belirtmek için <Stacking> öğesini kullanın. Google varsayılan olarak base yığınlama türünü kullanır. Diğer bir deyişle, diğer promosyonlardan önce en iyi uygun temel promosyon seçilir ve uygulanır. base öğesinin yalnızca second veya any ile birleştirilebileceğini ve başka bir base veya none ile birleştirilemeyeceğini unutmayın.

  • Birlikte uygulanabilecek çeşitli promosyon grupları olsa bile, daha fazla indirim sunan tek bir promosyon veya promosyon grubu olduğunda bu grup aslında kullanılan paket olmayabilir. Birden fazla promosyon (kombinasyonu) uygun olduğunda en büyük indirime sahip promosyon (kombinasyon) rezervasyona uygulanır.

  • Promosyonlarınızı etkileyen herhangi bir değişiklik gerçekleştiğinde Promosyonlar mesajı güncellemesi gönderin.

En iyi promosyon (veya promosyon grubu) AmountAfterTax tutarına uygulanır. Yalnızca AmountBeforeTax belirtilirse promosyonlar AmountBeforeTax için uygulanır.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğelerin kullanıldığı bir Promosyon mesajının temel bir örneği verilmiştir. Dosyanızı hazırladıktan sonra bu uç noktaya POST mesajı üzerinden Google'a gönderin:

https://www.google.com/travel/hotels/uploads/promotions

Mesajı aktarma/POST gönderme hakkında daha fazla bilgi için Mesaj aktarma bölümüne bakın.

<HotelPromotions> için hotel_id özelliği olarak, tesisi tanımlamak amacıyla sisteminizde kullandığınız benzersiz Otel Kimliği'ni kullanın. Bu değer, Otel Listesi feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. Sisteminizle tutarlılık, Google'ın verilerinizi doğru bir şekilde görüntülemesini sağlamak için çok önemlidir.

UserCountry, promosyon için uygun olan kullanıcı konumlarını (ülkeleri) listelemek içindir. Belirtilirse yalnızca listelenen ülkelerdeki kullanıcılara indirimli fiyat sunulur.

Bu örnekte, ABD ve İtalya'daki kullanıcılar için uzatılmış konaklama süresinde% 15 indirimin nasıl ayarlanacağı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

Daha fazla örnek için Promosyon örnekleri bölümüne bakın.

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

Bu bölümde, promosyonları ayarlarken karşılaşabileceğiniz senaryoların çözümleri sunulmaktadır.

1. Senaryo: Uzun süreli konaklama için indirim promosyonu ekleme

Açıklama

Uzun süreli konaklamanın belirli günlerinde indirimli geceler sunmak istiyorsunuz.

Çözüm

Konaklama gece sayısına göre uygulanan indirim türünü özelleştirmek için FreeNights ayarını kullanın.

Örnek

Bu örnekte, belirtilen rezervasyon tarihi aralığında konaklanan her 7 gece için iki gecelik konaklamaya% 20 indirimin nasıl ekleneceği gösterilmektedir. 15 gecelik seyahat planında toplam 4 geceye% 20 indirim uygulanır.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

2. Senaryo: Cihaz türlerini ayarlama

Promosyon için uygun olan kullanıcı cihazlarını belirtmek üzere devices özelliğini ayarlarsınız. Belirtilirse yalnızca listelenen cihazlardaki kullanıcılara indirimli fiyat sunulur.

Açıklama

Hangi kullanıcı cihazının promosyon için uygun olduğunu belirtmek istiyorsunuz.

Çözüm

Cihaz türünü şu değerlerden bir veya daha fazlasına ayarlayın: desktop, tablet veya mobile.

Örnek

Aşağıdaki örnekte, cep telefonu ve tablet kullanıcıları için% 25 indirimin nasıl belirtileceği gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

3. Senaryo: Eski promosyonları yeni promosyonlarla değiştirme

Açıklama

Bir mülke ait mevcut promosyon grubu eski veya yanlış olduğundan tamamen yeni bir grupla değiştirilmesi gerekiyor.

Çözüm

Promosyonları değiştirmek için overlay işlemini kullanın.

Örnek

Aşağıdaki örnekte tesis için% 20 ve% 30 oranındaki orijinal iki indirim gösterilmektedir.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Ardından bu örnekte, mevcut iki promosyonu tesis için% 15'lik tek bir promosyonla değiştirmek için overlay özelliğinin nasıl kullanılacağı gösterilmektedir.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

4. Senaryo: Promosyonlardan birini veya tümünü kaldırma

Açıklama

Mülk, yenilerini ayarlamadan tüm promosyonlarını kaldırdığı veya bir hata yaptığınız ve bu promosyonu düzeltmeniz gerektiği için promosyonlardan birini veya tümünü (değiştirme olmadan) kaldırmak istiyorsunuz.

Çözüm

Bir tesise ait yalnızca belirli promosyonları silmek istiyorsanız delete işlemini, değiştirme yapılmadan mevcut tüm promosyonları kaldırmak için overlay işlemini (delete değil) kullanın.

Promosyonları overlay kullanarak değiştirme hakkında ayrıntılı bilgi için 3. senaryo bölümüne bakın.

Sana Özel

Aşağıdaki örnekte, bir tesis için yalnızca bir promosyonun nasıl silineceği gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

Bu örnekte, bir tesisin yerini almadan tüm promosyonların nasıl kaldırılacağı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

5. Senaryo: Promosyonları gruplandırma

Yığınlama, promosyonların nasıl birleştirilebileceğini belirtir. Belirtilmezse type öğesinin base olduğu varsayılır. Diğer bir deyişle, diğer promosyonlardan önce en uygun temel promosyon seçilir ve önce uygulanır. Stacking için type özelliği any olduğunda bu özellik diğer promosyonlarla birleştirilebilir.

Açıklama

Kullanıcının, aynı tesis için aynı anda birden çok promosyon kullanma seçeneğine sahip olmasını istiyorsunuz.

Çözüm

Tesis başına birden fazla indirim ayarlamak için yığınlamayı kullanın. Bir yığında en fazla bir base ve bir second bulunabilir ancak sınırsız sayıda any olabilir. any, none dışındaki türlerle birleştirilebilir.

Örnek

Bu örnekte base, second ve any Yığma türlerinin nasıl gruplandırılacağı gösterilmektedir. %15, %25, %10 oranındaki birleşik bir indirim için 100 ABD doları tutarındaki fiyat, toplamda 57,38 ABD doları olur (100 × 0,85 × 0,75 × 0,9).

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

1 ile 3 arasındaki yığma promosyonlar için uygulanan birleşik indirimin, 4. promosyonun indiriminden daha iyi olduğunu unutmayın. Promosyon 4, yığın türü (none) nedeniyle diğer promosyonlarla birleştirilemez. 4. promosyon en az% 43 oranında indirime sahipse 1-3 arasındaki promosyonların kombinasyonu yerine bu promosyon kullanılır.