← Voltar ao início Documentação
Embed SDK v1 · Spalopia · Siana

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.

Passo 1

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

Passo 2

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.

Passo 3

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/booking ou subdomínios como en.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:

CamadaConvençãoOnde 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).

Passo 4

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.

Simular volta do banco →
Passo 5

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âmetroValorO que muda
theme_primaryhex (6, sem #)Cor primária (botões e principais detalhes)
theme_primary_lighthexPrimário claro (fundos suaves do primário)
theme_primary_darkhexPrimário escuro (hover / estados)
theme_accenthexCor secundária / destaque
theme_accent_lighthexDestaque claro
theme_text_basehexCor do texto base
theme_body_bghexFundo da página
theme_card_bghexFundo dos cartões
theme_radiussquare · semirounded · roundedArredondamento dos cantos (não aceita px/rem)
theme_fontOpen Sans · Roboto · Lato · Montserrat
Poppins · Inter · Nunito
Tipografia do motor (apenas famílias permitidas; um valor fora da lista é ignorado)
theme_preset1 – 4Aplica uma paleta completa predefinida (substitui as cores individuais)
theme_cleartrueApaga 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 SDKChave em 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

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.

Configurações de tema do novo motor de reservas no back office: cores, tipografia e pré-visualização
É assim que a configuração do tema aparece no seu back office: cores, tipografia e pré-visualização.

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.

FerramentaO que nos passaPara 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.
EventoQuando é acionadoNo 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 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.

ValorO que concede
analyticsSó analítica (GA4)
marketingSó marketing (Meta Pixel)
analytics,marketingAmbas
accept-allAmbas
reject-all · necessary-onlyNenhuma: 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-cookies no 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_cookies no 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.

AtributoValorEfeito
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-modemodal · drawerTipo de overlay (predefinição modal). Ignorado em integrado
data-siana-chromefull · minimalminimal oculta breadcrumbs, seta de voltar e informação do centro
data-siana-serviceUUIDPré-seleciona um serviço (aterragem na sua ficha)
data-siana-viewfull · widgetwidget = apenas quadro de reserva (requer serviço)
data-siana-locator4-128 [a-z0-9-]Aponta para a confirmação de uma compra existente
data-siana-pin3-128 [a-z0-9]PIN auto-validado (requer locator)
data-siana-dateYYYY-MM-DDData pré-selecionada
data-siana-localees · en · fr · …Idioma inicial do motor
data-siana-drawer-sideright · leftLado do drawer (predefinição right)
data-siana-drawer-widthCSS lengthLargura do drawer (predefinição min(480px,80vw))
data-siana-modal-widthpx · %Largura do modal
data-siana-modal-heightpx · %Altura do modal
data-siana-min-heightpxAltura inicial integrada antes do primeiro redimensionamento
data-siana-session-id1-128 [A-Za-z0-9_-]A sua referência de reserva — retorna no handoff para correlação
data-siana-item-id1-128 [a-z0-9_-]Item a cancelar (delete mode) → o motor emite cart:remove
data-siana-callback-urlhttps URLEndpoint server-side que recebe o mesmo payload do handoff por POST
data-siana-purchase-modevoucher · appointment · bothFiltra o catálogo: apenas vouchers, apenas agendamentos, ou tudo (predefinição both)
data-siana-expslug de categoriaFiltra o catálogo para uma categoria (o seu slug no Siana)
data-siana-channelslug de canalAplica um canal com preços e condições próprios (configurado no Siana)
data-siana-currencyISO 4217 (EUR, GBP…)Moeda de visualização inicial
data-siana-groupidentificador de grupoPré-seleciona o grupo de cliente
data-siana-hide-add-to-cart1 · trueOculta o botão "adicionar ao carrinho" (compra direta, sem cesto)
data-siana-fresh1 · trueAbre limpo: ignora a retoma de percurso e entra no catálogo. Não toca no carrinho (ver persistency)