← Torna all'inizio Documentazione
Embed SDK v1 · Spalopia · Siana

Una riga, tutti i casi.

Questa guida esplora, passo dopo passo e caso per caso, gli attributi data-siana-* riconosciuti dall'SDK, le chiamate di window.SianaBooking e i flussi completi (modale, drawer, inline, widget, recupero post-pagamento). Copia, incolla, sostituisci il tuo sottodominio. Non c'è alcun pacchetto da installare.

Passo 1

Come mostrare il motore

Lo script e nient'altro

Incolla questo <script> una sola volta su ogni pagina in cui vuoi che appaia il motore — idealmente prima di </body>. Non c'è alcun pacchetto da installare; lo script viene scaricato dal sottodominio che Siana ti fornisce.

<script src="https://reservas.tuhotel.com/embed.js"></script>

Lo script non mostra nulla da solo. Reagisce solo agli elementi con i marcatori data-siana-* che aggiungi sotto (o che appaiono dopo nel DOM — ascolta le mutazioni).

Modale centrato

Contrassegna qualsiasi pulsante con data-siana-open. Facendo clic su di esso si aprirà il motore in uno strato centrato sul tuo sito. Si chiude con la X interna, Esc o cliccando sul backdrop.

<button type="button" data-siana-open>Prenota</button>

Drawer laterale

Stesso pulsante con data-siana-mode="drawer". Entra da destra (default), o da sinistra con data-siana-drawer-side="left". La larghezza è controllata con data-siana-drawer-width (accetta px, %, vw e funzioni CSS min/max/clamp).

<button
  type="button"
  data-siana-open
  data-siana-mode="drawer"
  data-siana-drawer-side="right"
  data-siana-drawer-width="min(560px,80vw)"
>Prenota</button>

Inline (come una sezione aggiuntiva)

Un <div data-siana-inline></div> vuoto funge da spazio. Lo script monta l'iframe all'interno e lo ridimensiona automaticamente man mano che il contenuto cresce — non devi misurare le altezze.

<h1>Prenota la tua esperienza</h1>
<div data-siana-inline data-siana-chrome="minimal"></div>

data-siana-mode viene ignorato all'interno di data-siana-inline — il contenitore inline non può essere convertito in overlay anche se qualcuno lo richiede.

Per la lingua del motore integrato, consulta il caso L.

Non integrare il motore con un <iframe> scritto a mano. Usa sempre il blocco div + script. Con un iframe manuale il motore appare nella lingua predefinita, mostra il proprio avviso sui cookie e non adatta la sua altezza, quindi il contenuto viene tagliato o lascia uno spazio vuoto.

Nascondere la navigazione del motore

data-siana-chrome="minimal" nasconde i breadcrumbs, la freccia "indietro" e il blocco informazioni centrale. Utile quando il motore risiede all'interno di un contesto che fornisce già la propria navigazione (una scheda, un drawer, una sezione integrata).

<button
  type="button"
  data-siana-open
  data-siana-chrome="minimal"
>Prenota</button>

Apertura automatica al caricamento della pagina

Contrassegna il pulsante con data-siana-auto-open (senza valore) e l'SDK lo "clicca" non appena il DOM è pronto. Un pattern tipico per la pagina di ritorno di Redsys: il cliente arriva, il drawer si apre da solo, la conferma viene mostrata.

<button
  type="button"
  data-siana-open
  data-siana-auto-open
  data-siana-locator="abcd-1234"
  data-siana-pin="fdd2bt"
  data-siana-mode="drawer"
>Caricamento…</button>
Simula il ritorno di Redsys →

Se aggiungi data-siana-auto-open a più elementi, solo il primo viene attivato (con un avviso).

Larghezze del modal e del drawer

Solo modal: data-siana-modal-width, data-siana-modal-height (px o %). Solo drawer: data-siana-drawer-width (px, %, vw, o CSS min/max/clamp) — default min(480px,80vw). Integrato (prima del primo ridimensionamento): data-siana-min-height in px.

<button
  type="button"
  data-siana-open
  data-siana-modal-width="720px"
  data-siana-modal-height="80%"
>Modal stretto</button>

<button
  type="button"
  data-siana-open
  data-siana-mode="drawer"
  data-siana-drawer-width="clamp(360px, 50vw, 720px)"
>Drawer fluido</button>

<div data-siana-inline data-siana-min-height="640"></div>

Un link, senza codice

La forma più semplice di tutte: un normale link all'indirizzo del motore. Il cliente arriva alla schermata di prenotazione sulla propria pagina o scheda. Zero JavaScript, nessuno script da installare — lo attivi tu in pochi minuti, senza dipendere da nessuno.

<a href="https://163-f1401005.bysiana.com">Prenota</a>

È l'opzione consigliata per iniziare senza aiuto tecnico. Quando vuoi che il motore appaia sopra il tuo sito web senza cambiare pagina, passa al modal (B), al pannello (C) o all'integrato (D).

Passo 2

Il tuo dominio

Quale dominio vuoi usare?

Prima di configurare il dominio, decidi come vuoi che il motore funzioni sul tuo sito web (Passo 1). In tutti i casi ti forniamo un indirizzo pronto all'uso, senza che tu debba fare nulla. Se si apre come link esterno —il reindirizzamento—, non è necessaria alcuna configurazione DNS da parte tua. Se il motore è integrato nel tuo sito web (modal, drawer o inline), non devi configurare nulla perché funzioni: il dominio proprio (CNAME) è facoltativo e serve solo se vuoi che il motore venga servito dal tuo dominio.

Opzione A — Motore con link esterno

Il cliente clicca su un pulsante del tuo sito web e il motore si apre in una nuova pagina. Hai due alternative e nessuna richiede configurazione tecnica:

A1 · Usa il dominio di bysiana.com. Dicci quale alias personalizzato vuoi utilizzare —ad esempio il-tuo-spa.bysiana.com— e ti forniremo il link sotto il nostro dominio, pronto all'uso.

A2 · Usa il tuo dominio. Se preferisci che il link porti il tuo marchio —ad esempio prenotazioni.il-tuo-dominio.com—, scrivici a soporte@spalopia.com indicando il dominio che vuoi utilizzare e noi ci occuperemo della configurazione interna necessaria.

Opzione B — Motore integrato nel tuo sito web

Il motore appare integrato all’interno della tua pagina (modal, drawer o inline), senza che il cliente la abbandoni in nessun momento. Non devi configurare nulla perché funzioni. Il dominio proprio (CNAME) è facoltativo: se non lo configuri, viene usato l’indirizzo di Siana e tutto funziona allo stesso modo, senza problemi di cookie né di funzionamento. L’unica differenza è l’analisi: con il tuo dominio, GA4 e Meta Pixel condividono la sessione con il tuo sito web; con l’indirizzo di Siana, no (vedi Analisi · Domande frequenti).

Se vuoi usare il tuo dominio, scrivici a soporte@spalopia.com indicando il dominio e ci occuperemo della configurazione interna.

Passo 3

Cosa mostrare

Arriva direttamente alla scheda del trattamento

Quando la tua card descrive già il trattamento, salta l'elenco: passa l'UUID del servizio con data-siana-service e l'iframe aprirà direttamente la scheda (PDP).

<button
  type="button"
  data-siana-open
  data-siana-mode="drawer"
  data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e"
  data-siana-chrome="minimal"
>Prenota massaggio</button>

Combina con data-siana-chrome="minimal" per nascondere la freccia "indietro" del motore — non c'è dove tornare, il cliente arrivava dalla tua card.

Solo il riquadro di prenotazione

data-siana-view="widget" renderizza unicamente il blocco "Persone + Data + Prenota" del servizio — senza descrizione, immagini o raccomandazioni. Necessita di un data-siana-service valido.

<button
  type="button"
  data-siana-open
  data-siana-mode="drawer"
  data-siana-view="widget"
  data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e"
  data-siana-chrome="minimal"
>Prenota (widget)</button>

Forza la lingua di input

data-siana-locale avvia il motore nella lingua che indichi. Se il tuo sito web ha già un selettore di lingua, passalo qui affinché il motore erediti il contesto.

<button type="button" data-siana-open data-siana-locale="en">Book</button>

Con il motore integrato, inserisci un blocco completo in ogni pagina:

<!-- Pagina in spagnolo -->
<div data-siana-inline data-siana-locale="es"></div>
<script src="https://TU-CENTRO.bysiana.com/embed.js" async></script>

<!-- Pagina in inglese -->
<div data-siana-inline data-siana-locale="en"></div>
<script src="https://TU-CENTRO.bysiana.com/embed.js" async></script>

<!-- Pagina in tedesco -->
<div data-siana-inline data-siana-locale="de"></div>
<script src="https://TU-CENTRO.bysiana.com/embed.js" async></script>

Lo script è lo stesso in tutte le pagine: cambia solo data-siana-locale.

Sito in più lingue

  • Se il tuo sito ha una pagina per lingua (ad esempio /es/reservas, /en/booking o sottodomini come en.miweb.com), inserisci il blocco in ogni pagina con la sua lingua.
  • Se il tuo sito cambia lingua con un parametro nell'URL, puoi usare ?siana_locale=en (caso P), che ha la priorità sull'attributo.

Lingue supportate: es · en · de · fr · it · pt · ca · eu · nl · ru.

Pre-compila la data

data-siana-date="YYYY-MM-DD" arriva al motore come query param per avviare con quella data pre-selezionata quando il servizio lo supporta.

<button
  type="button"
  data-siana-open
  data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e"
  data-siana-date="2026-06-15"
>Prenota il 15 giugno</button>

Apri in un canale specifico

Un canale applica prezzi e condizioni propri (partner, azienda, una promozione...), e li configuri in Siana. In un link diretto il canale è il prefisso del sottodominio (promo-tudominio.com); integrato, si passa con data-siana-channel.

<!-- Come link: il canale va nel sottodominio -->
<a href="https://promo-reservas.tuhotel.com">Prenota</a>

<!-- O integrato (data-siana-channel) -->
<button data-siana-open data-siana-channel="promo">Prenota</button>

Apri filtrato per categoria

Filtra il catalogo a una categoria (il suo slug in Siana) con il parametro ?exp=<categoria>. Nel demo usiamo masajes-corporales.

<!-- Come link -->
<a href="https://reservas.tuhotel.com/?exp=masajes-corporales">Vedi categoria</a>

<!-- O integrato (data-siana-exp) -->
<button data-siana-open data-siana-exp="masajes-corporales">Vedi categoria</button>

Prefisso siana_* nei query params dell'host

Tutto quanto sopra —servizio, data, lingua, canale, categoria— può anche essere attivato dall'URL della tua pagina, senza toccare lo snippet. Prima, due spazi dei nomi che conviene non mescolare:

StratoConvenzioneDove vive
SDK (HTML) data-siana-* Attributi del pulsante o contenitore nella tua pagina. data-siana-service, data-siana-date, ecc. Il prefisso data-siana- namespacea già l'SDK — non collide con nulla.
URL (host) siana_* Query params nell'URL della tua pagina. ?siana_service=…&siana_date=…. Il prefisso evita che collidano con params propri del tuo sito (molte persone usano ?service o ?id per altre cose).

Deep-linking automatico. L'SDK legge la query della tua pagina e sovrascrive con essa i data-siana-* dello snippet: l'URL è l'intenzione dinamica; lo snippet, il default statico. Con la stessa pagina integrata, ogni campagna può atterrare in un servizio, data o categoria diversi solo cambiando il link:

// Email della campagna — apre il motore già posizionato nel servizio e nella data
https://tuhotel.com/reservar?siana_service=UUID&siana_date=YYYY-MM-DD&siana_exp=masajes-corporales

Parametri supportati: siana_service, siana_date, siana_exp, siana_locale, siana_view, siana_purchase_mode, siana_currency, siana_channel e siana_group.

Il motore accetta lo stesso prefisso anche se costruisci manualmente l'URL dell'iframe (integrazione avanzata, senza SDK):

<iframe src="https://reservas.tuhotel.com/?embed=1&siana_service=UUID"></iframe>

L'importante: l'SDK legge dal tuo URL solo questa allowlist di contenuti. Le credenziali (token, locator, pin) e la struttura dell'embed (modalità, dimensioni, tema, sessione, callback) non vengono mai lette da un URL condivisibile: per il ritorno con locator/PIN continui a leggere window.location.search e a passarlo come attributi data-siana-* (vedi caso R).

Passo 4

Ritorno dal pagamento

Aprire direttamente la conferma di una prenotazione

data-siana-locator punta l'iframe a /purchase/{LOCATOR} invece che al catalogo. Serve per i link "Rivedi la tua prenotazione" nelle email, nell'area clienti o nella landing page post-pagamento. Se il cliente non ha convalidato il PIN in questo browser, il motore glielo chiede.

<button
  type="button"
  data-siana-open
  data-siana-locator="abcd-1234-efgh-5678"
  data-siana-mode="drawer"
  data-siana-chrome="minimal"
>Rivedi la tua prenotazione</button>

data-siana-locator ha priorità su data-siana-service e data-siana-view — la pagina di conferma è autosufficiente.

Locator + PIN (ritorno dal pagamento)

Redsys, PayPal e Bizum reindirizzano il cliente dalla schermata per convalidare il pagamento con la propria banca e poi lo riportano a una pagina del tuo dominio. Creerai tu questa pagina —ad esempio /confirmation— e ce la passerai come return_url: Siana reindirizza il cliente lì con ?siana_locator=…&siana_pin=… (il prefisso siana_, come nel caso P). La tua pagina abbina questi due valori in data-siana-locator e data-siana-pin, e il motore apre la conferma da solo, senza chiedere il PIN.

<!-- Versione statica (locator + PIN conosciuti al momento della build) -->
<button
  type="button"
  data-siana-open
  data-siana-auto-open
  data-siana-locator="abcd-1234-efgh-5678"
  data-siana-pin="fdd2bt"
  data-siana-mode="drawer"
  data-siana-chrome="minimal"
>Rivedi il tuo acquisto</button>

<!-- La tua pagina /confirmation — riceve: ?siana_locator=N-SPD-T5SB-A3EA-9&siana_pin=fdd2bt -->
<div id="siana-confirmation"></div>
<script>
  var params = new URLSearchParams(window.location.search)
  var locator = (params.get('siana_locator') || '').trim()
  var pin = (params.get('d3226782744ce122d789ea8e03d32f53') || params.get('siana_pin') || '').trim()
  if (locator && pin) {
    var btn = document.createElement('button')
    btn.setAttribute('data-siana-open', '')
    btn.setAttribute('data-siana-auto-open', '')
    btn.setAttribute('data-siana-locator', locator)
    btn.setAttribute('data-siana-pin', pin)
    btn.setAttribute('data-siana-mode', 'drawer')
    btn.setAttribute('data-siana-chrome', 'minimal')
    btn.textContent = 'Rivedi il tuo acquisto'
    document.getElementById('siana-confirmation').appendChild(btn)
  }
</script>
<script src="https://reservas.tuhotel.com/embed.js"></script>

Senza locator il PIN non viene inoltrato. data-siana-pin da solo viene ignorato (con avviso in console).

Provalo. Il pulsante apre una pagina di esempio /confirmation —la stessa del codice sopra— con i parametri che Redsys emetterebbe al ritorno del cliente. Legge siana_locator e siana_pin e avvia il motore con la conferma, senza chiedere nulla.

Simula il ritorno dalla banca →
Passo 5

Il tuo brand

Colori, tipografia e arrotondamento tramite query params

Il motore adotta i colori del tuo brand. L'abitudine è fissarli dalla tua configurazione (pannello), ma puoi anche forzare o visualizzare in anteprima una palette aggiungendo parametri theme_* all'URL del motore — utile per mostrare varianti senza toccare la configurazione. L'override si mantiene durante la sessione finché non lo pulisci.

Formato: i colori sono hex di 6 cifre senza # (es. a8456b). Un valore non valido viene ignorato e viene mantenuto il colore predefinito.

ParametroValoreCosa cambia
theme_primaryhex (6, senza #)Colore primario (pulsanti e accenti principali)
theme_primary_lighthexPrimario chiaro (sfondi tenui del primario)
theme_primary_darkhexPrimario scuro (hover / stati)
theme_accenthexColore secondario / accento
theme_accent_lighthexAccento chiaro
theme_text_basehexColore del testo base
theme_body_bghexSfondo della pagina
theme_card_bghexSfondo delle schede
theme_radiussquare · semirounded · roundedArrotondamento degli angoli (non accetta px/rem)
theme_fontOpen Sans · Roboto · Lato · Montserrat
Poppins · Inter · Nunito
Tipografia del motore (solo famiglie consentite; un valore fuori lista viene ignorato)
theme_preset1 – 4Applica una palette completa predefinita (sovrascrive i colori individuali)
theme_cleartrueCancella l'override e torna alla configurazione predefinita

Esempio — primario rosa-caffè, accento blu e angoli arrotondati:

https://reservas.tuhotel.com/?theme_primary=a8456b&theme_primary_light=f3c9da&theme_primary_dark=5b2b3a&theme_accent=1e5fd0&theme_accent_light=bcd6ff&theme_radius=rounded

Scorciatoia con una palette predefinita:

https://reservas.tuhotel.com/?theme_preset=3

La tipografia è anch'essa configurabile con theme_font, all'interno di una lista di famiglie consentite (Open Sans, Roboto, Lato, Montserrat, Poppins, Inter, Nunito). Colori, sfondi, arrotondamento e font si adattano al tuo brand.

Dall'SDK (senza toccare l'URL). Non devi costruire manualmente l'URL del motore: l'SDK inoltra il tema all'iframe per te. Definisci una palette globale con window.SIANA_THEME (si applica a tutti gli embedded della pagina) o una puntuale per pulsante con attributi data-siana-theme-* (sovrascrivono la globale). L'SDK convalida ogni valore e lo traduce nei theme_* della tabella sopra.

// Globale — una volta, prima di embed.js. Si applica a modal, drawer, inline e widget.
<script>
  window.SIANA_THEME = {
    primary: '034c53', primaryDark: '033d42', primaryLight: 'cddbdd',
    accent: 'd07e40', accentLight: 'fff9f0',
    textBase: 'ffffff', bodyBg: 'ffffff', cardBg: 'ffffff',
    radius: 'semirounded', font: 'Open Sans'
  }
</script>
<script src="https://reservas.tuhotel.com/embed.js"></script>

<!-- Override puntuale su un pulsante -->
<button data-siana-open
        data-siana-theme-primary="a8456b"
        data-siana-theme-accent="1e5fd0"
        data-siana-theme-radius="rounded"
        data-siana-theme-font="Poppins">Prenota</button>

// …o dall'API JS
SianaBooking.open({ mode: 'drawer', theme: { primary: '047074', font: 'Open Sans' } })
Attributo SDKChiave in window.SIANA_THEME / APItheme_* equivalente
data-siana-theme-primaryprimarytheme_primary
data-siana-theme-primary-lightprimaryLighttheme_primary_light
data-siana-theme-primary-darkprimaryDarktheme_primary_dark
data-siana-theme-accentaccenttheme_accent
data-siana-theme-accent-lightaccentLighttheme_accent_light
data-siana-theme-text-basetextBasetheme_text_base
data-siana-theme-body-bgbodyBgtheme_body_bg
data-siana-theme-card-bgcardBgtheme_card_bg
data-siana-theme-radiusradiustheme_radius
data-siana-theme-fontfonttheme_font
data-siana-theme-presetpresettheme_preset
data-siana-theme-clearcleartheme_clear

Configura il tuo brand dal pannello di Siana

Per la produzione, la raccomandazione è di non toccare il codice: fissa l'identità del motore una volta dal tuo back office, in Configurazione › Motore di prenotazione. Lì regoli il colore primario e secondario, la tipografia e il formato dei pulsanti (riempito o contorno, e l'arrotondamento degli angoli). Un'anteprima ti mostra come lo vedranno i tuoi clienti; quando è di tuo gradimento, salvi e pubblichi, e tutti gli embedded (modal, drawer, inline, widget) lo riflettono istantaneamente.

Configurazione del tema del nuovo motore di prenotazione nel back office: colori, tipografia e anteprima
Ecco come appare la configurazione del tema nel tuo back office: colori, tipografia e anteprima.

back office o theme_*? Il back office è la fonte di verità e la via per i clienti senza profilo tecnico. I theme_* / data-siana-theme-* del caso S servono per forzare o previsualizzare una variante puntuale dall'integrazione stessa, e sovrascrivono ciò che è configurato nel pannello finché sono presenti.

Integrazione avanzata

Controlla il motore dal tuo codice

Una volta caricato embed.js, espone window.SianaBooking: un'API globale con gli stessi attributi in forma di oggetto. Utile quando il pulsante viene costruito in runtime o da un framework.

// Aprire il motore da JS (modal di default)
window.SianaBooking.open()

// Aprire un servizio specifico nel drawer
window.SianaBooking.open({
  service: '4165d3bc-bf21-5273-a598-d1d308aedf9e',
  mode: 'drawer',
  chrome: 'minimal',
  drawerSide: 'right',
  drawerWidth: 'min(560px,80vw)'
})

// Aprire la conferma di un acquisto
window.SianaBooking.open({
  locator: 'abcd-1234-efgh-5678',
  pin: 'fdd2bt',
  mode: 'drawer'
})

// Montare inline in un elemento
window.SianaBooking.mount(document.getElementById('booking-slot'), {
  chrome: 'minimal',
  minHeight: 640
})

// Chiudere l'overlay attivo
window.SianaBooking.close()

Ascoltare cosa succede all'interno

Il motore emette eventi all'host tramite postMessage v1. Li ricevi con SianaBooking.on(event, handler).

window.SianaBooking.on('ready',            () => console.log('motore pronto'))
window.SianaBooking.on('open',             () => console.log('overlay aperto'))
window.SianaBooking.on('close',            () => console.log('overlay chiuso'))
window.SianaBooking.on('booking:complete', booking => {
  // { id, reference, total, currency }
  myAnalytics.track('purchase', booking)
})
window.SianaBooking.on('error', err => {
  // { code, message } — errore recuperabile, il motore è ancora attivo
  console.warn('[motore]', err.code, err.message)
})
window.SianaBooking.on('cart:count', ({ count }) => {
  // n° di articoli nel carrello — visualizza un badge sul tuo pulsante "Prenota"
  var badge = document.querySelector('#mi-badge')
  if (badge) badge.textContent = count
})

Per integrazioni che non richiedono una pagina di ritorno (Stripe), iscriviti a booking:complete per il tracking. Usa cart:count per mostrare un contatore di articoli sopra il tuo pulsante di apertura. Non hai bisogno di creare nient'altro.

Un contatore del carrello sopra il tuo pulsante

Il motore avvisa ogni volta che il numero di articoli nel carrello cambia con l'evento cart:count. Iscriviti e visualizza un badge sopra il tuo pulsante "Prenota", come in qualsiasi negozio online. Copia e incolla esattamente:

<button id="reservar" data-siana-open data-siana-mode="drawer">
  Prenota
  <span id="cart-badge" hidden>0</span>
</button>

<script src="https://reservas.tuhotel.com/embed.js"></script>
<script>
  var badge = document.getElementById('cart-badge')
  function wire () {
    if (!window.SianaBooking) return false
    window.SianaBooking.on('cart:count', function (e) {
      badge.textContent = e.count
      badge.hidden = e.count === 0          // nascondilo quando è vuoto
    })
    return true
  }
  // embed.js potrebbe caricarsi dopo: riprova finché non esiste
  if (!wire()) { var n = 0; var t = setInterval(function () { if (wire() || ++n > 100) clearInterval(t) }, 50) }
</script>

Il conteggio viene emesso anche all'apertura (con ciò che il cliente aveva salvato nel carrello), così il badge appare corretto fin dal primo momento. Il dato è solo un numero — non contiene informazioni sulla prenotazione.

Il carrello e la navigazione persistono

Se il cliente aggiunge qualcosa al carrello, naviga nel tuo sito e torna alla pagina del motore, il carrello è ancora lì (fino a 6 ore). È isolato dal dominio del tuo sito, quindi due siti diversi che integrano lo stesso motore non condividono mai il carrello.

In un'apertura generica (senza data-siana-service o altra intenzione specifica) il motore inoltre riapre dove il cliente l'aveva lasciato (ultima scheda o catalogo). Se apri con un'intenzione esplicita (service, date, purchase-mode, view=widget, preset, locator), prevale ciò che viene ricevuto e non viene ripristinato.

<!-- riapre dove il cliente l'ha lasciato, con il suo carrello -->
<button data-siana-open data-siana-mode="drawer">Prenota</button>

<!-- inizia sempre dal catalogo (carrello intatto) -->
<button data-siana-open data-siana-mode="drawer" data-siana-fresh>Nuova prenotazione</button>

data-siana-fresh riavvia solo la navigazione: ignora la ripresa e entra nel catalogo. Non svuota il carrello — è la selezione del cliente e cancellarla in silenzio frustra. Se in futuro avrai bisogno di svuotare anche il carrello, verrà aggiunto un attributo esplicito separato.

CSP & sandbox

Se il tuo sito pubblica una politica di sicurezza (CSP), aggiungi il dominio del motore alle direttive:

Content-Security-Policy:
  frame-src https://reservas.tuhotel.com;
  script-src https://reservas.tuhotel.com

Non inserire sandbox nell'iframe. Se la tua piattaforma lo impone, assicurati di includere allow-forms, allow-scripts, allow-same-origin, allow-popups e allow-top-navigation — senza quest'ultimo il passaggio del pagamento fallisce.

Diagnosi

Qualsiasi valore non valido in un data-siana-* viene ignorato con un avviso in console prefissato da [Siana]. Per ispezionare lo stato:

window.SianaBooking.diagnose()
// {
//   engineOrigin: 'https://reservas.tuhotel.com',
//   protocolVersion: 1,
//   modalOpen: false,
//   inlineFrames: 1,
//   lastError: null
// }

Se embed.js non si carica mai, verifica: (1) l'URL dello script, (2) l'header script-src del tuo CSP, (3) che il dominio risolva il DNS. L'SDK controlla anche gli errori ERR_BLOCKED_BY_ORB — di solito significa che embed.js non viene servito con il tipo MIME JavaScript.

Analisi: GA4, Meta Pixel e Tag Manager

Il motore emette dieci eventi di e-commerce verso tre destinazioni indipendenti. Per attivarli, forniscici i tuoi identificativi e li configureremo nella scheda del tuo centro.

StrumentoCosa ci fornisciA cosa serve
Google Analytics 4 il tuo measurement ID (G-XXXXXXXXXX) Riceve i dieci eventi con il loro carico completo di e-commerce: importo, valuta, articoli, quantità. È la fonte per i rapporti di funnel e conversione.
Meta Pixel il tuo pixel ID Riceve gli stessi eventi tradotti nella nomenclatura di Meta, con un carico ridotto. Serve per pubblici personalizzati e per misurare campagne di Facebook e Instagram.
Google Tag Manager il tuo container ID (GTM-XXXXXX) Riceve ogni evento come oggetto attivabile in dataLayer, con i campi di commercio raggruppati in ecommerce. Ti permette di impostare le tue etichette senza che tocchiamo il motore.
EventoQuando si attivaIn Meta Pixel
page_view L'utente ogni cambio di pagina PageView
view_item_list L'utente vede l'elenco dei servizi ViewContent
select_item L'utente clicca su una scheda servizio ViewContent
view_item L'utente apre la scheda di un servizio ViewContent
add_to_cart L'utente aggiunge un servizio al carrello AddToCart
remove_from_cart L'utente rimuove un servizio dal carrello RemoveFromCart
view_cart L'utente apre il carrello ViewContent
begin_checkout L'utente entra nel checkout InitiateCheckout
add_payment_info L'utente avvia il pagamento AddPaymentInfo
purchase L'acquisto dell'utente viene confermato Purchase

Consenso

Il motore implementa Consent Mode v2 e si avvia con tutti i permessi negati. Il consenso per l'analisi abilita GA4; quello per il marketing, Meta Pixel. Sono indipendenti, quindi un utente può accettarne uno e rifiutare l'altro. Conseguenza pratica: i tuoi numeri saranno inferiori al traffico reale, e questa differenza è data dalle persone che non accettano i cookie.

Se non ci fornisci alcun identificativo, non viene caricato alcuno script di terze parti: il motore non invia nulla da nessuna parte. Ogni evento è inoltre arricchito con la valuta attiva e il nome del centro, il che permette di segmentare le catene senza configurare altro.

Se il tuo sito web ha il proprio gestore dei cookie (CMP) e il visitatore ha già accettato o rifiutato, passa quella decisione al motore per non chiedergliela due volte. Ciò che ci passi sostituisce il banner del motore.

ValoreCosa concede
analyticsSolo analisi (GA4)
marketingSolo marketing (Meta Pixel)
analytics,marketingEntrambi
accept-allEntrambi
reject-all · necessary-onlyNessuno: non viene caricato alcuno script di analisi

Motore integrato (modal, drawer o inline)

All’interno dell’iframe non appare il banner del motore: il consenso viene sempre deciso dal tuo sito web. Il motore non lo ricorda tra una visita e l’altra, quindi il tuo sito web deve trasmetterlo a ogni caricamento. Se non arriva, non viene caricato alcuno script di analisi. Ci sono tre modi, combinabili:

  • Attributo data-siana-cookies sul pulsante o sul contenitore del motore, con uno dei valori della tabella. Utile quando conosci già la decisione al momento di renderizzare la pagina.
  • SianaBooking.setConsent({ analytics, marketing }) dall’avviso del tuo CMP, quando il visitatore accetta o cambia la propria scelta. Non ricarica il motore, quindi non si perde né il carrello né il passaggio del pagamento. Puoi chiamarlo prima che il motore si apra: gli viene consegnato non appena è pronto.
  • Parametro siana_cookies nell’URL della tua pagina (ad esempio ?siana_cookies=analytics,marketing), con gli stessi valori.
<!-- Si ya sabes la decisión al cargar la página -->
<button data-siana-open data-siana-cookies="analytics,marketing">Reservar</button>

<script>
  // En el aviso de tu gestor de cookies, cuando el visitante acepta o cambia su elección
  SianaBooking.setConsent({ analytics: true, marketing: false })
</script>

Link esterno (reindirizzamento)

Il motore si apre nella propria pagina e mostra il suo banner. Per non ripeterlo, aggiungi il parametro cookies al link con la decisione già raccolta dal tuo CMP, ad esempio https://tu-spa.bysiana.com/?cookies=analytics,marketing. Il motore la salva e non la chiede più su quel dominio.

Genera il link con la decisione reale del visitatore in quel momento. Non lasciare un ?cookies=accept-all fisso nel tuo HTML: concederebbe il consenso a chi non lo ha dato.

Provieni dal motore precedente? I parametri utb_consent_google-ga4, utb_consent_google-tagmanager e utb_consent_facebook (valore 1 o 0) continuano a funzionare: Google equivale all’analisi e Facebook al marketing.

Domande frequenti: riutilizzare l’analisi esistente

Posso usare gli stessi ID di GA4, Meta Pixel e GTM che uso già sul mio sito web?
Sì, senza restrizioni. Non serve creare un altro measurement ID, un altro pixel ID né un altro contenitore GTM. Ce li fornisci e li configuriamo nella scheda del tuo centro. Gli eventi arrivano alle stesse proprietà e agli stessi account di quelli del tuo sito web.

Devo configurare domini incrociati (cross-domain) o passarvi un ID di sessione?
Dipende dal dominio da cui viene servito il motore. Questa regola vale sia per il link esterno sia per il motore integrato.

  • Sottodominio proprio (CNAME, ad esempio reservas.tuweb.com): condivide la sessione di GA4 e di Meta Pixel con il tuo sito web, purché usi gli stessi ID. Non occorre configurare domini incrociati né passarci un ID di sessione.
  • Dominio di Siana (*.bysiana.com): è un altro dominio, quindi la sessione non continua. Se usi l’analisi, ti consigliamo di usare il tuo sottodominio.

È opportuno verificarlo con GA4 DebugView e con il test degli eventi di Meta.

L’evento purchase funziona con Redsys e con Stripe?
Sì, purchase viene registrato allo stesso modo con qualsiasi gateway. Non c’è incompatibilità con Stripe né con altri metodi di pagamento. Una precisazione: con i gateway che reindirizzano (Redsys, CECA, Reduniq), Meta Pixel non deduplica per ID evento, quindi un nuovo tentativo o un ricaricamento dopo il pagamento può duplicare Purchase in Meta. GA4 deduplica invece per transaction_id. Verifica il dato di Meta prima di considerarlo attendibile.

Posso distribuire GA4 e Meta Pixel da un unico contenitore GTM?
Sì. Forniscici solo l’ID del contenitore (GTM-XXXXXX), senza il measurement ID di GA4 né il pixel ID di Meta. Se ci fornisci tutti e tre e il tuo contenitore attiva già quegli stessi tag, gli eventi si duplicano, perché il motore carica ogni destinazione in modo indipendente. Il motore invia ogni evento al dataLayer con il suo payload di ecommerce (valore e valuta).

Cosa succede al mio gestore dei cookie (CMP) se integro il motore?
All’interno dell’iframe non viene mostrato il banner del motore: il tuo sito web gli trasmette la decisione del visitatore a ogni caricamento. Se non la riceve, non viene caricato alcuno script di analisi. Come farlo, con un esempio: Se il tuo sito web ha già chiesto il consenso.

Posso rinominare gli eventi (ad esempio, purchase_spa) per non mescolarli con un altro sito o con un altro motore di prenotazioni?
Lo sconsigliamo. GA4 conta come acquisto solo l’evento purchase: un purchase_spa arriverebbe come evento personalizzato, senza entrate. Per separare i dati del motore basta filtrare per nome host (il dominio del motore) o per la marca del prodotto (item_brand, il nome del centro), che è già presente in ogni evento. Se vuoi comunque nomi propri, fallo dal tuo Google Tag Manager: fornisci solo l’ID del contenitore e, al suo interno, decidi con quale nome ogni evento arriva a GA4.

Devo configurare qualcosa in GA4 per via del gateway di pagamento?
Sì: aggiungi il dominio del gateway (ad esempio, sis.redsys.es) a «Referenze indesiderate» in GA4 (Amministrazione → Flussi di dati → Configurare tag). Così, quando l’acquirente torna dal pagamento, GA4 non apre una nuova sessione attribuita alla banca.

Vedo il dataLayer vuoto, perché?
Ci sono due possibili motivi, ed entrambi sono normali: non abbiamo ancora configurato i tuoi ID, oppure il visitatore non ha accettato i cookie nel banner del motore. Per verificarlo, entra nel motore, accetta i cookie e scrivi dataLayer nella console del browser.

Riferimento

Tabella completa degli attributi

Tutti i data-siana-* riconosciuti dall'SDK v1. Vanno posti sull'elemento che apre o integra il motore: un pulsante con data-siana-open, o un contenitore con data-siana-inline.

AttributoValoreEffetto
data-siana-open(nessun valore)Contrassegna un elemento come trigger dell'overlay (modale o drawer)
data-siana-inline(nessun valore)Contrassegna un contenitore per integrare il motore nella pagina stessa
data-siana-auto-open(nessun valore)Attiva il click automaticamente al caricamento del DOM
data-siana-modemodal · drawerTipo di overlay (default modal). Ignorato in inline
data-siana-chromefull · minimalminimal nasconde breadcrumbs, freccia indietro e info del centro
data-siana-serviceUUIDPre-seleziona un servizio (atterra sulla sua scheda)
data-siana-viewfull · widgetwidget = solo riquadro di prenotazione (richiede service)
data-siana-locator4-128 [a-z0-9-]Punta alla conferma di un acquisto esistente
data-siana-pin3-128 [a-z0-9]PIN auto-validato (richiede locator)
data-siana-dateYYYY-MM-DDData pre-selezionata
data-siana-localees · en · fr · …Lingua iniziale del motore
data-siana-drawer-sideright · leftLato del drawer (default right)
data-siana-drawer-widthCSS lengthLarghezza del drawer (default min(480px,80vw))
data-siana-modal-widthpx · %Larghezza del modale
data-siana-modal-heightpx · %Altezza del modale
data-siana-min-heightpxAltezza iniziale inline prima del primo resize
data-siana-session-id1-128 [A-Za-z0-9_-]Il tuo riferimento di prenotazione — torna nell'handoff per correlare
data-siana-item-id1-128 [a-z0-9_-]Articolo da rimuovere (delete mode) → il motore emette cart:remove
data-siana-callback-urlhttps URLEndpoint server-side che riceve lo stesso payload dell'handoff tramite POST
data-siana-purchase-modevoucher · appointment · bothFiltra il catalogo: solo buoni, solo appuntamenti, o tutto (default both)
data-siana-expslug di categoriaFiltra il catalogo a una categoria (il suo slug in Siana)
data-siana-channelslug di canaleApplica un canale con prezzi e condizioni proprie (configurato in Siana)
data-siana-currencyISO 4217 (EUR, GBP…)Valuta di visualizzazione iniziale
data-siana-groupidentificatore di gruppoPre-seleziona il gruppo di clienti
data-siana-hide-add-to-cart1 · trueNasconde il pulsante "aggiungi al carrello" (acquisto diretto, senza carrello)
data-siana-fresh1 · trueApre pulito: ignora la ripresa del percorso ed entra nel catalogo. Non tocca il carrello (vedi persistenza)