Widget sul proprio sito web

Cos'è un widget

Un widget mostra il Suo shop Unitlify direttamente sul Suo sito web. L'ospite resta sulla Sua pagina, cerca un'offerta, sceglie data e biglietti e paga, senza passare a unitlify.de. Tecnicamente il widget è il Suo shop in una cornice: tutte le offerte, i prezzi, i metodi di pagamento e i testi legali provengono da Unitlify, colori e caratteri dal designer shop.

I widget si gestiscono sotto Sistema di prenotazione → Integrazione sito web. Serve il permesso «Integrazione sito web».

Passo 1: autorizzare il dominio

Prima che un widget funzioni sul Suo sito web, il dominio del sito deve essere inserito sotto Domini autorizzati. Senza autorizzazione il widget mostra un messaggio di errore al posto delle offerte.

• Inserire senza https://, ad esempio la-mia-azienda.it. Con o senza www. non fa differenza.
• Se il widget gira su un sottodominio come shop.la-mia-azienda.it o biglietti.la-mia-azienda.it, inserisca quel sottodominio. la-mia-azienda.it da solo non basta.
• Il sito web deve funzionare in https.
• Dopo l'inserimento può volerci fino a un minuto prima che l'autorizzazione abbia effetto ovunque.

Passo 2: creare il widget

Clicchi su Nuovo widget. L'editor guida in cinque passaggi: tipo di widget, impostazioni, design, contenuto visibile, salvataggio.

I quattro tipi di widget

Impostazioni

• Lingua: tedesco, inglese, francese o spagnolo. È la lingua di riserva. Il widget segue prima la lingua del Suo sito web (l'attributo lang della pagina), poi la lingua del browser dell'ospite, poi questa impostazione.
• SUB-ID: un identificativo a scelta libera fino a 60 caratteri, in base al quale analizzare in seguito le prenotazioni. Maggiori informazioni più avanti.
• Nome e descrizione: solo per Lei; compaiono nell'elenco dei widget e nella vista di dettaglio della prenotazione.
• Pulsante: testo del pulsante (fino a 40 caratteri, altrimenti «Prenota ora»), destinazione (riquadro di prenotazione, pagina prodotto, catalogo) e se il pulsante fluttua in basso a destra o si trova sul lato destro.

Design

Larghezza in pixel (vuoto = larghezza piena), allineamento, altezza (cresce con il contenuto o fissa), cornice e raggio degli angoli. Per il catalogo inoltre riquadri o elenco, riquadri per riga e se la prima offerta viene evidenziata. Sullo smartphone c'è sempre un riquadro per riga.

Un'altezza fissa comporta una barra di scorrimento propria nel widget. «Cresce con il contenuto» è quasi sempre la scelta migliore.

Colori, carattere e forma dei riquadri non si impostano qui ma nel Designer shop. Valgono insieme per lo shop e per tutti i widget.

Contenuto visibile

Per catalogo e prodotto decide cosa è visibile: immagine, prezzo, durata e luogo sul riquadro; intestazione, barra di ricerca, filtri, numero di risultati, buoni e barra di fiducia intorno; galleria, descrizione e punti di forza sulla pagina prodotto. Nel widget gli elementi di contorno sono disattivati per impostazione predefinita, tranne i buoni. I filtri compaiono solo quando c'è qualcosa da filtrare (almeno due sedi, lingue o prezzi). Il widget mostra i buoni solo con «Tutte le offerte».

Per il widget Booking sceglie solo se mostrare calendario, biglietti rimanenti e categorie esaurite.

Passo 3: inserire il codice di incorporamento

Dopo il salvataggio l'editor mostra il codice di incorporamento:

<unitlify-katalog widget-id="IL-SUO-ID-WIDGET"></unitlify-katalog>
<script src="https://unitlify.de/widget/v1/katalog.js" defer></script>

Inserisca entrambe le righe nel punto del Suo sito web in cui deve comparire il widget.

• WordPress, Elementor, Wix, Squarespace: inserire il codice in un elemento HTML (non in un blocco di testo).
• Più widget su una pagina: ogni widget ha il proprio elemento <unitlify-katalog>. Lo script deve comparire una sola volta nella pagina, ma una seconda volta non fa danni.
• Plugin di velocità come WP Rocket, LiteSpeed Cache o Autoptimize: escluda katalog.js da «Ritarda esecuzione JavaScript», altrimenti il widget compare solo dopo un clic sulla pagina.

Sovrascrivere le impostazioni nel codice

Può sovrascrivere le impostazioni di design direttamente sull'elemento, senza creare un secondo widget nella dashboard:

<unitlify-katalog widget-id="…" max-width="640" align="center" frame="border" lang="en"></unitlify-katalog>

L'attributo lang="de" è la via più rapida se il widget compare nella lingua sbagliata, ad esempio perché il Suo sito web ha impostato lang="en-US".

Cosa succede dopo la prenotazione

L'ospite resta sulla sua conferma nel widget; il Suo sito web non viene abbandonato. Con il widget Pulsante, la successiva apertura ricomincia da capo.

Per la Sua agenzia web: dopo una prenotazione completata il widget genera sull'elemento l'evento unitlify:booking, senza dati personali. Con esso si può ad esempio attivare un obiettivo di conversione in Analytics. L'evento significa «prenotazione creata», non «pagata»: arriva anche con bonifico e pagamento in loco. Con i metodi di pagamento con reindirizzamento al fornitore (Klarna, iDEAL) non viene generato.

SUB-ID: analizzare le prenotazioni per origine

Ogni widget può portare una SUB-ID, ad esempio homepage, landingpage-estate o partner-hotel-x. A ogni prenotazione e a ogni acquisto di buono tramite il widget, la SUB-ID viene salvata sulla prenotazione. Più widget possono portare la stessa SUB-ID; vengono allora analizzati insieme.

I risultati si vedono in tre punti:

• Integrazione sito web: per ogni widget prenotazioni, partecipanti e fatturato per 30 giorni, 90 giorni, 12 mesi o totale, sotto la tabella «Per SUB-ID». Il fatturato comprende tutte le prenotazioni non annullate, quindi anche quelle non ancora pagate.
• Elenco prenotazioni: filtri «Tutti i widget» e «Tutte le SUB-ID». I filtri compaiono solo quando esistono widget o SUB-ID.
• Esportazione: colonne «Widget (incorporamento)» e «SUB-ID».

La SUB-ID viene copiata al momento della prenotazione. Se la modifica in seguito, le vecchie prenotazioni mantengono il vecchio identificativo. Se elimina un widget, le sue prenotazioni perdono l'associazione al widget; la SUB-ID resta sulla prenotazione, ma non compare più nel filtro finché nessun altro widget la porta.

Metodi di pagamento nel widget

Nel widget valgono gli stessi metodi di pagamento e le stesse regole dello shop, vedere Configurare i metodi di pagamento. Per Apple Pay deve inoltre inserire il dominio del Suo sito web sotto Metodi di pagamento → Domini registrati.

Anteprima

L'anteprima nell'editor mostra lo stato salvato. Le modifiche non salvate non si vedono né nell'anteprima né sul Suo sito web. Dopo il salvataggio può volerci fino a un minuto prima che la nuova versione compaia sul Suo sito web.

Lista di controllo in caso di problemi

• Messaggio di errore al posto delle offerte: dominio non autorizzato, oppure inserito solo il dominio principale invece del sottodominio. Il messaggio indica il dominio mancante.
• Il widget resta vuoto: il sito web gira in http invece di https, oppure un plugin di velocità ritarda lo script.
• Lingua sbagliata: verificare l'attributo lang del Suo sito web o impostare lang="de" sull'elemento.
• Modifica non visibile: non salvata, oppure ancora entro il minuto di cache.
• Nessun buono nel catalogo: i buoni compaiono solo con «Tutte le offerte».
• Manca Apple Pay nel widget: aggiungere il dominio sotto Metodi di pagamento → Domini registrati.
• Mancano prenotazioni nelle statistiche del widget: la prenotazione non è arrivata tramite il widget, ma tramite il link dello shop o un altro canale.