Dokumentation

Alles, was Sie brauchen, um Barefoot CMP einzurichten, zu konfigurieren und zu optimieren. Von der ersten Integration bis zur detaillierten API-Referenz.

Schnellstart

Barefoot CMP in 3 einfachen Schritten einrichten. Keine technischen Kenntnisse erforderlich.

Hinweis: Du benötigst ein aktives Barefoot CMP-Konto. Registriere dich kostenlos, falls du noch kein Konto hast.

Schritt 1: Account erstellen

Melde dich im Dashboard an oder erstelle ein neues Konto. Nach der Registrierung erhältst du automatisch deine eindeutige CMP-ID.

Schritt 2: Website registrieren

Im Dashboard:

  1. Klicke auf „Neue Website"
  2. Gib die Domain deiner Website ein (z.B. www.beispiel.de)
  3. Wähle die gewünschten Sprachen
  4. Speichern – du erhältst eine Website-spezifische CMP-ID

Schritt 3: Script einbinden

Kopiere diese Zeile Code und füge sie in den <head> deiner Website ein:

HTML <script src="https://cmp.barefoot-performance.com/v1/loader.js?id=DEINE_CMP_ID" async></script>

Fertig! Das Banner sollte jetzt auf deiner Website sichtbar sein. Für eine ausführlichere Anleitung siehe Getting Started.

HTML/JavaScript Integration

Detaillierte Anleitung für die direkte Code-Integration in deine Website.

Basis-Integration

Die einfachste Methode: Eine einzige Script-Zeile im HTML-Head:

HTML <!-- Barefoot CMP Loader --> <script src="https://cmp.barefoot-performance.com/v1/loader.js?id=YOUR_CMP_ID" async></script>

Platzierung im HTML

Platziere das Script im <head>-Bereich, vor allen anderen Scripts:

HTML <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Meine Website</title> <!-- Barefoot CMP – IMMER ZUERST --> <script src="https://cmp.barefoot-performance.com/v1/loader.js?id=YOUR_CMP_ID" async></script> <!-- Andere Scripts danach --> <script src="analytics.js"></script> </head> <body> <!-- Dein Inhalt --> </body> </html>

Query-Parameter

Du kannst das Loader-Script mit zusätzlichen Parametern konfigurieren:

ParameterWertBeschreibung
idstring (erforderlich)Deine CMP-ID aus dem Dashboard
langde | en | ...Banner-Sprache (12 Sprachen verfügbar)
positionbottom | top | centerBanner-Position (Standard: bottom)
themelight | dark | autoDesign-Theme (Standard: light)

Beispiel mit Parametern:

HTML <script src="https://cmp.barefoot-performance.com/v1/loader.js?id=YOUR_CMP_ID&lang=de&position=top&theme=dark" async></script>

Für die vollständige JavaScript API, Konfigurationsoptionen und Events siehe JavaScript API & Events.

Weitere Plattformen

Webflow, Squarespace, Wix und andere Platform-as-a-Service Lösungen.

Webflow

  1. Gehe zu Project Settings → Custom Code
  2. Öffne den Tab Head Code
  3. Füge das Script ein und speichere
HTML <script src="https://cmp.barefoot-performance.com/v1/loader.js?id=YOUR_CMP_ID" async></script>

Squarespace

  1. Klicke auf Settings → Advanced → Code Injection
  2. Im Feld Header das Script einfügen
  3. Speichern

Wix

  1. Gehe zu Settings → Advanced → Custom Code
  2. Klicke auf Add Custom Code
  3. Script einfügen, Ort auf Head setzen
  4. Speichern und publizieren

Shopware, Typo3, andere CMS

Für alle anderen Systeme gilt: Füge das Script im <head>-Bereich ein, idealerweise vor anderen Scripts. Detaillierte Anleitungen für WordPress und Shopify finden Sie auf den jeweiligen Seiten.

Fehlerbehebung

Lösungen für häufige Probleme und Fehler.

Banner wird nicht angezeigt

Überprüfe Folgendes:
1. Ist das Script wirklich im <head> eingefügt?
2. Hast du YOUR_CMP_ID durch deine echte ID ersetzt?
3. Browser-Cache leeren (Strg+Shift+Del)
4. Browser-Konsole prüfen (F12 → Console) auf JavaScript-Fehler
5. CMP-ID im Dashboard aktiviert?
Wahrscheinliche Ursachen:
- JavaScript-Bibliotheks-Konflikt (jQuery, andere CMP)
- CSS-Konflikte mit deinem Theme
- Content-Security-Policy blockiert das Script

Lösung: Browser-Konsole auf Fehler prüfen. Temporär andere Scripts deaktivieren. CSP-Header prüfen.

Google Consent Mode

Überprüfe:
1. Barefoot CMP Script muss VOR GA4/Ads-Tag geladen werden
2. Google Tag Manager sollte nach Barefoot CMP laden
3. Consent Mode v2 in GA4/Google Ads Admin aktiviert
4. Google Tag Assistant zur Prüfung nutzen

Detaillierte Anleitung: Google Consent Mode v2 Guide

Performance-Probleme

Performance-Tipps:
1. async Attribut im Script verwenden (Standard)
2. Preconnect-Hint hinzufügen
3. Andere Scripts/Plugins prüfen
4. Barefoot CMP ist nur ~25KB gzipped

Detaillierte Analyse: Performance-Leitfaden

Support kontaktieren

Wenn dein Problem nicht gelöst ist: