Vai al contenuto principale

​
Looker Studio Connector

Il community connector di Finseo ti permette di importare i tuoi dati sulla visibilità nella ricerca AI direttamente in Google Looker Studio. Crea dashboard personalizzate e report per i clienti con i dati di performance del tuo brand da ChatGPT, Perplexity, Google AI Overviews, Gemini e Grok.

​
Cosa ti serve

  • Un account Finseo con un piano a pagamento e almeno un progetto di tracking
  • Una API key Finseo con scope read — creane una nella dashboard in Settings → API → Create Key
  • Un account Google con accesso a Looker Studio

​
Guida al setup

1

Apri il connettore Finseo

Apri il link del connettore Finseo mentre sei connesso con il tuo account Google.
2

Autorizza il connettore

Google richiede un’autorizzazione una tantum affinché il connettore possa recuperare i dati per tuo conto. Clicca su Authorize e conferma.
3

Inserisci la tua API key Finseo

Incolla la tua API key (inizia con sk_live_) e clicca su Submit. Se non ne hai ancora una, creane una in Settings → API → Create Key.
4

Configura la sorgente dati

Scegli il tuo project, un report type e, facoltativamente, un AI model filter e un tag filter (separati da virgola).
5

Connetti e crea

Clicca su Connect, controlla l’elenco dei campi, poi Create Report. Usa il selettore di intervallo date di Looker Studio per controllare il periodo.
La tua API key viene memorizzata per ogni utente Google da Looker Studio. Puoi sostituirla in qualsiasi momento tramite Edit connection.

​
Tipi di report

Il selettore di intervallo date in Looker Studio controlla il periodo (fino a 90 giorni). Tutti i tipi di report restituiscono gli stessi numeri che vedi nella dashboard di Finseo. Il tag filter opzionale (separato da virgola, es. Nonbrand, Kaufberatung) limita ogni tipo di report ai prompt che hanno almeno uno di quei tag — utile per pagine di report separate branded vs non-branded.

​
Campi disponibili

Visibilità per giorno: Data, Visibilità % (KPI della dashboard), Menzioni del brand, Risposte AI analizzate, Posizione media %, Punteggio di sentiment, Prompt monitorati Ranking dei competitor: Posizione, Competitor, Dominio, È il tuo brand, Menzioni, Tasso di visibilità %, Posizione media %, Punteggio di sentiment Fonti più citate: Posizione, Dominio della fonte, URL della fonte, Tipo di fonte, Tipo di URL, Citazioni, Prompt che citano, Tasso di citazione % Performance dei prompt: Prompt, Tag, Lingua, Brand visibile, Brand principale, Menzioni del brand, Posizione media %, Punteggio di sentiment, Citazioni del proprio dominio, Risposte AI analizzate, Competitor trovati, Fonti trovate Query fan-out: Query fan-out, Modelli, Prompt di esempio, Ultima rilevazione, Occorrenze, Prompt che le attivano

​
Suggerimenti

  • Usa una sorgente dati per ogni progetto e tipo di report. Puoi aggiungere più sorgenti dati a un singolo report per combinare, ad esempio, il trend giornaliero con il ranking dei competitor.
  • Fondi la sorgente dati di visibilità con i tuoi dati di Search Console per confrontare fianco a fianco la ricerca classica e la ricerca AI.
  • Le risposte vengono messe in cache per cinque minuti, quindi le esecuzioni di tracking molto recenti possono impiegare un momento prima di comparire.

​
Risoluzione dei problemi

  • “Invalid credentials” — la tua API key è stata revocata, è scaduta o non ha lo scope read. Crea una nuova key in Settings → API.
  • Progetto assente dal menu a tendina — la key è limitata a progetti specifici. Crea una key con accesso a tutti i progetti o aggiungi il progetto alla key.
  • Report vuoto — controlla l’intervallo di date: il connettore restituisce i dati dei giorni in cui il tuo progetto ha effettivamente raccolto risposte AI.
Hai bisogno di aiuto? Contatta il supporto o il tuo account manager Finseo.