Data Studio: creare report con i dati di AutoPSEO

AutoPSEO non pubblica un connettore per Data Studio, lo strumento di dashboard di Google chiamato in precedenza Looker Studio. Puoi comunque rappresentare i suoi dati in grafici in tre modi: con il connettore Search Console di Google per i dati grezzi, con un CSV esportato da un report di AutoPSEO, oppure con un foglio Google che uno script pianificato compila a partire dalla REST API di AutoPSEO. La scelta dipende da quanto deve essere aggiornata la dashboard e dal fatto che servano le analisi di AutoPSEO o soltanto le metriche grezze.

Opzione 1: il connettore Search Console di Google

Il connettore di Google legge direttamente Search Console, quindi fornisce le metriche grezze ma nessuna delle analisi di AutoPSEO. Secondo la guida di Google al connettore:

• Offre due tabelle, Site Impression e URL Impression, e ogni origine dati ne usa una sola. Aggiungi due origini dati al report per mostrarle entrambe.
• Servono almeno i permessi di visualizzazione sulla proprietà Search Console, con l'accesso a entrambi i prodotti effettuato con lo stesso account Google.
• Site Impression copre i risultati web, immagini, video e notizie; URL Impression aggiunge Discover e Google News.

Per aggiungerlo, scegli Create → Data Source → Search Console, seleziona il sito, la tabella e il tipo di ricerca predefinito, quindi fai clic su Connect.

Opzione 2: caricare un CSV da AutoPSEO

Per una dashboard una tantum o mensile, esporta una tabella da uno qualsiasi dei report (Esportazione dei dati) e aggiungila con il connettore di caricamento file CSV di Data Studio. I requisiti di caricamento di Google determinano come esportare:

• I campi devono essere separati da virgole, quindi imposta prima Account → CSV export format su Standard (US / UK).
• Il file deve essere in UTF-8 e avere una riga di intestazione, come accade per le esportazioni di AutoPSEO.
• Ogni file aggiunto a un set di dati deve avere esattamente le stesse colonne nello stesso ordine, quindi esporta ogni volta lo stesso report con le stesse colonne e la stessa impostazione di confronto.
• I nuovi file vengono accodati e i duplicati non vengono rimossi, quindi non caricare intervalli di date sovrapposti.
• Un file può pesare fino a 100 MB e ogni utente dispone di 2 GB di spazio per i caricamenti.

Le percentuali vengono esportate con il simbolo di percentuale (27.03%), quindi controlla i tipi di campo dopo il caricamento.

Opzione 3: un foglio Google alimentato dalla REST API

Per una dashboard che si mantiene aggiornata da sola, fai scrivere a un processo pianificato i dati di AutoPSEO in un foglio Google e collega il foglio. Il connettore Fogli Google verifica la presenza di valori modificati e nuove righe a ogni interrogazione del report.

1. In AutoPSEO apri MCP & API e crea una chiave API con ambito Read only. Viene mostrata una sola volta, quindi conservala tra i segreti del tuo processo.
2. Dal processo pianificato (Google Apps Script, un cron job o uno strumento di workflow) chiama la REST API e scrivi le righe nel foglio.
3. In Data Studio aggiungi il foglio con il connettore Fogli Google e seleziona Use first row as headers.

Una chiamata per ottenere le query principali degli ultimi 28 giorni si presenta così:

curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
  -H "Authorization: Bearer apk_live_..."

Ogni risposta è in JSON, con il risultato in data e i dettagli della chiamata in meta. La REST API espone gli stessi 19 strumenti Search Console e GA4 del server MCP: proprietà, righe di search analytics, query, pagine e paesi principali, confronto tra periodi, variazioni di posizionamento, posizionamenti nuovi e persi, decadimento dei contenuti, cannibalizzazione, benchmark del CTR, page poaching, ispezione degli URL, sitemap, annotazioni e, per GA4, panoramica, suddivisione ed eventi chiave. Le query e le pagine principali restituiscono fino a 1,000 righe, i paesi principali fino a 300 e search-analytics fino a 5,000 righe grezze per una o due dimensioni. Le chiamate sono limitate a 60 al minuto per chiave e a 1,000 all'ora per account, e il documento OpenAPI 3.1 disponibile a https://app.autopseo.com/v1/openapi.json descrive ogni parametro.

Quale opzione scegliere

Se la dashboard serve soprattutto a mostrare i numeri a un cliente, un link di condivisione del report o un report pianificato su Slack o Teams può richiedere meno lavoro. La nostra FAQ su Search Console in Looker Studio approfondisce il connettore di Google.