Installationsanleitung für Next.js

Velo in Next.js einbinden

Installieren Sie das Velo-Cookie-Banner und Google Consent Mode v2 auf Next.js mit einer Zeile im Root-Layout. Mit Zugriff auf den Code der Website dauern die meisten Installationen nur ein paar Minuten. Wenn Sie Google Tag Manager nutzen, beschreibt diese Seite auch diesen Weg.

Anleitung und Bildquellen geprüft am 7. November 2026.

Funktioniert mit den Plattformen, auf denen Sie bauen

WordPressShopifyWebflowWixHubSpotPrestaShopDrupalBigCommerceShopwareNext.jsAstroSquare

Was Sie für Next.js brauchen

Bevor Sie beginnen

  • Wo. app/layout.tsx → head
  • Voraussetzung. App Router oder Pages Router
  • Live. Nach dem nächsten Deployment
  • Typische Dauer. Etwa fünf Minuten

Sobald es live ist

  • Ihr Banner folgt den Standardwerten, die Sie für die Region jedes Besuchers festlegen.
  • Tags warten, bis der Besucher entschieden hat.
  • Jede Entscheidung wird protokolliert, und Consent Mode v2 gibt sie an Ihre Google-Tags weiter.
CMConsent Mode v2GPCGlobal Privacy ControlEUDSGVOUSUS-Bundesstaaten

Zwei Wege, Velo auf Next.js zu installieren

Wählen Sie den Weg, der dazu passt, wie Ihre Website ihre Tags bereits lädt. Beide führen zum selben Banner und zu denselben Signalen.


Eine Zeile ins Root-Layout einfügen

Fügen Sie das Snippet Ihrer Website in den websiteweiten head-Bereich ein, veröffentlichen Sie und testen Sie es auf der Live-Website. Wenn Ihre Mess-Tags bereits über Google Tag Manager laufen, nehmen Sie stattdessen den Weg weiter unten.

Sie nutzen Tag Manager? Dann ohne Code

Wenn Google Tag Manager bereits auf Ihrer Website läuft, ist das der einfachste Weg, Velo einzubinden. Sie müssen keinen Code anfassen, es sind vier kurze Schritte, und alle Ihre Tags bleiben an einem Ort.

Etwa fünf MinutenTypische Installationsdauer für Next.js
Nach dem nächsten DeploymentDann geht das Banner live
1,500Sitzungen im Monat im Free-Tarif, für eine Website
Laden Sie das Snippet einmal, aus dem Root-Layout. Ein Tag in einem useEffect läuft erst, wenn Ihre anderen Tags bereits auslösen können, und next/script ohne Strategie wartet auf die Hydration. Testen Sie eine Seite, die Sie über einen Link erreichen, sowie ein vollständiges Neuladen. Das Banner sollte an seinem Platz bleiben, ohne zweite Kopie.
!
Darauf sollten Sie achtenInstallation für Next.js
Alle unterstützten Plattformen ansehen

Alles, was ein Consent-Setup braucht

Dasselbe Banner, dieselben Nachweise und Analysen in jedem Tarif. Pro bietet zusätzlich unbegrenzt viele Websites, unbegrenzte Analysen und Ihr eigenes Logo.


Ihr Banner fragt in der Sprache des Besuchers und folgt den Standardwerten, die Sie für seine Region festlegen.

Jede Entscheidung wird protokolliert, und Consent Mode v2 gibt sie an Ihre Google-Tags weiter.


Google Consent Mode v2Advanced Mode in jedem Tarif, mit einer Vorlage für Google Tag Manager.
Regeln nach Land der BesucherOpt-in, wo das Gesetz es verlangt, und strengere Regeln für bis zu 60 Länder.
US-DatenschutzgesetzeEin Opt-out-Banner mit der Option „Nicht verkaufen oder teilen“.
Global Privacy ControlGPC-Signale werden in jedem Tarif beachtet.
Ablehnen so einfach wie Akzeptieren„Ablehnen“ steht auf der ersten Ebene direkt neben „Akzeptieren“.
Die Sprache der BesucherAus dem Browser übernommen, mit Ihrem eigenen Banner-Text in jeder Sprache.
Layouts und ThemesEcke, Leiste oder zentrierte Box, in Ihren Farben, hell oder dunkel.
A/B-Tests für Ihr BannerLassen Sie 2 bis 8 Varianten des Banners parallel laufen.
EinwilligungsprotokollJede Entscheidung wird 3 Jahre gespeichert, mit Belegsuche per ID.
Consent-DashboardZustimmungs- und Ablehnungsraten über 7 bis 90 Tage.
Analysen von Cookies und TrackernKategorien aus bekannten Signaturen, dazu KI-Vorschläge, die Sie freigeben.
Script-BlockierungScripts warten auf ihre Einwilligungskategorie, bevor sie laufen.

Eine Zeile ins Root-Layout einfügen

Fügen Sie das Snippet Ihrer Website in den websiteweiten head-Bereich ein, veröffentlichen Sie und testen Sie es auf der Live-Website. Wenn Ihre Mess-Tags bereits über Google Tag Manager laufen, nehmen Sie stattdessen den Weg weiter unten.

Zeile kopieren

Kopieren Sie das vollständige Installations-Snippet für diese Website aus Ihrem Velo-Dashboard. Das Beispiel unten zeigt das Format; ersetzen Sie your-site-id, bevor Sie es verwenden. Behalten Sie den API-Endpunkt bei, den Ihr Dashboard vorgibt.

Beispiel-Snippet
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>

In das Root-Layout einfügen

Öffnen Sie beim App Router das Root-Layout (app/layout.tsx oder src/app/layout.tsx). Hat es kein <head>-Element, ergänzen Sie eines oberhalb von <body> und fügen Sie dort Ihr vollständiges Velo-Snippet ein, oberhalb aller Analyse- und Werbe-Tags. Beim Pages Router fügen Sie es in <Head> in pages/_document.tsx ein und legen diese Datei an, falls das Projekt keine hat. Das Snippet ist so, wie es ist, gültiges JSX. Setzen Sie es nicht in einen useEffect und nicht in next/script mit der Standardstrategie, denn beides lädt es erst, wenn Ihre anderen Tags bereits auslösen können. Deployen Sie und testen Sie dann eine Seite, die Sie über einen Link erreichen, sowie ein vollständiges Neuladen.

Next.js · Root-Layout
// app/layout.tsx on the App Router. On the Pages Router, the same
// line goes inside <Head> in pages/_document.tsx.
export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <head>
        {/* Paste the complete Velo snippet from your dashboard here. */}
        <script src="https://cdn.veloconsent.com/v1/velo.js"
                data-api="https://app-staging.veloconsent.com"
                data-velo-site="your-site-id" async></script>
      </head>
      <body>{children}</body>
    </html>
  );
}
Konfigurationsreferenz, abgeglichen mit der Dokumentation der Plattform. Kein Screenshot aus dem Admin-Bereich. Geprüfte Konfigurationsreferenz · 7. November 2026. Dokumentation der Plattform ↗

Veröffentlichen und die Live-Website prüfen

Speichern und veröffentlichen Sie die Änderung mit den Schritten Ihrer Plattform oben und leeren Sie danach den Website- oder CDN-Cache. Öffnen Sie die veröffentlichte URL in einer neuen Browsersitzung. Prüfen Sie das Banner dort, wo Ihre Regionsregeln es verlangen, testen Sie Zustimmen und Ablehnen und kontrollieren Sie, dass die Consent-Standardwerte und -Updates greifen, bevor Ihre Mess-Tags laufen. Prüfen Sie zum Schluss, ob die Website in Ihrem Velo-Dashboard als installiert angezeigt wird.

Das Velo-Banner in seinem Standardaussehen. Text, Farben und Regionseinstellungen Ihres Banners können abweichen.

Sie nutzen Tag Manager? Dann ohne Code

Wenn Google Tag Manager bereits auf Ihrer Website läuft, ist das der einfachste Weg, Velo einzubinden. Sie müssen keinen Code anfassen, es sind vier kurze Schritte, und alle Ihre Tags bleiben an einem Ort.

Die komplette Anleitung für Tag Manager

Velo zu Tag Manager hinzufügen

Öffnen Sie die Velo-Vorlage, klicken Sie auf Add to workspace und wählen Sie Ihren Container. Velo-Vorlage öffnen ↗

Site-ID einfügen

Öffnen Sie in Tag Manager Tags und klicken Sie auf New. Klicken Sie auf Tag Configuration, wählen Sie Velo CMP und fügen Sie Ihre Site-ID ein. Sie finden sie in Ihrem Velo-Dashboard. Alles andere lassen Sie unverändert.

Als Erstes laden

Klicken Sie auf Triggering, wählen Sie Consent Initialization – All Pages und klicken Sie auf Save. So startet Velo vor Ihren anderen Tags.

Veröffentlichen und prüfen

Klicken Sie auf Submit und dann auf Publish. Preview allein schaltet Velo nicht live. Öffnen Sie danach Ihre Website in einem privaten Fenster, testen Sie das Banner und prüfen Sie, ob die Website in Ihrem Velo-Dashboard als installiert angezeigt wird.

Oder übergeben Sie es an einen Agenten

Kopieren Sie den Prompt in Claude, ChatGPT, Cursor oder den Assistenten, den Sie ohnehin nutzen. Er enthält alles von dieser Seite: beide Wege, die Reihenfolge, in der die Tags laden müssen, und die Prüfungen, die zeigen, dass alles funktioniert.

Mit KI installieren

Der Prompt

Fügen Sie diesen Prompt in Ihren Assistenten ein und geben Sie dann Ihre Site-ID sowie das vollständige Installations-Snippet oder die GTM-Einstellungen aus Ihrem Velo-Dashboard an.

Installations-Prompt · Next.js
Installieren Sie Velo auf Next.js.

Aktuelle Anleitung: https://veloconsent.com/nextjs

Holen Sie vor jeder Änderung meine Site-ID und das vollständige Installations-Snippet oder die GTM-Einstellungen aus dem Velo-Dashboard. Prüfen Sie, welches Consent-Tool und welche Mess-Tags bereits auf der Website laufen.

Wählen Sie einen Installationsweg:
A. Wenn die Website bereits Google Tag Manager nutzt, fügen Sie die Vorlage Velo CMP (veröffentlicht von veloconsent) aus der Community Template Gallery hinzu. Tragen Sie meine Site-ID, das Theme und den API-Endpunkt aus dem Dashboard ein. Prüfen Sie die erweiterten Optionen; ads_data_redaction und url_passthrough sind standardmäßig deaktiviert. Verwenden Sie Consent Initialization – All Pages, nutzen Sie dann Preview und prüfen Sie die Einwilligung vor dem Veröffentlichen. Alle Schritte: https://veloconsent.com/google-tag-manager

B. Für die direkte Installation: Öffnen Sie beim App Router das Root-Layout, app/layout.tsx oder src/app/layout.tsx, ergänzen Sie oberhalb von <body> ein <head>-Element, falls keines vorhanden ist, und fügen Sie dort Ihr vollständiges Velo-Snippet ein, oberhalb aller Analyse- und Werbe-Tags. Fügen Sie es beim Pages Router in <Head> in pages/_document.tsx ein und legen Sie diese Datei an, falls das Projekt keine hat. Das Snippet ist in dieser Form gültiges JSX. Laden Sie es nicht in useEffect und nicht mit next/script in der Standardstrategie: Beides lädt es erst, wenn Ihre anderen Tags bereits auslösen können. Deployen Sie und testen Sie eine über einen Link erreichte Seite sowie ein vollständiges Neuladen.

Lassen Sie nicht zugehörigen Code unverändert. Vermeiden Sie doppelte Velo-Installationen oder konkurrierende Consent-Standardwerte. Gehen Sie nicht davon aus, dass die Platzierung im Head oder asynchrones Laden allein die Reihenfolge der Tags garantiert.

Prüfen Sie die veröffentlichte Website in einer neuen Sitzung. Prüfen Sie das Banner unter den konfigurierten Regionsregeln, die anfänglichen Consent-Standardwerte, die Updates nach Zustimmen und Ablehnen sowie das Ereignis velo_consent_update. Prüfen Sie, ob Nicht-Google-Tags ihren zugewiesenen Kategorien folgen. Testen Sie eine zweite Seite und jeden separaten Checkout-Bereich. Bestätigen Sie, dass die Signale im Velo-Dashboard ankommen.

Berichten Sie, was geändert wurde, wo es geändert wurde und welches Ergebnis jede Prüfung hatte. Beschreiben Sie fehlende Zugänge oder Prüfungen, die Sie nicht abschließen konnten.
Ihr Agent liest Webseiten? Verweisen Sie ihn auf veloconsent.com/llms.txt und /install.md, dort steht derselbe Kontext als reiner Text.

Aus dem Blog

Notizen zu Cookie-Bannern, Consent Mode und den Daten, die dazwischen verloren gehen.


Kanadische Websites und Consent Mode v2
V
Der Velo-Blog11. November 2026

Google Consent Mode v2 in Velo: Das ist neu

2. November 2026Beitrag lesen

Google Consent Mode v2 auf Shopify einrichten

2. September 2026Beitrag lesen

Häufige Fragen zu Velo auf Next.js

Funktioniert das mit dem App Router und dem Pages Router?

Ja. Beim App Router kommt das Snippet ins Root-Layout, beim Pages Router in pages/_document.tsx. Wir haben beide auf Next.js 16 getestet, mit vollständigem Neuladen und mit Link-Navigation.

Sollte ich stattdessen next/script verwenden?

Nur mit strategy="beforeInteractive" im Root-Layout, das in unseren Tests ebenfalls funktioniert hat. Ein einfaches Tag ist schlichter, weil es vom ersten Byte an im HTML steht, während beforeInteractive vom Loader von Next.js gestartet wird. Vermeiden Sie den Standard afterInteractive und lazyOnload, die erst laden, wenn Ihre anderen Tags bereits auslösen können.

Bleibt das Banner bei der clientseitigen Navigation erhalten?

Ja. Bei der Link-Navigation bleibt dasselbe Dokument bestehen, daher bleiben das Banner, die Schaltfläche zum erneuten Öffnen und die Wahl des Besuchers erhalten, und das Tag im Layout lädt nicht erneut.

Meine Website setzt eine Content Security Policy.

Das Snippet benötigt https://cdn.veloconsent.com in script-src und https://app-staging.veloconsent.com in connect-src. Prüfen Sie nach dem Veröffentlichen die Browser-Konsole und erlauben Sie alles andere, was Ihre Richtlinie blockiert.

Wird die Website dadurch langsamer?

Das Snippet aus dem Dashboard lädt asynchron. Wie bei jedem Skript sollten Sie die Auswirkung auf Ihre Website messen und die Reihenfolge Ihrer Tags prüfen. Asynchrones Laden allein garantiert nicht, dass die Consent-Standardwerte vor anderen Tags greifen.

Kann ein KI-Assistent das für mich erledigen?

Ja. Kopieren Sie den Prompt aus „Mit Agenten installieren“ direkt darunter in Claude, ChatGPT, Cursor oder den Assistenten, den Sie ohnehin nutzen. Er enthält die Schritte dieser Seite, die Reihenfolge, in der die Tags laden müssen, und die Prüfungen, die der Agent durchführen muss, bevor er Ihnen meldet, dass alles erledigt ist.

Kostenlos für eine Website

Banner, Analyse und Einwilligungsnachweise für eine Website, kostenlos. Pro ab 7 € im Monat, zzgl. MwSt., für unbegrenzt viele Websites.