# Datenquellen verbinden

Erfahren Sie, wie Sie Google Analytics 4, Search Console, Google Ads, GitHub und andere Plattformen mit AI Data Stream verbinden.

AI Data Stream verbindet sich mit Ihren Analytics- und Marketing-Plattformen, damit die KI Ihre Daten in Echtzeit analysieren kann. Diese Anleitung behandelt jeden Verbindungstyp.

## Verbindungsübersicht

| Datenquelle | Free | Pro | Business | Authentifizierung |
|-------------|------|-----|----------|-------------------|
| Google Analytics 4 | Ja | Ja | Ja | OAuth |
| Google Search Console | Ja | Ja | Ja | OAuth |
| PageSpeed Insights | Ja | Ja | Ja | Keine (öffentlich) |
| Google Ads | - | Ja | Ja | OAuth |
| WordPress | - | Ja | Ja | Anwendungspasswort |
| HubSpot | - | - | Ja | Private App Token |
| GitHub | - | Ja | Ja | OAuth / Persönliches Zugriffstoken |
| Pipedrive | - | - | Ja | API-Schlüssel |

Alle Verbindungen sind **nur lesend**. Wir ändern niemals Ihre Daten.

---

## Google Analytics 4

GA4 ist die häufigste Verbindung. Sie liefert Website-Traffic, Nutzerverhalten, Conversions und E-Commerce-Daten.

### GA4 verbinden

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **Google Analytics 4**
3. Klicken Sie auf **Mit Google verbinden**
4. Melden Sie sich mit Ihrem Google-Konto an (verwenden Sie das Konto mit GA4-Zugang)
5. Überprüfen Sie die Berechtigungen und klicken Sie auf **Zulassen**
6. Wählen Sie aus, welche GA4-Properties Sie verbinden möchten
7. Klicken Sie auf **Bestätigen**

### Worauf wir zugreifen

- **Traffic-Metriken:** Sitzungen, Nutzer, Seitenaufrufe, Absprungrate
- **Akquisitionsdaten:** Traffic-Quellen, Kampagnen, Verweise
- **Verhalten:** Seiten pro Sitzung, durchschn. Sitzungsdauer
- **Conversions:** Ziele, Ereignisse, E-Commerce-Transaktionen
- **Demografien:** Land, Gerät, Browser

### Erforderliche Berechtigungen

Wir fordern an:

- `analytics.readonly` - Nur-Lese-Zugriff auf Ihre Analytics-Daten

Wir fordern KEINEN Schreibzugriff an.

### Fehlerbehebung

**"Keine Properties gefunden"**

- Stellen Sie sicher, dass Sie sich mit dem richtigen Google-Konto anmelden
- Prüfen Sie, ob Ihr Konto mindestens Betrachter-Zugang zur GA4-Property hat

**"Zugang verweigert"**

- Der Kontoinhaber muss Ihnen möglicherweise Zugang in GA4 Admin → Property-Zugang gewähren

---

## Google Search Console

Search Console liefert organische Suchdaten: Klicks, Impressionen, Keywords und Seitenrankings.

### Search Console verbinden

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **Google Search Console**
3. Klicken Sie auf **Mit Google verbinden**
4. Autorisieren Sie den Zugang
5. Wählen Sie aus, welche Search Console-Properties Sie verbinden möchten

### Property-Typen

Search Console hat zwei Property-Typen:

- **Domain-Properties** (z.B. `beispiel.de`) - Enthält alle Subdomains
- **URL-Präfix-Properties** (z.B. `https://www.beispiel.de/`) - Nur spezifische URLs

Beide funktionieren mit AI Data Stream. Wählen Sie, was Sie eingerichtet haben.

### Worauf wir zugreifen

- **Suchleistung:** Klicks, Impressionen, CTR, durchschnittliche Position
- **Abfragedaten:** Keywords, die Traffic bringen
- **Seitendaten:** Welche Seiten ranken und Klicks erhalten
- **Geräteaufschlüsselung:** Mobile, Desktop, Tablet-Performance

---

## PageSpeed Insights

PageSpeed liefert Core Web Vitals und Leistungsbewertungen. Keine Authentifizierung erforderlich – es verwendet öffentliche Daten.

### PageSpeed verbinden

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **PageSpeed Insights**
3. Geben Sie Ihre Website-URL ein
4. Klicken Sie auf **Verbinden**

### Worauf wir zugreifen

- **Lighthouse-Bewertungen:** Performance, Barrierefreiheit, Best Practices, SEO
- **Core Web Vitals:** LCP, FID, CLS
- **Performance-Metriken:** Speed Index, Time to Interactive
- **Verbesserungsmöglichkeiten:** Vorgeschlagene Optimierungen

---

## Google Ads

Verfügbar in **Pro und Business-Tarifen**. Verbinden Sie Ihr Google Ads-Konto, um die Kampagnenleistung zu analysieren.

### Bevor Sie verbinden

Der Zugang zur Google Ads API erfordert eine Genehmigung von Google. Falls noch nicht geschehen:

1. Ihr Google Ads-Konto muss in gutem Zustand sein
2. API-Zugang wird typischerweise automatisch für Standardkonten genehmigt
3. MCC (Manager)-Konten können alle Unterkonten verbinden

### Google Ads verbinden

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **Google Ads**
3. Klicken Sie auf **Mit Google verbinden**
4. Melden Sie sich mit Ihrem Google Ads-Konto an
5. Wählen Sie aus, welche Konten Sie verbinden möchten (falls Sie mehrere haben)
6. Klicken Sie auf **Bestätigen**

### Worauf wir zugreifen

- **Kampagnenleistung:** Impressionen, Klicks, Conversions, Kosten
- **Anzeigengruppen-Daten:** Leistung nach Anzeigengruppe
- **Keyword-Daten:** Suchbegriffe, Qualitätsfaktor
- **Conversion-Tracking:** Ziele und Werte
- **Budget und Ausgaben:** Aktuelle Ausgaben vs. Budget

---

## WordPress

Verfügbar in **Pro und Business-Tarifen**. Verbinden Sie WordPress, um Inhaltsdaten in Ihre Analyse einzubeziehen.

### WordPress verbinden

Funktioniert mit jeder WordPress-Seite ab Version 5.6 (Anwendungspasswörter sind integriert).

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **WordPress**
3. Geben Sie Ihre WordPress-Seiten-URL ein
4. Generieren Sie ein Anwendungspasswort in WordPress:
   - Gehen Sie zu WordPress Admin → Benutzer → Ihr Profil
   - Scrollen Sie zu "Anwendungspasswörter"
   - Geben Sie "AI Data Stream" als Anwendungsname ein
   - Klicken Sie auf "Neues Anwendungspasswort hinzufügen"
   - Kopieren Sie das Passwort (Sie sehen es nicht wieder)
5. Geben Sie Ihren WordPress-Benutzernamen und das Anwendungspasswort ein
6. Klicken Sie auf **Verbinden**

### Worauf wir zugreifen

- **Inhalte:** Beiträge, Seiten, benutzerdefinierte Inhaltstypen
- **Kategorien und Tags:** Inhaltsorganisation
- **Autoren:** Wer was veröffentlicht hat
- **Daten:** Veröffentlichungs- und Änderungsdaten

---

## GitHub

Verfügbar in **Pro und Business-Tarifen**. Verbinden Sie ein GitHub-Repository, um Code-Änderungen, Deployments und Releases mit Ihren Analytics-Daten zu korrelieren.

### Authentifizierungsoptionen

GitHub unterstützt zwei Authentifizierungsmethoden:

**Option A: OAuth (empfohlen)**

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **GitHub**
3. Klicken Sie auf **Mit GitHub verbinden**
4. Autorisieren Sie AI Data Stream für den Zugriff auf Ihre Repositories
5. Geben Sie den Repository-Eigentümer und -Namen ein
6. Klicken Sie auf **Bestätigen**

**Option B: Persönliches Zugriffstoken**

1. Gehen Sie zu [github.com/settings/tokens](https://github.com/settings/tokens)
2. Klicken Sie auf **Generate new token (classic)**
3. Nennen Sie es "AI Data Stream"
4. Wählen Sie den `repo`-Scope
5. Klicken Sie auf **Generate token** und kopieren Sie es
6. Wählen Sie in AI Data Stream **GitHub** und **Persönliches Zugriffstoken**
7. Fügen Sie das Token ein, geben Sie den Repository-Eigentümer und -Namen ein
8. Klicken Sie auf **Verbinden**

### Worauf wir zugreifen

- **Repository-Übersicht:** Sprache, Stars, Forks, Sichtbarkeit, Lizenz, Themen
- **Releases:** Tag-Namen, Veröffentlichungsdaten, Release-Notizen
- **Neueste Commits:** Commit-Nachrichten, Autoren, Daten (filterbar nach Branch, Datumsbereich oder Autor)
- **Commit-Aktivität:** Wöchentliche Commit-Häufigkeit der letzten 52 Wochen
- **Deployments:** Produktions-/Staging-Deployments mit Status und Umgebung
- **Issues:** Offene/geschlossene Issues mit Labels, Zugewiesenen, Zeitstempeln
- **Pull Requests:** Zusammengeführte/offene/geschlossene PRs mit Branch-Info, Merge-Daten und Labels

### Tool-Konfiguration

Jedes GitHub-Tool kann in den Verbindungseinstellungen einzeln aktiviert oder deaktiviert werden. Die Repository-Übersicht ist immer verfügbar; die anderen sechs Tools (Releases, Commits, Commit-Aktivität, Deployments, Issues, Pull Requests) können je nach Bedarf umgeschaltet werden.

### Anwendungsfälle

GitHub ist besonders leistungsstark in Kombination mit Analytics-Daten:

- **Deployment-Korrelation:** "Fiel der Traffic-Rückgang mit einem Deployment zusammen?"
- **Release-Auswirkung:** "Wie hat sich der Traffic nach dem v2.0-Release verändert?"
- **Bug-Tracking:** "Gibt es offene Issues, die den Conversion-Rückgang erklären könnten?"
- **Entwicklungsgeschwindigkeit:** "Wie vergleicht sich unsere Commit-Häufigkeit mit dem Traffic-Wachstum?"

---

## HubSpot

Verfügbar in **Business-Tarifen**. Verbinden Sie HubSpot CRM, um Deals, Kontakte und Pipeline-Zustand zu analysieren.

### Private App Token erstellen

1. Melden Sie sich bei Ihrem HubSpot-Konto an
2. Gehen Sie zu **Einstellungen → Integrationen → Private Apps**
3. Klicken Sie auf **Private App erstellen**
4. Benennen Sie sie "AI Data Stream"
5. Unter **Scopes** gewähren Sie Lesezugang zu: CRM (Kontakte, Unternehmen, Deals), Sales (Aktivitäten, Pipelines)
6. Klicken Sie auf **App erstellen**
7. Kopieren Sie das Zugriffstoken

### HubSpot verbinden

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **HubSpot**
3. Fügen Sie Ihr Private App-Zugriffstoken ein
4. Klicken Sie auf **Verbinden**

### Worauf wir zugreifen

- **Deals:** Pipeline, Stufen, Werte, Abschlussdaten
- **Kontakte:** Lead-Quellen, Lebenszyklusphasen
- **Unternehmen:** Zugehörige Deals und Kontakte
- **Aktivitäten:** Aufgaben, Anrufe, protokollierte E-Mails
- **Pipeline-Metriken:** Gewinnraten, Deal-Geschwindigkeit

---

## Pipedrive

Verfügbar in **Business-Tarifen**. Verbinden Sie Pipedrive, um Ihre Vertriebspipeline und Aktivitäten zu analysieren.

### Pipedrive verbinden

1. Gehen Sie zu Ihrer Property und klicken Sie auf **Verbindung hinzufügen**
2. Wählen Sie **Pipedrive**
3. Geben Sie Ihren Pipedrive API-Token ein:
   - In Pipedrive: Einstellungen → Persönliche Einstellungen → API
   - Kopieren Sie Ihren persönlichen API-Token
4. Fügen Sie das Token in AI Data Stream ein
5. Klicken Sie auf **Verbinden**

### Worauf wir zugreifen

- **Deals:** Pipeline-Stufen, Werte, Wahrscheinlichkeiten
- **Aktivitäten:** Anrufe, Meetings, Aufgaben
- **Personen und Organisationen:** Kontaktdaten
- **Pipeline-Gesundheit:** Konversionsraten, Deal-Alter
- **Produkte:** Falls Sie Pipedrive-Produkte nutzen

---

## Verbindungen verwalten

### Verbindungsstatus anzeigen

Jede Verbindung zeigt:

- **Aktiv/Inaktiv**-Schalter
- **Zuletzt synchronisiert**-Zeitstempel
- **Fehlerstatus** bei Problemen

### Verbindungen aktualisieren

Daten werden in Echtzeit abgefragt, aber wenn Sie OAuth-Token aktualisieren müssen:

1. Gehen Sie zum Tab **Verbindungen** Ihrer Property
2. Klicken Sie auf die Verbindung, die Sie aktualisieren möchten
3. Klicken Sie auf **Neu verbinden**, um sich erneut zu authentifizieren

### Verbindungen entfernen

1. Gehen Sie zu **Verbindungen**
2. Klicken Sie auf die zu entfernende Verbindung
3. Klicken Sie auf **Verbindung löschen**
4. Bestätigen Sie die Entfernung

Dies hat keine Auswirkungen auf Ihre Daten in der Originalplattform.

### Verbindungseinstellungen

Jede Verbindung hat Einstellungen, die steuern, wie sie in der App erscheint:

**Im Dashboard anzeigen**

- Schalten Sie um, ob die Widgets dieser Verbindung auf Ihrem Property-Dashboard erscheinen
- Nützlich, um Verbindungen auszublenden, die Sie nicht täglich überwachen müssen

**Im Chat anzeigen**

- Schalten Sie um, ob diese Verbindung standardmäßig im KI-Chat aktiviert ist
- Wenn deaktiviert, fragt die KI diese Datenquelle nicht ab, es sei denn, Sie aktivieren sie manuell in einer Konversation
- Hilft, den Kontext zu reduzieren und sich auf bestimmte Datenquellen zu konzentrieren
- Sie können diese Standardeinstellungen jederzeit in einzelnen Konversationen überschreiben

Um diese Einstellungen zu ändern:

1. Gehen Sie zum Tab **Verbindungen** Ihrer Property
2. Finden Sie die Verbindung, die Sie konfigurieren möchten
3. Klicken Sie auf das Dashboard-Symbol (📊), um die Dashboard-Sichtbarkeit umzuschalten
4. Klicken Sie auf das Chat-Symbol (💬), um die Chat-Sichtbarkeit umzuschalten
5. Oder klicken Sie auf **Bearbeiten** für weitere Optionen

---

## Fehlerbehebung

### OAuth-Fehler

**"Zugriffstoken abgelaufen"**

- Klicken Sie auf **Neu verbinden**, um sich erneut zu authentifizieren

**"Unzureichende Berechtigungen"**

- Stellen Sie sicher, dass Ihr Konto die erforderliche Zugangsstufe hat
- Für GA4/GSC: Mindestens Betrachter-Rolle
- Für Google Ads: Standard- oder Admin-Zugang

### Verbindungs-Timeouts

**"Verbindungs-Timeout"**

- Große Datensätze können länger dauern
- Versuchen Sie, nach einem kürzeren Datumsbereich zu fragen

### Daten werden nicht angezeigt

**"Keine Daten gefunden"**

- Prüfen Sie, ob der Datumsbereich Daten enthält
- Verifizieren Sie, dass die richtige Property verbunden ist
- Bei neuen Verbindungen warten Sie einige Minuten für die erste Synchronisierung

### Ratenlimits

**"Ratenlimit überschritten"**

- Zu viele Anfragen an die Plattform
- Warten Sie einige Minuten und versuchen Sie es erneut
- Erwägen Sie, Anfragen zu kombinieren

## Nächste Schritte

- [Ein Gespräch mit Ihren Daten starten](/de/docs/using-ai-chat/)
- [Anmerkungen für Kontext hinzufügen](/de/docs/annotations/)
- [Berichte über Ihre Daten ausführen](/de/docs/reports/)
