Ta strona została przetłumaczona przez Cloud Translation API.

Wiadomość promocyjna

Omówienie

Komunikat Promocje określa reguły dotyczące rabatów przy użyciu: OTA_HotelRateAmountNotifRQ Przy każdej stawce określone promocje są weryfikowane i do modelu stosowany jest maksymalny dozwolony rabat. stawki. Ten typ wiadomości jest opcjonalny i wystarczy zdefiniować promocji, jeśli są one używane w Twoim systemie do stosowania rabatów.

Możesz łączyć promocje i stosować je do różnych atrybutów użytkownika. np. typy urządzeń (telefony komórkowe, tablety, komputery) i kody krajów.

Przykłady różnych scenariuszy związanych z promocjami można znaleźć w sekcji Instrukcje.

W poniższych sekcjach znajdziesz ogólne wskazówki, podstawowy przykład i instrukcje scenariuszy, które pomogą Ci rozpocząć dodawanie i aktualizowanie promocji.

Wytyczne

W tej sekcji znajdziesz typowe wskazówki i specjalne instrukcje konfigurowania promocji.

Przestrzegaj tych wskazówek dotyczących promocji:

Działania

Usuń: Użyj działania delete w elemencie <Promotion>, aby usunąć pojedynczy element promocji według identyfikatora.
Nakładka: Użyj działania overlay w elemencie <HotelPromotions>, by zastąpić ze wszystkimi promocjami obiektu.
Delta: Jeśli nie określono działania, wszystkie określone promocje w <HotelPromotions> są dodawane lub zamieniane. Jeśli promocja z tym identyfikatorem nie została nigdy dodana lub usunięta, promocja zostaje dodana. Jeśli promocja z tym identyfikatorem zostanie zastąpiona nową definicją.

Ogólne

Dla każdego miejsca zakwaterowania może obowiązywać jedna promocja lub zestaw promocji. ma zestaw warunków. Promocja może zostać wykorzystana tylko wtedy, gdy są spełnione warunki.
Jeśli chcesz, aby promocja dotyczyła tylko konkretnego dnia, pokoju lub stawki i określ go w warunkach danej promocji. Jeśli promocja nie dotyczy konkretnej daty, typu pokoju lub planu cen, nie musisz ich ustawiać.
Każda promocja jest powiązana z konkretną usługą. Jeśli korzystasz z tej samej promocji dla wielu usług musisz wysłać oddzielnie dla każdej z nich. Do określ identyfikator usługi, użyj atrybutu hotel_id <HotelPromotions>.
Możesz uwzględnić maksymalnie 99 promocji. W razie potrzeby skontaktuj się z TAM Google zawiera więcej treści.
Aby określić sposób łączenia promocji, użyj elementu <Stacking>. Według domyślnie Google używa typu układania base, co oznacza, że najlepsze promocja podstawowa jest wybierana i stosowana najpierw przed innymi promocjami. Notatka że dane base można łączyć tylko z second lub any i nie można ich łączyć z innym elementem base lub none.
Nawet jeśli istnieje kilka promocji, które można zastosować razem, ten stos może nie być tym użytym, jeśli istnieje inny pojedynczą promocję lub zestaw promocji, który oferuje większy rabat. promocja (kombinacja) z największym rabatem jest stosowany do rezerwacji gdy kwalifikuje się wiele promocji (kombinacji).
Wysyłaj wiadomość o promocjach zawsze wtedy, gdy wystąpią zmiany, które wpływają na Twoje promocje.

Ważne: na usługę może być maksymalnie 500 promocji. Aby usunąć promocje z usługi, możesz użyć wiadomości <Promotions>.

Najlepsza promocja (lub stos promocji) jest stosowana w: AmountAfterTax kwotę. Jeśli określona jest tylko opcja AmountBeforeTax, promocje są stosowane do AmountBeforeTax.

Przykład

Ta sekcja zawiera podstawowy przykład wiadomości z promocjami, która zawiera wymagane i opcjonalne elementy. Po przygotowaniu pliku wyślij go do Google za pomocą wiadomość POST do tego punktu końcowego:

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

Aby dowiedzieć się więcej na temat wysyłania/publikowania wiadomości, zapoznaj się z artykułem Wysyłanie wiadomości push.

W przypadku atrybutu hotel_id <HotelPromotions> użyj unikalnego identyfikatora hotelu użytych w systemie do identyfikacji usługi. Ta wartość musi pasować identyfikator hotelu określony za pomocą atrybutu <id> w <listing> w pliku danych Lista hoteli. Spójność z systemem jest kluczowa upewnienie się, że Google prawidłowo wyświetla Twoje dane.

UserCountry służy do wyświetlania listy odpowiednich lokalizacji użytkowników (krajów) dotyczących promocji. Jeśli określisz nazwę użytkownika, dostęp do niej będą mieli tylko użytkownicy z tych krajów. zaproponowała obniżoną stawkę.

Ten przykład pokazuje, jak ustawić 15% zniżki na dłuższy pobyt w przypadku użytkowników ze Stanów Zjednoczonych i Włoch:

<?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>

Więcej przykładów: Przykłady promocji.

Instrukcje

Ta sekcja zawiera rozwiązania scenariuszy, które mogą wystąpić podczas promocji.

Scenariusz 1. Jak dodać promocję z rabatem na dłuższy pobyt

Opis

Chcesz zaoferować obniżoną cenę w niektóre dni pobytu przedłużonego.

Rozwiązanie

Za pomocą ustawienia FreeNights możesz dostosować rodzaj rabatu od liczby nocy.

Przykład

Ten przykład pokazuje, jak dodać 20% zniżki za 2 noce za każde 7 dni pobyt w wybranym zakresie dat. W przypadku planu podróży na 15 nocy: 20% zniżki dotyczy łącznie 4 nocy.

<?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>

Scenariusz 2. Jak ustawić typy urządzeń

Ustawiasz devices, aby określić urządzenia użytkowników, które kwalifikują się do wyświetlania promocji. Jeśli określisz tę wartość, będą mogli korzystać tylko użytkownicy z urządzeń z listy. obniżoną stawkę.

Opis

Chcesz określić typ urządzenia użytkownika, na którym dostępna jest promocja.

Rozwiązanie

Ustaw co najmniej jedną z tych wartości typu urządzenia: desktop, tablet, lub mobile.

Przykład

Z przykładu poniżej dowiesz się, jak określić 25% rabatu na reklamy mobilne i użytkownicy tabletów:

<?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>

Scenariusz 3: jak zastąpić stare produkty nowymi promocjami

Opis

Obecny zestaw promocji dotyczących miejsca zakwaterowania jest nieaktualny lub nieprawidłowy i wymaga i można ją zastąpić całkowicie nowym zestawem.

Rozwiązanie

Aby zastąpić promocje, użyj działania overlay.

Przykład

Poniższy przykład pokazuje 2 oryginalne rabaty w wysokości 20% oraz 30% dla usługi.

<?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>

Ten przykład pokazuje, jak użyć funkcji overlay do zastąpienia istniejącego 2 promocje z pojedynczą promocją w wysokości 15% zniżki na obiekt.

<?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>

Scenariusz 4. Jak usunąć jedną lub wszystkie promocje

Opis

Chcesz usunąć jedną lub wszystkie promocje (bez zastąpienia), ponieważ usługa usunęła wszystkie promocje bez ustawienia nowych lub popełniła błąd, który musisz poprawić.

Rozwiązanie

Jeśli chcesz usunąć tylko konkretną osobę, użyj działania delete promocji obiektu i użyj działania overlay (a nie delete), aby je usunąć wszystkich istniejących promocji bez zamienników.

Szczegółowe informacje o zastępowaniu promocji za pomocą overlay znajdziesz w scenariuszu 3.

Przykłady

Ten przykład pokazuje, jak usunąć tylko jedną promocję usługi:

<?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>

Ten przykład pokazuje, jak usunąć wszystkie promocje bez zastępowania dla usługi:

<?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>

Scenariusz 5: jak łączyć promocje

Nakładanie się pozwala określić sposób łączenia promocji. Jeśli nie podasz żadnej wartości, type przyjmuje się, że to base, co oznacza, że najlepsza kwalifikująca się promocja podstawowa to wybrane i zastosowane jako pierwsze, przed innymi promocjami. Jeśli atrybut type Stacking wynosi any, można ją połączyć z dowolną inną promocją.

Opis

Chcesz, aby użytkownik mógł korzystać z wielu promocji jednocześnie dla tej samej usługi.

Rozwiązanie

Stosuj grupowanie, aby ustawić wiele rabatów na usługę. Maksymalna liczba grup w stosie wynosi jeden base i jeden second, ale nieograniczoną liczbę any; a any może być połączona z innymi typami oprócz none.

Przykład

Ten przykład pokazuje, jak nakładać typy base, second i any. Dla: łączny rabat w wysokości 15%, 25%, 10% i cena 100 zł to łącznie 57,38 USD (100 × 0,85 × 0,75 × 9 USD).

<?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>

Pamiętaj, że łączny rabat dla promocji zbiorczych od 1 do 3 wynosi jest korzystniejszy niż rabat w promocji. 4. Promocji 4 nie można łączyć z innych promocji ze względu na typ nakładania się tych elementów (none). Jeśli promocja 4 ma w wysokości 43% lub więcej, byłby używany zamiast kombinacji promocji 1–3.

Wiadomość promocyjna

Omówienie

Wytyczne

Działania

Ogólne

Związane z podatkami

Przykład

Instrukcje

Scenariusz 1. Jak dodać promocję z rabatem na dłuższy pobyt

Opis

Rozwiązanie

Przykład

Scenariusz 2. Jak ustawić typy urządzeń

Opis

Rozwiązanie

Przykład

Scenariusz 3: jak zastąpić stare produkty nowymi promocjami

Opis

Rozwiązanie

Przykład

Scenariusz 4. Jak usunąć jedną lub wszystkie promocje

Opis

Rozwiązanie

Przykłady

Scenariusz 5: jak łączyć promocje

Opis

Rozwiązanie

Przykład