Auf einer von HubSpot gehosteten Website (Content Hub, früher CMS Hub) gehört der FlowConsent-Code ganz oben in das Feld Site header HTML unter Settings → Content → Pages. Damit landet er im <head> aller Seiten der Domain. Die Installation umfasst drei Schritte: Code kopieren, in Site header HTML einfügen und das native Cookie-Banner von HubSpot deaktivieren. Der letzte Punkt ist die häufigste Falle: Ohne ihn sehen Ihre Besucher zwei Banner.
Bevor Sie beginnen
- Ein Konto auf app.flowconsent.com (Tarif Free kostenlos, ohne Kreditkarte, bis zu 25.000 Sitzungen pro Monat).
- Ein erstelltes und bereitgestelltes Banner: im Tarif Free über Ihr eigenes Cloudflare-Konto (Cloudflare-Anleitung), in Pro und Enterprise mit einem Klick.
- In HubSpot die Berechtigung Website settings und ein Abonnement, das eigenen Code im Header erlaubt. HubSpot nennt Content Hub Starter, Professional und Enterprise sowie Marketing Hub Professional und Enterprise.
Schritt 1: Code kopieren
Öffnen Sie in FlowConsent Builder → Deployment → Integration, Tab HTML / No-code. Der Code besteht aus zwei Teilen: dem Google-Consent-Mode-v2-Stub (denied-Standardwerte) und dem Banner-Script.
Schritt 2: Code in Site header HTML einfügen
- Klicken Sie in HubSpot in der oberen Navigationsleiste auf das Einstellungen-Symbol (Zahnrad).
- Öffnen Sie im linken Menü Content → Pages.
- Behalten Sie im Dropdown Choose a domain to edit its settings die Standardeinstellungen, um alle Domains abzudecken, oder wählen Sie eine bestimmte Domain und klicken Sie im Abschnitt Site header HTML auf Override default settings.
- Fügen Sie den Code ganz oben in das Feld Site header HTML ein, vor jedem vorhandenen Code, zusammen mit der Zeile, die das HubSpot-Banner deaktiviert (siehe Schritt 3):
<script>
// FlowConsent Loader - VOR jedem anderen Script im <head> platzieren
window.dataLayer=window.dataLayer||[];
function gtag(){dataLayer.push(arguments);}
gtag('consent','default',{
'ad_storage':'denied',
'analytics_storage':'denied',
'ad_user_data':'denied',
'ad_personalization':'denied',
'wait_for_update':500
});
gtag('set','url_passthrough',true);
gtag('set','ads_data_redaction',true);
</script>
<!-- FlowConsent CMP -->
<script src="https://IHR-LIZENZCODE.consent.flowconsent.com/cookie-manager.js?code=IHR_LIZENZCODE"></script>
<!-- Deaktiviert das native Cookie-Banner von HubSpot -->
<script>window.disableHubSpotCookieBanner = true;</script>- Klicken Sie unten links auf Save.
Jedes Tracking-Script, das bereits in diesem Feld steht (Google Analytics, Meta Pixel, Google Tag Manager…), muss unterhalb des Codes bleiben: Alles, was darüber steht, entgeht der vorherigen Blockierung.
Schritt 3: Natives HubSpot-Banner deaktivieren
Laut HubSpot deaktiviert dieses Flag auch das Einwilligungsmanagement von HubSpot. Der HubSpot-Tracking-Code, den HubSpot automatisch in seine Seiten einfügt, setzt eigene Cookies (__hstc, hubspotutk…): Damit diese der Entscheidung des Besuchers folgen, stellt HubSpot die Funktion setHubSpotConsent seiner Cookie Banner API bereit, die ein Entwickler anbinden muss. Der Ablehnungs-Scan (siehe unten) zeigt, ob diese Cookies ohne Einwilligung gesetzt werden.
Die Falle der nativen Integrationen
Laden Sie FlowConsent nie über GTM: Ein von GTM geladenes Banner kommt für die vorherige Blockierung zu spät. GTM-Tags beachten dann die Consent-Mode-v2-Signale; Nicht-Google-Tags benötigen die „Zusätzlichen Einwilligungseinstellungen“ (Consent-Mode-Anleitung).
Installation prüfen
- Öffnen Sie eine veröffentlichte Seite in einem privaten Fenster: Nur das FlowConsent-Banner erscheint.
- Im Tab Netzwerk keine Anfrage an Dritte vor Akzeptieren.
- Starten Sie den Installationsassistenten (Builder → Integration): Loader mit Ihrem Lizenzcode vorhanden, Consent-Mode-Stub vorhanden, Stub vor jedem Google-Tag (Anleitung).
- Schließen Sie mit einem Ablehnungs-Scan aus dem Tab Compliance ab (Compliance-Prüfung).
Mit Ihrem KI-Agenten erledigen (MCP)
Der offizielle MCP-Server von FlowConsent, https://mcp.flowconsent.com, funktioniert mit Claude, ChatGPT oder jedem MCP-Client, verbunden per OAuth 2.0 mit Ihrem FlowConsent-Konto (kein API-Schlüssel). Ihr Agent ruft den Code und die Platzierungsanweisungen ab (get_banner_snippet, get_setup_instructions), prüft die Installation mit einem echten Scan (verify_consent_compliance) und kann eine wiederkehrende Überwachung einrichten (monitor_compliance). Ihre HubSpot-Einstellungen ändert er nicht: Das Einfügen bleibt Ihre Aufgabe.
Beispielanfrage: „Gib mir den Code meines Banners für meine HubSpot-Website und prüfe, ob er auf https://meineseite.de korrekt installiert ist.“
Siehe MCP-Server-Anleitung und die Seite FlowConsent MCP.
Häufige Fragen
Gilt der Code auch für HubSpot-Landingpages und den Blog?
Das Feld Site header HTML gilt für die von HubSpot gehosteten Inhalte der gewählten Domain. Prüfen Sie nach dem Speichern eine Landingpage und einen Blogbeitrag mit dem Installationsassistenten.
Meine Website wird nicht von HubSpot gehostet, nur der Tracking-Code ist eingebunden. Was tun?
Diese Seite gilt dann nicht: Installieren Sie FlowConsent auf der Plattform, die die Website hostet, und deklarieren Sie HubSpot unter Builder → Services.
Kann ich das HubSpot-Banner neben FlowConsent behalten?
Das ist nicht empfehlenswert: Zwei Banner stören den Besucher und können unterschiedliche Entscheidungen speichern. Behalten Sie ein einziges Banner, FlowConsent, mit dem Flag disableHubSpotCookieBanner.
Warum habe ich keinen Zugriff auf das Feld Site header HTML?
Sie benötigen die Berechtigung Website settings und ein HubSpot-Abonnement, das Header-Code erlaubt. Wenden Sie sich an einen Super-Admin Ihres HubSpot-Kontos.