BigQuery-Hilfe-Leitfaden

Zuletzt aktualisiert am Donnerstag, 9. Januar 2025

Folgen Sie diesen Schritten, um Ihre AccuRanker-Daten mit Google BigQuery zu verbinden.

Voraussetzungen

Um BigQuery mit AccuRanker zu verbinden, benötigen Sie:

  • Ein AccuRanker-Abonnement mit 20K Keywords oder mehr.
  • Kontaktieren Sie den AccuRanker-Kundensupport mit einer Anfrage zur Aktivierung von BigQuery.
  • Ein Google Cloud-Konto mit einer Google BigQuery-Instanz.
  • Aktivierte Rechnungsstellung für Google BigQuery.
  • Berechtigungen zur Zuweisung bestimmter Rollen für ein Google-Service-Konto.

Schritt-für-Schritt-Anleitung zum Einrichten des BigQuery-Zugriffs

1. Service-Konto erstellen

Befolgen Sie die Google-Dokumentation Schlüssel für ein Servicekonto erstellen, um die Authentifizierung für den Schlüssel des Servicekontos einzurichten.

2. Einrichten von Servicekonto-Berechtigungen

Wir unterstützen drei verschiedene Berechtigungsszenarien, um die erforderlichen Berechtigungen für das Servicekonto zu erteilen. Wenn Sie die Berechtigungen noch nicht eingerichtet haben, lesen Sie die Dokumentation Zugriff auf Servicekonten verwalten von Google.

Sie können entweder Zugriff auf das Projekt oder auf einen einzelnen Datensatz gewähren.

| BigQuery Admin Role | BigQuery Admin | Project or Dataset already created | BigQuery Data Owner and BigQuery Job User | BigQuery Data Owner

BigQuery Job User | Projekt oder Dataset bereits erstellt | | Benutzerdefinierte IAM-Rollen | bigquery.tables.create

bigquery.tables.get

bigquery.tables.update

bigquery.tables.updateData

bigquery.tables.delete

bigquery.jobs.create | Projekt oder Dataset bereits erstellt |

Servicekonto-Schlüssel erstellen

Um den Dienstkontenfluss zu verwenden, müssen Sie die JSON-Datei für Ihr Dienstkonto bereitstellen.

  1. Erstellen Sie einen neuen Schlüssel, indem Sie das JSON-Format auswählen.
  2. Klicken Sie auf Erstellen.
  3. Laden Sie die JSON-Datei an einen sicheren Ort herunter; diese Datei ist für die Verbindung mit BigQuery erforderlich.

BigQuery-Konfiguration abschließen

  1. Wechseln Sie zu der Domäne, die Sie mit BigQuery verbinden möchten.
  2. Klicken Sie in der Übersicht auf "Integrationen", wo Sie die BigQuery-Integration finden können.bigqueryintegration.png
  3. Geben Sie der Verbindung einen Namen und legen Sie einen Speicherort für das Dataset fest.
  • Wenn Sie sich über den Speicherort nicht sicher sind, können Sie sich hier über die verschiedenen Speicherorte informieren.
  1. Laden Sie den JSON-Schlüssel für das Dienstkonto hoch und klicken Sie auf "Verbinden".
  • Wenn Sie bereits ein Dataset erstellt haben, vergewissern Sie sich, dass der Speicherort des Datasets mit dem bereits erstellten Dataset übereinstimmt.createbigqueryconnection.pngWir testen dann die Verbindung und fragen Sie, wenn die Verbindung erfolgreich getestet wurde.

(Optional) Historische Daten wieder auffüllen

Sie können nun zu Ihren Domain-Einstellungen gehen und ein Backfill Ihrer AccuRanker-Daten starten, wenn Sie historische Daten benötigen.

Wie wir BigQuery und Backfill-Daten aktualisieren

Wir stellen sicher, dass unsere BigQuery-Daten täglich aktualisiert werden, um die neuesten Änderungen widerzuspiegeln. Jeden Tag fügen wir neue Daten vom Vortag hinzu. Auf diese Weise wird sichergestellt, dass alle wichtigen Datensätze auf dem neuesten Stand bleiben und gleichzeitig historische Datensätze für Analysen erhalten bleiben.

Täglicher Aktualisierungsprozess

Der Aktualisierungsprozess konzentriert sich auf die folgenden Datensätze:

Alle* Ränge und eigene* Ränge

  • Diese Datensätze werden täglich durch Hinzufügen neuer Daten aktualisiert.
  • Sie sorgen für eine umfassende und aktuelle Aufzeichnung der Rankings.

Keyword-Metadaten* und Mitbewerber-Metadaten*

  • Diese Datensätze werden nach Bedarf ergänzt.
  • Neue Datensätze werden aufgenommen oder bestehende aktualisiert, um sicherzustellen, dass die Metadaten korrekt und vollständig bleiben.

Monatlicher Update-Zyklus

Zusätzlich zu den täglichen Aktualisierungen werden die Datensätze Searchvolume* und AI*search_volume in einem monatlichen Zyklus verwaltet.

  • Zeitplan für die Aktualisierung: Am 15. eines jeden Monats werden diese Tabellen gekürzt und durch die neuesten Daten aus dem Google Keyword-Planer (GKP) und aktualisierte Suchvolumenmetriken ersetzt.
  • Zweck: Durch diesen Prozess wird sichergestellt, dass die genauesten und aktuellsten Erkenntnisse zur Verfügung stehen.
  • Historische Daten: Diese Datensätze enthalten Backfill-Daten aus den letzten vier Jahren, die eine solide historische Perspektive für Trendanalysen bieten.

Backfill-Daten

Nach einer erfolgreichen Verbindung können Sie sich dafür entscheiden, Ihre Daten mit Backfill zu versehen. Und so funktioniert's:

  • Umfang: Entscheiden Sie, wie weit Sie zurückgehen möchten. Sie können die Daten bis zum Datum Ihres ersten Ranges zurückverfolgen.
  • Beschränkungen: Um böswilliges Verhalten zu vermeiden, können Sie die Daten nur einmal zurückverfolgen. Wenn Sie ein weiteres Backfill benötigen, müssen Sie dies über den Kundensupport beantragen.

BigQuery-Schema-Leitfaden

Die Namenskonvention für die Tabellen lautet

accuranker{schemaname}{unserinternaldomainslug}

Die Schemanamen sind unten aufgeführt und jedes Schema kann im JSON-Format heruntergeladen werden.

Tabellenbeschreibungen

| Tabellenname | Beschreibung | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks | Diese Tabelle enthält alle Informationen zum Keyword-Ranking, einschließlich dynamischer Rankings und Wettbewerber. | own_ranks | Diese Tabelle enthält alle Informationen zu Keyword-Rankings, die Sie verfolgen. | keyword_metadata | Diese Tabelle enthält Details zu den aktuell verfolgten Keywords, einschließlich Tags und domainspezifische Einstellungen. | | competitor_metadata | Diese Tabelle enthält Details zu den aktuell getrackten Wettbewerbern, einschließlich der Einstellungen für Wettbewerber. | | search_volume | Diese Tabelle enthält das monatliche Suchvolumen für jedes Keyword. Wenn das Keyword einen Standort hat, wird sowohl das standortspezifische als auch das länderspezifische Suchvolumen angezeigt. Wenn kein Ort angegeben ist, ist das Suchvolumen für beide gleich hoch. | Diese Tabelle enthält das monatliche AI-Suchvolumen für jedes Suchwort. Sie enthält das Suchvolumen* für einen bestimmten Suchtyp und das Suchvolumen*volume_total für beide Suchtypen zusammen. |