Surfaced Analytics · Docs

Einbau in 5 Minuten

Ein Script-Snippet in den <head> deiner Website — mehr braucht es nicht. Deine persönliche Site-ID findest du nach der kostenlosen Registrierung im Dashboard (fertig zum Kopieren).

Das Snippet

<!-- Surfaced Analytics: lädt und misst erst NACH der Cookie-Einwilligung (Kategorie Analyse/Messung) --> <script> window.addEventListener('SurfacedConsentGranted', function () { if (window.__sfaLoaded) return; // doppeltes Laden verhindern window.__sfaLoaded = true; window.__sfaConsent = true; // Freigabe für das Mess-Skript selbst var s = document.createElement('script'); s.src = 'https://analytics.surfaced.at/w.js'; s.async = true; s.setAttribute('data-site', 'DEINE-SITE-ID'); document.head.appendChild(s); }); </script> <!-- Im Cookie-Banner beim Opt-in für "Surfaced Analytics" auslösen: --> <!-- window.dispatchEvent(new Event('SurfacedConsentGranted')); --> <!-- Beim Widerruf (Opt-out) aufrufen, damit nichts im Browser zurückbleibt: --> <!-- window.surfaced && window.surfaced.forget(); -->

Ersetze DEINE-SITE-ID durch die ID aus deinem Dashboard. Das Script ist ~2 KB, lädt asynchron und bremst deine Seite nicht.

WordPress

Ohne Plugin: Design → Theme-Datei-Editor → header.php → Snippet vor </head> einfügen.

Mit Plugin (einfacher, Update-sicher): Plugin „WPCode" (oder „Insert Headers and Footers") installieren → Code Snippets → Header → Snippet einfügen → speichern.

Shopify

Onlineshop → Themes → ⋯ → Code bearbeiten → layout/theme.liquid öffnen → Snippet direkt vor </head> einfügen → speichern.

Für Kauf-Tracking (Business): Snippet zusätzlich im Checkout unter Einstellungen → Checkout → „Zusätzliche Skripte" der Danke-Seite einfügen (siehe unten).

Webflow

Site Settings → Custom Code → „Head Code" → Snippet einfügen → speichern & publishen. (Custom Code braucht einen bezahlten Webflow-Plan.)

Wix

Einstellungen → Benutzerdefinierter Code → „+ Benutzerdefinierten Code hinzufügen" → Snippet einfügen → „Head" auswählen → auf alle Seiten anwenden.

Next.js / React

In app/layout.tsx (App Router) im <head> bzw. via next/script:

import Script from "next/script"; // im Layout-JSX. Dein Cookie-Banner löst nach dem Opt-in SurfacedConsentGranted aus: <Script id="surfaced-loader" strategy="beforeInteractive">{` window.addEventListener('SurfacedConsentGranted', function () { if (window.__sfaLoaded) return; window.__sfaLoaded = true; window.__sfaConsent = true; var s = document.createElement('script'); s.src = 'https://analytics.surfaced.at/w.js'; s.async = true; s.setAttribute('data-site', 'DEINE-SITE-ID'); document.head.appendChild(s); }); `}</Script>

Beliebiges HTML

Snippet in jede Seite (oder dein zentrales Template) vor </head> einfügen — fertig.

Kauf-Tracking (Business)

Auf deiner Danke-/Bestellbestätigungsseite zusätzlich — verbindet Umsatz mit der KI, die den Kunden gebracht hat:

<script>(function f(){ window.surfaced ? surfaced.conversion(BETRAG, "EMAIL", "BESTELL-ID") : setTimeout(f,200); })();</script>

BETRAG (Zahl, z. B. 249), EMAIL und BESTELL-ID durch echte Werte ersetzen — jede Bestellung wird nur einmal gezählt.

Profi-Tipp: KI-Traffic sichtbarer machen

KI-Apps senden oft keinen Referrer. Wenn du Links zu deiner Website selbst platzierst (llms.txt, Verzeichnisse, Profile), hänge ?utm_source=chatgpt.com (bzw. die jeweilige KI) an — Surfaced erkennt auch UTM-Parameter und ordnet den Besuch der richtigen KI zu.

FAQ

Was zählt als KI-Besuch? Ein Besuch mit Referrer einer KI (chatgpt.com, perplexity.ai …), einem KI-UTM-Parameter oder dem User-Agent eines KI-Crawlers (GPTBot, PerplexityBot, ClaudeBot …). Das ist eine ehrliche Untergrenze: App-Traffic ohne Referrer und Google AI Overviews (kommen als google.com) sind nicht eindeutig zuordenbar.

Ist das DSGVO-konform? Das Tracking kommt ohne Cookies von Drittanbietern aus; die Firmen-Erkennung (Business) arbeitet nur auf Firmen-Ebene über berechtigtes Interesse — keine Personen-Identifikation. Provider-, VPN- und Privat-IPs werden aussortiert.

Bremst das Snippet meine Seite? Nein — ~2 KB, asynchron geladen, keine Render-Blockierung.

Noch kein Konto? Kostenlos registrieren — oder erst die Live-Demo ansehen.