Wat je nodig hebt
- De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
- Tweestapsverificatie (2FA) op je APIboard-account.
- Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
- Een Google-account met toegang tot een Search Console-property. Het account moet minstens beperkte toegang hebben; properties waarvoor je niet geverifieerd bent, kun je niet kiezen.
Verbinden
- Ga in APIboard naar Koppelen > Koppelingen.
- Zoek Google Search Console bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
- Klik op Verbind met Google Search Console. Je gaat naar de inlogpagina van Google.
- Log in met het Google-account dat toegang heeft tot de Search Console-property en geef toestemming. APIboard vraagt alleen leestoegang.
- Kies de property die je wilt koppelen, als je er meerdere hebt (zie hieronder).
- APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Google Search Console, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.
Account of administratie kiezen
Heeft je Google-login meerdere properties, dan zie je Kies je property. Elke property is een eigen koppeling en telt mee als account in je pakket. Al gekoppelde properties staan niet in de lijst. Heeft je login precies één property, dan zie je Koppeling bevestigen. Je kunt daar een Naam voor deze koppeling invullen en klikt op Koppelen of Bevestigen.
Meer properties koppelen? Klik op + Account toevoegen op de kaart van de koppeling. Je kiest een property van een login die al gekoppeld is, of Ander account koppelen om met een ander Google-account in te loggen. Kies in het volgende venster van Google het account dat je wilt toevoegen; je bestaande koppelingen blijven gewoon staan. Welk toegangsniveau je hebt (Eigenaar, Volledige toegang of Beperkte toegang), bewaart APIboard in de tabel Sites.
Welke gegevens je krijgt
| Onderwerp | Tabellen |
|---|---|
| Zoekprestaties | Dagtotalen, Zoektermen, Pagina’s |
| Bezoekers | Apparaten en landen |
| Properties | Sites |
Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Google Search Console.
Hoe vaak vernieuwd
De gegevens gaan per dag. De eerste vulling loopt dag voor dag terug in de tijd, vanaf 3 dagen geleden (de laatste dagen zijn bij Google nog niet definitief), tot de grens van je pakket. Verder dan 16 maanden terug kan niet: dat is de grens van Search Console zelf. Daarna haalt APIboard de nieuwe dagen op tot 3 dagen geleden en bevestigt het de laatste 2 dagen opnieuw.
De eerste vulling van gegevens met een datum (zoals facturen, uren of mutaties) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties of rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.
Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.
Goed om te weten
- Search Console loopt ongeveer 3 dagen achter. Dat hoort bij Search Console en is geen vertraging van APIboard.
- Per rapport per dag haalt APIboard maximaal 75.000 rijen op.
- Is een dag nog niet definitief of leeg, dan pauzeert de ronde 6 uur. Een lege dag geldt na 4 dagen of 24 uur wachten als definitief.
- Apparaten worden als Desktop, Mobiel en Tablet getoond. Landcodes worden Nederlandse landnamen; “zzz” is niet toe te wijzen verkeer.
- Trekt je Google-account de toegang tot de property in, dan gaat de koppeling naar Fout en moet je opnieuw verbinden.
- Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Je kiest opnieuw je property. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling.
- Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
- Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.
Problemen oplossen
- Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Mogelijke oorzaken: het Google-account heeft geen geverifieerde Search Console-property (voeg die eerst toe via search.google.com/search-console); je hebt de leestoegang niet gegeven; of Google gaf geen vernieuwingstoken terug. Trek in dat laatste geval de toegang van APIboard in via myaccount.google.com/permissions en verbind opnieuw.
- Je hebt geen toestemming gegeven. Probeer opnieuw en accepteer de gevraagde rechten. Je hebt in het venster van Google de toestemming geweigerd. Start de koppeling opnieuw en geef APIboard toestemming.
- OAuth-sessie verlopen, probeer opnieuw te verbinden. Je deed er langer dan 10 minuten over. Start de koppeling opnieuw en rond hem in één keer af, in dezelfde browser.
- Kies een account. Je hebt in het keuzescherm geen property geselecteerd. Kies er een en klik op Koppelen of Bevestigen.
- Kon geen popup-venster openen. Sta pop-ups toe voor deze site. Sta pop-ups toe voor APIboard in je browser en klik opnieuw op Verbind met Google Search Console.
- Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
- Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
- Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
- De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.
Was dit artikel behulpzaam?