# FlowConsent auf HubSpot installieren

Auf einer HubSpot-Website fügen Sie den FlowConsent-Code in Settings → Content → Pages → Site header HTML ein und deaktivieren das native HubSpot-Cookie-Banner.

> Canonical: https://www.flowconsent.com/de/doc/install-hubspot
> Last updated: 2026-10-01
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](https://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](/de/doc/cloudflare-deployment)), 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

1. Klicken Sie in HubSpot in der oberen Navigationsleiste auf das **Einstellungen**-Symbol (Zahnrad).
2. Öffnen Sie im linken Menü **Content → Pages**.
3. 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**.
4. 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):

```html title="Settings → Content → Pages → Site header HTML"
<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>
```

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

> [!WARNING]
> HubSpot zeigt auf seinen gehosteten Seiten ein eigenes Consent-Banner an, sobald unter **Settings → Privacy & Consent → Cookies** ein Banner konfiguriert ist. Zusammen mit FlowConsent sieht der Besucher zwei Banner und trifft womöglich zwei widersprüchliche Entscheidungen. Die Entwicklerdokumentation von HubSpot sieht dafür das Flag `window.disableHubSpotCookieBanner = true;` vor, das im `<head>` vor dem Laden des HubSpot-Banners gesetzt werden muss: Das ist die Zeile am Ende des Codes oben.

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

> [!NOTE]
> Unter **Settings → Content → Pages** bietet der Tab **Integrations** die Kästchen **Integrate with Google Analytics 4** und **Integrate with Google Tag Manager**. Diese Integrationen fügen ihre Scripts außerhalb Ihrer Kontrolle ein, und laut HubSpot richtet sich das GA-Script nur nach dem HubSpot-Banner. Deaktivieren Sie sie: Deklarieren Sie Google Analytics unter **Builder → Services**, damit FlowConsent es erst nach der Einwilligung lädt, und fügen Sie den GTM-Container manuell in **Site header HTML** ein, unterhalb des FlowConsent-Codes.

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](/de/doc/google-consent-mode)).

## Installation prüfen

1. Öffnen Sie eine veröffentlichte Seite in einem privaten Fenster: Nur das FlowConsent-Banner erscheint.
2. Im Tab **Netzwerk** keine Anfrage an Dritte vor **Akzeptieren**.
3. Starten Sie den **Installationsassistenten** (**Builder → Integration**): Loader mit Ihrem Lizenzcode vorhanden, Consent-Mode-Stub vorhanden, Stub vor jedem Google-Tag ([Anleitung](/de/doc/setup-wizard)).
4. Schließen Sie mit einem **Ablehnungs-Scan** aus dem Tab **Compliance** ab ([Compliance-Prüfung](/de/doc/compliance-verification)).

## 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](/de/doc/mcp-server) und die Seite [FlowConsent MCP](/de/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.