Tracking V2: iFrame und Einwilligung verbinden

Bei einer Website-Einbettung muss Tracking V2 die tatsächliche Sitzung und Einwilligung Ihrer Website erhalten. Der Buchungsprozess übernimmt keine unabhängige Ersatzsitzung im iFrame. Diese Einrichtung richtet sich an die Person oder Agentur, die Website, Google Tag Manager und Consent-Management betreut.

Richten Sie zuerst die Tracking-Ziele in edoobox ein und verwenden Sie den aktuellen Einbettungscode aus Vorschau / Share.

Den V2-Web-GTM-Container vorbereiten

Exportieren Sie in edoobox GTM-V2-Container.
Öffnen Sie in Google Tag Manager den passenden Web-Container und wählen Sie Verwaltung → Container importieren.
Importieren Sie die JSON-Datei als Ergänzung zum bestehenden Container und prüfen Sie Konflikte vor dem Bestätigen. Der Google-Ablauf unterscheidet «Zusammenführen» und «Überschreiben»; ein vollständiges Überschreiben entfernt bisherige Tags, Trigger und Variablen. Siehe Google: Container importieren.
Stellen Sie sicher, dass der Google-Tag für dieselbe Mess-ID auf Ihrer Website besteht. Das edoobox-Modul installiert keine zusätzliche GA4-Property.
Deaktivieren Sie die bisherigen edoobox-Kauf-Tags für dasselbe Konto. Behalten Sie den zulässigen Browser-Funnel und die Consent-Einrichtung.
Prüfen Sie den Container in der Vorschau und veröffentlichen Sie die vorbereiteten Änderungen.

Der V2-Export enthält ausschliesslich Browserereignisse. Käufe, Zahlungen, Storno und Erstattung kommen über den serverseitigen Versand aus edoobox.

Website-Helper beim iFrame ergänzen

Belassen Sie den edoobox-Einbettungscode und laden Sie danach auf Ihrer Website die beiden zusätzlichen Skripte. Verwenden Sie den Host der tatsächlich verwendeten edoobox-Umgebung:

<script src="https://app2.edoobox.com/js/home/tools/booking-analytics-v2.js"></script>
<script src="https://app2.edoobox.com/js/home/tools/booking-analytics-embedded-v2.js"></script>

Registrieren Sie anschliessend das konkrete iFrame:

edooboxBookingAnalyticsEmbedV2.register({
    iframeId: 'edoobox_customer',
    bookingOrigin: 'https://app2.edoobox.com',
    measurementId: 'G-CUSTOMERID',
    googleEnabled: true,
    microsoftEnabled: false,
    openaiEnabled: false,
    getConsent: function () {
        return readCurrentConsentFromYourCmp();
    }
});

readCurrentConsentFromYourCmp() ist im Beispiel ein Platzhalter für Ihre CMP-Anbindung. Ersetzen Sie die Funktion durch den tatsächlichen Zugriff auf die Einwilligung. Der Callback muss ein Objekt im folgenden Format liefern:

{
    analytics_storage: 'denied',
    ad_storage: 'denied',
    ad_user_data: 'denied',
    ad_personalization: 'denied'
}

Setzen Sie einen Wert nur dann auf granted, wenn eine entsprechende gültige Entscheidung vorliegt. Fehlende oder unbekannte Werte werden als Ablehnung behandelt.

Parameter richtig zuordnen

Parameter	Einrichtung
iframeId	Die eindeutige ID des tatsächlichen iFrame-DOM-Elements. Sie muss exakt übereinstimmen.
bookingOrigin	Protokoll und Host der Buchungsseite, gegebenenfalls mit Port; ohne Pfad und ohne abschliessenden Schrägstrich.
measurementId	Dieselbe GA4-Mess-ID wie in der aktiven edoobox-Konfiguration.
googleEnabled / microsoftEnabled / openaiEnabled	Exakt dieselben aktivierten Anbieter wie im edoobox-Konto.
getConsent	Liefert bei jedem Aufruf den aktuellen CMP-Stand.

Bei Ads ohne Google setzen Sie googleEnabled: false und lassen measurementId weg. Für mehrere edoobox-Konten registrieren Sie jedes iFrame separat mit seinen eigenen Zielen. Änderungen an der Anbieterwahl müssen sowohl in edoobox als auch in der Website-Registrierung nachgeführt werden.

Das iFrame benötigt den Origin-Referrer Ihrer Website, beispielsweise mit referrerpolicy="origin" oder dem üblichen Standard strict-origin-when-cross-origin. Bei no-referrer wird kein Elternkontext übernommen. Verwenden Sie die genaue Origin statt einer Wildcard.

Fordern Sie nach jeder CMP-Änderung eine neue Erfassung für dieses iFrame an:

edooboxBookingAnalyticsEmbedV2.refresh('edoobox_customer');

Das gilt sowohl nach Zustimmung als auch nach Widerruf. Analyse und Werbung werden getrennt behandelt. Werbezuordnung benötigt gleichzeitig ad_storage: 'granted' und ad_user_data: 'granted'. Ein Widerruf entfernt auch die gespeicherten Anzeigenkennungen aus dem Buchungskontext.

Das Modul erfasst keine erlaubte Google-Sitzung, wenn die Website nur eine Mess-ID eingetragen hat, aber keinen passenden Google-Tag bereitstellt. Der Buchungsablauf wartet nicht auf einen erfolgreichen Tracking-Abruf.

Direkte edoobox-Seite und eigene CMP

Bei einer direkten Teilnehmeransicht kann der edoobox-Cookiebanner die ausdrückliche Zustimmung liefern. Ohne Banner startet V2 mit Ablehnung. Wenn eine eigene CMP verwendet wird, stellen Sie vor der Initialisierung diese Funktion bereit:

window.edooboxAnalyticsConsent = function (measurementId) {
    return readCurrentConsentFromYourCmp();
};

Bei einer späteren Änderung übergeben Sie den aktuellen Stand:

window.dispatchEvent(new CustomEvent('edoobox:analytics-consent', {
    detail: {
        measurement_id: 'G-CUSTOMERID',
        consent: readCurrentConsentFromYourCmp()
    }
}));

Bei Ads ohne Google verwenden Sie im direkten Consent-Ereignis measurement_id: ''. Das Beispiel gehört auf die tatsächlich betreute Seite beziehungsweise in deren passende Integration; tragen Sie es nicht als beliebiges HTML in Verifizierungs-Meta-Tags ein.

Drei Kontrollfälle vor dem Livegang

Ablehnung: Starten Sie mit verweigerter Einwilligung. Es dürfen keine zustimmungspflichtigen Analyse- oder Werbeereignisse für diesen Vorgang übermittelt werden.
Zustimmung: Geben Sie die vorgesehenen Zwecke frei. Prüfen Sie den Browser-Funnel und eine kontrollierte definitive Buchung im Zielsystem.
Widerruf: Widerrufen Sie die Einwilligung im laufenden Vorgang und aktualisieren Sie den Helper. Prüfen Sie, dass keine erneute Freigabe aus einem alten Kontext entsteht.

Prüfen Sie auf Desktop und Smartphone sowie nach einem Seitenwechsel zwischen Angebotsübersicht und Buchung. Bei mehreren iFrames darf ein Ereignis nur dem vorgesehenen Konto und Tracking-Ziel zugeordnet werden.

Weiter: Ereignisse und Fehlersuche · Cookie Banner · Anbieter konfigurieren

Den tatsächlichen Elternkontext im CMS prüfen

Die Registrierung benötigt das reale edoobox-iFrame als DOM-Element auf der Seite, auf der die Helper laufen. Ein zusätzlicher Einbettungsrahmen eines Website-Baukastens kann diesen Zugriff verändern. Prüfen Sie das konkrete veröffentlichte CMS-Layout; ein äusserer Platzhalter mit gleicher sichtbarer Grösse ist nicht automatisch das richtige Element.

Lassen Sie die Helper nur einmal je betreuter Seite laden und registrieren Sie jede edoobox-Instanz mit einer eindeutigen ID. Übergeben Sie im Callback eine neue aktuelle CMP-Auswertung, keine beim Seitenstart eingefrorene Zustimmung. Nach einem Anbieter- oder Kontowechsel müssen Registrierung und gespeicherte Zielkonfiguration zusammenpassen.