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>| Argument | Typ | Standartwert | Beschreibung |
| lang | string | / | Sprache vom Widget |
| widgetId | string | / | Domain des Projektes |
| bookingUrl | string | / | URL zur Buchungsseite |
| requestUrl | string | / | URL zur Anfrageseite |
| room | string | / | wenn leer: alle Zimmer werden angezeigt wenn befüllt: Codex des Zimmers das im Dropdown vorausgwählt ist |
| hideRoomDropDown | bool | false | Blendet die Zimmerauswahl im Widget aus. Funktioniert nur wenn über 'room' ein Zimmer gesetzt wurde. |
| arrival | string | / | Die Anreise im Format yyyy-MM-dd (z.b. 2021-05-10) |
| departure | string | / | Die Abreise im Format yyyy-MM-dd (z.b. 2021-05-16) |
| promotion | string[] | [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:
| Argument | Typ | Standartwert | Beschreibung |
| arrival | string | / | Die Anreise im Format yyyy-MM-dd (z.b. 2021-05-10) |
| departure | string | / | 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.
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)
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:
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:
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.