Google Ads koppelen | Helpcentrum

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 dat toegang heeft tot het Google Ads-account.
Het klant-id van dat account: 10 cijfers, te vinden rechtsboven in Google Ads, bij het accountpictogram.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Google Ads 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.
Vul bij Klant-id van je Google Ads-account het klant-id in, bijvoorbeeld 123-456-7890. Streepjes en spaties mogen erin.
Klik op Verbind met Google Ads. Je gaat naar de inlogpagina van Google.
Log in met het Google-account dat toegang heeft tot dit Google Ads-account en geef APIboard toestemming.
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Google Ads, 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

Er is geen keuzescherm: het klant-id dat je invult is het account. Heb je meer Google Ads-accounts, koppel ze dan elk met hun eigen klant-id. De koppeling krijgt de naam van het Google Ads-account.

Welke gegevens je krijgt

Onderwerp	Tabellen
Prestaties per dag	Campagnes per dag, Advertentiegroepen per dag, Campagnes per apparaat
Zoeken en conversies	Zoekwoorden, Zoektermen, Conversies
Opbouw van het account	Campagnes, Advertentiegroepen, Conversieacties, Account

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 Ads.

Hoe vaak vernieuwd

De eerste vulling gaat in vensters van 30 dagen, de nieuwste eerst, terug tot de grens van je pakket en nooit verder dan 37 maanden. Het startpunt ligt 3 dagen terug, omdat de laatste dagen nog niet definitief zijn. Daarna verwerkt APIboard elke ronde de laatste 30 dagen opnieuw, plus eens per week een bredere controle over 90 dagen. De opbouw van het account (campagnes, advertentiegroepen, conversieacties) wordt hooguit eens per 24 uur volledig opgehaald; verdwenen items worden als verwijderd gemarkeerd.

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

Het recht dat APIboard bij Google vraagt (adwords) geeft op Googles kant ook schrijfrechten. APIboard gebruikt het alleen om te lezen.
Kosten worden uit Googles eenheid (micros) omgerekend. Labels zoals Actief, Gepauzeerd, Verwijderd en kanaaltypes (Zoeken, Display, Shopping, Video, Performance Max) staan in het Nederlands.
Is het Google Ads-account later niet meer bereikbaar (bijvoorbeeld opgeschort of toegang ingetrokken), dan gaat de koppeling naar Fout.
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 vult het klant-id opnieuw in. 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

Ongeldig klant-id. Vul het 10-cijferige klant-id in zoals getoond in Google Ads. Het klant-id heeft geen 10 cijfers. Kopieer het uit Google Ads, rechtsboven bij het accountpictogram.
Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Mogelijke oorzaken: het klant-id bestaat niet of je Google-account heeft er geen toegang toe; je hebt de toestemming 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.
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 Ads.
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.