Come integrare GMBapi.com in BigQuery
L'integrazione dei dati locali di GMBapi.com con BigQuery apre nuove e potenti funzionalità, consentendo analisi avanzate dei dati, report personalizzati e una perfetta integrazione con i tuoi strumenti esistenti. Questa guida ti accompagna passo dopo passo nella configurazione dell'integrazione di BigQuery e nella massimizzazione del suo potenziale per la tua attività.
Cosa ottieni con la nostra integrazione BigQuery
Con questa integrazione, puoi:
Accedere a tabelle BigQuery
organizzate e strutturate (nessun dump di dati grezzi).
Le tabelle sono aggiornate quotidianamente con i dati più recenti dei tuoi GBP.
Genera i tuoi report e approfondimenti personalizzati di 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 di integrazione con BigQuery e GMBapi.com
Prima di configurare l'integrazione di BigQuery, assicurati di avere quanto segue:
Hai un account GMBapi.com attivo con tutte le tue sedi sincronizzate!
Hai un account di fatturazione attivo associato al tuo progetto Google Cloud.
Hai creato un account di servizio con i seguenti ruoli:Editor dati BigQuery - Necessario per creare/modificare una tabella all'interno del tuo GCPUtente processo BigQuery - Necessario per pianificare ed eseguire query
Condividi l'email dell'account di servizio e il 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 punto Fase 3
Fase 1: Crea un progetto Google Cloud
Naviga su Google Cloud Platform.
Crea un nuovo progetto o seleziona uno esistente.
Passaggio 2: imposta i dettagli di fatturazione
Vai alla Google Cloud Console .
Dal menu a sinistra, seleziona “Fatturazione ” → quindi fai clic su “Gestisci account di fatturazione ”.
Scegli l'organizzazione appropriata (se applicabile) e fai clic 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.
Passo 2.1. Collega il tuo account di fatturazione al progetto
Nella Cloud Console, seleziona il progetto che vuoi collegare.
Naviga alla sezione “Fatturazione ”.
Se richiesto, seleziona l'account di fatturazione da collegare a questo progetto.
Per cambiare account di fatturazione in seguito, clicca “Gestisci account di fatturazione ” e scegli l'opzione appropriata.
⚠️ Nota: Senza la fatturazione abilitata, le query pianificate e altre operazioni BigQuery non verranno eseguite.
Fase 3: Creare e configurare un account di servizio
Nel tuo progetto Google Cloud, vai a IAM e amministrazione > Account di servizio .
Clicca su Crea account di servizio .
Assegna un nome al tuo account di servizio (es.
“Integrazione BigQuery ”).Assegna i seguenti ruoli per garantire che l'account di servizio abbia accesso per programmare query e creare tabelle all'interno del GCP: Editor dati di BigQuery Utente processo BigQuery
Completa la creazione dell'account di servizio e copia l'indirizzo email generato.
Fase 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 sedi GBP) a cui desideri che l'account di servizio acceda.
I dati vengono archiviati per ciascun account GBP e per ognuno è richiesto l'accesso esplicito.
Nota: Se in futuro avrai bisogno di accedere ad altri account GBP, ripeti semplicemente la Fase 3 in avanti per ogni nuovo account.
Fase 5: Configura BigQuery
Vai a BigQuery all'interno della 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 trasferire i dati utilizzando una query pianificata; le regioni di origine e di destinazione devono corrispondere. Poiché GMBapi.com archivia i dati nei Paesi Bassi, anche il tuo set di dati deve trovarsi in quella regione per abilitare il trasferimento.
Nota: Se necessario, puoi successivamente replicare o migrare i tuoi dati in un'altra regione. Scopri di più 👉 Replica dei dati 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)
Usa 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.
Usa le credenziali dell'account di servizio quando imposti le query pianificate.
Accesso Diretto tramite API BigQuery
In alternativa, puoi usare le credenziali dell'account di servizio per accedere ai dati direttamente tramite l'API BigQuery all'interno del tuo codice.
✅ Raccomandazione: Per un migliore controllo, portabilità e a prova di futuro, raccomandiamo di creare una copia delle tabelle all'interno del tuo progetto GCP tramite query pianificate o programmaticamente usando l'API BigQuery.
Il nostro team fornirà modelli SQL pronti all'uso e snippet di codice visuale per aiutarti a iniziare rapidamente.
Casi d'Uso Esempio per l'Integrazione con BigQuery
Report Personalizzati
Genera report su misura specifici per le tue esigenze aziendali, approfondendo le metriche di performance SEO locali.
Integrazione con la Piattaforma
Integra le nostre intuizioni senza soluzione di continuità nel tuo CRM, nella dashboard del tuo sito web o in qualsiasi piattaforma di analisi usata dalla tua attività.
Analisi Avanzata
Sfrutta le potenti capacità analitiche di BigQuery per individuare tendenze, opportunità e insight attuabili più velocemente che mai.
Ottenere Aiuto
Se ti blocchi in qualsiasi punto del processo, il nostro team è qui per assisterti. Non esitare a contattarci se non sei sicuro di come impostare le autorizzazioni, creare account di servizio o programmare query. Ci impegniamo a rendere il tuo processo di integrazione fluido e di successo.
Richiedi l'accesso a un gruppo di sedi e inizia una prova gratuita. Poi:
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 programmare query per recuperare tabelle di dati strutturati.
Per assistenza dettagliata, accedi alla nostra documentazione completa o contatta direttamente il nostro team di supporto per semplificare la tua esperienza di integrazione con BigQuery.
Sfrutta appieno il potenziale dei tuoi dati SEO locali con la nostra solida integrazione BigQuery, rendendo più facili che mai le decisioni più intelligenti e basate sui dati.
Domande frequenti su GMBapi.com e l'integrazione con BigQuery
Domande Frequenti
Per impostare l'integrazione, hai bisogno di un account GMBapi.com attivo con le tue sedi 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 tuo progetto, mentre il ruolo Job User rende possibile programmare 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 destinazione corrispondano affinché i trasferimenti di dati funzionino. Se le regioni non sono allineate, le query programmate 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 dai tuoi Profili dell'attività su Google. Ciò garantisce che le tue analisi, dashboard e report riflettano sempre le metriche più recenti delle prestazioni SEO locali senza la necessità di aggiornamenti manuali.
Puoi accedere ai tuoi dati in due modi principali. Il metodo consigliato è quello di utilizzare query programmate, 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 programmate 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 collegarli 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.
Se riscontri problemi, sia con la configurazione 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 problemi dall'inizio alla fine.
