Tabelrichtlijnen en referenties

Tabelnamen en -locatie

Als je Search Console-bulkgegevens exporteert, worden de volgende tabellen gemaakt in het BigQuery-project:

Naam van dataset: searchconsole (dit kan worden aangepast, dus jij of iemand anders heeft misschien een andere naam gekozen tijdens het instellen)

Lijst met tabellen:

• searchdata_site_impression: Geeft prestatiegegevens voor je property weer, verzameld per property.
• searchdata_url_impression: Geeft prestatiegegevens voor je property weer, verzameld per URL.
• ExportLog: Geef informatie weer over elke geslaagde export naar een van de vorige gegevenstabellen. Search Console exporteert meestal afzonderlijk naar die tabellen. Mislukte exportpogingen staan hier niet.

Bulksgewijze gegevensexports: tabellen en tips - Training voor Google Search Console

Tabellen opslaan volgens schema

Search Console exporteert bulkgegevens één keer per dag, maar niet per se voor elke tabel tegelijkertijd.

Als Search Console een tijdelijke fout tegenkomt, zoals een verbindingsprobleem, blijft de app het onmiddellijk opnieuw proberen zonder dat je een melding krijgt.

Als er tijdens de schrijfpoging een aanhoudende fout ontstaat (bijvoorbeeld een fout met de rechten), probeert Search Console de tabel pas de volgende dag opnieuw te exporteren. Search Console probeert de gegevens van de gemiste dag ongeveer een week opnieuw te exporteren. Daarna probeert die geen gegevens voor die dag meer op te slaan. Stel dat Search Console gegevens voor dag 1 probeert op te slaan, maar er een verificatiefout wordt aangetroffen die pas op dag 9 is opgelost. Dan worden de gegevens voor dag 1 en 2 niet geëxporteerd. De resterende dagen worden wel toegevoegd als de toegang wordt hersteld op dag 9.

Als Search Console eerder opgeslagen gegevens moet aanpassen vanwege een opgeloste verwerkingsfout, zijn alle wijzigingen atomisch. Dit betekent dat Search Console alle gegevens voor die dag in één toewijzing updatet. Het gebeurt niet vaak dat oude gegevens worden gecorrigeerd. Je krijgt hierover geen e-mail, maar het wordt wel vastgelegd in het exportlogboek.

Prestatiegegevens worden incrementeel verzameld in Search Console. Dit resulteert in tabelrijen met herhaalde sleutels. Deze gegevens worden niet gecomprimeerd voordat je ze naar je tabellen exporteert. Probeer daarom alle statistieken te verzamelen.

Bewaartijd gegevens

Tabellen worden standaard onbeperkt bewaard, net als partities. Hierbij gelden de algemene standaardwaarden die zijn ingesteld door je Google Cloud-project of -organisatie.

Als je wilt voorkomen dat gegevens voor onbepaalde tijd worden verzameld, raden we je aan een vervaldatum te kiezen voor de partitie. Kies een passende periode voor je situatie, bijvoorbeeld 1 maand, 6 maanden of 12 maanden. Het is niet verstandig om een vervaldatum voor de hele tabel in te stellen, omdat dan al je gegevens worden verwijderd.

Schema voor tabellen

Hier vind je het schema voor de tabellen die zijn geëxporteerd door Search Console. Alle tabellen hebben het voorvoegsel <je_project-ID>.searchconsole.

Tabel searchdata_site_impression

Deze tabel geeft gegevens weer die zijn verzameld per property. De tabel heeft de volgende velden:

• data_date: De dag waarop de gegevens in deze rij zijn gemaakt (Pacific Time).
• site_url: De URL van de property. Voor property's op domeinniveau is dit sc-domain:property-naam. Voor property's met een URL-voorvoegsel is dit de volledige URL van de propertydefinitie. Voorbeelden: sc-domain:developers.google.com, https://developers.google.com/webmasters-tools/
• query: De zoekopdracht van de gebruiker. Als is_anonymized_query waar is, is dit een tekenreeks van 0 tekens.
• is_anonymized_query: Zeldzame zoekopdrachten (ook wel geanonimiseerde zoekopdrachten genoemd) zijn gemarkeerd met deze Booleaanse waarde. Het veld 'query' is null als het waar is. Dit is ter bescherming van de privacy van de gebruikers die de zoekopdracht uitvoeren.
• Country: Het land waar de zoekopdracht is uitgevoerd, in ISO-3166-1-Alpha-3-indeling.
• search_type: Een van de volgende tekenreekswaarden:
  • web: Het standaardtabblad (Alle) in Google Zoeken.
  • image: Het tabblad Afbeeldingen in Google Zoeken.
  • video: Het tabblad Video's in Google Zoeken.
  • news: Het tabblad Nieuws in Google Zoeken
  • discover: Discover-resultaten
  • googleNews: news.google.com en de Google Nieuws-app op Android en iOS
• device: Het apparaat waarop de zoekopdracht is uitgevoerd.
• impressions: Het aantal vertoningen voor deze rij.
• clicks: Het aantal klikken voor deze rij.
• sum_top_position: De som van de hoogste positie van de site in de zoekresultaten voor elke vertoning in die tabelrij, waarbij 0 de toppositie in de resultaten is. De gemiddelde positie (op basis van 1) wordt als volgt berekend: SOM(sum_top_position)/SOM(impressions) + 1.

Tabel searchdata_url_impression

Deze tabel geeft gegevens weer die zijn verzameld per URL. De tabel heeft de volgende velden:

• data_date: Hetzelfde als hierboven.
• site_url: Hetzelfde als hierboven.
• url: De volledig gekwalificeerde URL waar de gebruiker uiteindelijk terechtkomt als die op het zoekresultaat of Discover-verhaal klikt.
• query: Hetzelfde als hierboven.
• is_anonymized_query: Hetzelfde als hierboven
• is_anonymized_discover: Of de gegevensrij onder de Discover-anonimiseringsdrempel valt. Als je de drempelwaarde overschrijdt, ontbreken sommige andere velden (zoals URL en land). Dit is ter bescherming van de privacy van gebruikers.
• country: Hetzelfde als hierboven.
• search_type: Hetzelfde als hierboven.
• device: Hetzelfde als hierboven.
• is_[search_appearance_type]: Er worden verschillende Booleaanse velden gebruikt om het zoekopmaaktype aan te geven, zoals is_amp_top_stories, is_job_listing en is_job_details. Een veld is waar als de betreffende rij voor het specifieke uitgebreide resultaat wordt weergegeven.
• impressions: Hetzelfde als hierboven.
• clicks: Hetzelfde als hierboven.
• sum_position: Een op 0 gebaseerd getal dat de hoogste positie van deze URL in de zoekresultaten voor de zoekopdracht aangeeft. (0 geeft de toppositie in de resultaten aan.) De gemiddelde positie (op basis van 1) wordt als volgt berekend: SUM(sum_position)/SUM(impressions) + 1.

Tabel ExportLog

Deze tabel geeft aan welke gegevens voor een dag zijn opgeslagen. Mislukte exports worden hier niet geregistreerd. Je kunt meer informatie vinden over hoe je deze bijhoudt. De tabel heeft de volgende velden:

• agenda: Welk type gegevens is opgeslagen. Momenteel is SEARCHDATA de enige waarde.
• namespace: In welke tabel dit is opgeslagen. Search Console exporteert gegevens voor elke tabel doorgaans afzonderlijk, dus elke dag heeft in principe 2 exportrijen.
• data_date: Datum van de klik of vertoning, in Pacific Time. Dit is de gebruikte partitiedatum voor de tabellen.
• epoch_version: Een geheel getal, waarbij 0 de eerste keer aangeeft dat gegevens voor deze datum zijn opgeslagen in deze tabel. In zeldzame gevallen moet Search Console eerdere gegevens aanpassen, bijvoorbeeld vanwege een gegevensafwijking. Telkens als de gegevens voor die tabel en datum worden geüpdatet, wordt deze waarde met 1 verhoogd.
• publish_time: Wanneer de export werd afgerond, in Pacific Time.