Guida di BigQuery
Ultimo aggiornamento il giovedì 9 gennaio 2025
Seguite questi passaggi per collegare i dati di AccuRanker con Google BigQuery.
Prerequisiti
Per collegare BigQuery ad AccuRanker, sono necessari:
- Un abbonamento AccuRanker da 20K parole chiave o superiore.
- Contattare l'assistenza clienti di AccuRanker per richiedere l'abilitazione di BigQuery.
- Un account Google Cloud con un'istanza di Google BigQuery.
- Fatturazione abilitata su Google BigQuery.
- Autorizzazioni per l'assegnazione di ruoli specifici per un account di servizio Google.
Guida passo-passo all'impostazione dell'accesso a BigQuery
1. Creare un account di servizio
Seguite la documentazione di Google su Creare una chiave dell'account di servizio per impostare l'autenticazione della chiave dell'account di servizio.
2. Impostazione dei permessi dell'account di servizio
Supportiamo tre diversi scenari di autorizzazione per concedere le autorizzazioni necessarie all'account di servizio. Se non avete mai impostato le autorizzazioni, leggete la documentazione di Google Manage access to service accounts.
È possibile concedere l'accesso al progetto o a un singolo set di dati.
| Tipo di autorizzazione | Ruolo | Risorsa | |------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| | Ruolo di amministratore di BigQuery | Amministratore di BigQuery | Progetto o dataset già creato | Proprietario dei dati di BigQuery e Utente del lavoro di BigQuery | Proprietario dei dati di BigQuery
Utente del lavoro BigQuery | Progetto o dataset già creato | | Ruoli IAM personalizzati | bigquery.tables.create
bigquery.tables.get
bigquery.tables.update
bigquery.tables.updateData
bigquery.tables.delete
bigquery.jobs.create | Progetto o dataset già creato |
Creare le chiavi dell'account di servizio
Per utilizzare il flusso dell'account di servizio, è necessario fornire il file JSON dell'account di servizio.
- Creare una nuova chiave selezionando il formato JSON.
- Fare clic su Crea.
- Scaricare il file JSON in un luogo sicuro; questo file è essenziale per la connessione a BigQuery.
Terminare la configurazione di BigQuery
- Accedere al dominio che si desidera collegare a BigQuery.
- Nella panoramica, fare clic su "Integrazioni", dove si trova l'integrazione BigQuery.
- Assegnare un nome alla connessione e specificare una posizione per il set di dati.
- Se non siete sicuri della posizione, potete leggere qui le informazioni sulle diverse posizioni.
- Caricare la chiave JSON dell'account di servizio e fare clic su "Connetti".
- Se è già stato creato un set di dati, assicurarsi che la posizione del set di dati corrisponda a quella del set di dati già creato.Verrà quindi testata la connessione e verrà richiesto quando la connessione è stata testata con successo.
(Opzionale) Ricarica dei dati storici
Ora è possibile accedere alle impostazioni del dominio e avviare un backfill dei dati di AccuRanker, se si necessita di dati storici.
Come aggiorniamo BigQuery e i dati di backfill
Ci assicuriamo che i nostri dati BigQuery siano aggiornati quotidianamente per riflettere le modifiche più recenti. Ogni giorno aggiungiamo i nuovi dati del giorno precedente. Questo approccio garantisce che tutti i set di dati critici rimangano aggiornati, preservando i record storici per l'analisi.
Processo di aggiornamento quotidiano
Il processo di aggiornamento si concentra sui seguenti set di dati:
Tutti i ranghie* I propri ranghi *.
- Questi set di dati vengono aggiornati quotidianamente con l'aggiunta di nuovi dati.
- Mantengono un registro completo e aggiornato delle classifiche.
Metadati delle parole chiave* e metadati dei concorrenti*
- Questi set di dati vengono incrementati secondo le necessità.
- Vengono incorporati nuovi record o aggiornati quelli esistenti per garantire che i metadati rimangano accurati e completi.
Ciclo di aggiornamento mensile
Oltre agli aggiornamenti quotidiani, i dataset Searchvolume* e AI*search_volume sono gestiti con un ciclo mensile.
- Programma di aggiornamento: Il 15 di ogni mese, queste tabelle vengono troncate e sostituite con i dati più recenti di Google Keyword Planner (GKP) e con le metriche aggiornate del volume di ricerca.
- Scopo: questo processo garantisce la disponibilità di informazioni più accurate e recenti.
- Dati storici: Questi set di dati includono dati retrodatati che coprono gli ultimi quattro anni, fornendo una solida prospettiva storica per l'analisi delle tendenze.
Riempimento dei dati
Dopo una connessione riuscita, è possibile scegliere di ricaricare i dati. Ecco come funziona:
- Ambito: Decidere fino a che punto si desidera effettuare il backfill. È possibile ricaricare i dati fino alla data del primo grado.
- Restrizioni: Per evitare comportamenti dannosi, è possibile eseguire il backfill solo una volta. Se è necessario eseguire nuovamente il backfill, è necessario richiederlo all'assistenza clienti.
Guida agli schemi di BigQuery
La convenzione di denominazione delle tabelle sarà
accuranker{schemaname}{nostrointernaldomainslug}
I nomi degli schemi sono elencati di seguito e ogni schema può essere scaricato in formato JSON.
Descrizioni delle tabelle
| Nome tabella | Descrizione | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks
| Questa tabella contiene tutte le informazioni sulla classifica delle parole chiave, comprese le classifiche dinamiche e i concorrenti. | | own_ranks
| Questa tabella contiene tutte le informazioni sulle classifiche delle parole chiave di cui si tiene traccia. | | keyword_metadata
| Questa tabella contiene i dettagli delle parole chiave attualmente tracciate, compresi i tag e le impostazioni specifiche del dominio. | | competitor_metadata
| Questa tabella contiene i dettagli dei concorrenti attualmente tracciati, comprese le impostazioni per i concorrenti. | | search_volume
| Questa tabella contiene il volume di ricerca mensile per ogni parola chiave. Se la parola chiave ha una località, mostra i volumi di ricerca sia specifici per la località che a livello di Paese. Se non viene specificata alcuna località, il volume di ricerca è lo stesso per entrambe. | Questa tabella contiene il volume di ricerca mensile di AI per
ogni parola chiave. Include il volume di ricerca* per un tipo di ricerca specifico e il volume di ricerca*totale per entrambi i tipi di ricerca combinati. |