Eine Zeile, alle Fälle.
Dieser Leitfaden führt Schritt für Schritt und Fall für Fall durch die
data-siana-* Attribute, die das SDK erkennt, die Aufrufe von
window.SianaBooking und die kompletten Abläufe
(Modal, Drawer, Inline, Widget, Wiederherstellung nach der Zahlung). Kopieren,
einfügen, Ihre Subdomain ersetzen. Es ist kein Paket zu installieren.
Fallübersicht
- Schritt 1 · So zeigen Sie die Engine an
- A Das Skript und sonst nichts
- B Zentriertes Modal
- C Seitlicher Drawer
- D Inline (als eigener Bereich)
- E Navigation der Engine ausblenden
- F Automatisches Öffnen beim Laden der Seite
- G Breiten des Modals und des Drawers
- H Ein Link, ohne Code
- Schritt 2 · Ihre Domain
- I Welche Domain möchten Sie verwenden?
- Schritt 3 · Was angezeigt werden soll
- J Auf der Behandlungsseite landen
- K Nur das Buchungsfeld
- L Eingabesprache erzwingen
- M Datum vorab ausfüllen
- N Link pro Kanal (Subdomain)
- O Link pro Kategorie (?exp=)
- P Deep-Linking über URL (Präfix siana_*)
- Schritt 4 · Rückkehr von der Zahlung
- Q Direkte Bestätigung einer Buchung öffnen
- R Locator + PIN (Rückkehr von der Zahlung)
- Schritt 5 · Ihre Marke
- S Farben, Typografie und Rundung über Query-Parameter
- T Ihre Marke über das Siana-Panel konfigurieren
- Erweiterte Integration
- U Die Engine über Ihren Code steuern
- V Zuhören, was im Inneren passiert
- W Ein Warenkorbzähler auf Ihrem Button
- X Der Warenkorb und die Navigation bleiben erhalten
- Y CSP & Sandbox
- Z Diagnose
- AA Analyse: GA4, Meta Pixel und Tag Manager
- Referenz
- AB Vollständige Attributtabelle
Wie man die Engine anzeigt
Das Skript und sonst nichts
Fügen Sie dieses <script> nur einmal auf jeder Seite ein, auf der die Engine erscheinen soll – idealerweise vor </body>. Es ist kein Paket zu installieren; das Skript wird von der Subdomain heruntergeladen, die Siana für Sie bereitstellt.
<script src="https://reservas.tuhotel.com/embed.js"></script>
Das Skript selbst stellt nichts dar. Es reagiert nur auf Elemente mit data-siana-* Markierungen, die Sie darunter hinzufügen (oder die später im DOM erscheinen – es überwacht Mutationen).
Zentriertes Modal
Markieren Sie einen beliebigen Button mit data-siana-open. Beim Klicken öffnet sich die Engine in einer zentrierten Ebene über Ihrer Website. Schließen Sie es mit dem internen X, Esc oder einem Klick auf den Hintergrund.
<button type="button" data-siana-open>Buchen</button>
Seitlicher Drawer
Derselbe Button mit data-siana-mode="drawer". Er kommt von rechts (Standard), oder von links mit data-siana-drawer-side="left". Die Breite steuern Sie mit data-siana-drawer-width (akzeptiert px, %, vw und CSS-Funktionen 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)" >Buchen</button>
Inline (als weiterer Abschnitt)
Ein leeres <div data-siana-inline></div> dient als Platzhalter. Das Skript montiert den iframe darin und passt die Größe automatisch an, wenn der Inhalt wächst – Sie müssen keine Höhen messen.
<h1>Reservieren Sie Ihr Erlebnis</h1> <div data-siana-inline data-siana-chrome="minimal"></div>
data-siana-mode wird innerhalb von data-siana-inline ignoriert – der inline-Container kann nicht zu einem Overlay werden, selbst wenn jemand dies anfordert.
Zur Sprache der eingebetteten Engine siehe Fall L.
Betten Sie die Engine nicht mit einem handgeschriebenen <iframe> ein. Verwenden Sie immer den Block aus div + script. Mit einem manuellen iframe erscheint die Engine in der Standardsprache, zeigt ihren eigenen Cookie-Hinweis und passt ihre Höhe nicht an, sodass der Inhalt abgeschnitten wird oder eine Lücke entsteht.
Die Navigation des Moduls ausblenden
data-siana-chrome="minimal" blendet die Breadcrumbs, den "Zurück"-Pfeil und den Infoblock des Zentrums aus. Nützlich, wenn das Modul in einem Kontext lebt, der bereits seine eigene Navigation bietet (eine Karte, ein Drawer, ein Inline-Abschnitt).
<button type="button" data-siana-open data-siana-chrome="minimal" >Buchen</button>
Automatisches Öffnen beim Laden der Seite
Markieren Sie die Schaltfläche mit data-siana-auto-open (ohne Wert) und das SDK "klickt" sie an, sobald das DOM bereit ist. Typisches Muster für die Rückseite von Redsys: Der Kunde landet, der Drawer öffnet sich automatisch, die Bestätigung wird angezeigt.
<button type="button" data-siana-open data-siana-auto-open data-siana-locator="abcd-1234" data-siana-pin="fdd2bt" data-siana-mode="drawer" >Wird geladen…</button>Redsys-Rückgabe simulieren →
Wenn Sie data-siana-auto-open zu mehreren Elementen hinzufügen, wird nur das erste ausgelöst (mit Warnung).
Breiten des Modals und des Drawers
Nur Modal: data-siana-modal-width, data-siana-modal-height (px oder %).
Nur Drawer: data-siana-drawer-width (px, %, vw, oder CSS min/max/clamp) — Standard min(480px,80vw).
Inline (vor der ersten Größenanpassung): data-siana-min-height in px.
<button type="button" data-siana-open data-siana-modal-width="720px" data-siana-modal-height="80%" >Schmales Modal</button> <button type="button" data-siana-open data-siana-mode="drawer" data-siana-drawer-width="clamp(360px, 50vw, 720px)" >Fließender Drawer</button> <div data-siana-inline data-siana-min-height="640"></div>
Ein Link, ohne Code
Die einfachste aller Formen: ein normaler Link zur Adresse des Moduls. Der Kunde gelangt auf die Buchungsseite in einem eigenen Fenster oder Tab. Kein JavaScript, kein Skript zur Installation – Sie aktivieren es in wenigen Minuten, ohne von jemandem abhängig zu sein.
<a href="https://163-f1401005.bysiana.com">Buchen</a>
Dies ist die empfohlene Option, um ohne technische Hilfe zu starten. Wenn Sie möchten, dass das Modul über Ihrer Website erscheint, ohne die Seite zu wechseln, wechseln Sie zum Modal (B), zum Panel (C) oder zum eingebetteten Modul (D).
Ihre Domain
Welche Domain möchten Sie verwenden?
Bevor Sie die Domain konfigurieren, entscheiden Sie, wie das Modul auf Ihrer Website funktionieren soll (Schritt 1). In allen Fällen stellen wir Ihnen eine sofort einsatzbereite Adresse zur Verfügung, ohne dass Sie etwas ändern müssen. Wenn sie als externer Link geöffnet wird – die Weiterleitung –, ist Ihrerseits keine DNS-Konfiguration erforderlich. Wenn das Modul in Ihre Website eingebettet ist (modal, drawer oder inline), müssen Sie nichts konfigurieren, damit es funktioniert: Eine eigene Domain (CNAME) ist optional und nur erforderlich, wenn das Modul über Ihre Domain bereitgestellt werden soll.
Option A — Modul mit externem Link
Der Kunde klickt auf eine Schaltfläche auf Ihrer Website und das Modul öffnet sich auf einer neuen Seite. Sie haben zwei Alternativen, und keine erfordert eine technische Konfiguration:
A1 · Verwenden Sie die bysiana.com-Domain. Teilen Sie uns mit, welchen benutzerdefinierten Alias Sie verwenden möchten – zum Beispiel Ihr-Spa.bysiana.com – und wir stellen Ihnen den Link unter unserer Domain zur Verfügung, der sofort einsatzbereit ist.
A2 · Verwenden Sie Ihre eigene Domain. Wenn Sie es vorziehen, dass der Link Ihre Marke trägt – zum Beispiel reservierungen.Ihre-Domain.com –, schreiben Sie uns eine E-Mail an soporte@spalopia.com und geben Sie die gewünschte Domain an. Wir kümmern uns um die notwendige interne Konfiguration.
Option B — Modul eingebettet in Ihre Website
Das Modul wird in Ihre eigene Seite eingebettet (modal, drawer oder inline), ohne dass der Kunde die Seite jemals verlässt. Sie müssen nichts konfigurieren, damit es funktioniert. Eine eigene Domain (CNAME) ist optional: Wenn Sie sie nicht konfigurieren, wird die Siana-Adresse verwendet und alles funktioniert genauso, ohne Probleme mit Cookies oder der Funktionalität. Der einzige Unterschied ist die Analyse: Mit Ihrer eigenen Domain teilen GA4 und Meta Pixel die Sitzung mit Ihrer Website; mit der Siana-Adresse nicht (siehe Analyse · Häufige Fragen).
Wenn Sie Ihre eigene Domain verwenden möchten, schreiben Sie uns an soporte@spalopia.com und nennen Sie die Domain. Wir kümmern uns um die interne Konfiguration.
Was angezeigt werden soll
Auf der Behandlungsseite landen
Wenn Ihre eigene Karte die Behandlung bereits beschreibt, überspringen Sie die Liste: Übergeben Sie die UUID des Dienstes mit data-siana-service und der iframe öffnet direkt die Produktseite (PDP).
<button type="button" data-siana-open data-siana-mode="drawer" data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e" data-siana-chrome="minimal" >Massage buchen</button>
Kombinieren Sie mit data-siana-chrome="minimal", um den "Zurück"-Pfeil der Engine auszublenden – es gibt keinen Weg zurück, der Kunde kam von Ihrer Karte.
Nur das Buchungsfeld
data-siana-view="widget" rendert ausschließlich den Block "Personen + Datum + Buchen" des Dienstes – ohne Beschreibung, Bilder oder Empfehlungen. Benötigt ein gültiges data-siana-service.
<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" >Buchen (Widget)</button>
Erzwinge die Eingabesprache
data-siana-locale startet die Engine in der von Ihnen angegebenen Sprache. Wenn Ihre Website bereits einen Sprachselektor hat, übergeben Sie ihn hier, damit die Engine den Kontext übernimmt.
<button type="button" data-siana-open data-siana-locale="en">Book</button>
Bei der eingebetteten Engine fügen Sie auf jeder Seite einen vollständigen Block ein:
<!-- Spanische Seite --> <div data-siana-inline data-siana-locale="es"></div> <script src="https://TU-CENTRO.bysiana.com/embed.js" async></script> <!-- Englische Seite --> <div data-siana-inline data-siana-locale="en"></div> <script src="https://TU-CENTRO.bysiana.com/embed.js" async></script> <!-- Deutsche Seite --> <div data-siana-inline data-siana-locale="de"></div> <script src="https://TU-CENTRO.bysiana.com/embed.js" async></script>
Das Script ist auf allen Seiten gleich: Nur data-siana-locale ändert sich.
Mehrsprachige Website
- Wenn Ihre Website eine Seite pro Sprache hat (zum Beispiel
/es/reservas,/en/bookingoder Subdomains wieen.miweb.com), fügen Sie den Block auf jeder Seite mit ihrer Sprache ein. - Wenn Ihre Website die Sprache über einen URL-Parameter wechselt, können Sie
?siana_locale=enverwenden (Fall P), der Vorrang vor dem Attribut hat.
Unterstützte Sprachen: es · en · de · fr · it · pt · ca · eu · nl · ru.
Datum vorab ausfüllen
data-siana-date="JJJJ-MM-TT" gelangt als Query-Parameter zur Engine, um mit diesem vorab ausgewählten Datum zu starten, wenn der Dienst dies unterstützt.
<button type="button" data-siana-open data-siana-service="4165d3bc-bf21-5273-a598-d1d308aedf9e" data-siana-date="2026-06-15" >Am 15. Juni buchen</button>
In einem bestimmten Kanal öffnen
Ein Kanal wendet eigene Preise und Bedingungen an (Partner, Unternehmen, eine Aktion…), und Sie konfigurieren diese in Siana. Bei einem Direktlink ist der Kanal das Präfix der Subdomain (promo-ihredomain.com); eingebettet, wird er mit data-siana-channel übergeben.
<!-- Als Link: Der Kanal befindet sich in der Subdomain --> <a href="https://promo-reservas.ihrhotel.com">Buchen</a> <!-- Oder eingebettet (data-siana-channel) --> <button data-siana-open data-siana-channel="promo">Buchen</button>
Nach Kategorie gefiltert öffnen
Filtern Sie den Katalog auf eine Kategorie (ihren Slug in Siana) mit dem Parameter ?exp=<kategorie>. Im Demo verwenden wir masajes-corporales.
<!-- Als Link --> <a href="https://reservas.ihrhotel.com/?exp=masajes-corporales">Kategorie anzeigen</a> <!-- Oder eingebettet (data-siana-exp) --> <button data-siana-open data-siana-exp="masajes-corporales">Kategorie anzeigen</button>
Präfix siana_* in Host-Query-Parametern
Alles oben Genannte – Dienstleistung, Datum, Sprache, Kanal, Kategorie – kann auch über die URL Ihrer Seite ausgelöst werden, ohne den Snippet zu berühren. Zuvor zwei Namensräume, die nicht vermischt werden sollten:
| Ebene | Konvention | Wo es lebt |
|---|---|---|
| SDK (HTML) | data-siana-* | Attribute des Buttons oder Containers auf Ihrer Seite. data-siana-service, data-siana-date, etc. Das Präfix data-siana- kapselt bereits das SDK – es kollidiert mit nichts. |
| URL (Host) | siana_* | Query-Parameter in der URL Ihrer Seite. ?siana_service=…&siana_date=…. Das Präfix verhindert Kollisionen mit eigenen Parametern Ihrer Website (viele Leute verwenden ?service oder ?id für andere Dinge). |
Automatisches Deep-Linking. Das SDK liest die Query Ihrer Seite und überschreibt damit die data-siana-* des Snippets: Die URL ist die dynamische Absicht; der Snippet, der statische Standard. Mit derselben eingebetteten Seite kann jede Kampagne auf einer anderen Dienstleistung, einem anderen Datum oder einer anderen Kategorie landen, indem nur der Link geändert wird:
// Kampagnen-E-Mail – öffnet die Engine bereits auf den Dienst und das Datum positioniert
https://tuhotel.com/reservar?siana_service=UUID&siana_date=YYYY-MM-DD&siana_exp=masajes-corporales
Unterstützte Parameter: siana_service, siana_date, siana_exp, siana_locale, siana_view, siana_purchase_mode, siana_currency, siana_channel und siana_group.
Die Engine akzeptiert auch das gleiche Präfix, wenn Sie die iframe-URL manuell erstellen (erweiterte Integration, ohne SDK):
<iframe src="https://reservas.tuhotel.com/?embed=1&siana_service=UUID"></iframe>
Das Wichtige: Das SDK liest nur diese Allowlist von Inhalten aus Ihrer URL. Die Zugangsdaten (token, locator, pin) und die Struktur des Embeds (Modus, Größen, Thema, Session, Callback) werden niemals aus einer teilbaren URL gelesen: für die Rückgabe mit Locator/PIN lesen Sie weiterhin window.location.search und übergeben es als data-siana-*-Attribute (siehe Fall R).
Rückkehr von der Zahlung
Bestätigung einer Buchung direkt öffnen
data-siana-locator leitet das iframe auf /purchase/{LOCATOR} statt auf den Katalog. Dies dient für "Buchung überprüfen"-Links in E-Mails, im Kundenbereich oder auf Post-Payment-Landingpages. Wenn der Kunde die PIN in diesem Browser noch nicht validiert hat, fragt die Engine danach.
<button type="button" data-siana-open data-siana-locator="abcd-1234-efgh-5678" data-siana-mode="drawer" data-siana-chrome="minimal" >Ihre Buchung überprüfen</button>
data-siana-locator hat Vorrang vor data-siana-service und data-siana-view – die Bestätigungsseite ist eigenständig.
Locator + PIN (Rückkehr von der Zahlung)
Redsys, PayPal und Bizum leiten den Kunden von der Seite weg, um die Zahlung mit seiner Bank zu validieren und leiten ihn danach auf eine Seite Ihrer eigenen Domain zurück. Sie erstellen diese Seite selbst – zum Beispiel /confirmation – und übergeben sie uns als return_url: Siana leitet den Kunden dorthin mit ?siana_locator=…&siana_pin=… (dem Präfix siana_, wie in Fall P) zurück. Ihre Seite verknüpft diese beiden Werte in data-siana-locator und data-siana-pin, und die Engine öffnet die Bestätigung automatisch, ohne nach der PIN zu fragen.
<!-- Statische Version (Locator + PIN zur Build-Zeit bekannt) -->
<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"
>Ihren Kauf überprüfen</button>
<!-- Ihre Seite /confirmation – empfängt: ?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 = 'Ihren Kauf überprüfen'
document.getElementById('siana-confirmation').appendChild(btn)
}
</script>
<script src="https://reservas.tuhotel.com/embed.js"></script>
Ohne Locator wird die PIN nicht weitergeleitet. data-siana-pin allein wird ignoriert (mit Warnung in der Konsole).
Testen Sie es. Der Button öffnet eine Beispielseite /confirmation – die gleiche wie im obigen Code – mit den Parametern, die Redsys bei der Rückleitung des Kunden ausgeben würde. Sie liest siana_locator und siana_pin und startet die Engine mit der Bestätigung, ohne etwas zu fragen.
Ihre Marke
Farben, Typografie und Rundung über Query-Parameter
Die Engine passt sich den Farben Ihrer Marke an. Normalerweise werden diese in Ihrer Konfiguration (Panel) festgelegt, aber Sie können auch eine Farbpalette erzwingen oder vorab ansehen, indem Sie theme_*-Parameter zur URL der Engine hinzufügen – nützlich, um Varianten zu zeigen, ohne die Konfiguration zu ändern. Das Override bleibt während der Sitzung bestehen, bis Sie es löschen.
Format: Farben sind 6-stellige Hex-Werte ohne # (z. B. a8456b). Ein ungültiger Wert wird ignoriert und die Standardfarbe beibehalten.
| Parameter | Wert | Was sich ändert |
|---|---|---|
| theme_primary | hex (6, ohne #) | Primärfarbe (Schaltflächen und Hauptakzente) |
| theme_primary_light | hex | Helles Primär (sanfte Hintergründe der Primärfarbe) |
| theme_primary_dark | hex | Dunkles Primär (Hover / Zustände) |
| theme_accent | hex | Sekundärfarbe / Akzent |
| theme_accent_light | hex | Heller Akzent |
| theme_text_base | hex | Farbe des Basistextes |
| theme_body_bg | hex | Seitenhintergrund |
| theme_card_bg | hex | Kartenhintergrund |
| theme_radius | square · semirounded · rounded | Eckenrundung (akzeptiert keine px/rem) |
| theme_font | Open Sans · Roboto · Lato · Montserrat Poppins · Inter · Nunito | Typografie der Engine (nur erlaubte Familien; ein Wert außerhalb der Liste wird ignoriert) |
| theme_preset | 1 – 4 | Wendet eine komplette vordefinierte Palette an (überschreibt einzelne Farben) |
| theme_clear | true | Löscht die Überschreibung und kehrt zur Standardkonfiguration zurück |
Beispiel – rosa-braunes Primär, blaues Akzent und abgerundete Ecken:
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
Abkürzung mit einer vordefinierten Palette:
https://reservas.tuhotel.com/?theme_preset=3
Die Typografie ist auch konfigurierbar mit theme_font, innerhalb einer Liste erlaubter Familien (Open Sans, Roboto, Lato, Montserrat, Poppins, Inter, Nunito). Farben, Hintergründe, Rundung und Schriftart passen sich Ihrer Marke an.
Vom SDK aus (ohne die URL zu berühren). Sie müssen die URL der Engine nicht manuell erstellen: Das SDK leitet das Thema für Sie an das iframe weiter. Definieren Sie eine globale Palette mit window.SIANA_THEME (wird auf alle eingebetteten Elemente der Seite angewendet) oder eine spezifische pro Schaltfläche mit data-siana-theme-* Attributen (überschreiben die globale). Das SDK validiert jeden Wert und übersetzt ihn in die theme_* aus der obigen Tabelle.
// Global – einmal, vor embed.js. Gilt für Modal, Drawer, Inline und 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> <!-- Spezifische Überschreibung auf einer Schaltfläche --> <button data-siana-open data-siana-theme-primary="a8456b" data-siana-theme-accent="1e5fd0" data-siana-theme-radius="rounded" data-siana-theme-font="Poppins">Buchen</button> // …oder über die JS API SianaBooking.open({ mode: 'drawer', theme: { primary: '047074', font: 'Open Sans' } })
| SDK-Attribut | Schlüssel in window.SIANA_THEME / API | theme_* Äquivalent |
|---|---|---|
| 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 |
Konfigurieren Sie Ihre Marke im Siana-Panel
Für die Produktion wird empfohlen, keinen Code anzufassen: Legen Sie die Identität der Engine einmal in Ihrem back office fest, unter Konfiguration › Buchungsmaschine. Dort passen Sie die Primär- und Sekundärfarbe, die Typografie und das Format der Schaltflächen (Füllung oder Umriss, und die Eckenrundung) an. Eine Vorschau zeigt Ihnen, wie Ihre Kunden es sehen werden; wenn es Ihnen gefällt, speichern und veröffentlichen Sie, und alle eingebetteten Elemente (Modal, Drawer, Inline, Widget) spiegeln dies sofort wider.
back office oder theme_*? Das back office ist die Quelle der Wahrheit und der Weg für Kunden ohne technisches Profil. Die theme_* / data-siana-theme-* aus dem Fall S dienen dazu, eine spezifische Variante direkt aus der Integration zu erzwingen oder vorab anzuzeigen, und überschreiben die im Panel konfigurierte Einstellung, solange sie vorhanden sind.
Erweiterte Integration
Steuern Sie die Engine über Ihren Code
Nach dem Laden von embed.js wird window.SianaBooking exponiert: eine globale API mit denselben Attributen in Objektform. Nützlich, wenn der Button zur Laufzeit oder aus einem Framework heraus erstellt wird.
// Engine über JS öffnen (Standard-Modal)
window.SianaBooking.open()
// Einen bestimmten Service in der Schublade öffnen
window.SianaBooking.open({
service: '4165d3bc-bf21-5273-a598-d1d308aedf9e',
mode: 'drawer',
chrome: 'minimal',
drawerSide: 'right',
drawerWidth: 'min(560px,80vw)'
})
// Die Bestätigung eines Kaufs öffnen
window.SianaBooking.open({
locator: 'abcd-1234-efgh-5678',
pin: 'fdd2bt',
mode: 'drawer'
})
// Inline in einem Element montieren
window.SianaBooking.mount(document.getElementById('booking-slot'), {
chrome: 'minimal',
minHeight: 640
})
// Das aktive Overlay schließen
window.SianaBooking.close()
Hören, was im Inneren passiert
Die Engine sendet Events über postMessage v1 an den Host. Sie empfangen diese mit SianaBooking.on(event, handler).
window.SianaBooking.on('ready', () => console.log('Engine bereit'))
window.SianaBooking.on('open', () => console.log('Overlay geöffnet'))
window.SianaBooking.on('close', () => console.log('Overlay geschlossen'))
window.SianaBooking.on('booking:complete', booking => {
// { id, reference, total, currency }
myAnalytics.track('purchase', booking)
})
window.SianaBooking.on('error', err => {
// { code, message } — behebbarer Fehler, die Engine läuft weiter
console.warn('[engine]', err.code, err.message)
})
window.SianaBooking.on('cart:count', ({ count }) => {
// Anzahl der Artikel im Warenkorb — zeigt ein Abzeichen auf Ihrem "Buchen"-Button an
var badge = document.querySelector('#mi-badge')
if (badge) badge.textContent = count
})
Für Integrationen, die keine Rückseite erfordern (Stripe), abonnieren Sie booking:complete für das Tracking. Verwenden Sie cart:count, um einen Artikelzähler über Ihrem Öffnungsbutton anzuzeigen. Sie müssen nichts weiter erstellen.
Ein Warenkorbzähler auf Ihrem Button
Die Engine informiert jedes Mal, wenn sich die Anzahl der Artikel im Warenkorb ändert, mit dem Event cart:count. Abonnieren Sie es und zeigen Sie ein Abzeichen über Ihrem "Buchen"-Button an, wie in jedem Online-Shop. Kopieren-Einfügen wie es ist:
<button id="reservar" data-siana-open data-siana-mode="drawer">
Buchen
<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 // Ausblenden, wenn leer
})
return true
}
// embed.js kann später laden: wiederholen, bis es existiert
if (!wire()) { var n = 0; var t = setInterval(function () { if (wire() || ++n > 100) clearInterval(t) }, 50) }
</script>
Der Zähler wird auch beim Öffnen ausgegeben (mit dem, was der Kunde im Warenkorb gespeichert hatte), so dass das Abzeichen von Anfang an korrekt angezeigt wird. Die Daten sind nur eine Zahl – sie enthalten keine Buchungsinformationen.
Warenkorb und Navigation bleiben erhalten
Wenn der Kunde etwas in den Warenkorb legt, auf Ihrer Website navigiert und zur Seite der Engine zurückkehrt, ist der Warenkorb immer noch da (bis zu 6 Stunden). Er ist durch die Domain Ihrer Website isoliert, sodass zwei verschiedene Websites, die dieselbe Engine einbetten, niemals den Warenkorb teilen.
Bei einer generischen Öffnung (ohne data-siana-service oder eine andere konkrete Absicht) wird die Engine dort wieder geöffnet, wo der Kunde sie verlassen hat (letzter Eintrag oder Katalog). Wenn Sie mit einer expliziten Absicht öffnen (service, date, purchase-mode, view=widget, preset, locator), wird das Angekommene gesendet und nicht fortgesetzt.
<!-- öffnet dort wieder, wo der Kunde es verlassen hat, mit seinem Warenkorb --> <button data-siana-open data-siana-mode="drawer">Buchen</button> <!-- beginnt immer im Katalog (Warenkorb intakt) --> <button data-siana-open data-siana-mode="drawer" data-siana-fresh>Neue Buchung</button>
data-siana-fresh setzt nur die Navigation zurück: Es ignoriert die Wiederaufnahme und wechselt in den Katalog. Es leert den Warenkorb nicht – dies ist die Auswahl des Kunden, und das stille Löschen wäre frustrierend. Falls Sie in Zukunft auch den Warenkorb leeren müssen, würde ein separates, explizites Attribut hinzugefügt.
CSP & Sandbox
Wenn Ihre Website eine Sicherheitsrichtlinie (CSP) veröffentlicht, fügen Sie die Domain der Engine zu den Direktiven hinzu:
Content-Security-Policy: frame-src https://reservas.tuhotel.com; script-src https://reservas.tuhotel.com
Verwenden Sie kein sandbox im iframe. Wenn Ihre Plattform es erzwingt, stellen Sie sicher, dass Sie allow-forms, allow-scripts, allow-same-origin, allow-popups und allow-top-navigation hinzufügen – ohne Letzteres schlägt der Zahlungsschritt fehl.
Diagnose
Jeder ungültige Wert in einem data-siana-* wird mit einer Warnung in der Konsole ignoriert, der das Präfix [Siana] vorangestellt ist. Um den Status zu überprüfen:
window.SianaBooking.diagnose()
// {
// engineOrigin: 'https://reservas.tuhotel.com',
// protocolVersion: 1,
// modalOpen: false,
// inlineFrames: 1,
// lastError: null
// }
Wenn embed.js nie geladen wird, prüfen Sie: (1) die URL des Skripts, (2) den script-src-Header Ihres CSP, (3) ob die Domain DNS auflöst. Das SDK überwacht auch ERR_BLOCKED_BY_ORB-Fehler – dies bedeutet in der Regel, dass embed.js nicht mit dem MIME-Typ JavaScript bereitgestellt wird.
Analytik: GA4, Meta Pixel und Tag Manager
Die Engine sendet zehn E-Commerce-Ereignisse an drei unabhängige Ziele. Um diese zu aktivieren, geben Sie uns Ihre Kennungen und wir konfigurieren diese in der Akte Ihres Zentrums.
| Tool | Was Sie uns geben | Wofür es dient |
|---|---|---|
| Google Analytics 4 | Ihre Measurement ID (G-XXXXXXXXXX) |
Empfängt die zehn Ereignisse mit ihrer vollständigen E-Commerce-Nutzlast: Betrag, Währung, Artikel, Mengen. Dies ist die Quelle für Trichter- und Konvertierungsberichte. |
| Meta Pixel | Ihre Pixel ID | Empfängt dieselben Ereignisse, übersetzt in die Meta-Nomenklatur, mit einer reduzierten Last. Dient für benutzerdefinierte Zielgruppen und zur Messung von Facebook- und Instagram-Kampagnen. |
| Google Tag Manager | Ihre Container ID (GTM-XXXXXX) |
Empfängt jedes Ereignis als auslösbares Objekt in dataLayer, wobei die E-Commerce-Felder in ecommerce gruppiert sind. Ermöglicht Ihnen, Ihre eigenen Tags einzurichten, ohne dass wir die Engine berühren müssen. |
| Ereignis | Wann es ausgelöst wird | Im Meta Pixel |
|---|---|---|
page_view |
Der Benutzer bei jedem Seitenwechsel | PageView |
view_item_list |
Der Benutzer sieht die Liste der Dienstleistungen | ViewContent |
select_item |
Der Benutzer klickt auf eine Servicekarte | ViewContent |
view_item |
Der Benutzer öffnet das Service-Detailblatt | ViewContent |
add_to_cart |
Der Benutzer fügt einen Service zum Warenkorb hinzu | AddToCart |
remove_from_cart |
Der Benutzer entfernt einen Service aus dem Warenkorb | RemoveFromCart |
view_cart |
Der Benutzer öffnet den Warenkorb | ViewContent |
begin_checkout |
Der Benutzer geht zum Checkout | InitiateCheckout |
add_payment_info |
Der Benutzer leitet die Zahlung ein | AddPaymentInfo |
purchase |
Der Benutzer die Bestellung wird bestätigt | Purchase |
Zustimmung
Die Engine implementiert Consent Mode v2 und startet mit allen Berechtigungen verweigert. Die Zustimmung zu Analytik aktiviert GA4; die zu Marketing, Meta Pixel. Sie sind unabhängig, sodass ein Benutzer das eine akzeptieren und das andere ablehnen kann. Praktische Konsequenz: Ihre Zahlen werden niedriger sein als der tatsächliche Traffic, und diese Differenz ist die Zahl der Personen, die Cookies nicht akzeptieren.
Wenn Sie uns keine Kennungen übermitteln, wird kein Skript von Drittanbietern geladen: Die Engine sendet nichts an irgendeinen Ort. Jedes Ereignis wird zusätzlich mit der aktiven Währung und dem Namen des Zentrums angereichert, was die Segmentierung von Ketten ohne weitere Konfiguration ermöglicht.
Wenn Ihre Website die Zustimmung bereits abgefragt hat
Wenn Ihre Website einen eigenen Cookie-Manager (CMP) hat und der Besucher bereits zugestimmt oder abgelehnt hat, übermitteln Sie diese Entscheidung an die Engine, damit er nicht zweimal gefragt wird. Was Sie uns übermitteln, ersetzt das Banner der Engine.
| Wert | Was er erlaubt |
|---|---|
analytics | Nur Analyse (GA4) |
marketing | Nur Marketing (Meta Pixel) |
analytics,marketing | Beides |
accept-all | Beides |
reject-all · necessary-only | Nichts: Es wird kein Analyseskript geladen |
Eingebettete Engine (modal, drawer oder inline)
Innerhalb des iframe erscheint das Banner der Engine nicht: Die Zustimmung wird immer von Ihrer Website bestimmt. Die Engine merkt sie sich nicht zwischen Besuchen, daher muss Ihre Website sie bei jedem Laden übermitteln. Wenn sie nicht ankommt, wird kein Analyseskript geladen. Es gibt drei Möglichkeiten, die sich kombinieren lassen:
- Attribut
data-siana-cookiesauf der Schaltfläche oder dem Container der Engine, mit einem der Werte aus der Tabelle. Nützlich, wenn die Entscheidung beim Rendern der Seite bereits bekannt ist. SianaBooking.setConsent({ analytics, marketing })aus dem Hinweis Ihres CMP, wenn der Besucher zustimmt oder seine Auswahl ändert. Die Engine wird nicht neu geladen, sodass weder der Warenkorb noch der Zahlungsschritt verloren geht. Sie können den Aufruf ausführen, bevor sich die Engine öffnet: Er wird ihr übermittelt, sobald sie bereit ist.- Parameter
siana_cookiesin der URL Ihrer eigenen Seite (zum Beispiel?siana_cookies=analytics,marketing), mit denselben Werten.
<!-- 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>
Externer Link (Weiterleitung)
Die Engine öffnet sich auf ihrer eigenen Seite und zeigt ihr Banner. Damit es nicht erneut erscheint, fügen Sie dem Link den Parameter cookies mit der Entscheidung hinzu, die Ihr CMP bereits erfasst hat, zum Beispiel https://tu-spa.bysiana.com/?cookies=analytics,marketing. Die Engine speichert sie und fragt auf dieser Domain nicht erneut nach.
Erstellen Sie den Link mit der tatsächlichen Entscheidung des Besuchers zu diesem Zeitpunkt. Lassen Sie kein festes ?cookies=accept-all in Ihrem HTML stehen: Damit würden Sie die Zustimmung für jemanden erteilen, der sie nicht gegeben hat.
Kommen Sie von der vorherigen Engine? Die Parameter utb_consent_google-ga4, utb_consent_google-tagmanager und utb_consent_facebook (Wert 1 oder 0) funktionieren weiterhin: Google entspricht Analyse und Facebook Marketing.
Häufige Fragen: vorhandene Analyse wiederverwenden
Kann ich dieselben IDs für GA4, Meta Pixel und GTM verwenden, die ich bereits auf meiner Website nutze?
Ja, ohne Einschränkung. Sie müssen weder eine weitere measurement ID noch eine weitere pixel ID oder einen weiteren GTM-Container erstellen. Sie stellen uns diese zur Verfügung und wir konfigurieren sie im Datensatz Ihres Zentrums. Die Ereignisse gehen an dieselben Properties und Konten wie die Ihrer Website.
Muss ich domainübergreifendes Tracking (cross-domain) konfigurieren oder Ihnen eine Sitzungs-ID übermitteln?
Das hängt von der Domain ab, über die die Engine bereitgestellt wird. Diese Regel gilt sowohl für externe Links als auch für eingebettete Engines.
- Eigene Subdomain (CNAME, zum Beispiel
reservas.tuweb.com): teilt die GA4- und Meta-Pixel-Sitzung mit Ihrer Website, sofern Sie dieselben IDs verwenden. Sie müssen weder domainübergreifendes Tracking konfigurieren noch uns eine Sitzungs-ID übermitteln. - Siana-Domain (
*.bysiana.com): Es handelt sich um eine andere Domain, daher wird die Sitzung nicht fortgesetzt. Wenn Sie Analyse verwenden, empfehlen wir Ihnen, Ihre eigene Subdomain zu nutzen.
Es empfiehlt sich, dies mit GA4 DebugView und dem Meta-Ereignistest zu prüfen.
Funktioniert das Ereignis purchase mit Redsys und mit Stripe?
Ja, purchase wird bei jedem Zahlungsgateway gleich erfasst. Es gibt keine Inkompatibilität mit Stripe oder einer anderen Zahlungsmethode. Eine Einschränkung: Bei Gateways mit Weiterleitung (Redsys, CECA, Reduniq) dedupliziert Meta Pixel nicht anhand der Ereignis-ID. Daher kann ein erneuter Versuch oder ein Neuladen nach der Zahlung Purchase in Meta duplizieren. GA4 dedupliziert dagegen anhand von transaction_id. Prüfen Sie die Meta-Zahl, bevor Sie sich darauf verlassen.
Kann ich GA4 und Meta Pixel über einen einzigen GTM-Container bereitstellen?
Ja. Geben Sie uns nur die Container-ID (GTM-XXXXXX), ohne die measurement ID von GA4 oder die pixel ID von Meta. Wenn Sie uns alle drei geben und Ihr Container bereits dieselben Tags auslöst, werden die Ereignisse dupliziert, weil die Engine jedes Ziel unabhängig lädt. Die Engine sendet jedes Ereignis an den dataLayer mit seiner ecommerce-Nutzlast (Wert und Währung).
Was passiert mit meinem Cookie-Manager (CMP), wenn ich die Engine einbette?
Innerhalb des iframe wird das Banner der Engine nicht angezeigt: Ihre Website übermittelt ihr die Entscheidung des Besuchers bei jedem Laden. Wenn sie diese nicht erhält, wird kein Analyseskript geladen. So geht es, mit Beispiel: Wenn Ihre Website die Zustimmung bereits abgefragt hat.
Kann ich die Ereignisse umbenennen (zum Beispiel purchase_spa), damit sie sich nicht mit einer anderen Website oder einer anderen Buchungs-Engine mischen?
Davon raten wir ab. GA4 zählt nur das Ereignis purchase als Kauf: ein purchase_spa käme als benutzerdefiniertes Ereignis ohne Umsatz an. Um die Daten der Engine zu trennen, genügt es, nach dem Hostnamen (der Domain der Engine) oder nach der Produktmarke (item_brand, der Name des Zentrums) zu filtern, die in jedem Ereignis enthalten ist. Wenn Sie dennoch eigene Namen wünschen, machen Sie das in Ihrem Google Tag Manager: Sie geben uns nur die Container-ID und entscheiden darin, unter welchem Namen jedes Ereignis in GA4 ankommt.
Muss ich in GA4 wegen des Zahlungsgateways etwas konfigurieren?
Ja: Fügen Sie die Domain des Gateways (zum Beispiel sis.redsys.es) zu „Unerwünschte Verweisquellen“ in GA4 hinzu (Verwaltung → Datenströme → Tag-Einstellungen konfigurieren). So öffnet GA4 keine neue, der Bank zugeordnete Sitzung, wenn der Käufer von der Zahlung zurückkehrt.
Ich sehe den dataLayer leer, warum?
Es gibt zwei mögliche Gründe, und beide sind normal: Wir haben Ihre IDs noch nicht konfiguriert, oder der Besucher hat die Cookies im Banner der Engine nicht akzeptiert. Zur Prüfung rufen Sie die Engine auf, akzeptieren Sie die Cookies und geben Sie dataLayer in der Browser-Konsole ein.
Referenz
Vollständige Attributtabelle
Alle data-siana-*, die vom SDK v1 erkannt werden. Sie werden auf das Element angewendet, das die Engine öffnet oder einbettet: einen Button mit data-siana-open oder einen Container mit data-siana-inline.
| Attribut | Wert | Effekt |
|---|---|---|
| data-siana-open | (kein Wert) | Markiert ein Element als Auslöser für das Overlay (Modal oder Drawer) |
| data-siana-inline | (kein Wert) | Markiert einen Container zum Einbetten der Engine auf derselben Seite |
| data-siana-auto-open | (kein Wert) | Löst den Klick automatisch beim Laden des DOM aus |
| data-siana-mode | modal · drawer | Art des Overlays (Standard modal). Bei inline ignoriert |
| data-siana-chrome | full · minimal | minimal verbirgt Breadcrumbs, Zurück-Pfeil und Zentrumsinformationen |
| data-siana-service | UUID | Wählt einen Service vor (landet auf dessen Detailseite) |
| data-siana-view | full · widget | widget = nur Buchungsfeld (Service erforderlich) |
| data-siana-locator | 4-128 [a-z0-9-] | Verweist auf die Bestätigung eines bestehenden Kaufs |
| data-siana-pin | 3-128 [a-z0-9] | Automatisch validierte PIN (Locator erforderlich) |
| data-siana-date | JJJJ-MM-TT | Vorausgewähltes Datum |
| data-siana-locale | es · en · fr · … | Anfangssprache der Engine |
| data-siana-drawer-side | right · left | Seite des Drawers (Standard right) |
| data-siana-drawer-width | CSS length | Breite des Drawers (Standard min(480px,80vw)) |
| data-siana-modal-width | px · % | Breite des Modals |
| data-siana-modal-height | px · % | Höhe des Modals |
| data-siana-min-height | px | Anfängliche Inline-Höhe vor dem ersten Resize |
| data-siana-session-id | 1-128 [A-Za-z0-9_-] | Ihre Buchungsreferenz – wird im Handoff zurückgegeben, um Korrelationen herzustellen |
| data-siana-item-id | 1-128 [a-z0-9_-] | Zu löschendes Element (Löschmodus) → die Engine gibt cart:remove aus |
| data-siana-callback-url | https URL | Server-seitiger Endpunkt, der dieselbe Handoff-Nutzlast per POST empfängt |
| data-siana-purchase-mode | voucher · appointment · both | Filtert den Katalog: nur Gutscheine, nur Termine oder beides (Standard both) |
| data-siana-exp | Kategorie-Slug | Filtert den Katalog nach einer Kategorie (ihrem Slug in Siana) |
| data-siana-channel | Kanal-Slug | Wendet einen Kanal mit eigenen Preisen und Bedingungen an (in Siana konfiguriert) |
| data-siana-currency | ISO 4217 (EUR, GBP…) | Anfängliche Anzeigewährung |
| data-siana-group | Gruppen-ID | Wählt die Kundengruppe vor |
| data-siana-hide-add-to-cart | 1 · true | Versteckt den Button "In den Warenkorb" (Direktkauf, ohne Warenkorb) |
| data-siana-fresh | 1 · true | Öffnet sauber: ignoriert die Routenfortsetzung und geht in den Katalog. Berührt den Warenkorb nicht (siehe Persistenz) |