Michel van LuijtelaarL'integrazione dei dati locali di GMBapi.com con BigQuery apre nuove potenti funzionalità, consentendo analisi dati avanzate, reportistica personalizzata e integrazione senza soluzione di continuità con i tuoi strumenti esistenti. Questa guida ti accompagna passo dopo passo nella configurazione dell'integrazione con BigQuery e ti mostra come massimizzare il suo potenziale per la tua attività.
Cosa ottieni con la nostra integrazione BigQuery
Con questa integrazione, puoi:
Accedere a tabelle BigQuery
organizzate e strutturate (senza dump di dati grezzi).
Le tabelle vengono aggiornate quotidianamente con i dati più recenti dai tuoi GBP.
Genera i tuoi report e approfondimenti personalizzati su Google
Business Profile.
Integra i nostri approfondimenti direttamente nella tua piattaforma, software o sito web.
Utilizza il codice fornito per replicare le visualizzazioni presenti sul nostro sito web sui tuoi report o sul tuo sito web!
Requisiti per l'integrazione di BigQuery e GMBapi.com
Prima di configurare l'integrazione di BigQuery, assicurati di quanto segue:
Hai un account GMBapi.com attivo con tutte le tue sedi sincronizzate!
Hai un account di fatturazione attivo associato al tuo Google Cloud Project.
Hai creato un account di servizio con i seguenti ruoli:BigQuery Data Editor - Necessario per creare/modificare una tabella all'interno del tuo GCPBigQuery Job User - Necessario per pianificare ed eseguire query
Condividi l'email dell'account di servizio e il/i nome/i degli account in app.gmbapi.com che dovrebbero ricevere l'accesso.
Una volta condiviso l'accesso alle tabelle, puoi pianificare query utilizzando l'account di servizio creato nel tuo progetto BigQuery.
Guida passo passo per configurare l'integrazione di BigQuery
*Se hai già creato un account Google Cloud Platform con la fatturazione configurata, puoi passare al Passaggio 3
Passaggio 1: Crea un progetto Google Cloud
Vai a Google Cloud Platform.
Crea un nuovo progetto o selezionane uno esistente.
Passaggio 2: imposta i dettagli di fatturazione
Vai alla Google Cloud Console .
Nel menu a sinistra, seleziona “Fatturazione ” → quindi clicca su “Gestisci account di fatturazione ”.
Scegli l'organizzazione appropriata (se applicabile) e clicca su “Crea account ”.
Inserisci un nome per il tuo account di fatturazione, seleziona il tuo paese e collegalo all'organizzazione corretta.
Aggiungi un metodo di pagamento valido e invia per abilitare la fatturazione.
Passaggio 2.1. Collega il tuo account di fatturazione al progetto
Nella Cloud Console, seleziona il progetto che desideri collegare.
Naviga nella sezione “Fatturazione ”.
Se richiesto, seleziona l'account di fatturazione da collegare a questo progetto.
Per cambiare account di fatturazione in seguito, fai clic su “Gestisci account di fatturazione ” e scegli l'opzione appropriata.
⚠️ Nota: Senza la fatturazione abilitata, le query programmate e altre operazioni BigQuery non verranno eseguite.
Fase 3: Creare e configurare un account di servizio
Nel tuo progetto Google Cloud, vai su IAM e Amministrazione > Account di servizio .
Fai clic su Crea account di servizio .
Dai un nome al tuo account di servizio (ad esempio,
“Integrazione BigQuery ”).Assegna i seguenti ruoli per garantire che l'account di servizio abbia accesso per pianificare le query e creare tabelle all'interno del GCP: Editor dati BigQuery Utente job BigQuery
Completa la creazione dell'account di servizio e copia l'indirizzo email generato.
Passaggio 4: Condividi l'email dell'account di servizio
Condividi l'email dell'account di servizio con il nostro team di supporto o tramite il tuo portale di gestione dell'integrazione.
Inoltre, conferma l'account GMBapi.com (gruppo di località GBP) a cui desideri che l'account di servizio acceda.
I dati sono archiviati per account GBP e l'accesso esplicito è richiesto per ciascuno.
Nota: Se in futuro hai bisogno di accedere ad altri account GBP, ripeti semplicemente il Passaggio 3 in poi per ogni nuovo account.
Passaggio 5: Configura BigQuery
Vai su BigQuery nella tua Google Cloud Console.
Crea un nuovo set di dati o selezionane uno esistente.
Importante : Imposta la regione del set di dati su europe-west4 (Paesi Bassi).
Questo è necessario per il trasferimento dei dati utilizzando una query pianificata; le regioni di origine e di destinazione devono corrispondere. Poiché GMBapi.com memorizza i dati nei Paesi Bassi, anche il tuo set di dati deve trovarsi in quella regione per consentire il trasferimento.
Nota: Se necessario, puoi in seguito replicare o migrare i tuoi dati in un'altra regione. Scopri di più 👉 Replicazione dei dati di BigQuery
Passaggio 6: Accedi e utilizza i tuoi dati
Una volta concesso l'accesso, hai due modi principali per lavorare con i tuoi dati:
Query pianificate (Consigliato)
Utilizza le query pianificate nel tuo progetto BigQuery per copiare i dati organizzati da GMBapi.com nel tuo set di dati. Questo garantisce accesso e proprietà dei dati a lungo termine.
Utilizza le credenziali dell'account di servizio quando imposti le query pianificate.
Accesso diretto tramite API BigQuery
In alternativa, puoi utilizzare le credenziali dell'account di servizio per accedere ai dati direttamente tramite l'API BigQuery all'interno del tuo codice.
✅ Raccomandazione: Per un controllo, una portabilità e una protezione futura migliori, consigliamo di creare una copia delle tabelle all'interno del proprio progetto GCP, tramite query pianificate o programmaticamente utilizzando l'API BigQuery.
Il nostro team fornirà modelli SQL pronti all'uso e snippet di codice visivo per aiutarti a iniziare rapidamente.
Esempi di casi d'uso per l'integrazione di BigQuery
Report personalizzati
Genera report personalizzati specifici per le tue esigenze aziendali, approfondendo le metriche di performance SEO locali.
Integrazione con la piattaforma
Integra le nostre informazioni senza problemi nel tuo CRM, nella dashboard del sito web o in qualsiasi piattaforma di analisi utilizzata dalla tua azienda.
Analisi avanzata
Sfrutta le potenti capacità di analisi di BigQuery per individuare tendenze, opportunità e insight utili più velocemente che mai.
Richiedere assistenza
Se riscontri difficoltà in qualsiasi punto del processo, il nostro team è a tua disposizione. Non esitare a contattarci se non sei sicuro di come impostare le autorizzazioni, creare account di servizio o pianificare query. Ci impegniamo a rendere il tuo processo di integrazione agevole e di successo.
Richiedi l'accesso a un gruppo di località e avvia una prova gratuita. Quindi:
Contatta il nostro team di supporto.
Imposta il tuo progetto BigQuery.
Assicurati che il tuo account di fatturazione sia attivo.
Crea un account di servizio con i ruoli corretti.
Condividi l'email dell'account di servizio e i nomi degli account app.gmbapi.com pertinenti.
Inizia a pianificare le query per recuperare le tabelle di dati strutturati.
Per assistenza dettagliata, accedi alla nostra documentazione completa o contatta direttamente il nostro team di supporto per ottimizzare la tua esperienza di integrazione con BigQuery.
Sfrutta appieno il potenziale dei tuoi dati SEO locali con la nostra solida integrazione BigQuery, rendendo le decisioni più intelligenti e basate sui dati più facili che mai.
Domande frequenti su GMBapi.com e l'integrazione BigQuery
Domande frequenti
Per configurare l'integrazione, è necessario un account GMBapi.com attivo con le posizioni sincronizzate, un progetto Google Cloud con fatturazione abilitata e un account di servizio con i ruoli BigQuery corretti. Una volta che questi sono a posto, il nostro team può concedere l'accesso a tabelle BigQuery strutturate che si aggiornano quotidianamente con i dati del tuo Profilo dell'attività su Google.
L'account di servizio deve avere i ruoli BigQuery Data Editor e BigQuery Job User. Il ruolo Data Editor consente all'account di creare e modificare tabelle all'interno del progetto, mentre il ruolo Job User rende possibile pianificare ed eseguire query. Senza questi ruoli, l'integrazione e i trasferimenti di dati non funzioneranno correttamente.
Il tuo set di dati deve essere situato in europe-west4 perché GMBapi.com memorizza i suoi dati nei Paesi Bassi. Google richiede che le regioni di origine e di destinazione corrispondano affinché i trasferimenti di dati funzionino. Se le regioni non sono allineate, le query pianificate e le pipeline di dati falliranno. Se necessario, puoi successivamente replicare o migrare i dati in una regione diversa, ma il set di dati iniziale deve essere in europe-west4.
Le tabelle BigQuery vengono aggiornate quotidianamente con i dati più recenti dei tuoi Profili dell'attività su Google. Ciò garantisce che le tue analisi, dashboard e report riflettano sempre le ultime metriche di performance SEO locali senza la necessità di aggiornamenti manuali.
Puoi accedere ai tuoi dati in due modi principali. Il metodo consigliato è quello di utilizzare le query pianificate, che copiano le tabelle strutturate da GMBapi.com nel tuo progetto BigQuery in modo da mantenere il controllo e la proprietà a lungo termine. In alternativa, puoi utilizzare l'API BigQuery per interrogare i dati direttamente con le credenziali del tuo account di servizio. La maggior parte delle aziende sceglie le query pianificate poiché offrono maggiore flessibilità e portabilità.
Sì, l'integrazione è progettata per funzionare senza problemi con i tuoi strumenti esistenti. Una volta che i tuoi dati sono disponibili in BigQuery, puoi connetterli direttamente alle tue dashboard, sistemi CRM, siti web o piattaforme di analisi. Molte aziende utilizzano questa funzionalità per creare dashboard personalizzate o integrare le informazioni nei loro flussi di lavoro esistenti.
In caso di problemi, sia con l'impostazione dell'account di servizio, l'abilitazione della fatturazione o la pianificazione delle query, puoi contattare il team di supporto di GMBapi.com. Il nostro team è disponibile per guidarti attraverso il processo e assicurarsi che la tua integrazione funzioni senza intoppi dall'inizio alla fine.
