RESAVIO - Integration Guide

Integration

So einfach binden Sie unsere Buchungsmaschine in Ihre Hotel- oder Unterkunft-Website ein!

Link

Verlinken Sie unser Buchungssystem ganz einfach auf Ihrer Website:

<a href="https://resavio.com/booking/{LANGUAGE}/{CLIENT_ID}" target="_blank">Online buchen!</a>

Die Platzhalter {LANGUAGE} und {CLIENT_ID} müssen (inklusive geschweifter Klammern) durch das Sprachkürzel (z.B. de = Deutsch, en = Englisch) bzw. die ID der Unterkunft ersetzt werden.

Weitere URLs:

Kompaktes Buchungsformular:
https://resavio.com/booking/de/{CLIENT_ID}/form

Lageplan-Buchung:
https://resavio.com/booking/de/{CLIENT_ID}/map

Buchung einer bestimmten Zimmerkategorie:
https://resavio.com/booking/de/{CLIENT_ID}/categories/{CATEGORY_ID}

Arrangement-Direktbuchung:
https://resavio.com/booking/de/{CLIENT_ID}/arrangements/{ARRANGEMENT_ID}

Übersicht aller verfügbaren Angebote in einem Zeitraum:
https://resavio.com/booking/de/{CLIENT_ID}/offers?checkin={YYYY-MM-DD}&checkout={YYYY-MM-DD}&adults={ADULTS}

Direktbuchung eines bestimmten Angebots:
https://resavio.com/booking/de/{CLIENT_ID}/cart/rooms/add?tariff_id={TARIFF_ID}&checkin={YYYY-MM-DD}&checkout={YYYY-MM-DD}&adults={ADULTS}
Anstelle der tariff_id kann auch eine arrangement_id übergeben werden.

Bewertungen:
https://resavio.com/booking/en/{CLIENT_ID}/reviews

URL-Parameter

tariff_id: ID des Tarifs
arrangement_id: ID des Arrangements
checkin: Anreisedatum im Format YYYY-MM-DD
checkout: Abreisedatum im Format YYYY-MM-DD
adults: Anzahl Erwachsener
childs: Alter der Kinder als Array,
z.B. für 2 Kinder im Alter von 2 und 12 Jahren:
?childs[]=2&childs[]=12

iFrame

Integrieren Sie unser Buchungstool in einem iFrame in Ihre Seite:

<iframe src="https://resavio.com/booking/de/{CLIENT_ID}" width="100%" id="resavio-iframe" style="background-color: transparent; border: 0 none transparent; padding: 0; overflow: auto;"></iframe>

Sie können alle obenstehenden Landingpages nach Wunsch mittels iFrame in Ihre Website einbetten. Tauschen Sie dazu einfach die URL im src-Attribut durch die der Landingpage aus.

Indem Sie zusätzlich folgenden JavaScript-Code in Ihre Seite einbinden werden Scrollbalken vermieden:

<script src="https://resavio.com/widgets/js/no-scrollbars.js"></script>

Widgets

Eine weitere Variante der Integration unseres Buchungstools sind unsere Widgets. Um unsere Widgets nutzen zu können, fügen Sie zunächst unser Widget-Script vor dem schließenden </body>-Tag Ihrer Website ein. Dabei können sie über das Attribut data-locale die Sprache festlegen.

<script id="resavio-widgets" data-locale="de" src="https://resavio.com/widgets/js/widgets.js"></script>

Binden Sie außerdem das zugehörige Stylesheet im <head>-Bereich der Website ein:

<link rel="stylesheet" type="text/css" href="https://resavio.com/widgets/css/widgets.css">

Die Farben der Widgets können mittels CSS-Variablen dynamisch angepasst werden:

Unsere Widgets können anschließend an der gewünschten Stelle auf Ihrer Website eingefügt werden.

Für ein Buchungsformular mit Datepicker verwenden Sie folgenden Code:

<resavio-form client="1" layout="horizontal"></resavio-form>

Über das Attribut client wird Ihre Kundennummer übergeben. Sie können zwischen zwei Layout-Varianten wählen: horizontal | vertical.

Für eine fix am unteren Bildschirmrand positionierte Buchungsleiste verwenden Sie folgendes Widget:

<resavio-sticky-bar client="1"></resavio-sticky-bar>

Eigenes HTML-Formular

Wenn Sie mehr Gestaltungsmöglichkeiten haben möchten, dann können Sie (Programmierkenntnisse vorausgesetzt) auch ein eigenes HTML-Buchungsformular mit An- und Abreisefeld integrieren und völlig frei per CSS gestalten. Folgenden HTML-Code können Sie als Grundgerüst verwenden und nach Ihren Anforderungen anpassen:

Cookies

Standardmäßig fragt unser System Ihre Gäste nach einer Einwilligung in die Verwendung von Cookies. Wenn Sie nicht wünschen, dass das Cookie-Banner angezeigt wird, können Sie das über den URL-Parameter ?cookie_consent=essential verhindern. Dann werden allerdings auch nur erforderliche Cookies gesetzt. Wenn Sie bereits eine Einwilligung für die Verwendung nicht erforderlicher Cookies auf Ihrer Seite eingeholt haben, können Sie diese auch für die einzelnen Cookie-Typen an unser System übergeben:
?cookie_consent=essential|personalization|analytics|advertising

Google Analytics

Damit das allgemeine Website-Tag von Google im Buchungsprozess ausgespielt wird, hinterlegen Sie bitte zunächst Ihre Google-Analytics-Mess-ID (G-*) in den Systemeinstellungen im Bereich Tracking. Für korrektes Cross-Domain-Tracking kann die domainübergreifende Verknüpfung verwendet werden. Der auf Ihrer Website eingebundene Tracking-Code sollte dazu ergänzt werden um:

gtag('set', 'linker', {'domains': ['resavio.com']});

Ist das Tracking aktiviert und hat der Gast der Verwendung von Analytics-Cookies zugestimmt, wird jeder Seitenaufruf im Buchungsprozess aufgezeichnet. Beim Abschluss einer Buchung wird unsererseits außerdem ein Kauf-Ereignis gesendet (transaction_id = Reservierungsnr.):

gtag('event', 'purchase', {'transaction_id': '1234', 'affiliation': 'RESAVIO', 'value': 100.00, 'currency': 'EUR'});