Tutorial: Schnellsuche

Tutorial: Schnellsuche

Schnellsuche tatsächlich nötig?

Der Einbau einer Schnellsuche muss sehr gut überlegt sein.  Eine schlechte Umsetzung wirkt sich nachteilig für den Buchungserfolg und das Usererlebnis aus. 
Die Seiten mit den besten Conversions und Buchungserfolgen verzichten daher auf eine Schnellsuche!

Die Empfehlung lautet somit, den Aufruf der Buchungsstrecke nur über einen Button zu öffnen. Es wird direkt die TOSC Detailseite des Betriebes geöffnet.

Vorteile:

  • Die Detailseite deckt alle Suchvarianten ab

  • Ist vom User gelernt (booking.com etc.)

  • Die Suchfunktion auf der Detailseite erfüllt alle Standards, die systemseitig unterstützt werden:

    • saubere Trennung Erwachsene - Kinder

    • Kinder mit Alterseingabe

    • mehrere Suchzeilen

    • benutzerfreundliche Datumseingabe 

 

Sollten Sie sich dennoch für eine Schnellsuche entscheiden, ist Folgendes zwingend zu berücksichtigen:

  • Die Anzahl der Kinder sowie das jeweilige Alter müssen abgefragt werden

  • Für eine korrekte Preisberechnung ist die Altersangabe der Kinder unbedingt erforderlich

Eine Schnellsuche ohne diese Angaben führt zu fehlerhaften oder unvollständigen Ergebnissen.

 

Technische Umsetzung der Schnellsuche

Wenn Sie eine Schnellsuche auf der Website eines Betriebes umsetzen möchten, kann hierfür unsere Schnellsuch-Funktion verwendet werden.

Grundprinzip

  1. Erstellen Sie ein HTML-Formular (optional)

  2. Erfassen Sie die Suchdaten des Gastes

  3. Übergeben Sie diese Daten an eine von uns bereitgestellte JavaScript-Funktion

  4. Leiten Sie den Gast nach dem Absenden der Suche auf jene Unterseite weiter, auf der das TOSC5 Widget eingebunden ist

Für die Weiterleitung steht eine Callback-Funktion zur Verfügung.

Einbindung der benötigten JavaScript-Bibliothek

Auf der Seite, auf der die Schnellsuche ausgelöst wird, muss folgendes JavaScript geladen werden:

<script src="https://web5.deskline.net/dwutility.js"></script>

Auslösen der Schnellsuche

Zum Starten der Suche wird die Funktion dw.accommodationDetailQuickFind(...) verwendet.

Übergabeparameter

Der Funktion werden unter anderem übergeben:

  • ID des Vermieters (nicht die TagID)

  • Suchdaten des Gastes (Anreise, Abreise, Belegung)

  • Datenbankcode

  • Callback-Funktion zur Weiterleitung auf die TOSC5-Seite

Die Werte aus Ihrem Formular müssen im korrekten Format übergeben werden.
Zum Auslesen der Formularwerte können gängige JavaScript-Methoden verwendet werden (z. B. document.getElementsByName("Anreise")[0]...).

Ermittlung der benötigten IDs

ID des Vermieters

Die ID des Vermieters erhalten Sie entweder:

  • über Ihr Serviceteam

  • oder über die Entwicklerkonsole des Browsers auf einer Seite, auf der das TOSC5 Widget eingebunden ist (oder über den Direktlink)

Abzufragender Wert:

tagContext_6.appContext.serviceProviderId (Beispiel: a6aed2be-9287-4d12-8824-0af9f25a943a)

Datenbankcode

Auch der Datenbankcode kann:

  • über Ihr Serviceteam

  • oder über die Entwicklerkonsole ermittelt werden

Abzufragender Wert:

tagContext_6.appContext.dbCode (Beispiel: ABC)

Verkürztes Beispiel: Schnellsuche mit HTML-Formular

<script> function onFormSubmit(){ dw.accommodationDetailQuickFind( // LocalStorageID: ID des Vermieters, siehe oben 'a6aed2be-9287-4d12-8824-0af9f25a943a', // Gastdaten { dateFrom:new Date("2021-11-10"), dateTo:new Date("2021-11-13"), occupancy1:{ units:1, adults:3, children:[0,1] }, //Datenbankcode (3-stellig) dbCode:'ABC', //ID des Vermieters (Siehe oben) id:'a6aed2be-9287-4d12-8824-0af9f25a943a' }, function() { // Callback Funktion, um z.B. einen Redirekt auf die Unterseite mit der TOSC5 Applikation durchzuführen. window.location.href = "https://example.com/urlaub" }) // blockieren der Standard Formularaktion return false; } </script> <form onsubmit="return onFormSubmit()"> ... ... ... <button type="submit">submit</button></form>

 

Werte

Beschreibung

Beschreibung

DateObject für das Anreisedatum des Gastes.

DateObject für das Abreisedatum des Gastes.

Überlicherweise wird hier nur "occupancy1" verwendet. Sie können jedoch bis zu 3 verschiedene Belegungsoptionen übergeben. (2 * 2 Erwachsene, 1 * 1 Erwachsene und 2 Kinder)

units - Wie oft wird diese Belegung gesucht.

adults - Anzahl Erwachsener

children - Array, Alter der Kinder bei Reiseantritt (z.b 0,1 für ein Kind unter einem Jahr, und eines mit einem Jahr; 6,6 für 2 sechsjähre)