AI Visibility Daten in Looker Studio

Verbinden Sie Ihre AI-Sichtbarkeitsdaten mit Google Looker Studio für individuelle Dashboards und Berichte.

TL;DR

Generieren Sie einen persönlichen API-Schlüssel in Ihren Kontoeinstellungen, richten Sie den Looker Studio Community Connector ein (oder verwenden Sie den JSON-Connector) und geben Sie Ihren API-Schlüssel ein. Ihre AI-Sichtbarkeitsdaten — einschließlich Sichtbarkeitswerte, Erwähnungen und Sentimentanalysen von ChatGPT, Gemini, Perplexity und Claude — stehen als Looker Studio-Datenquelle für individuelle Dashboards zur Verfügung.

Inhaltsverzeichnis
  1. Was ist die Looker Studio-Integration?
  2. Voraussetzungen
  3. Schritt-für-Schritt-Anleitung
    1. API-Schlüssel generieren
    2. Connector einrichten
    3. Daten verbinden
  4. Verfügbare Datenfelder
  5. API-Referenz
  6. Connector-Skript herunterladen
  7. FAQ

Was ist die Looker Studio-Integration?

Die Looker Studio-Integration ermöglicht es Ihnen, Ihre AI-Sichtbarkeits-Monitoring-Daten in Google Looker Studio (ehemals Google Data Studio) zu importieren. Damit können Sie:

  • Individuelle Dashboards erstellen, die auf Ihre Berichtsanforderungen zugeschnitten sind
  • AI-Sichtbarkeitsdaten mit anderen Marketing-Datenquellen kombinieren
  • Interaktive Berichte mit Ihrem Team oder Kunden teilen
  • Automatisierte E-Mail-Berichte mit geplanter Zustellung einrichten
  • Trends über verschiedene AI-Plattformen im Zeitverlauf visualisieren

Jeder Benutzer greift nur über seinen persönlichen API-Schlüssel auf seine eigenen Daten zu. Ihre Daten werden nie mit anderen Benutzern geteilt.

Voraussetzungen

  • Ein aktives AI Visibility Tool-Konto (jeder Plan)
  • Mindestens ein Themenfeld mit abgeschlossenen Analyseergebnissen
  • Ein Google-Konto mit Zugriff auf Looker Studio

Schritt-für-Schritt-Anleitung

Schritt 1: API-Schlüssel generieren

  1. Melden Sie sich in Ihrem AI Visibility Tool-Konto an.
  2. Klicken Sie auf Ihre E-Mail-Adresse im Menü oben rechts.
  3. Select "API Keys" from the dropdown menu under "Integrations".
  4. Klicken Sie auf "API-Schlüssel erstellen" und geben Sie einen beschreibenden Namen ein (z.B. "Looker Studio").
  5. Kopieren Sie den API-Schlüssel sofort — er wird nur einmal angezeigt.
Wichtig: Der API-Schlüssel wird nach der Erstellung nur einmal angezeigt. Bewahren Sie ihn sicher auf. Wenn Sie ihn verlieren, müssen Sie einen neuen Schlüssel erstellen.

Ihr API-Schlüssel beginnt mit dem Präfix avt_ gefolgt von 48 Zeichen. Sie können bis zu 3 aktive API-Schlüssel gleichzeitig haben.

Schritt 2: Connector einrichten

Es gibt zwei Möglichkeiten, Ihre Daten mit Looker Studio zu verbinden:

Option A: Community Connector (Empfohlen)
  1. Laden Sie das Connector-Skript herunter (siehe unten).
  2. Gehen Sie zu script.google.com und erstellen Sie ein neues Projekt.
  3. Fügen Sie den Connector-Skriptcode in den Editor ein.
  4. Aktualisieren Sie die API_BASE_URL Variable auf Ihre Deployment-URL.
  5. Stellen Sie das Skript bereit: Klicken Sie auf "Bereitstellen" → "Neue Bereitstellung" → Typ: "Add-on" → Bereitstellen.
  6. Kopieren Sie die Bereitstellungs-ID zur Verwendung in Looker Studio.
Option B: JSON-Connector (Kein Skript erforderlich)
  1. Open Looker Studio and click "Create" → "Data Source".
  2. Search for the "JSON" or "Custom JSON/CSV" connector.
  3. Geben Sie die API-URL ein: https://your-domain.com/api/v1/looker/data
  4. Fügen Sie den Authorization-Header hinzu: Authorization: Bearer YOUR_API_KEY
  5. Konfigurieren Sie die Datumsparameter nach Bedarf.

Schritt 3: Daten verbinden

  1. In Looker Studio, click "Create" → "Data Source".
  2. Wählen Sie Ihren Connector (Community Connector oder JSON-Connector).
  3. Geben Sie Ihren API-Schlüssel ein, wenn Sie dazu aufgefordert werden.
  4. Click "Connect" — the available fields will be loaded automatically.
  5. Click "Create Report" to start building your dashboard.
Tipp: Beginnen Sie mit einem Datumsbereichsdiagramm und einer Tabelle mit Sichtbarkeitswerten nach AI-System, um einen schnellen Überblick über Ihre Daten zu erhalten.

Verfügbare Datenfelder

Die folgenden Dimensionen und Metriken sind in Looker Studio verfügbar:

Dimensionen

Feld Geben Sie Beschreibung
date Datum Das Datum, an dem die Analyse durchgeführt wurde (JJJJ-MM-TT)
topic_area Text Name des überwachten Themenfelds (Auswahl)
prompt Text Der an das AI-System gesendete Prompt-Text
category Text Dem Prompt zugewiesene Kategorie
funnel_stage Text Marketing-Funnel-Stufe (z.B. Bekanntheit, Überlegung, Entscheidung)
ai_system Text Die abgefragte AI-Plattform (z.B. ChatGPT, Gemini, Perplexity, Claude)
brand Text Die Marke, die auf Erwähnungen verfolgt wird

Metriken

Feld Geben Sie Beschreibung
visibility_score Zahl Gesamt-Sichtbarkeitswert (0–100) für die Marke in der AI-Antwort
mention_count Zahl Anzahl der Erwähnungen der Marke in der AI-Antwort
position_score Zahl Positionsranking-Wert — höhere Werte bedeuten frühere Erwähnungen
sentiment_score Zahl Sentimentwert von -1 (negativ) bis +1 (positiv)
web_search_used Boolean Ob das AI-System eine Websuche zur Generierung der Antwort verwendet hat

API-Referenz

Die REST-API verwendet Ihren persönlichen API-Schlüssel zur Authentifizierung. Alle Endpunkte geben JSON zurück.

Authentifizierung

Fügen Sie Ihren API-Schlüssel in jede Anfrage ein, indem Sie eine dieser Methoden verwenden:

  • Header (empfohlen): Authorization: Bearer avt_your_key_here
  • Query-Parameter: ?api_key=avt_your_key_here

Endpunkte

GET /api/v1/looker/schema

Gibt das Schema (Felddefinitionen) für die Datenquelle zurück.

Beispielanfrage:

curl -H "Authorization: Bearer avt_your_key_here" \
  https://your-domain.com/api/v1/looker/schema
GET /api/v1/looker/data

Gibt die tatsächlichen Sichtbarkeitsdaten zurück. Unterstützt Filter und Paginierung.

Parameter:

Parameter Geben Sie Beschreibung
date_from String Startdatum (JJJJ-MM-TT)
date_to String Enddatum (JJJJ-MM-TT)
selection_id Integer Nach Themenfeld-ID filtern
ai_system String Nach AI-System filtern (z.B. chatgpt, gemini, perplexity, claude)
limit Integer Anzahl der zurückzugebenden Datensätze (Standard: 1000)
offset Integer Anzahl der zu überspringenden Datensätze (Standard: 0)

Beispielanfrage:

curl -H "Authorization: Bearer avt_your_key_here" \
  "https://your-domain.com/api/v1/looker/data?date_from=2025-01-01&date_to=2025-01-31&limit=500"
GET /api/v1/looker/selections

Gibt eine Liste Ihrer Themenfelder (Auswahlen) mit ihren IDs zurück. Verwenden Sie diese IDs zum Filtern von Datenanfragen.

Beispielanfrage:

curl -H "Authorization: Bearer avt_your_key_here" \
  https://your-domain.com/api/v1/looker/selections

Rate Limit: Die API erlaubt bis zu 100 Anfragen pro Minute pro API-Schlüssel. Looker Studio speichert Daten automatisch zwischen, sodass dieses Limit bei normaler Nutzung selten erreicht wird.

Connector-Skript herunterladen

Laden Sie die Google Apps Script-Datei für den Community Connector herunter:

Connector-Skript herunterladen (connector.gs)

Öffnen Sie nach dem Herunterladen die Datei in einem Texteditor, aktualisieren Sie die API_BASE_URL und fügen Sie den Code in ein neues Google Apps Script-Projekt ein.

FAQ

Die Looker Studio-Integration ist in allen Plänen verfügbar, einschließlich des kostenlosen Plans. Jeder Benutzer kann API-Schlüssel generieren und seine Daten mit Looker Studio verbinden.

Nein. Jeder API-Schlüssel ist an Ihr persönliches Konto gebunden. Die API gibt nur Daten aus Ihren eigenen Themenfeldern und Analyseergebnissen zurück. Es gibt keine Möglichkeit, auf die Daten anderer Benutzer zuzugreifen.

Sie können bis zu 3 aktive API-Schlüssel gleichzeitig haben. Sie können unbenutzte Schlüssel löschen und jederzeit neue erstellen.

API-Schlüssel werden aus Sicherheitsgründen nur einmal bei der Erstellung angezeigt. Wenn Sie einen Schlüssel verlieren, löschen Sie ihn auf Ihrer API-Schlüssel-Seite und erstellen Sie einen neuen. Aktualisieren Sie dann den Schlüssel in Ihrer Looker Studio-Datenquellenkonfiguration.

Looker Studio ruft bei jedem Öffnen oder Aktualisieren eines Berichts aktuelle Daten von der API ab. Sie können auch die Datenaktualisierungseinstellungen in Looker Studio konfigurieren. Die zugrunde liegenden AI-Sichtbarkeitsdaten werden aktualisiert, wenn Sie neue Analysen im Tool durchführen.

Stellen Sie sicher, dass Ihr API-Schlüssel korrekt und noch aktiv ist. Überprüfen Sie die API-Schlüssel-Seite in Ihrem Konto, um den Schlüsselstatus zu verifizieren. Wenn der Schlüssel gelöscht oder deaktiviert wurde, erstellen Sie einen neuen und aktualisieren Sie ihn in Ihren Looker Studio-Connector-Einstellungen.

Ja. Die REST-API ist eine Standard-JSON-API, die mit jedem Tool funktioniert, das HTTP-Anfragen senden kann — einschließlich Excel, Google Sheets, Power BI, Tableau, Python-Skripte und mehr.
Zurück zur Dokumentation