BigQuery Helpgids

Laatst bijgewerkt op donderdag 9 januari 2025

Volg deze stappen om uw AccuRanker data te verbinden met Google BigQuery.

Vereisten

Om BigQuery met AccuRanker te verbinden, heb je nodig:

  • Een AccuRanker-abonnement met 20K trefwoorden of meer.
  • Neem contact op met de klantenservice van AccuRanker met een verzoek om BigQuery in te schakelen.
  • Een Google Cloud account met een Google BigQuery instance.
  • Ingeschakelde facturering op Google BigQuery.
  • Machtigingen om specifieke rollen toe te wijzen voor een Google service account.

Stap-voor-stap handleiding voor het instellen van toegang tot BigQuery

1. Serviceaccount maken

Volg de documentatie over het maken van een serviceaccountsleutel van Google om de verificatie van de serviceaccountsleutel in te stellen.

2. Serviceaccount machtigingen instellen

We ondersteunen drie verschillende machtigingsscenario's om de benodigde machtigingen toe te kennen aan de serviceaccount. Als je nog niet eerder machtigingen hebt ingesteld, lees dan Google's documentatie Toegang tot serviceaccounts beheren.

Je kunt toegang verlenen tot het project of tot een enkele dataset.

| Type rechten | Rol | Hulpbron | | ------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| | BigQuery Admin Rol | BigQuery Admin | Project of dataset al aangemaakt | BigQuery Data Owner en BigQuery Job User | BigQuery Data Owner

BigQuery Job User | Project of dataset al aangemaakt | Aangepaste IAM rollen | bigquery.tables.create

bigquery.tables.get

bigquery.tables.update

bigquery.tabellen.updateData

bigquery.tables.delete

bigquery.jobs.create | Project of dataset al aangemaakt |

Service account sleutels aanmaken

Om de service account flow te gebruiken, moet je het JSON-bestand voor je service account aanleveren.

  1. Maak een nieuwe sleutel door JSON-indeling te selecteren.
  2. Klik op Create.
  3. Download het JSON-bestand naar een veilige locatie; dit bestand is essentieel voor het verbinden met BigQuery.

BigQuery configuratie voltooien

  1. Ga naar het domein waarmee je verbinding wilt maken met BigQuery.
  2. Klik in het overzicht op "Integraties" waar je de BigQuery integratie kunt vinden.bigqueryintegration.png
  3. Geef de verbinding een naam en specificeer een locatie voor de dataset.
  • Als je twijfelt over de locatie, kun je hier meer lezen over de verschillende locaties.
  1. Upload de Service Account JSON-sleutel en klik op "Verbinden".
  • Als je al een dataset hebt gemaakt, zorg er dan voor dat de locatie van de dataset overeenkomt met de reeds gemaakte dataset.createbigqueryconnection.pngWe zullen dan de verbinding testen en je vragen wanneer de verbinding met succes is getest.

(Optioneel) Historische gegevens terugvullen

U kunt nu naar uw domein instellingen gaan en een backfill van uw AccuRanker data starten als u historische data nodig heeft.

Hoe wij BigQuery en Backfill data updaten

Wij zorgen ervoor dat onze BigQuery data dagelijks wordt bijgewerkt om de meest recente wijzigingen weer te geven. Elke dag voegen we nieuwe data van de vorige dag toe. Deze aanpak zorgt ervoor dat alle belangrijke datasets actueel blijven terwijl historische records voor analyse behouden blijven.

Dagelijks updateproces

Het updateproces richt zich op de volgende datasets:

Alle* rangen en Eigen* rangen.

  • Deze datasets worden dagelijks bijgewerkt door nieuwe gegevens toe te voegen.
  • Ze onderhouden een uitgebreid en actueel overzicht van rankings.

Trefwoordmetadata* en Concurrent*metadata

  • Deze datasets worden waar nodig aangevuld.
  • Nieuwe records worden toegevoegd of bestaande worden vernieuwd om ervoor te zorgen dat de metadata accuraat en volledig blijven.

Maandelijkse updatecyclus

Naast dagelijkse updates worden de datasets Searchvolume* en AI*search_volume maandelijks beheerd.

  • Bijwerkschema: Op de 15e van elke maand worden deze tabellen ingekort en vervangen door de meest recente gegevens van de Google Keyword Planner (GKP) en bijgewerkte zoekvolume statistieken.
  • Doel: Dit proces zorgt ervoor dat de meest accurate en recente inzichten beschikbaar zijn.
  • Historische gegevens: Deze datasets bevatten backfilled data van de afgelopen vier jaar, wat een robuust historisch perspectief biedt voor trendanalyse.

Backfill gegevens

Na een succesvolle verbinding kunt u ervoor kiezen om uw gegevens te backfillen. Dit is hoe het werkt:

  • Bereik: Bepaal hoe ver terug je wilt backfillen. Je kunt gegevens helemaal terugzetten tot de datum van je eerste rang.
  • Beperkingen: Om kwaadaardig gedrag te voorkomen, kun je maar één keer backfillen. Als u opnieuw moet backfillen, moet u dit aanvragen via de klantenservice.

BigQuery Schema Gids

De naamgevingsconventie voor de tabellen is

accuranker{schemaname}{onzeinternaldomainslug}

De schema namen staan hieronder en elk schema kan gedownload worden in JSON formaat.

Tabel Beschrijvingen

| Tabel Naam | Beschrijving | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks | Deze tabel bevat alle informatie over keyword rankings, inclusief dynamische rankings en concurrenten. | own_ranks | Deze tabel bevat alle informatie over trefwoord rankings die u volgt. | keyword_metadata | Deze tabel bevat details van de huidige getraceerde trefwoorden, inclusief tags en domeinspecifieke instellingen. | Concurrent_metadata | Deze tabel bevat details van momenteel gevolgde concurrenten, inclusief instellingen voor concurrenten. | Zoekvolume Deze tabel bevat het maandelijkse zoekvolume voor elk trefwoord. Als het trefwoord een locatie heeft, toont het zowel locatie-specifieke als land-niveau zoekvolumes. Als er geen locatie is opgegeven, is het zoekvolume hetzelfde voor beide. | Deze tabel bevat het maandelijkse AI-zoekvolume voor elk trefwoord. Het bevat zoekvolume* voor een specifiek zoektype en zoekvolume*_totaal voor beide zoektypes samen. |