Promosyon Mesajı

Genel Bakış

Promosyon mesajı, indirim oranlarıyla ilgili kuralları OTA_HotelRateAmountNotifRQ kullanarak tanımlar. Tanımlanan promosyonlar her ücret için 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 oran indirimleri uygulamak için kullanılıyorsa promosyonları tanımlamanız gerekir.

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

Çeşitli promosyonlarla ilgili senaryo örnekleri için Nasıl yapılır? bölümüne bakın.

Aşağıdaki bölümlerde, promosyon ekleme ve güncelleme işlemlerine 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 yer almaktadır.

Promosyonlarla ilgili aşağıdaki yönergeleri 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 mülkle ilgili tüm promosyonları değiştirmek için <HotelPromotions> öğesinde overlay işlemi kullanın.
Delta
Hiçbir işlem belirtilmezse <HotelPromotions> içinde belirtilen tüm promosyonlar eklenir veya değiştirilir. Bu kimliğe sahip bir promosyon hiç eklenmemişse veya silinmişse promosyon eklenir. Bu kimliğe sahip bir promosyon varsa yeni tanımla değiştirilir.

Genel

  • Her tesis için tek bir promosyon veya bir dizi promosyon olabilir. Her promosyonun bir koşullar kümesi vardır. Bu promosyon yalnızca koşullar karşılandığında uygulanabilir.

  • Promosyonlar, seyahat planının ücreti için geçerlidir. Kişi başına maksimum indirim ayarlanamaz.

  • 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 ayarlanmak zorunda değildir.

  • Her promosyon belirli bir mülke 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. Bundan daha fazla öğe eklemeniz gerekiyorsa Google THY'nizle iletişime geçin.

  • Promosyonların nasıl birleştirilebileceğini belirtmek için <Stacking> öğesini kullanın. Varsayılan olarak Google, base yığınlama türünü kullanır. Bu, diğer promosyonlardan önce uygun olan en iyi temel promosyonun seçilip uygulandığı anlamına gelir. base yalnızca second veya any ile birleştirilebilir ve başka bir base veya none ile birleştirilemez.

  • Birlikte uygulanabilecek birden fazla promosyon olsa bile daha yüksek indirim sunan tek bir promosyon veya promosyon grubu varsa bu promosyonlar kullanılmayabilir. Birden fazla promosyon (kombinasyon) uygun olduğunda rezervasyona en büyük indirime sahip promosyon (kombinasyon) uygulanır.

  • Promosyonlarınızı etkileyen herhangi bir değişiklik olduğunda Promosyon mesajı güncellemesi gönderin.

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

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğelerin kullanıldığı bir promosyon mesajına dair temel bir örnek verilmektedir. Dosyanızı hazırladıktan sonra aşağıdaki uç noktaya bir POST mesajı göndererek Google'a iletin:

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

Mesajı nasıl göndereceğiniz/POST edeceğiniz hakkında daha fazla bilgi edinmek için Mesaj gönderme başlıklı makaleyi inceleyin.

<HotelPromotions> öğesinin hotel_id özelliği için, tesisin tanımlanmasında 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. Google'ın verilerinizi doğru şekilde göstermesini sağlamak için sisteminizle tutarlılık çok önemlidir.

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

Bu örnekte, ABD ve İtalya'daki kullanıcılar için uzun süreli konaklamalarda% 15 indirim uygulanması 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 başlıklı makaleyi inceleyin.

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

Bu bölümde, promosyon oluştururken karşılaşabileceğiniz senaryolarla ilgili çözümler sunulmaktadır.

1. senaryo: Uzun süreli konaklamalar için indirim promosyonu ekleme

Açıklama

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

Çözüm

Konaklama gecesi sayısına bağlı olarak 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% 20 indirim nasıl ekleneceği gösterilmektedir. 15 gecelik bir seyahat planında toplam 4 gece için% 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ürleri nasıl ayarlanır?

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

Açıklama

Promosyon için uygun olan kullanıcı cihazı türünü belirtmek istiyorsanız.

Çözüm

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

Örnek

Aşağıdaki örnekte, mobil ve tablet kullanıcıları için% 25 indirim 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ı yenileriyle değiştirme

Açıklama

Bir tesis için geçerli promosyon grubu güncel değil veya yanlış ve 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 orijinal% 20 ve% 30 indirimler 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>

Bu örnekte ise mevcut iki promosyonu, tesiste% 15 indirim sunan 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: Bir veya tüm promosyonları kaldırma

Açıklama

Tesis, yeni promosyonlar ayarlamadan tüm promosyonlarını kaldırdığı için veya bir hata yaptığınız ve bunu düzeltmeniz gerektiği için bir ya da tüm promosyonları (değiştirmeden) kaldırmak istiyorsunuz.

Çözüm

Bir tesis için yalnızca belirli promosyonları silmek istiyorsanız delete işlemini kullanın. Mevcut tüm promosyonları değiştirmeden kaldırmak için overlay (delete değil) işlemini kullanın.

overlay kullanarak promosyonları değiştirme hakkında ayrıntılı bilgi için 3. Senaryo'ya bakın.

Örnekler

Aşağıdaki örnekte bir tesise ait 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 tesise ait tüm promosyonların değiştirilmeden 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ı birleştirme

Birleştirme, promosyonların nasıl birleştirilebileceğini belirtir. Belirtilmezse type değerinin base olduğu varsayılır. Bu durumda, diğer promosyonlardan önce en uygun temel promosyon seçilir ve uygulanır. Stacking öğesinin type özelliği any olduğunda diğer promosyonlarla birleştirilebilir.

Açıklama

Kullanıcının aynı mülk için aynı anda birden fazla promosyon kullanma seçeneği olmasını istiyorsunuz.

Çözüm

Tesis başına birden fazla indirim belirlemek için katmanlandırmayı kullanın. Bir yığında en fazla bir base ve bir second olabilir ancak sınırsız sayıda any olabilir. any, none hariç diğer türlerle birleştirilebilir.

Örnek

Bu örnekte, base, second ve any birleştirme türlerinin nasıl birleştirileceği gösterilmektedir. %15, %25 ve %10 indirim uygulandığında 100 ABD doları fiyat, toplam 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-3 numaralı promosyonların birleştirilmiş indiriminin, 4 numaralı promosyonun indiriminden daha iyi olduğunu unutmayın. Promosyon 4, birleştirme türü (none) nedeniyle diğer promosyonlarla birleştirilemez. Promosyon 4'te% 43 veya daha yüksek bir indirim olsaydı 1-3 arasındaki promosyonların birleşimi yerine bu promosyon kullanılırdı.