Parametri del link al modulo
| A cosa serve | Risparmiare passi all’ospite: un link da newsletter, post o landing apre il modulo subito con date, ospiti, tipologie di camera, codice promozionale o lingua già al posto giusto. |
| A chi si rivolge | A chi gestisce il sito e le campagne dell’hotel: newsletter, post, annunci, landing page. Lo sviluppatore non serve – i parametri si aggiungono all’indirizzo della pagina. |
| Cosa ottieni | Link al motore di prenotazione che si aprono con date di arrivo e partenza, ospiti, tipologie di camera, codice promozionale e lingua già al loro posto. |
| Limitazioni | Nell’articolo ci sono i parametri e gli scenari principali; l’elenco completo sta nella guida «Parametri del link» nel PMS. Nel link non c’è il parametro valuta: la valuta di visualizzazione la sceglie l’ospite. |
Un link al motore di prenotazione è l’indirizzo della pagina in cui il modulo è incorporato, più i parametri: brevi indicazioni su ciò che il modulo deve sapere già prima del primo tocco dell’ospite. Il modulo si apre subito nello stato giusto: la landing di un appartamento – con quell’appartamento, la newsletter in promozione – con date e codice, l’email in tedesco – in tedesco. I parametri si combinano: un solo link può portare insieme date, codice promozionale e lingua.
Data di arrivo
Sezione intitolata “Data di arrivo”Il parametro più frequente sono le date: checkIn – la data di arrivo, checkOut – la data di partenza. Le date si scrivono nel formato AAAA-MM-GG, per esempio 2026-12-11. Al posto della data di arrivo si può passare la parola today o tomorrow – il modulo sostituirà la data di oggi o di domani. Il numero di notti lo definisce il parametro nights.
Le date nel link sono un modo per portare l’ospite a una scelta già pronta. Un post sui soggiorni natalizi, una newsletter con l’offerta del weekend – in questi messaggi un link con le date risparmia all’ospite il primo passo: il calendario si apre con i giorni già impostati.
Risultato: il modulo si apre con le date di arrivo e partenza già impostate – l’ospite vede subito cosa è disponibile per le sue date.
Composizione degli ospiti
Sezione intitolata “Composizione degli ospiti”Quante persone arrivano è parte della ricerca anche questo: adults – adulti, children – bambini. Per i bambini si possono passare le età separate da virgola; il numero di camere nella ricerca lo definisce il parametro rooms.
Il link «per la famiglia con bambini» apre il modulo con la compagnia già compilata: l’ospite non deve regolare i contatori – la ricerca parte subito dalle camere che ospitano il suo gruppo.
Il widget ha i suoi valori predefiniti – i campi «Adulti predefiniti» e «Bambini predefiniti» nella pagina «Widget» del PMS; funzionano quando l’ospite apre il widget senza parametri.
Risultato: il link porta con sé la composizione degli ospiti – il modulo si apre con adulti, bambini e numero di camere già compilati.
Tipologie di camera
Sezione intitolata “Tipologie di camera”Il parametro roomTypeIds indica quali tipologie mostrare: il modulo si aprirà solo con le tipologie scelte, le altre non compaiono nella ricerca. Il parametro è ripetibile – si aggiunge una volta per ogni tipologia, così si può comporne una sola o più.
Lo scenario principale è la landing di un appartamento. In un aparthotel ogni appartamento è una tipologia a sé; la pagina dell’appartamento sul tuo sito riceve il suo link, che apre il modulo direttamente su quell’appartamento. Allo stesso modo si compongono i link «solo suite» per una campagna pubblicitaria o «matrimoniali» per una newsletter per l’anniversario.
Quali tipologie si vendano sul sito lo decidi tu con le tariffe; il parametro restringe la scelta dentro ciò che è già disponibile. L’elenco completo dei parametri – nella guida «Parametri del link» nel PMS.
Risultato: un link – un insieme di tipologie: dall’appartamento intero sulla sua landing alla selezione per una campagna precisa.
Codice promozionale
Sezione intitolata “Codice promozionale”Il parametro promoCode porta il codice nel modulo: l’ospite apre il link, e il codice è già nel campo «Codice promozionale» del carrello – come se l’avesse inserito da solo. Da lì tutto è familiare: il pulsante «Applica», la risposta appare sotto il campo, senza ricaricare la pagina.
Il campo «Codice promozionale» sta nel carrello per impostazione predefinita; per mostrarlo risponde l’interruttore «Mostra il campo “codice promozionale”» nella pagina «Widget». Come sono costruiti gli sconti, la validità dei codici e le statistiche degli utilizzi – nell’articolo sui codici promozionali.
In coppia con le date il parametro compone la campagna intera: «date più codice» in un’unica email – l’ospite apre il modulo con le condizioni della campagna già pronte.
Risultato: il codice dal link è già nel campo «Codice promozionale» – all’ospite resta applicarlo con un tocco.
Il parametro lang definisce la lingua del modulo per quel link: il modulo si aprirà subito nella lingua scelta. Serve là dove la lingua è nota in anticipo: una newsletter in tedesco, una pagina per gli ospiti italiani, un post in un social straniero.
L’insieme di lingue del modulo lo definisci tu – otto lingue per gli ospiti, attivarle si possono tutte; il selettore di lingua nell’intestazione del modulo resta all’ospite. Tra i parametri del link non c’è la valuta: la lingua al link si può passare, la valuta la sceglie sempre l’ospite.
Risultato: il link apre il modulo nella lingua del pubblico – senza il passo in più «trova la tua lingua».
Ricette di link
Sezione intitolata “Ricette di link”La base di ogni link è l’indirizzo della pagina in cui il modulo è incorporato. Per il widget questa pagina è fissata nel PMS: nella pagina «Widget», nel blocco «Comportamento», c’è il campo «URL della pagina di prenotazione» – la pagina in cui il modulo è incorporato; il pulsante del widget porta proprio lì. Un link con parametri è lo stesso indirizzo più i parametri aggiunti: il primo dopo il segno «?», gli altri dopo &.
Alcune ricette pronte:
-
La promozione in newsletter – date e codice in un solo messaggio:
https://hotel.example/booking?checkIn=2026-12-11&checkOut=2026-12-14&promoCode=WELCOME_10 -
La landing dell’appartamento – una tipologia, il parametro si ripete una volta per ciascuna:
https://hotel.example/booking?roomTypeIds=IDENTIFICATORE -
La newsletter nella lingua dell’ospite – a qualsiasi insieme di parametri si aggiunge
lang: la versione tedesca dell’email porta a un link con date e lingua, quella italiana – con le sue.
Il codice di incorporamento nel frattempo non cambia: lo snippet dal PMS collega il modulo dai server HotelsCalendar, quindi i link con parametri vivono solo dove tu li distribuisci – nelle email, nei post e nelle landing. Niente da correggere sul sito.
Risultato: prendi l’indirizzo della pagina di prenotazione, aggiungi i parametri – e il link per la campagna è pronto.
Vedi anche
Sezione intitolata “Vedi anche”- Codici promozionali – creare il codice che il link mette nel carrello: sconti, scadenze, limiti e statistiche.
- Lingue e valute del modulo – scegliere l’insieme di lingue del modulo e capire perché la valuta non è tra i parametri del link.
- Il widget multi-struttura – più strutture in un widget: a chi conviene e come attivare la scelta della struttura.