# Google Analytics verbinden

Auf dieser Seite verbinden Sie Spyglasses mit Ihrem Google Analytics. Nach der Verbindung leitet Spyglasses alle KI-Besuche (konkret Traffic von KI-Assistenten, nicht andere Bot-Typen) als `page_view`-Events über das Measurement Protocol an Ihr Google Analytics weiter.

## Was Sie lernen

In dieser Anleitung erfahren Sie:

- Wie Sie Google Analytics verbinden
- Welche Daten an GA4 gesendet werden
- Welche wichtigen Einschränkungen Sie kennen sollten
- Wie Sie überprüfen, ob die Integration funktioniert

## Voraussetzungen

Dieses Dashboard setzt voraus, dass das [Spyglasses AI Traffic Analytics Plugin](/docs/getting-started/overview) auf Ihrer Website installiert ist. Ohne das Plugin gibt es keinen KI-Traffic zum Weiterleiten.

## Was Sie benötigen

Um Google Analytics zu verbinden, brauchen Sie zwei Angaben aus Ihrer GA4-Property:

### 1. Mess-ID (Measurement ID)

Das ist die Kennung Ihrer GA4-Property. Sie beginnt mit `G-` (z. B. `G-XXXXXXXXXX`).

So finden Sie sie:
1. Melden Sie sich bei Google Analytics an
2. Öffnen Sie „Verwaltung" (Zahnradsymbol)
3. Wählen Sie Ihre Property aus
4. Klicken Sie auf „Datenstreams"
5. Wählen Sie Ihren Web-Stream aus
6. Kopieren Sie die Mess-ID

### 2. API-Secret

Das ist ein geheimer Schlüssel, der Measurement-Protocol-Anfragen autorisiert.

Eine ausführliche Anleitung zum Erzeugen eines API-Secrets finden Sie unter [So erhalten Sie Ihr GA4-API-Secret](/docs/analytics/ga4-api-secret).

Kurzfassung:
1. Öffnen Sie die Einstellungen Ihres GA4-Web-Streams
2. Scrollen Sie zu „Measurement Protocol API secrets"
3. Klicken Sie auf „Erstellen"
4. Vergeben Sie einen Namen (z. B. „Spyglasses")
5. Kopieren Sie den erzeugten Secret-Wert

## Die Integration verbinden

1. Tragen Sie Ihre Mess-ID ein (G-XXXXXXXXXX)
2. Tragen Sie Ihr API-Secret ein
3. Klicken Sie auf „Speichern" bzw. „Verbinden"
4. Spyglasses überprüft die Verbindung

Nach der Verbindung fließen KI-Besuchsdaten innerhalb weniger Minuten in Ihr Google Analytics.

## Welche Daten gesendet werden

Spyglasses sendet `page_view`-Events für Besuche von KI-Assistenten mit:

- Seiten-URL
- Seitentitel
- Kennung der KI-Plattform (ChatGPT, Claude usw.)
- Zeitstempel
- Geografische Angaben (sofern verfügbar)

**Hinweis**: Weitergeleitet wird ausschließlich Traffic von KI-Assistenten — nicht von Trainings-Crawlern für KI-Modelle, Suchmaschinen-Crawlern oder anderen Bot-Typen. So bleiben Ihre GA4-Daten auf aussagekräftige Daten zur KI-Sichtbarkeit fokussiert.

## Wichtige Einschränkungen

### Voraussetzung Session-ID

Viele Berichte und Ansichten in Google Analytics setzen eine **Session-ID** (`session_id`) voraus, die beim Senden über das Measurement Protocol nicht erzeugt werden kann.

Google verlangt, dass Session-IDs durch menschliche Besuche erzeugt werden, die über das JavaScript-Snippet erfasst werden. Serverseitige Events über das Measurement Protocol haben keinen Zugriff auf den clientseitigen Session-Kontext.

**Was das bedeutet:**
- KI-Besuchsdaten erscheinen in einigen GA4-Berichten, aber nicht in allen
- Sitzungsbasierte Berichte zeigen Spyglasses-Daten unter Umständen nicht
- Manche Standardberichte filtern Events ohne Sitzung heraus

### Eigene Berichte erstellen

Um Ihre KI-Traffic-Daten in GA4 zu sehen, müssen Sie gegebenenfalls eigene Berichte oder Zielgruppen erstellen, die nicht von der Session-ID abhängen.

Eine Schritt-für-Schritt-Anleitung finden Sie unter [Eine GA4-Zielgruppe für KI-Traffic erstellen](/docs/analytics/ga4-ai-audience).

### Betroffene Berichte

Berichte, die typischerweise funktionieren:
- Der Bericht „Ereignisse" (zeigt page_view-Events)
- Echtzeitübersicht (mit Einschränkungen)
- Eigene Explorationen mit Filter nach Ereignisparametern

Berichte, die Spyglasses-Daten möglicherweise nicht zeigen:
- Akquisitionsberichte (benötigen ggf. Sitzungen)
- Engagement-Berichte
- Berichte zur Nutzerreise
- Attributionsberichte

## Die Verbindung überprüfen

Prüfen Sie nach dem Verbinden, ob Daten fließen:

### In Spyglasses
Kontrollieren Sie, dass die Integration den Status „Verbunden" zeigt und aktuelle Sync-Aktivität anzeigt.

### In Google Analytics

1. Öffnen Sie „Berichte > Echtzeit"
2. Halten Sie nach page_view-Events Ausschau
3. Filtern Sie über den Ereignisparameter nach der KI-Quelle

Oder:

1. Öffnen Sie „Explorativ"
2. Erstellen Sie eine neue Exploration
3. Fügen Sie `page_view` als Ereignis hinzu
4. Filtern Sie auf Events mit KI-bezogenen Parametern
5. Prüfen Sie, ob Daten erscheinen

### Fehlersuche

Falls keine Daten erscheinen:

1. **Zugangsdaten prüfen**: Stellen Sie sicher, dass Mess-ID und API-Secret korrekt sind
2. **24 Stunden warten**: GA4 kann Verarbeitungsverzögerungen haben
3. **Property-Einstellungen prüfen**: Stellen Sie sicher, dass Ihre GA4-Property Measurement-Protocol-Daten akzeptiert
4. **Prüfen, ob KI-Traffic existiert**: Sehen Sie im Spyglasses-Dashboard „AI Traffic Analytics" nach Daten

## Verbindung trennen

So trennen Sie die Integration:
1. Klicken Sie auf „Trennen" bzw. „Entfernen"
2. Bestätigen Sie die Aktion
3. Spyglasses sendet ab sofort keine Daten mehr

Bereits in GA4 vorhandene historische Daten bleiben erhalten; gestoppt wird nur der künftige Datenfluss.

## Best Practices

### Ein eigenes API-Secret verwenden

Erstellen Sie ein API-Secret speziell für Spyglasses, statt eines aus anderen Integrationen wiederzuverwenden. So lässt sich der Zugriff bei Bedarf leichter widerrufen.

### Benutzerdefinierte Dimensionen anlegen

Für bessere Auswertungen in GA4 empfiehlt es sich, benutzerdefinierte Dimensionen anzulegen für:
- KI-Plattform (ChatGPT, Claude usw.)
- Besuchstyp (Zitation vs. Klick)
- Seitenabsicht (Page Intent)

### Mit nativen GA4-Daten kombinieren

Nutzen Sie Spyglasses-Daten zusammen mit Ihrem regulären GA4-Tracking, um:
- KI-vermittelten Traffic mit organischem Traffic zu vergleichen
- Conversion-Raten nach Traffic-Quelle zu verfolgen
- Ein einheitliches Reporting aufzubauen

### Datenqualität überwachen

Prüfen Sie regelmäßig:
- Ob weiterhin Daten fließen
- Ob die Event-Zahlen zwischen Spyglasses und GA4 übereinstimmen
- Ob es unerwartete Lücken in den Daten gibt

## Verwandte Themen

- [Erste Schritte](/docs/getting-started/overview) – Das Tracking-Plugin installieren
- [Anleitung zum GA4-API-Secret](/docs/analytics/ga4-api-secret) – Ausführliche Einrichtungsschritte
- [GA4-Zielgruppe für KI-Traffic](/docs/analytics/ga4-ai-audience) – Berichte erstellen, die mit diesen Daten funktionieren
- [AI Traffic Analytics](/docs/dashboards/ai-traffic-analytics) – KI-Traffic in Spyglasses ansehen