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
Erstellen Sie ein HTML-Formular (optional)
Erfassen Sie die Suchdaten des Gastes
Übergeben Sie diese Daten an eine von uns bereitgestellte JavaScript-Funktion
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 |
|---|
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) |