Podstawowe ustawienia Reservation+ (R+)

Jak załadować silnik R+ na stronę www:
1. Wstaw następujący kod na stronę:

<!– Reservation PLUS start –>
<script type=”text/javascript” src=”https://booking.previo.cz/iframe/”></script>
<iframe src=”https://booking.previo.cz/?hotId=123456″ scrolling=”no” frameborder=”0″
width=”727″ height=”2000″ name=”previo-booking-iframe” id=”previo-booking-iframe”
allowTransparency=”true”></iframe>
<!– Reservation PLUS end –>

Obowiązkowe parametry iframe atrybutu SRC:
hotId=123456 – ID Twojego obiektu noclegowego widoczne jest w pasku adresu przeglądarki po zalogowaniu do Previo:

Znajdziesz je też zawsze w menu Pomoc -> O aplikacji 

Opcjonalne parametry elementu iframe atrybutu SRC:
Parametry ogólne

  • lang=en – oznaczanie poszczególnych wersji językowych (CS = czeski, EN = angielski, DE = niemiecki, RU =
    rosyjski, SK = słowacki, IT = włoski, FR = francuski, ES = hiszpański, PL = polski, ZH –
    chiński, RO = rumuński, SL = słoweński, UK = ukraiński)
  • currency=CZK – oznaczanie dostępnych walut (CZK = korona czeska, USD = dolar amerykański, EUR = euro, GBP – funt brytyjski, RUB – rubel rosyjski, PLN – złoty polski, UAH – hrywna ukraińska, HUF – forint węgierski)
  • showTabs=reservation-maps – pozwoli na wybór zakładek ramki silnika, które chcesz w niej wyświetlać; w podanym przykładzie wskazujesz, że chcesz wyświetlić 2 sekcje ramki: zakładkę “rezerwacja” i “mapa”, pozostałe zakładki pozostaną ukryte w ramce silnika.Zakładki do wyboru w ramach parametru showTabs to:„reservation” – wyszukiwarka z formularzem rezerwacji
    „stay” – pakiety pobytowe, które oferujesz jako oddzielną usługę w obiekcie (ustawisz je w Previo w sekcji Ceny / Pakiety pobytowe), np.:

    „review” – zatwierdzone i opublikowane przez Ciebie opinie gości o pobycie w Twoim obiekcie. Recenzje, ich ustawienia opisujemy w dedykowanym artykule

„pricelist” – kalendarz cen z możliwością przejścia do formularza rezerwacji online
„occupancy” – kalendarz dostępności w obiekcie z możliwością przejścia do formularza rezerwacji online
„map” – mapa ze wskazaniem lokalizacji obiektu/ów
„coupon” – formularz zamówienia voucherów upominkowych
„hotels” – lista Twoich obiektów /hoteli – lista wszystkich obiektów w grupie – > dotyczy sieci hoteli, których licencje w Previo zostały połączone w jedną grupę hotelową. Więcej informacji na ten temat uzyskasz w naszym Dziale Wsparcia.

Nazwy poszczególnych zakładek w parametrze showTabs oddzielaj myślnikiem.

  • hideTabs=stay-review-pricelist-occupancy – ukryj wybraną sekcję z listy j.w. Nazwy poszczególnych zakładek oddzielaj myślnikiem.
  • theme=kolor szablonu – możliwe opcje to: ciemny, pomarańczowy, czerwony, zielony, szary, bordowy, brązowy, fioletowy, theme01, ciemnoniebieski, czarny, ciemnobrązowy, jasnopomarańczowy, ciemnozielony, jasnozielony, winny, fioletowy, ciemnoróżowy, złoty, zielony , różowy, darkmode-złoty, darkmode-cyjan, darkmode-szary, darkmode-różowy, darkmode-niebieski, darkmode-pomarańczowy, darkmode-zielony. Parametr do wprowadzenia: dark, orange, red, green, gray, bordo, brown, purple, theme01, darkblue, black, darkbrown, lightorange, darkgreen, lightgreen, wine, violet, darkpink, gold, naturegreen, pink, darkmode-gold, darkmode-cyan, darkmode-gray, darkmode-pink, darkmode-blue, darkmode-orange, darkmode-green
  • ga=UA-1234567-8 – kod konta Google Analytics (Identyfikator usługi) do pomiaru ruchu
  • hotelDetail=1, pokazuje szczegóły obiektu w nagłówku ramki silnika (logo, nazwa, liczba gwiazdek, adres, opinie, krótki opis i zdjęcia). Odpowiednie zwłaszcza, jeśli formularz znajduje się w nowym oknie lub gdy odsyłasz do niego z innych stron:
  • showHotels=XXX-YYY, za pomocą parametru można wybrać, które hotele z grupy będą wyświetlane w sekcji „Lista obiektów” oraz w zakładce „Mapa” w IBE. Po = po prostu wprowadź identyfikatory profili, a jeśli chcesz wyświetlić więcej niż jeden profil, oddziel identyfikatory myślnikiem. Np.: showHotels=730562-730700

    Parametry zakładki Rezerwacja
  • guestFilter=1, wyświetla filtr dla liczby gości. Może być używany razem z parametrem „arrival”. Konkretną liczbę gości można ustawić dodatkowymi parametrami numberOfAdults=X i childAges=X-Y. Bez tych parametrów automatycznie wypełnimy wstępnie 2 osoby dorosłe jako najczęstszą opcję.
  • showRoomType=546, formularz rezerwacji wyświetli tylko niektóre pokoje (zgodnie z identyfikatorami pokoi), jeśli chcesz wyświetlić więcej pokoi, oddziel je myślnikiem: showRoomType=12345-6543-8974
  • highlightRoomType=546, wybrany typ pokoju zostanie podświetlony w Twoim IBE (zastąp 546 numerem identyfikacyjnym typu pokoju) Pokój zostanie przeniesiony na pierwsze miejsce wśród wszystkich pokoi, a jego cena zostanie automatycznie rozwinięta, więc opcje cen (nrr itp.) widoczne od razu.
  • DiscountCoupon=ABC2017, automatycznie wypełnia kupon rabatowy w pierwszym kroku formularza rezerwacji
  • expandPrices=1 – pokaż ceny dla wszystkich ilości gości w pokoju w drugim kroku rezerwacji
  • expandServices=1, w trzecim kroku IBE w usługach hotelowych zostanie wyświetlona zakładka „Wszystkie” pokazująca wszystkie niewymienione usługi + zostaną również wyświetlone wszystkie usługi z grup usług.
  • hideSoldRooms=1 ukryje wyprzedane lub zamknięte do sprzedaży pokoje z listy.
  • hideBenefits=1 ukryje motywatory tekstowe i graficzne w pierwszym kroku procesu rezerwacji.

Parametry ostatniego kroku rezerwacji

  • showGuestDetail=1, rozwija formularz z informacjami o gościu w ostatnim kroku formularza rezerwacji
  • showNote=1, rozwija notatkę w czwartym kroku formularza rezerwacji.
  • mandatoryData: name-address-country-passport-visa – określa obowiązkowe dane, które klient musi wypełnić w trzecim kroku formularza rezerwacji. („name” – pełna nazwa/godność, „country” – kraj, „adress” – pełny adres, „viza” – numer wizy)
  • redirectUrl=http://www.mydomain.com/thank-you-for-reservation – adres URL, na który zostanie przekierowany
    ostatni krok formularza rezerwacyjnego po złożeniu zamówienia. Możesz także użyć opcjonalnego parametru
  • redirectType=iframe/parent, który przekieruje Cię na wybraną stronę wewnątrz iframe lub w witrynie nadrzędnej. Jeśli nie użyjesz tego parametru, opcja iframe zostanie wybrana automatycznie.Pole comIds zostanie przesłane jako jego parametry GET – numery właśnie utworzonych rezerwacji, szczegółowe informacje można wtedy uzyskać funkcjami API (np. Hotels.searchBonuses).
    price – całkowita cena rezerwacji
    currency – waluta rezerwacji
    arrival – data przybycia w formacie RRRR-MM-DD
    departure – data wyjazdu w formacie RRRR-MM-DD
    customerName – imię i nazwisko osoby kontaktowej
    customerEmail – email osoby kontaktowej

Parametry dla zakładek cennik/obłożenie

  • pricelistType=seasons / pricelistType=rooms, cennik wyświetla się automatycznie w wariancie „rooms” (po wybraniu pokoju do wyświetlenia kalendarza), jeśli masz więcej niż 4 sezony cenowe w przyszłości. Jeśli użyjesz parametru pricelistType=seasons lub masz mniej niż 4 sezony cennikowe w przyszłości, cennik wyświetli się jako tabela z cenami wszystkich pokoi, gdzie zamiast rodzaju pokoju wybierasz tylko datę wyświetlenia ceny.
  • numOfGuests=min/max/liczba – określa liczbę gości, która jest wstępnie wybrana przy wyborze pokoju. Min. zawsze pokazuje ceny za 1 osobę (niezależnie od pojemności pokoju). Max zawsze wyświetla cenę za pełną pojemność głównych łóżek w danym pokoju.
  • showOccupancyTabs=object/objectKind/object-objectKind – parametr określa, które zakładki będą wyświetlane w sekcji Dostępność. Obiekt (object) to obłożenie określonych pokoi, rodzaj obiektu (objectKind) to obłożenie typów pokoi, a użycie obu parametrów oddzielonych myślnikiem spowoduje wyświetlenie obu zakładek.
  • drawOccupancyBy=object/objectKind – określa, która zakładka będzie wyświetlana domyślnie w sekcji Dostępność. “object” – według konkretnych pokoi”, “objectKind” – według typów pokoi.

Parametry do pakietów

  • showStays=12345, wyświetlą się tylko wybrane pakiety pobytowe (zgodnie z ID pakietu), aby wprowadzić kilka pakietów użyj myślnika: showStays=123-456-789
  • stayPricesPerRoom=1, wyświetli pakiety liczone za pokój (i ich cenę) zgodnie z tą logiką i nie przeliczy ceny za osobę (czyli przy zamówieniu zostanie wyświetlona najniższa cena za cały pokój, a nie najniższa cena obliczona za osobę w pakiecie)

Przykład użycia parametrów opcjonalnych
Ukrywanie zakładki obłożenia i wyświetlanie formularza w języku angielskim:

<!– Reservation PLUS start –>
<div class=”previo-reservation-form”>
<script type=”text/javascript” src=”https://booking.previo.cz/iframe/”></script>
<iframe src=”https://booking.previo.cz/?hotId=123456&lang=en&hideTabs=occupancy” scrolling=”no” frameborder=”0″ width=”100%” height=”2000″ name=”previo-booking-iframe” id=”previo-booking-iframe” allowTransparency=”true”></iframe>
</div>
<!– Reservation PLUS end –>

Obowiązkowe atrybuty elementu iframe:

  • scrolling=no – nie wyświetlaj scrollbarów wewnątrz elementu iframe (wysokość formularza jest dopasowywana automatycznie)
  • name=previo-booking-iframe – nazwa elementu iframe
  • id=previo-booking-iframe – ID elementu iframe

Opcjonalne atrybuty elementu iframe:

  • width=100% – ustawienie szerokości formularza
  • height=2000 – ustawienie wysokości formularza
  • frameborder=0– ramka elementu iframe
  • allowTransparency=true – włącz przezroczystość elementu iframe

Możliwe jest również wstępne wypełnienie formularza parametrami GET i przekierowanie od razu do kolejnych kroków:

  1. Zakładka Rezerwacja służąca do zamawiania konkretnego pokoju:

Użyj http://booking.previo.cz/?hotId=123456 z następującymi parametrami:
showRoomType=123 – identyfikator typu pokoju (wymagane)
arrival=DD.MM.RRRR – data przybycia (opcjonalnie, domyślnie jest to dzisiaj)
departure=DD.MM.RRRR – data wyjazdu (opcjonalnie, domyślnie jeden dzień później niż data przyjazdu)

  1. Zakładka Pakiety służąca do zamówienia konkretnego pakietu pobytowego:

Użyj http://booking.previo.cz/stay/?hotId=123456 z następującymi parametrami:
stayId=123 – ID pakietu (wymagane)
arrival=DD.MM.RRRR – wyświetlenie kalendarza z wybranym konkretnym dniem (opcjonalnie, domyślnie najbliższy możliwy)

Własny pomiar celów / konwersji / retargetingu / i inne

Konwersje Awords i Sklik oraz transakcje e-commerce GA są mierzone automatycznie przez Previa. Jeśli chcesz mierzyć również inne cele, np. odwiedzenie 2. kroku formularza, wypełnienie rezerwacji, sprawdzenie, jaką datę klient wypełnił w 1. kroku, możesz skorzystać z prostego transferu informacji pomiędzy iframe oraz stronę internetową. Podczas przechodzenia z jednego kroku do drugiego iframe wysyła wywołanie metody bookingPlusStepEvent do strony internetowej, jeśli taka metoda istnieje na stronie nadrzędnej, to jest wywoływana m.in. parametrów, gdzie dowiesz się do jakiego kroku użytkownik właśnie się przeniósł, a na 2 i 5 kroku uzyskasz również dodatkowe informacje o rezerwacji (data, cena, numer vouchera).

Twoja funkcja może wyglądać tak:

/**
* @param JSON reservationInfo
*/
function reservationPlusStepEvent(reservationInfo) {
values = JSON.parse(reservationInfo);

// reservation was created
if(values.step == 5) {
// this will print available data to console
console.log(values);
// do some action
}
}

Więcej wskazówek znajdziesz w artykule dedykowanym pozycjonowaniu