Tutorial: Quickfinder

Owned by Rita Turner
Last updated: 05.09.2023 by Supporto Feratel
2 min read

Il quickfinder è davvero necessario?

L’integrazione di un quickfinder deve essere ben realizzata, pena un effetto negativo sulle conversioni (tanto è vero che i siti che convertono di più non integrano questo tipo di ricerca).
Il suggerimento quindi è di indirizzare l’utente alla pagina di prenotazione direttamente tramite un pulsante “prenota ora”, senza mostrare un calendario di ricerca.

Vantaggi:

  • la pagina di dettaglio copre tutte le varianti di ricerca
  • la funzione di ricerca nella pagina di dettaglio soddisfa tutti gli standard richiesti dal sistema:
    • campi in cui inserire il numero adulti e il numero bambini
    • possibilità di inserire l’età dei bambini
    • possibilità di cercare più camere
    • tool di inserimento della data facile da usare


Nel caso in cui si decida comunque di integrare il quickfinder, è necessario tenere conto che bisogna obbligatoriamente richiedere l’inserimento del numero di bambini e la rispettiva età, necessaria per il calcolo corretto del prezzo.


Se volete implementare un quickfinder, potete seguire le istruzioni indicate sulla nostra guida: https://www.desklineitalia.it/res/tosc5/dmodemo/qf-accommodation-accoweb.html


Per ottenere l'ID della struttura, è possibile contattare l’organizzazione turistica di riferimento oppure cercare il valore nel link diretto del widget Cerca&Prenota (disponibile in WebClient) utilizzando la console per sviluppatori del browser.

tagContext_6.appContext.serviceProviderId

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

Per ottenere il codice del database è possibile richiederlo all’organizzazione turistica di riferimento, oppure andare alla pagina in cui è in esecuzione il widget Cerca&Prenota (o al link diretto) e interrogare il seguente valore con la console per sviluppatori del browser:

tagContext_6.appContext.dbCode

(esempio: ABC)


Esempio di codice abbreviato nel contesto di un modulo HTML:

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


Valori

ValoreDescrizione
dateFromDateObject per la data di arrivo dell'ospite.
dateToDateObject per la data di partenza dell'ospite.
occupancyX

Di solito si usa solo "occupancy1". Tuttavia, è possibile trasferire fino a 3 diverse opzioni di occupazione.

unità - quante camere vengono cercate

adults - Numero di adulti

children - Array, età dei bambini all'inizio del viaggio (ad es. 0 ,1 per la ricerca con due bambini, uno di meno di un anno e uno di un anno; 6,6 per due bambini di sei anni)