Guide d'aide BigQuery
Dernière mise à jour le jeudi 9 janvier 2025
Suivez ces étapes pour connecter vos données AccuRanker à Google BigQuery.
Conditions préalables
Pour connecter BigQuery à AccuRanker, vous devez disposer des éléments suivants :
- Un abonnement AccuRanker de 20 000 mots clés ou plus.
- Contacter le support client d'AccuRanker pour demander l'activation de Big Query.
- Un compte Google Cloud avec une instance Google BigQuery.
- Facturation activée sur Google BigQuery.
- Des autorisations permettant d'attribuer des rôles spécifiques à un compte de service Google.
Guide étape par étape pour configurer l'accès à BigQuery
1. Créer un compte de service
Suivez la documentation de Google sur la création d'une clé de compte de service pour configurer l'authentification de la clé de compte de service.
2. Configurer les autorisations du compte de service
Nous prenons en charge trois scénarios d'autorisation différents pour accorder les autorisations nécessaires au compte de service. Si vous n'avez pas encore configuré les autorisations, lisez la documentation de Google intitulée Gérer l'accès aux comptes de service.
Vous pouvez accorder l'accès au projet ou à un seul ensemble de données.
Vous pouvez accorder l'accès au projet ou à un seul jeu de données. | Permissions Type | Rôle | Ressource | |------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| | BigQuery Admin Role | BigQuery Admin | Projet ou jeu de données déjà créé | | BigQuery Data Owner et BigQuery Job User | BigQuery Data Owner
BigQuery Job User | Projet ou jeu de données déjà créé | | Rôles IAM personnalisés | bigquery.tables.create
bigquery.tables.get
bigquery.tables.update
bigquery.tables.updateData
bigquery.tables.delete
bigquery.jobs.create | Projet ou jeu de données déjà créé |
Création de clés de compte de service
Pour utiliser le flux de compte de service, vous devez fournir le fichier JSON pour votre compte de service.
- Créez une nouvelle clé en sélectionnant le format JSON.
- Cliquez sur Créer.
- Téléchargez le fichier JSON dans un emplacement sécurisé ; ce fichier est essentiel pour se connecter à BigQuery.
Terminer la configuration de BigQuery
- Accédez au domaine que vous souhaitez connecter à BigQuery.
- Dans l'aperçu, cliquez sur "Intégrations" où vous trouverez l'intégration BigQuery.
- Donnez un nom à la connexion et indiquez un emplacement pour le jeu de données.
- Si vous n'êtes pas sûr de l'emplacement, vous pouvez vous renseigner sur les différents emplacements ici.
- Téléchargez la clé JSON du compte de service et cliquez sur "Connecter".
- Si vous avez déjà créé un jeu de données, assurez-vous que l'emplacement du jeu de données correspond à celui du jeu de données déjà créé.Nous testerons alors la connexion et vous inviterons à le faire lorsque la connexion aura été testée avec succès.
(Facultatif) Remplissage des données historiques
Vous pouvez maintenant aller dans les paramètres de votre domaine et lancer un backfill de vos données AccuRanker si vous avez besoin de données historiques.
Comment nous mettons à jour BigQuery et remplissons les données
Nous veillons à ce que nos données BigQuery soient mises à jour quotidiennement pour refléter les changements les plus récents. Chaque jour, nous ajoutons les nouvelles données de la veille. Cette approche garantit que tous les ensembles de données critiques restent à jour tout en préservant les enregistrements historiques à des fins d'analyse.
Processus de mise à jour quotidienne
Le processus de mise à jour se concentre sur les ensembles de données suivants :
Tous les classements* et les propres classements*
- Ces ensembles de données sont mis à jour quotidiennement par l'ajout de nouvelles données.
- Ils permettent de conserver un enregistrement complet et actualisé des classements.
Métadonnées des mots-clés* et métadonnées des concurrents*
- Ces ensembles de données sont complétés si nécessaire.
- De nouveaux enregistrements sont incorporés ou les enregistrements existants sont actualisés afin de garantir que les métadonnées restent exactes et complètes.
Cycle de mise à jour mensuel
Outre les mises à jour quotidiennes, les ensembles de données Searchvolume* et AI*search_volume sont gérés selon un cycle mensuel.
- Calendrier des mises à jour: Le 15 de chaque mois, ces tableaux sont tronqués et remplacés par les données les plus récentes du planificateur de mots clés de Google (GKP) et les mesures de volume de recherche mises à jour.
- Objectif: Ce processus permet de disposer des informations les plus précises et les plus récentes.
- Données historiques: Ces ensembles de données comprennent des données rétablies couvrant les quatre dernières années, offrant ainsi une perspective historique solide pour l'analyse des tendances.
Remplir les données
Après une connexion réussie, vous pouvez choisir de remplir vos données. Voici comment cela fonctionne :
- Étendue: Déterminez jusqu'où vous souhaitez rétablir les données. Vous pouvez rétablir les données jusqu'à la date de votre premier classement.
- Restrictions: Pour éviter les comportements malveillants, vous ne pouvez rétablir les données qu'une seule fois. Si vous avez besoin d'effectuer un nouveau remplissage, vous devez en faire la demande auprès de l'assistance clientèle.
Guide du schéma BigQuery
La convention d'appellation des tables sera la suivante
accuranker{schemaname}{notredomaineinternelug}
Les noms des schémas sont répertoriés ci-dessous et chaque schéma peut être téléchargé au format JSON.
- métadonnées_mots_clés
- données_concurrents
- rangs_propres
- tous_les_rangs
- volume_de_recherche
- Volume de recherche AI
Descriptions des tables
| Nom de la table | Description | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks
| Cette table contient toutes les informations sur le classement des mots clés, y compris les classements dynamiques et les concurrents. | Cette table contient toutes les informations sur le classement des mots clés, y compris les classements dynamiques et les concurrents. | Cette table contient les détails des mots-clés
actuellement suivis, y compris les balises et les paramètres spécifiques au domaine. | Cette table contient des détails
sur les mots-clés actuellement suivis, y compris les balises et les paramètres spécifiques au domaine. | Ce tableau contient le volume
de recherche mensuel pour chaque mot-clé. Si le mot-clé a un emplacement, il indique les volumes de recherche spécifiques à l'emplacement et au niveau du pays. Si aucun lieu n'est spécifié, le volume de recherche est le même pour les deux. | ai_search_volume
| Ce tableau contient le volume de recherche mensuel de l'IA pour chaque mot-clé. Il comprend le volume de recherche* pour un type de recherche spécifique et le volume*_total pour les deux types de recherche combinés. |