So verbinden Sie LLM Pulse mit Tableau

Sie können Tableau-Dashboards mit Ihren Daten aus LLM Pulse erstellen, ohne eine Zeile Code zu schreiben. Die API von LLM Pulse liefert auf Wunsch eine einfache Tabelle, und Tableau liest sie über den REST API Connector ein, den Tableau im Tableau Exchange veröffentlicht.

Warum es keinen Connector von LLM Pulse für Tableau gibt

Das Framework Web Data Connector von Tableau ist veraltet. Für APIs wie unsere empfiehlt Tableau seinen REST API Connector, und genau den verwendet diese Anleitung.

Für Sie ist der Unterschied in der Praxis gering: Sie installieren einen Connector von Tableau statt einen von uns und fügen eine URL ein.

Das benötigen Sie

• Einen API-Schlüssel von LLM Pulse. API-Schlüssel sind ab Tarif Scale verfügbar. Erstellen Sie einen unter Kontomenü > API-Schlüssel.
• Tableau Desktop 2023.3 oder neuer.
• Den REST API Connector von Tableau, installiert aus dem Tableau Exchange. Dabei wird auch ein Treiber installiert. Folgen Sie deshalb den Installationshinweisen von Tableau.

Schritt 1: Daten-URL zusammenstellen

Nur unterstützte tabellarische Lese-Endpunkte akzeptieren output=csv. Hängen Sie den Parameter an einen unterstützten Endpunkt an, damit dieser eine flache Tabelle zurückgibt, die Tableau direkt lesen kann.

Der häufigste Ausgangspunkt ist die Zeitreihe Ihrer Kennzahlen zur Sichtbarkeit:

https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=YOUR_PROJECT_ID&range=90&granularity=week&metrics=mentions,visibility,citation_rate,ai_visibility_score&competitors=ALL_COMPETITOR_IDS&output=csv

Ihre Projekt-ID finden Sie in der URL jeder Projektseite, die IDs Ihrer Wettbewerber unter Wettbewerber oder über den Endpunkt /dimensions/competitors.

Schritt 2: Verbindung in Tableau herstellen

1. Wählen Sie in Tableau Desktop Verbinden > Zu einem Server > REST API.
2. Fügen Sie die URL aus Schritt 1 ein.
3. Stellen Sie die Authentifizierung auf Bearer token und fügen Sie Ihren API-Schlüssel von LLM Pulse ein.
4. Stellen Sie das Antwortformat auf CSV.
5. Laden Sie die Daten.

Tableau erstellt einen Extrakt mit einer Zeile pro Datum, Akteur und Kennzahl.

Schritt 3: Ansichten erstellen

Die Zeitreihentabelle hat diese Spalten:

Spalte	Bedeutung
date	Beginn des Tages, der Woche oder des Monats, je nach angeforderter zeitlicher Auflösung
actor_type	project für Ihre Marke, competitor für einen Wettbewerber im Tracking
actor_name, actor_domain, actor_id	Auf welchen Akteur sich die Zeile bezieht
metric	Welche Kennzahl die Zeile enthält
value	Der Wert, auf derselben Skala wie in der App

Da die Tabelle im Langformat vorliegt, kann ein einziges Arbeitsblatt jede Kennzahl darstellen: Ziehen Sie date auf „Spalten“, value auf „Zeilen“ und actor_name auf „Farbe“, und filtern Sie nach metric. Fügen Sie einen zweiten Filter für metric hinzu, und Sie haben ein ganzes Dashboard aus einer einzigen Datenquelle.

Weitere nützliche Tabellen

Tauschen Sie den Endpunkt in der URL aus und behalten Sie output=csv bei:

Was Sie brauchen	Endpunkt
Share of Voice im Zeitverlauf	/metrics/sov
Momentaufnahme des Share of Voice als Ranking	/metrics/sov mit view=current
Top-4-Wettbewerber plus Sonstige	/metrics/sov mit view=breakdown
Leistung je Prompt	/metrics/prompt_summary
Am häufigsten zitierte Domains	/metrics/top_sources
Einzelne Erwähnungen und Zitierungen	/dimensions/mentions, /dimensions/citations
Daten aus der Google Search Console	/search_console/timeseries, /search_console/queries, /search_console/pages

Die vollständige Referenz aller Parameter finden Sie im Artikel REST-API im Überblick oder in der API-Dokumentation.

Gut zu wissen

• Aktualisierungen erfolgen über Extrakte, nicht live. Der REST API Connector von Tableau lädt die Daten in einen Extrakt. Planen Sie deshalb eine Aktualisierung in dem Rhythmus, den Sie benötigen. Prompt-Ausführungen folgen dem für Ihr Konto eingestellten Tracking-Rhythmus: täglich, wöchentlich oder monatlich.
• Vergleichen Sie Marken anhand von Prompts ohne Markenbezug. Fügen Sie brand_kind=non_brand an eine beliebige Kennzahlen-URL an, um Ihre Marke fair mit Wettbewerbern zu vergleichen. Prompts, die eine Marke nennen, bevorzugen naturgemäß diese Marke. So geht standardmäßig auch die Übersicht in der App vor.
• Paginierte Endpunkte liefern jeweils eine Seite. /metrics/prompt_summary, /metrics/top_sources, die Listen unter /dimensions/* und die Endpunkte der Search Console liefern bis zu 100 Zeilen pro Anfrage. Die Gesamtzahl der Zeilen steht im Antwort-Header X-Total-Count. Erhöhen Sie also per_page oder blättern Sie mit page weiter, um alles zu laden.
• Sehr große Abrufe sind begrenzt. Eine einzelne Anfrage liefert höchstens 200.000 Zeilen. Erreichen Sie diese Grenze, verkürzen Sie den Zeitraum, fordern Sie weniger Kennzahlen an oder verwenden Sie granularity=week.
• Textzellen werden für Tabellenkalkulationen maskiert. Ein Prompt, der mit = oder - beginnt, wird mit einem vorangestellten Apostroph zurückgegeben, damit er nie als Formel interpretiert wird.

Fehlerbehebung

Tableau zeigt alles in einer einzigen Spalte. Als Antwortformat ist JSON eingestellt. Stellen Sie es in den Einstellungen des Connectors auf CSV um.

Fehler 401 oder 403. Prüfen Sie, ob das Token als Bearer-Token gesendet wird, ob der Schlüssel unter Kontomenü > API-Schlüssel aktiv ist und ob Ihr Tarif API-Zugriff enthält (ab Tarif Scale). Die Endpunkte der Search Console setzen zusätzlich mindestens den Tarif Growth und eine verbundene Property voraus.

Fehler 422 mit Hinweis auf output. Dieser Endpunkt unterstützt keine tabellarische Ausgabe. Verwenden Sie einen der oben aufgeführten unterstützten Endpunkte.

Leere Tabelle. Prüfen Sie, ob die Projekt-ID stimmt und ob der Zeitraum Ausführungen enthält. Warten Sie bei einem neuen Projekt, bis die erste Prompt-Ausführung abgeschlossen ist, bevor Sie Daten in der Tabelle erwarten.

Tableau meldet keine Spalten. Die Tabellen für Zeitreihe, Zusammenfassung und Share of Voice liefern immer ihre Kopfzeile, auch für einen leeren Zeitraum. Die übrigen Endpunkte bilden ihre Spalten aus den Zeilen selbst. Ein Zeitraum ohne Daten liefert daher eine leere Datei ohne Kopfzeile, und Tableau findet kein Schema, das es lesen kann. Richten Sie die Verbindung auf einen Zeitraum mit Daten aus und aktualisieren Sie dann.