Uma linha, todos os casos.
Este guia percorre, passo a passo e caso a caso, os atributos
data-siana-* que o SDK reconhece, as chamadas de
window.SianaBooking e os fluxos completos
(modal, drawer, inline, widget, recuperação pós-pagamento). Copia,
cola, substitui o teu subdomínio. Não há pacote para instalar.
Índice de casos
- Passo 1 · Como mostrar o motor
- A O script e nada mais
- B Modal centrado
- C Drawer lateral
- D Integrado (como uma secção mais)
- E Esconder a navegação do motor
- F Abrir automaticamente ao carregar a página
- G Larguras do modal e do drawer
- H Uma ligação, sem código
- Passo 2 · O teu domínio
- I Que domínio queres utilizar?
- Passo 3 · O que mostrar
- J Aterrar na ficha do tratamento
- K Apenas o quadro de reserva
- L Forçar o idioma de entrada
- M Preencher a data
- N Link por canal (subdomínio)
- O Link por categoria (?exp=)
- P Deep-linking por URL (prefixo siana_*)
- Passo 4 · Regresso do pagamento
- Q Abrir diretamente a confirmação de uma reserva
- R Localizador + PIN (regresso do pagamento)
- Passo 5 · A tua marca
- S Cores, tipografia e arredondamento por query params
- T Configura a tua marca a partir do painel da Siana
- Integração avançada
- U Controla o motor a partir do teu código
- V Ouvir o que acontece por dentro
- W Um contador de carrinho sobre o teu botão
- X O carrinho e a navegação sobrevivem
- Y CSP & sandbox
- Z Diagnóstico
- AA Analítica: GA4, Meta Pixel e Tag Manager
- Referência
- AB Tabela completa de atributos
Como mostrar o motor
O script e nada mais
Cola este <script> apenas uma vez em cada página onde queres que o motor apareça — idealmente antes de </body>. Não há pacote para instalar; o script é descarregado do subdomínio que a Siana te atribui.
<script src="https://reservas.tuhotel.com/embed.js"></script>
O script não pinta nada por si só. Apenas reage aos elementos com marcas data-siana-* que adicionares abaixo (ou que apareçam depois no DOM — ouve mutações).
Modal centrado
Marca qualquer botão com data-siana-open. Ao premir, o motor abre-se numa camada centrada sobre a tua web. Fecha com o X interno, Esc ou clique no fundo.
<button type="button" data-siana-open>Reservar</button>
Drawer lateral
Mesmo botão com data-siana-mode="drawer". Entra pela direita (predefinição), ou pela esquerda com data-siana-drawer-side="left". A largura é controlada com data-siana-drawer-width (aceita px, %, vw e funções 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)" >Reservar</button>
Inline (como uma secção adicional)
Um <div data-siana-inline></div> vazio serve de espaço. O script monta o iframe dentro e redimensiona-o automaticamente à medida que o conteúdo cresce — não precisa de medir alturas.
<h1>Reserve a sua experiência</h1> <div data-siana-inline data-siana-chrome="minimal"></div>
data-siana-mode é ignorado dentro de data-siana-inline — o contentor inline não pode tornar-se um overlay, mesmo que seja solicitado.
Para o idioma do motor integrado, consulte o caso L.
Não integre o motor com um <iframe> escrito à mão. Use sempre o bloco div + script. Com um iframe manual, o motor aparece no idioma predefinido, mostra o seu próprio aviso de cookies e não ajusta a altura, pelo que o conteúdo fica cortado ou deixa um espaço vazio.
Esconder a navegação do motor
data-siana-chrome="minimal" oculta os breadcrumbs, a seta "voltar" e o bloco de informação central. Útil quando o motor está integrado num contexto que já fornece a sua própria navegação (uma ficha, um drawer, uma secção inline).
<button type="button" data-siana-open data-siana-chrome="minimal" >Reservar</button>
Abertura automática ao carregar a página
Marque o botão com data-siana-auto-open (sem valor) e o SDK irá "clicá-lo" assim que o DOM estiver pronto. Padrão típico da página de retorno do Redsys: o cliente chega, o drawer abre-se sozinho, a confirmação é mostrada.
<button type="button" data-siana-open data-siana-auto-open data-siana-locator="abcd-1234" data-siana-pin="fdd2bt" data-siana-mode="drawer" >A carregar…</button>Simular o retorno do Redsys →
Se adicionar data-siana-auto-open a vários elementos, apenas o primeiro é ativado (com aviso).
Larguras do modal e do drawer
Apenas modal: data-siana-modal-width, data-siana-modal-height (px ou %).
Apenas drawer: data-siana-drawer-width (px, %, vw, ou CSS min/max/clamp) — padrão min(480px,80vw).
Inline (antes do primeiro redimensionamento): data-siana-min-height em px.
<button type="button" data-siana-open data-siana-modal-width="720px" data-siana-modal-height="80%" >Modal estreito</button> <button type="button" data-siana-open data-siana-mode="drawer" data-siana-drawer-width="clamp(360px, 50vw, 720px)" >Drawer fluído</button> <div data-siana-inline data-siana-min-height="640"></div>
Um link, sem código
A forma mais simples de todas: um link normal para o endereço do motor. O cliente chega à página de reserva na sua própria página ou separador. Zero JavaScript, sem script para instalar — pode ativá-la em poucos minutos, sem depender de ninguém.
<a href="https://163-f1401005.bysiana.com">Reservar</a>
É a opção recomendada para começar sem ajuda técnica. Quando quiser que o motor apareça em cima do seu website sem mudar de página, passe para o modal (B), para o painel (C) ou para o integrado (D).
O seu domínio
Que domínio quer usar?
Antes de configurar o domínio, decida como quer que o motor funcione no seu website (Passo 1). Em todos os casos, disponibilizamos-lhe um endereço pronto a usar, sem que precise de tocar em nada. Se abrir como link externo —o redirecionamento—, não há nenhuma configuração DNS da sua parte. Se o motor estiver integrado no seu website (modal, drawer ou inline), não precisa de configurar nada para que funcione: o domínio próprio (CNAME) é opcional e só é necessário se quiser que o motor seja servido a partir do seu domínio.
Opção A — Motor com link externo
O cliente clica num botão do seu website e o motor abre numa nova página. Tem duas alternativas e nenhuma requer configuração técnica:
A1 · Usar o domínio de bysiana.com. Diga-nos qual o alias personalizado que pretende utilizar —por exemplo o-seu-spa.bysiana.com— e nós fornecemos-lhe o link sob o nosso domínio, pronto a usar.
A2 · Usar o seu próprio domínio. Se preferir que o link tenha a sua marca —por exemplo reservas.o-seu-dominio.com—, escreva-nos para soporte@spalopia.com indicando o domínio que quer usar e nós tratamos da configuração interna necessária.
Opção B — Motor integrado no seu website
O motor aparece integrado na sua própria página (modal, drawer ou inline), sem que o cliente a abandone em nenhum momento. Não precisa de configurar nada para que funcione. O domínio próprio (CNAME) é opcional: se não o configurar, é usado o endereço da Siana e tudo funciona da mesma forma, sem problemas de cookies nem de funcionamento. A única diferença é a analítica: com o seu próprio domínio, GA4 e Meta Pixel partilham a sessão com o seu website; com o endereço da Siana, não (ver Analítica · Dúvidas frequentes).
Se quiser usar o seu próprio domínio, escreva-nos para soporte@spalopia.com indicando o domínio e nós tratamos da configuração interna.
O que mostrar
Aterrar na ficha do tratamento
Quando o seu próprio cartão já descreve o tratamento, salte a lista: passe o UUID do serviço com data-siana-service e o iframe abre diretamente a ficha (PDP).
<button type="button" data-siana-open data-siana-mode="drawer" data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e" data-siana-chrome="minimal" >Reservar massagem</button>
Combine com data-siana-chrome="minimal" para ocultar a seta "voltar" do motor — não tem para onde voltar, o cliente vinha do seu cartão.
Apenas a caixa de reserva
data-siana-view="widget" renderiza unicamente o bloco "Pessoas + Data + Reservar" do serviço — sem descrição, imagens nem recomendações. Necessita de um data-siana-service válido.
<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" >Reservar (widget)</button>
Forçar o idioma de entrada
data-siana-locale inicia o motor no idioma que indicar. Se o seu site já tem um seletor de idioma, passe-o aqui para que o motor herde o contexto.
<button type="button" data-siana-open data-siana-locale="en">Book</button>
Com o motor integrado, coloque um bloco completo em cada página:
<!-- Página em espanhol --> <div data-siana-inline data-siana-locale="es"></div> <script src="https://TU-CENTRO.bysiana.com/embed.js" async></script> <!-- Página em inglês --> <div data-siana-inline data-siana-locale="en"></div> <script src="https://TU-CENTRO.bysiana.com/embed.js" async></script> <!-- Página em alemão --> <div data-siana-inline data-siana-locale="de"></div> <script src="https://TU-CENTRO.bysiana.com/embed.js" async></script>
O script é o mesmo em todas as páginas: só muda data-siana-locale.
Site em vários idiomas
- Se o seu site tem uma página por idioma (por exemplo
/es/reservas,/en/bookingou subdomínios comoen.miweb.com), coloque o bloco em cada página com o respetivo idioma. - Se o seu site muda de idioma com um parâmetro no URL, pode usar
?siana_locale=en(caso P), que tem prioridade sobre o atributo.
Idiomas suportados: es · en · de · fr · it · pt · ca · eu · nl · ru.
Pré-preencher data
data-siana-date="YYYY-MM-DD" chega ao motor como query param para iniciar com essa data pré-selecionada quando o serviço o suporta.
<button type="button" data-siana-open data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e" data-siana-date="2026-06-15" >Reservar a 15 de junho</button>
Abrir num canal concreto
Um canal aplica preços e condições próprios (parceiros, empresa, uma promoção…), e configura-os em Siana. Num link direto o canal é o prefixo do subdomínio (promo-tudominio.com); integrado, passa-se com data-siana-channel.
<!-- Como link: o canal vai no subdomínio --> <a href="https://promo-reservas.tuhotel.com">Reservar</a> <!-- Ou integrado (data-siana-channel) --> <button data-siana-open data-siana-channel="promo">Reservar</button>
Abrir filtrado por categoria
Filtra o catálogo para uma categoria (o seu slug em Siana) com o parâmetro ?exp=<categoria>. Na demonstração usamos masajes-corporales.
<!-- Como link --> <a href="https://reservas.tuhotel.com/?exp=masajes-corporales">Ver categoria</a> <!-- Ou integrado (data-siana-exp) --> <button data-siana-open data-siana-exp="masajes-corporales">Ver categoria</button>
Prefixo siana_* em query params do host
Tudo o que precede —serviço, data, idioma, canal, categoria— também pode ser acionado a partir do URL da sua página, sem tocar no snippet. Antes, dois espaços de nomes que convém não misturar:
| Camada | Convenção | Onde vive |
|---|---|---|
| SDK (HTML) | data-siana-* | Atributos do botão ou contentor na sua página. data-siana-service, data-siana-date, etc. O prefixo data-siana- já faz o namespace do SDK — não colide com nada. |
| URL (host) | siana_* | Query params no URL da sua página. ?siana_service=…&siana_date=…. O prefixo evita que colidam com params próprios do seu site (muita gente usa ?service ou ?id para outras coisas). |
Deep-linking automático. O SDK lê a query da sua página e sobrescreve com ela os data-siana-* do snippet: o URL é a intenção dinâmica; o snippet, o default estático. Com a mesma página integrada, cada campanha pode aterrar num serviço, data ou categoria distintos apenas mudando o link:
// Email de campanha — abre o motor já posicionado no serviço e na data
https://tuhotel.com/reservar?siana_service=UUID&siana_date=YYYY-MM-DD&siana_exp=masajes-corporales
Parâmetros suportados: siana_service, siana_date, siana_exp, siana_locale, siana_view, siana_purchase_mode, siana_currency, siana_channel e siana_group.
O motor também aceita o mesmo prefixo se construir manualmente o URL do iframe (integração avançada, sem SDK):
<iframe src="https://reservas.tuhotel.com/?embed=1&siana_service=UUID"></iframe>
O importante: o SDK apenas lê da sua URL essa *allowlist* de conteúdo. As credenciais (token, locator, pin) e a estrutura do embed (modo, tamanhos, tema, sessão, *callback*) nunca são lidas de um URL partilhável: para o retorno com locator/PIN continua a ler window.location.search e a passá-lo como atributos data-siana-* (ver caso R).
Volta do pagamento
Abrir diretamente a confirmação de uma reserva
data-siana-locator aponta o iframe para /purchase/{LOCATOR} em vez do catálogo. Serve para links "Rever a sua reserva" em emails, área de cliente ou *landing page* pós-pagamento. Se o cliente não validou o PIN neste navegador, o motor pede-o.
<button type="button" data-siana-open data-siana-locator="abcd-1234-efgh-5678" data-siana-mode="drawer" data-siana-chrome="minimal" >Rever a sua reserva</button>
data-siana-locator tem prioridade sobre data-siana-service e data-siana-view — a página de confirmação é autossuficiente.
Locator + PIN (volta do pagamento)
Redsys, PayPal e Bizum tiram o cliente do ecrã para validar o pagamento com o seu banco e depois devolvem-no a uma página do seu próprio domínio. Cria essa página —por exemplo /confirmation— e passa-nos como return_url: Siana devolve o cliente aí com ?siana_locator=…&siana_pin=… (o prefixo siana_, como no caso P). A sua página emparelha esses dois valores em data-siana-locator e data-siana-pin, e o motor abre a confirmação sozinho, sem pedir o PIN.
<!-- Versão estática (locator + PIN conhecidos em build time) -->
<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"
>Rever a sua compra</button>
<!-- A sua página /confirmation — recebe: ?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 = 'Rever a sua compra'
document.getElementById('siana-confirmation').appendChild(btn)
}
</script>
<script src="https://reservas.tuhotel.com/embed.js"></script>
Sem locator o PIN não é encaminhado. data-siana-pin isolado é ignorado (com aviso na consola).
Experimente. O botão abre uma página de exemplo /confirmation —a mesma do código acima— com os parâmetros que o Redsys emitiria ao devolver o cliente. Lê siana_locator e siana_pin e ativa o motor com a confirmação, sem pedir nada.
A sua marca
Cores, tipografia e arredondamento por query params
O motor adota as cores da sua marca. O habitual é defini-los a partir da sua configuração (painel), mas também pode forçar ou pré-visualizar uma paleta adicionando parâmetros theme_* ao URL do motor — útil para mostrar variantes sem alterar a configuração. O *override* mantém-se durante a sessão até que o limpe.
Formato: as cores são hexadecimais de 6 dígitos sem # (p. ex. a8456b). Um valor inválido é ignorado e a cor predefinida é mantida.
| Parâmetro | Valor | O que muda |
|---|---|---|
| theme_primary | hex (6, sem #) | Cor primária (botões e principais detalhes) |
| theme_primary_light | hex | Primário claro (fundos suaves do primário) |
| theme_primary_dark | hex | Primário escuro (hover / estados) |
| theme_accent | hex | Cor secundária / destaque |
| theme_accent_light | hex | Destaque claro |
| theme_text_base | hex | Cor do texto base |
| theme_body_bg | hex | Fundo da página |
| theme_card_bg | hex | Fundo dos cartões |
| theme_radius | square · semirounded · rounded | Arredondamento dos cantos (não aceita px/rem) |
| theme_font | Open Sans · Roboto · Lato · Montserrat Poppins · Inter · Nunito | Tipografia do motor (apenas famílias permitidas; um valor fora da lista é ignorado) |
| theme_preset | 1 – 4 | Aplica uma paleta completa predefinida (substitui as cores individuais) |
| theme_clear | true | Apaga a substituição e volta à configuração predefinida |
Exemplo — primário rosa-acastanhado, destaque azul e cantos arredondados:
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
Atalho com uma paleta predefinida:
https://reservas.tuhotel.com/?theme_preset=3
A tipografia também é configurável com theme_font, dentro de uma lista de famílias permitidas (Open Sans, Roboto, Lato, Montserrat, Poppins, Inter, Nunito). Cores, fundos, arredondamento e tipo de letra adaptam-se à sua marca.
A partir do SDK (sem tocar no URL). Não precisa de construir o URL do motor manualmente: o SDK reencaminha o tema para o iframe por si. Defina uma paleta global com window.SIANA_THEME (aplica-se a todos os integrados da página) ou uma pontual por botão com atributos data-siana-theme-* (substituem a global). O SDK valida cada valor e traduz para os theme_* da tabela acima.
// Global — uma vez, antes de embed.js. Aplica-se 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> <!-- Substituição pontual num botão --> <button data-siana-open data-siana-theme-primary="a8456b" data-siana-theme-accent="1e5fd0" data-siana-theme-radius="rounded" data-siana-theme-font="Poppins">Reservar</button> // …ou a partir da API JS SianaBooking.open({ mode: 'drawer', theme: { primary: '047074', font: 'Open Sans' } })
| Atributo SDK | Chave em window.SIANA_THEME / API | theme_* equivalente |
|---|---|---|
| data-siana-theme-primary | primary | theme_primary |
| data-siana-theme-primary-light | primaryLight | theme_primary_light |
| data-siana-theme-primary-dark | primaryDark | theme_primary_dark |
| data-siana-theme-accent | accent | theme_accent |
| data-siana-theme-accent-light | accentLight | theme_accent_light |
| data-siana-theme-text-base | textBase | theme_text_base |
| data-siana-theme-body-bg | bodyBg | theme_body_bg |
| data-siana-theme-card-bg | cardBg | theme_card_bg |
| data-siana-theme-radius | radius | theme_radius |
| data-siana-theme-font | font | theme_font |
| data-siana-theme-preset | preset | theme_preset |
| data-siana-theme-clear | clear | theme_clear |
Configure a sua marca a partir do painel da Siana
O recomendado para produção é não tocar no código: defina a identidade do motor uma vez a partir do seu back office, em Configuração › Motor de reservas. Aí ajusta a cor primária e secundária, a tipografia e o formato dos botões (preenchimento ou contorno, e o arredondamento dos cantos). Uma pré-visualização mostra-lhe como os seus clientes o verão; quando estiver ao seu gosto, guarda e publica, e todos os integrados (modal, drawer, inline, widget) refletem-no instantaneamente.
back office ou theme_*? O back office é a fonte de verdade e o caminho para clientes sem perfil técnico. Os theme_* / data-siana-theme-* do caso S servem para forçar ou pré-visualizar uma variante pontual a partir da própria integração, e substituem o que está configurado no painel enquanto estão presentes.
Integração avançada
Controle o motor a partir do seu código
Uma vez carregado embed.js, expõe window.SianaBooking: uma API global com os mesmos atributos em forma de objeto. Útil quando o botão é construído em runtime ou a partir de um framework.
// Abrir o motor a partir de JS (modal padrão)
window.SianaBooking.open()
// Abrir um serviço concreto em drawer
window.SianaBooking.open({
service: '4165d3bc-bf21-5273-a598-d1d308aedf9e',
mode: 'drawer',
chrome: 'minimal',
drawerSide: 'right',
drawerWidth: 'min(560px,80vw)'
})
// Abrir a confirmação de uma compra
window.SianaBooking.open({
locator: 'abcd-1234-efgh-5678',
pin: 'fdd2bt',
mode: 'drawer'
})
// Montar inline num elemento
window.SianaBooking.mount(document.getElementById('booking-slot'), {
chrome: 'minimal',
minHeight: 640
})
// Fechar o overlay ativo
window.SianaBooking.close()
Ouvir o que acontece dentro
O motor emite eventos para o host via postMessage v1. Recebe-os com SianaBooking.on(event, handler).
window.SianaBooking.on('ready', () => console.log('motor pronto'))
window.SianaBooking.on('open', () => console.log('overlay aberto'))
window.SianaBooking.on('close', () => console.log('overlay fechado'))
window.SianaBooking.on('booking:complete', booking => {
// { id, reference, total, currency }
myAnalytics.track('purchase', booking)
})
window.SianaBooking.on('error', err => {
// { code, message } — erro recuperável, o motor continua ativo
console.warn('[motor]', err.code, err.message)
})
window.SianaBooking.on('cart:count', ({ count }) => {
// nº de itens no carrinho — pinta um badge no seu botão "Reservar"
var badge = document.querySelector('#mi-badge')
if (badge) badge.textContent = count
})
Para integrações que não requerem página de retorno (Stripe), subscreva booking:complete para tracking. Use cart:count para mostrar um contador de itens no seu botão de abertura. Não precisa de criar mais nada.
Um contador de carrinho sobre o seu botão
O motor avisa cada vez que o número de itens no carrinho muda com o evento cart:count. Subscreva e mostre um badge sobre o seu botão "Reservar", como em qualquer loja online. Copie-cole tal e qual:
<button id="reservar" data-siana-open data-siana-mode="drawer">
Reservar
<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 // esconde-o quando está vazio
})
return true
}
// embed.js pode carregar depois: tenta novamente até que exista
if (!wire()) { var n = 0; var t = setInterval(function () { if (wire() || ++n > 100) clearInterval(t) }, 50) }
</script>
A contagem é emitida também ao abrir (com o que o cliente tivesse guardado no carrinho), assim o badge aparece correto desde o primeiro momento. O dado é apenas um número — não contém informação da reserva.
O carrinho e a navegação sobrevivem
Se o cliente adicionar algo ao carrinho, navegar pelo seu site e voltar à página do motor, o carrinho continua lá (até 6 h). Está isolado pelo domínio do seu site, assim dois sites distintos que integrem o mesmo motor nunca partilham carrinho.
Numa abertura genérica (sem data-siana-service nem outra intenção concreta) o motor além disso reabre onde o cliente deixou (última ficha ou catálogo). Se abrir com uma intenção explícita (service, date, purchase-mode, view=widget, preset, locator), manda o que chega e não é retomado.
<!-- reabre onde o cliente deixou, com o seu carrinho --> <button data-siana-open data-siana-mode="drawer">Reservar</button> <!-- começa sempre no catálogo (carrinho intacto) --> <button data-siana-open data-siana-mode="drawer" data-siana-fresh>Nova reserva</button>
data-siana-fresh apenas reinicia a navegação: ignora a retoma e entra no catálogo. Não esvazia o carrinho — é a seleção do cliente e apagá-la em silêncio frustra. Se no futuro precisar de esvaziar também o carrinho, seria adicionado um atributo à parte explícito.
CSP & sandbox
Se o seu site publicar uma política de segurança (CSP), adicione o domínio do motor às diretivas:
Content-Security-Policy: frame-src https://reservas.tuhotel.com; script-src https://reservas.tuhotel.com
Não coloque sandbox no iframe. Se a sua plataforma o força, certifique-se de incluir allow-forms, allow-scripts, allow-same-origin, allow-popups e allow-top-navigation — sem este último, o passo de pagamento falha.
Diagnóstico
Qualquer valor inválido num data-siana-* é ignorado com um aviso na consola prefixado por [Siana]. Para inspecionar o estado:
window.SianaBooking.diagnose()
// {
// engineOrigin: 'https://reservas.tuhotel.com',
// protocolVersion: 1,
// modalOpen: false,
// inlineFrames: 1,
// lastError: null
// }
Se embed.js nunca carregar, verifique: (1) o URL do script, (2) o cabeçalho script-src do seu CSP, (3) se o domínio resolve DNS. O SDK também monitoriza erros ERR_BLOCKED_BY_ORB — geralmente significa que embed.js não é servido com tipo MIME JavaScript.
Analítica: GA4, Meta Pixel e Tag Manager
O motor emite dez eventos de comércio eletrónico para três destinos independentes. Para ativá-los, passe-nos os seus identificadores e nós configuramo-los na ficha do seu centro.
| Ferramenta | O que nos passa | Para que serve |
|---|---|---|
| Google Analytics 4 | o seu measurement ID (G-XXXXXXXXXX) |
Recebe os dez eventos com a sua carga completa de comércio eletrónico: valor, moeda, artigos, quantidades. É a fonte para relatórios de funil e conversão. |
| Meta Pixel | o seu pixel ID | Recebe os mesmos eventos traduzidos para a nomenclatura da Meta, com uma carga reduzida. Serve para públicos personalizados e para medir campanhas de Facebook e Instagram. |
| Google Tag Manager | o seu container ID (GTM-XXXXXX) |
Recebe cada evento como objeto acionável em dataLayer, com os campos de comércio agrupados em ecommerce. Permite-lhe montar as suas próprias tags sem que toquemos no motor. |
| Evento | Quando é acionado | No Meta Pixel |
|---|---|---|
page_view |
O utilizador cada mudança de página | PageView |
view_item_list |
O utilizador vê a listagem de serviços | ViewContent |
select_item |
O utilizador clica num cartão de serviço | ViewContent |
view_item |
O utilizador abre a ficha de um serviço | ViewContent |
add_to_cart |
O utilizador adiciona um serviço ao carrinho | AddToCart |
remove_from_cart |
O utilizador remove um serviço do carrinho | RemoveFromCart |
view_cart |
O utilizador abre o carrinho | ViewContent |
begin_checkout |
O utilizador entra no checkout | InitiateCheckout |
add_payment_info |
O utilizador inicia o pagamento | AddPaymentInfo |
purchase |
O utilizador a compra fica confirmada | Purchase |
Consentimento
O motor implementa Consent Mode v2 e arranca com todas as permissões negadas. O consentimento de analítica habilita GA4; o de marketing, Meta Pixel. São independentes, pelo que um utilizador pode aceitar um e rejeitar o outro. Consequência prática: os seus números serão menores que o tráfego real, e essa diferença é a gente que não aceita cookies.
Se não nos passar nenhum identificador, nenhum script de terceiros é carregado: o motor não envia nada para parte alguma. Cada evento é enriquecido ainda com a moeda ativa e o nome do centro, o que permite segmentar cadeias sem configurar mais nada.
Se o seu website já pediu o consentimento
Se o seu website tem o seu próprio gestor de cookies (CMP) e o visitante já aceitou ou rejeitou, passe essa decisão ao motor para não lhe perguntar duas vezes. O que nos passar substitui o banner do motor.
| Valor | O que concede |
|---|---|
analytics | Só analítica (GA4) |
marketing | Só marketing (Meta Pixel) |
analytics,marketing | Ambas |
accept-all | Ambas |
reject-all · necessary-only | Nenhuma: não é carregado nenhum script de analítica |
Motor integrado (modal, drawer ou inline)
Dentro do iframe não aparece o banner do motor: o consentimento é sempre decidido pelo seu website. O motor não o recorda entre visitas, pelo que o seu website tem de o transmitir em cada carregamento. Se não chegar, não é carregado nenhum script de analítica. Há três formas, combináveis:
- Atributo
data-siana-cookiesno botão ou contentor do motor, com um dos valores da tabela. Útil quando já conhece a decisão ao apresentar a página. SianaBooking.setConsent({ analytics, marketing })a partir do aviso do seu CMP, quando o visitante aceita ou altera a sua escolha. Não recarrega o motor, pelo que não se perde nem o carrinho nem o passo do pagamento. Pode chamá-lo antes de o motor abrir: é-lhe entregue assim que estiver pronto.- Parâmetro
siana_cookiesno URL da sua própria página (por exemplo?siana_cookies=analytics,marketing), com os mesmos valores.
<!-- 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 externo (redirecionamento)
O motor abre na sua própria página e mostra o seu banner. Para não o repetir, adicione o parâmetro cookies ao link com a decisão que o seu CMP já recolheu, por exemplo https://tu-spa.bysiana.com/?cookies=analytics,marketing. O motor guarda-a e não volta a perguntar nesse domínio.
Gere o link com a decisão real do visitante nesse momento. Não deixe um ?cookies=accept-all fixo no seu HTML: concederia o consentimento a quem não o deu.
Vem do motor anterior? Os parâmetros utb_consent_google-ga4, utb_consent_google-tagmanager e utb_consent_facebook (valor 1 ou 0) continuam a funcionar: Google equivale a analítica e Facebook a marketing.
Dúvidas frequentes: reutilizar analítica existente
Posso usar os mesmos IDs de GA4, Meta Pixel e GTM que já uso no meu website?
Sim, sem restrições. Não é necessário criar outro measurement ID, outro pixel ID nem outro contentor GTM. Fornece-nos esses dados e nós configuramo-los na ficha do seu centro. Os eventos chegam às mesmas propriedades e contas que os do seu website.
Tenho de configurar domínios cruzados (cross-domain) ou passar-vos um ID de sessão?
Depende do domínio a partir do qual o motor é servido. Esta regra aplica-se tanto ao link externo como ao motor integrado.
- Subdomínio próprio (CNAME, por exemplo
reservas.tuweb.com): partilha a sessão de GA4 e de Meta Pixel com o seu website, desde que use os mesmos IDs. Não é necessário configurar domínios cruzados nem passar-nos nenhum ID de sessão. - Domínio da Siana (
*.bysiana.com): é outro domínio, pelo que a sessão não continua. Se usa analítica, recomendamos que use o seu subdomínio próprio.
Convém verificar com GA4 DebugView e com o teste de eventos de Meta.
O evento purchase funciona com Redsys e com Stripe?
Sim, purchase é registado da mesma forma com qualquer gateway. Não há incompatibilidade com Stripe nem com qualquer outro método de pagamento. Ressalva: com gateways que redirecionam (Redsys, CECA, Reduniq), Meta Pixel não deduplica por ID de evento, pelo que uma nova tentativa ou um recarregamento após o pagamento pode duplicar Purchase em Meta. GA4 deduplica por transaction_id. Verifique o valor de Meta antes de o considerar correto.
Posso implementar GA4 e Meta Pixel a partir de um único contentor GTM?
Sim. Forneça-nos apenas o ID do contentor (GTM-XXXXXX), sem o measurement ID de GA4 nem o pixel ID de Meta. Se nos fornecer os três e o seu contentor já disparar essas mesmas etiquetas, os eventos duplicam-se, porque o motor carrega cada destino de forma independente. O motor envia cada evento para o dataLayer com a sua carga de ecommerce (valor e moeda).
O que acontece com o meu gestor de cookies (CMP) se integrar o motor?
Dentro do iframe não é mostrado o banner do motor: o seu website transmite-lhe a decisão do visitante em cada carregamento. Se não a receber, não é carregado nenhum script de analítica. Como fazê-lo, com exemplo: Se o seu website já pediu o consentimento.
Posso renomear os eventos (por exemplo, purchase_spa) para não os misturar com outro website ou com outro motor de reservas?
Recomendamos que não. O GA4 só conta como compra o evento purchase: um purchase_spa chegaria como evento personalizado, sem receitas. Para separar os dados do motor basta filtrar por nome de host (o domínio do motor) ou pela marca do produto (item_brand, o nome do centro), que já vai em cada evento. Se ainda assim quiserem nomes próprios, façam-no a partir do vosso Google Tag Manager: forneçam-nos apenas o ID do contentor e, dentro dele, decidem com que nome cada evento chega ao GA4.
Tenho de configurar alguma coisa no GA4 por causa da passarela de pagamento?
Sim: acrescentem o domínio da passarela (por exemplo, sis.redsys.es) a «Referências indesejadas» no GA4 (Administrar → Fluxos de dados → Configurar etiqueta). Assim, quando o comprador volta do pagamento, o GA4 não abre uma nova sessão atribuída ao banco.
Vejo o dataLayer vazio, porquê?
Há duas razões possíveis, e ambas são normais: ainda não temos os vossos IDs configurados, ou o visitante não aceitou os cookies no banner do motor. Para verificar, entrem no motor, aceitem os cookies e escrevam dataLayer na consola do navegador.
Referência
Tabela completa de atributos
Todos os data-siana-* reconhecidos pelo SDK v1. São colocados no elemento que abre ou integra o motor: um botão com data-siana-open, ou um contentor com data-siana-inline.
| Atributo | Valor | Efeito |
|---|---|---|
| data-siana-open | (sem valor) | Marca um elemento como trigger do overlay (modal ou drawer) |
| data-siana-inline | (sem valor) | Marca um contentor para integrar o motor na própria página |
| data-siana-auto-open | (sem valor) | Dispara o clique automaticamente ao carregar o DOM |
| data-siana-mode | modal · drawer | Tipo de overlay (predefinição modal). Ignorado em integrado |
| data-siana-chrome | full · minimal | minimal oculta breadcrumbs, seta de voltar e informação do centro |
| data-siana-service | UUID | Pré-seleciona um serviço (aterragem na sua ficha) |
| data-siana-view | full · widget | widget = apenas quadro de reserva (requer serviço) |
| data-siana-locator | 4-128 [a-z0-9-] | Aponta para a confirmação de uma compra existente |
| data-siana-pin | 3-128 [a-z0-9] | PIN auto-validado (requer locator) |
| data-siana-date | YYYY-MM-DD | Data pré-selecionada |
| data-siana-locale | es · en · fr · … | Idioma inicial do motor |
| data-siana-drawer-side | right · left | Lado do drawer (predefinição right) |
| data-siana-drawer-width | CSS length | Largura do drawer (predefinição min(480px,80vw)) |
| data-siana-modal-width | px · % | Largura do modal |
| data-siana-modal-height | px · % | Altura do modal |
| data-siana-min-height | px | Altura inicial integrada antes do primeiro redimensionamento |
| data-siana-session-id | 1-128 [A-Za-z0-9_-] | A sua referência de reserva — retorna no handoff para correlação |
| data-siana-item-id | 1-128 [a-z0-9_-] | Item a cancelar (delete mode) → o motor emite cart:remove |
| data-siana-callback-url | https URL | Endpoint server-side que recebe o mesmo payload do handoff por POST |
| data-siana-purchase-mode | voucher · appointment · both | Filtra o catálogo: apenas vouchers, apenas agendamentos, ou tudo (predefinição both) |
| data-siana-exp | slug de categoria | Filtra o catálogo para uma categoria (o seu slug no Siana) |
| data-siana-channel | slug de canal | Aplica um canal com preços e condições próprios (configurado no Siana) |
| data-siana-currency | ISO 4217 (EUR, GBP…) | Moeda de visualização inicial |
| data-siana-group | identificador de grupo | Pré-seleciona o grupo de cliente |
| data-siana-hide-add-to-cart | 1 · true | Oculta o botão "adicionar ao carrinho" (compra direta, sem cesto) |
| data-siana-fresh | 1 · true | Abre limpo: ignora a retoma de percurso e entra no catálogo. Não toca no carrinho (ver persistency) |