> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 🔗 Integriert Hoppy Cookie mit Transparency & Consent Framework v2.3 (TCF) > ℹ️ **Note:** Dieser Artikel wurde automatisch mit AI übersetzt und kann Ungenauigkeiten enthalten. Wenn etwas falsch aussieht, kontaktieren Sie bitte unser Support-Team. Die Integration von Transparency & Consent Framework v2.3 (TCF) hilft Ihrem Shop, Einwilligungssignale an IAB-registrierte Anbieter auf standardisierte Weise zu übermitteln. Wenn aktiviert, Hoppy Cookie generiert und verwaltet eine gültige TCF-Einwilligungszeichenfolge (TC String), stellt die offizielle `__tcfapi` Schnittstelle und teilt Besuchereinwilligungspräferenzen mit teilnehmenden Werbe- und Analyseanbietern. Hoppy Cookie ist bereits als IAB Consent Management Platform (CMP ID: 454) registriert, so dass keine zusätzliche Registrierung oder externe Einrichtung erforderlich ist. --- # **⚠️ Bevor Sie beginnen** Bevor Sie TCF aktivieren, stellen Sie sicher: * Hoppy GDPR EU Cookie Banner ist installiert und aktiv * Ihr Cookie Banner wird veröffentlicht * Die App Embed ist in Ihrem Shopify Thema 💡 Es sind keine API-Schlüssel, Anmeldeinformationen oder externe Konten erforderlich. ⚠️ TCF gilt nur für Besucher in DSGVO-Regionen. Wenn Sie planen, verwenden **Google Consent Mode V2** Für den DSGVO-Verkehr sollte TCF zuerst aktiviert werden. --- # **🛠️ Schritt 1 - Öffnen Sie den Abschnitt Integrationen** In deinem Inneren Shopify Admin: → offen **Hoppy GDPR EU Cookie Banner** → Klicken **Integrationen** Standort: **Transparency & Consent Framework v2.3 (TCF)** und öffnen Sie die Integrationsseite. --- # **🚀 Schritt 2 — TCF aktivieren** Ganz oben auf der Seite: → Klicken **Einschalten** Einmal aktiviert: * Der Integrationsstatus ändert sich **am** * Die App lädt die IAB Global Vendor List (GVL) * Das Schaufenster beginnt, die `__tcfapi` Schnittstelle * DSGVO-Besucher erhalten eine TCF-kompatible Einwilligungserfahrung 💡 Das Banner und das Popup der Einstellungen passen sich bei Bedarf automatisch an die TCF-Struktur an. --- # **🧩 Schritt 3 — Wählen Sie Collaborating Vendors (optional)** Unterhalb des Integrationsschalters finden Sie die: ### **Suchanbieter** Feld. Auf diese Weise können Sie auswählen, welche Anbieter aus der IAB Global Vendor List Einwilligungssignale erhalten dürfen. ### **Wie man Vendors hinzufügt** → Starten Sie die Eingabe eines Anbieternamens → Wählen Sie den Anbieter aus den Ergebnissen → Wiederholen nach Bedarf ### **Wie man Vendors entfernt** → Klicken Sie auf **×** Neben dem Namen des Anbieters um es aus der ausgewählten Liste zu entfernen. --- ### **Wichtiges Verhalten** Wenn keine Anbieter ausgewählt werden: → Alle Anbieter aus der Global Vendor List sind standardmäßig erlaubt. Für die meisten Händler wird empfohlen, nur die Anbieter auszuwählen, die aktiv im Storefront verwendet werden. Dies hilft, die Zustimmungskommunikation genauer und einfacher zu verwalten. --- # **💾 Schritt 4 - Speichern Sie Ihre Änderungen** Nachdem Sie TCF aktiviert und Ihre bevorzugten Anbieter ausgewählt haben: → Klicken **Sparen** Die App wird: * Speichern Sie Ihre TCF-Konfiguration * Storefront-Einstellungen aktualisieren * Veröffentlichen Sie die notwendige Bannerkonfiguration Einmal gespeichert, beginnt die Storefront automatisch mit den aktualisierten TCF-Einstellungen. --- # **🔄 Wie TCF Arbeiten** Nach der Aktivierung funktioniert der Einwilligungsfluss für DSGVO-Besucher automatisch. ### **Was passiert hinter den Kulissen** 1. Die App lädt die neueste IAB Global Vendor List 2. Besucher interagieren mit dem TCF-kompatiblen Zustimmungsbanner 3. Zustimmungsentscheidungen werden in einen TC-String umgewandelt 4. Der TC String wird auf der Storefront gespeichert 5. Zustimmungssignale werden durch die `__tcfapi` Schnittstelle 6. Teilnehmende Anbieter passen Verhalten basierend auf den gewährten Berechtigungen an Dieser Vorgang erfolgt automatisch, ohne dass ein manueller Eingriff erforderlich ist. --- # **🧪 Schritt 5 — Überprüfen Sie die Integration** Nach dem Speichern wird empfohlen, zu überprüfen, ob TCF korrekt funktioniert. --- ## **Überprüfen Sie den Integrationsstatus** Zurück zu: **Integrationen → Transparency & Consent Framework v2.3 (TCF)** Das Status-Badge sollte anzeigen: **am** --- ## **Test aus einer DSGVO Region** Da TCF nur für DSGVO-Besucher gilt: → Test mit einem EU VPN Standort oder → Verfügbar Shopify Test-Tools für regionales Storefront-Verhalten Die TCF-Einwilligungserfahrung sollte automatisch angezeigt werden. --- ## **Überprüfen Sie den TC String** Nach Einreichung der Zustimmung Präferenzen: → Öffnen Sie die Entwickler-Tools Ihres Browsers → Browser-Cookies überprüfen Suchen Sie nach: euconsent-v2 Möglicherweise finden Sie den gleichen Wert auch in localStorage gespeichert. Sein Vorhandensein bestätigt, dass ein gültiger TC-String generiert und gespeichert wurde. --- ## **Verifizieren des Verkäuferverhaltens** Wenn bestimmte Anbieter ausgewählt wurden: → Bestätigen Sie, dass diese Vendor-Skripte korrekt geladen werden → Überprüfen Sie, ob sie angemessen auf die Zustimmungsauswahl reagieren Wenn Sie Google Consent Mode V2 neben TCF verwenden, testen Sie beide Integrationen zusammen, um sicherzustellen, dass die Zustimmungssignale wie erwartet fließen. --- # **⚠️ Gemeinsame Fehlerbehebung** ## **TCF Banner erscheint nicht** Überprüfung: * Der Besucher befindet sich in einer DSGVO-Region * Das Cookie Banner wird veröffentlicht * Das App Embed ist aktiviert Die TCF-Funktionalität wird nur aktiviert, wenn die DSGVO-Anforderungen gelten. --- ## **Vendor List ist nicht geladen** Die Global Vendor List wird vorübergehend für die Performance zwischengespeichert. Wenn Verkäufer nicht erscheinen: → Die Seite auffrischen → Warten Sie ein paar Minuten und versuchen Sie es erneut → Überprüfen Sie, ob Ihre Storefront auf den Vendor List Service zugreifen kann --- ## **Verkäufer ignorieren die Zustimmung** Überprüfung: * Die richtigen Anbieter wurden ausgewählt * Der Verkäufer unterstützt die `__tcfapi` Schnittstelle * Der Anbieter ist im IAB-Framework registriert TCF betrifft nur Anbieter, die am Framework teilnehmen. --- ## **Google Consent Mode V2 funktioniert nicht** TCF ist für Google Consent Mode V2 in DSGVO-Regionen erforderlich, konfiguriert jedoch nicht automatisch den Google Consent Mode. Nach Aktivierung des TCF: → Konfigurieren Sie den Google Consent Mode V2 getrennt vom Abschnitt Integrationen. --- # **⚠️ Wichtige Hinweise** ### **Nur DSGVO-Regionen** TCF gilt nur für Besucher, die sich in den von der DSGVO abgedeckten Regionen befinden. Besucher außerhalb dieser Regionen nutzen weiterhin die Standard-Einwilligungserfahrung. --- ### **Leere Vendor List erlaubt allen Vendors** Wenn keine Anbieter manuell ausgewählt werden: → Alle Anbieter aus der Global Vendor List sind standardmäßig erlaubt. --- ### **Die Zustimmung wird automatisch gespeichert** Der generierte TC-String wird automatisch gespeichert und entsprechend den Einwilligungsanforderungen wiederverwendet. Es ist keine manuelle Cookie-Konfiguration erforderlich. --- ### **TCF Erforderlich für Google Consent Mode V2** Für DSGVO-Besucher hängt Google Consent Mode V2 davon ab, dass TCF aktiv ist. TCF sollte immer konfiguriert werden, bevor Google Consent Mode V2 aktiviert wird. --- # **🎉 Endergebnis** Einmal erfolgreich konfiguriert: ✅ DSGVO-Besucher erhalten eine TCF-konforme Einwilligungserfahrung ✅ Zustimmungsentscheidungen werden in einen gültigen TC-String umgewandelt ✅ Die `__tcfapi` Interface wird auf der Storefront verfügbar ✅ IAB-registrierte Anbieter erhalten standardisierte Zustimmungssignale ✅ Vendor-Berechtigungen können direkt von der App aus gesteuert werden ✅ Ihr Shop ist bereit für Google Consent Mode V2 und andere TCF-kompatible Dienste Die Integration von Transparency & Consent Framework v2.3 trägt dazu bei, dass Einwilligungsinformationen in einem standardisierten Format kommuniziert werden, das große Werbe- und Analyseanbieter verstehen und respektieren können. 🔒 ---