rateCHECKER Docs

Datenquellen

Als Datenquellen sind aktuell ASA, Xenus über AlpineBits und EasyChannel vorgesehen.

Installation

Zum Einfügen des rateChecker Widgets fügen Sie folgenden Code innerhalb des <body /> Tags ein.
<script type="text/javascript">
 (function(w,d,o,f,js,fjs){w["conWidgets"]=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
 js=d.createElement("script"),fjs=d.getElementsByTagName("script")[0];js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs)
 })(window,document,"_conWidgets","https://widgets.secure.consisto.net/js/modules/widget.min.js");
 </script>
Wichtig: dieser Code muss nur einmal pro Seite oberhalb des ersten Widgets eingefügt werden. Auch wenn mehrere verschiedene Widgets auf einer Seite verwendet werden, wird dieser Code nur einmal benötigt.

Konfiguration

Fügen Sie folgenden Code an der Stelle ein, an der der rateCHECKER erscheinen soll.
<con-pricecalendar id="pricecalendar"></con-pricecalendar>
 <script type="text/javascript">
 _conWidgets('init', document.querySelector("#pricecalendar"), {
 'lang': 'de',
 'widgetId': "[Domain]",
 'bookingUrl': "BookingURL",
 'requestUrl': "RequestURL"
 });
 </script>
ArgumentTypStandartwertBeschreibung
langstring/Sprache vom Widget
widgetIdstring/Domain des Projektes
bookingUrlstring/URL zur Buchungsseite
requestUrlstring/URL zur Anfrageseite
roomstring/wenn leer: alle Zimmer werden angezeigt
wenn befüllt: Codex des Zimmers das im Dropdown vorausgwählt ist
hideRoomDropDownboolfalseBlendet die Zimmerauswahl im Widget aus.
Funktioniert nur wenn über 'room' ein Zimmer gesetzt wurde.
arrivalstring/Die Anreise im Format yyyy-MM-dd (z.b. 2021-05-10)
departurestring/Die Abreise im Format yyyy-MM-dd (z.b. 2021-05-16)
promotionstring[][null, null, null]UTM-Parameter für Buchungs- und Anfragelink. Beispiel: ['medium', 'source', 'campaign']
 layoutBreakpoints int[] [1200, 1024, 768, 414]Breiten in px, an denen das Widget auf eine andere Ansicht umschaltet.
Achtung, hierbei handelt es sich um Breiten des Containers, in dem das Widget integriert ist.
(dreispaltig, zweispaltig, einspaltig, einspaltig kleiner)

Url Parameter
Zusätzlich zu den Parametern beim Initialisieren vom Widget können in der URL folgende Parameter mitgeschickt werden:
ArgumentTypStandartwertBeschreibung
arrivalstring/Die Anreise im Format yyyy-MM-dd (z.b. 2021-05-10)
departurestring/Die Abreise im Format yyyy-MM-dd (z.b. 2021-05-16)

API

Zu einem Initialisierten rateCHECKER sind einige Funktionen per JavaScript zugänglich.
In dem initialisierten HTML-Element des rateCHECKERs gibt es einen Objekt, über das Funktionen verfügbar sind.
document.querySelector("#pricecalendar").con_pricecalendar

In diesem Objekt sind folgende Funktionen verfügbar:

getSelectedData()
Gibt ein Objekt mit den aktuell ausgefüllten Daten zurück.
  • SelectedYear (int)
  • SelectedMonth (int)
  • Stay (object)
    • Arrival (Date - null wenn nicht gewählt)
    • Departure (Date - null wenn nicht gewählt)
  • MealPlan (string)
  • Room (object - null wenn nicht gewählt)
    • Codex (string)
    • BookingCodex (string)
  • Offer (object - null wenn nicht gewählt)
    • Codex (string)
    • BookingCodex (string)
  • Adults (int)
  • ChildAges (int[])
  • StayBookable (bool)
  • RoomsAvailable (object[])
    • Codex (string)
    • BookingCodex (string)
    • Bookable (bool)
Beispiel:
document.querySelector("#pricecalendar").con_pricecalendar.getSelectedData();

Events

onWidgetLoaded(shadowRoot, element)
shadowRoot: Das Shadow-Element vom aktuellen Widget
element: Das Element im Light-DOM

onWidgetResized(shadowRoot, element)
shadowRoot: Das Shadow-Element vom aktuellen Widget
element: Das Element im Light-DOM

onAjaxUpdated(shadowRoot, element)
shadowRoot: Das Shadow-Element vom aktuellen Widget
element: Das Element im Light-DOM

onButtonClick(shadowRoot, element, details)
shadowRoot: Das Shadow-Element vom aktuellen Widget
element: Das Element im Light-DOM
details: Objekt mit folgenden Eigenschaften:
  • action: (string) gibt entweder "request" oder "booking" zurück, je nachdem welcher Button geklickt wurde
  • roomName: (string) gibt den Namen des ausgewählten Zimmers zurück. Leer wenn kein Zimmer ausgewählt
  • value: (float) gibt den Preis des Zimmers zurück. 0 wenn kein Zimmer ausgewählt oder kein gültiger Preis vorhanden. (kann auch ein ab-Preis sein)

Tracking

Getrackt wird beim GoogleTagManager der Klick auf Buchen oder Anfragen.
Folgende Parameter werden aufgezeichnet:
  • Kategorie: rateCHECKER
  • Aktion: requestclick oder bookingclick
  • Label: Codex des Zimmers falls vorhanden
  • Value: Preis falls vorhanden (auch ab-Preis)

Beim Wechseln des Zimmers im Dropdown wird folgendes aufgezeichnet:

  • Kategorie: rateCHECKER
  • Aktion: changeroom
  • Label: Codex des Zimmers
  • Value:/

Bei Auswahl eines Zeitraumes (Anreise + Abreise) oder wechsel der Abreise wird der Zeitraum aufgezeichnet:

  • Kategorie: rateCHECKER
  • Aktion: dateselected
  • Label: Anreise - Abreise (im Format yyyy-m-d)
  • Value:/

Zusätzlich wird beim Klick auf Anfragen oder Buchen in der Ziel-URL der URL Parameter "ref=ratechecker" mitgeschickt, mit dem im eigenen Coding das eigene Tracking entsprechend angepasst werden kann.