Tutorial: Schnellsuche

Owned by Armin Schanitz
Last updated: 17.01.2023 by Anna MomkovaVersion comment
3 min read

Allgemein

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 allen 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 trotzdem für eine Schnellsuche entscheiden, muss die zwingende Abfrage der Kinder-Anzahl und des jeweiligen Alters berücksichtigt werden. Zur korrekten Preisberechnung wird das Alter der Kinder unbedingt benötigt.


Wenn sie für die Website des Betriebs eine Schnellsuche umsetzen, und diese bestmöglich in die Website einbinden möchten, kann dies mittels unserer Schnellsuch-Funktion umgesetzt werden. Erstellen sie hierzu wie gewohnt ein HTML Formular (optional) und übergeben anschließen die notwendigen Werte an eine von uns zur Verfügung gestellten Funktion. Üblicherweise werden sie auf einer Unterseite den TOSC5 eingebunden haben. Damit nach "Absenden" der Suche der Gast auf die korrekte Unterseite weitergeleitet werden kann, steht eine Callback-Function zur Verfügung.

Um die gewünschte Funktion zu verwenden muss auf der betroffenen Seite folgendes Javascript geladen werden:

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


Zum Auslösen der Suche verwenden Sie die Funktion "dw.accommodationDetailQuickFind..." Dieser übergeben Sie die ID ihres Vermieters (nicht die TagID), die Suchdaten des Gastes, die ID des gewünschten Vermieters, den Datenbankcode und die Callback-Funktion die ausgelöst wird, um den Gast auf die Seite Ihrer Website zu leiten, auf welcher der TOSC5 eingebunden ist. Die vom Gast in Ihrem Formular eingegebenen Werte müssen im korrekten Format übergeben werden. Zum auslesen der Daten aus Ihrem Formular können Sie gängige Javascript Funktionen verwenden (document.getElementsByName("Anreise")[0]...)


Um die ID des Vermieters zu erhalten können Sie entweder unser Serviceteam kontaktieren, oder aber auf einer Seite auf welcher ihr TOSC5 Widget läuft (oder am Direktlink) folgenden Wert mit der Entwicklerconsole ihres Browser abfragen:

tagContext_6.appContext.serviceProviderId

(Beispiel: a6aed2be-9287-4d12-8824-0af9f25a943a)

Um den Datenbankcode zu erhalten können Sie entweder unser Serviceteam kontaktieren, oder aber auf einer Seite auf welcher ihr TOSC5 Widget läuft (oder am Direktlink) folgenden Wert mit der Entwicklerconsole ihres Browser abfragen:

tagContext_6.appContext.dbCode

(Beispiel: ABC)


Verkürzter Beispielcode im Rahmen eines HTML Formulars:

<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

WertBeschreibung
dateFromDateObject für das Anreisedatum des Gastes.
dateToDateObject für das Abreisedatum des Gastes.
occupancyX

Ü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)