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

<script src="https://surfaced-ai-analytics.vercel.app/w.js" data-site="DEINE-SITE-ID" async></script>

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:
<Script src="https://surfaced-ai-analytics.vercel.app/w.js" data-site="DEINE-SITE-ID" strategy="afterInteractive" />

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.