Marketing & analytics Beschikbaar
Google Ads
Ads deelt de klantkoppeling en de Google-toestemming met Analytics en Search Console, maar heeft twee dingen extra nodig: een ontwikkelaarstoken van je bureau en, bij een beheerdersaccount, de wetenschap via welk account elk klantaccount bereikt moet worden.
Wat je nodig hebt
- De module Marketing staat aan en is gelicentieerd voor deze werkomgeving (Instellingen → Modules)
- De Google Ads API staat aan in het Google Cloud-project van je OAuth-client
- Een ontwikkelaarstoken uit het <strong>API-center</strong> van je Google Ads-beheerdersaccount. Vraag dat vroeg aan: Google beoordeelt zo'n aanvraag zelf, en een pas uitgegeven token leest nog niet zomaar je echte accounts.
- Een Google-account met toegang tot het Ads-account, of tot het beheerdersaccount erboven, gekoppeld onder Instellingen → Mijn account
- Het recht marketing.link.manage, dat zowel het token als het koppelen afschermt
Zo koppel je het
- 1 Vraag in je Google Ads-beheerdersaccount onder API-center een ontwikkelaarstoken aan. Dit is één token voor je hele bureau, niet één per klant.
- 2 Zet de Google Ads API aan in het Google Cloud-project waar je OAuth-client bij hoort.
- 3 Zet het token in Instellingen → Marketing. Het wordt versleuteld opgeslagen en nooit teruggegeven; het scherm meldt alleen dat er een token staat, en leeg laten bewaart het bestaande. Een installatie die nog
SCHAKL_GOOGLE_ADS_DEVELOPER_TOKENin de omgeving heeft staan blijft werken, maar het scherm is de plek waar het hoort. - 4 Koppel je Google-account onder Instellingen → Mijn account, als dat nog niet gebeurd is. Die ene toestemming dekt Analytics, Search Console en Ads samen.
- 5 Open Klanten → de klant, klik in het paneel Marketing op bewerken en kies Account koppelen met bron
Ads-account. Zit het account onder een beheerdersaccount, dan staat dat als hint achter de naam. - 6 De koppeling haalt ongeveer 13 maanden historie op en wordt daarna elke nacht bijgewerkt.
Beheerdersaccounts zijn de normale vorm, geen randgeval
Een bureau krijgt toegang tot het beheerdersaccount, niet tot elk klantaccount apart. Google beantwoordt de vraag welke accounts je mag zien alleen met de directe toekenningen, dus die lijst is precies één MCC-nummer en geen enkele klant die je daadwerkelijk draait. Daarom klapt schakl. elk beheerdersaccount uit tot de hele hiërarchie eronder, in één opvraag, en onthoudt bij elk klantaccount via welk beheerdersaccount het bereikt moet worden. Dat laatste is het dragende deel: zonder dat wordt elke volgende aanroep gedaan door iemand zonder rechten op dat account.
- Een geneste MCC hoeft niet apart doorlopen te worden: de hele boom komt in één keer mee
- Sub-beheerders vallen weg, hun klantaccounts blijven
- Beheerdersaccounts zijn zelf niet koppelbaar: Google weigert cijfers op dat niveau
- Boven de 500 klantaccounts per beheerder wordt de lijst afgekapt en dat wordt gelogd, nooit stilzwijgend weggelaten
De API-versie is een instelling, omdat hij verloopt
Google Ads is de enige Google-API hier waarvan het versienummer in de URL staat, en Google zet een versie ongeveer een jaar na uitgifte uit. Vanaf die dag antwoordt elk adres eronder met 404. Dat is geen probleem met je token, je rechten of je account, dus geen van de gewone foutmeldingen past erop en de module lijkt simpelweg stuk. schakl. herkent daarom een 404 van Ads apart en zegt wat er aan de hand is. De release wijst een actuele versie aan en <code>SCHAKL_GOOGLE_ADS_API_VERSION</code> overschrijft hem, zodat een installatie die zijn release overleeft vanuit het compose-bestand bijgesteld kan worden in plaats van te moeten wachten op een update.
Zonder token blijft de rest gewoon werken
Staat er geen ontwikkelaarstoken, dan gaat Ads niet stuk maar uit: de kiezer en de synchronisatie zakken terug naar een net gelabelde stand die zegt dat Ads nog ingesteld moet worden. Analytics en Search Console draaien intussen door. Dat is bewust zo gebouwd, want een bureau dat de eerste twee bronnen wil gebruiken hoort daar geen ontwikkelaarstoken voor te hoeven aanvragen.
Rechten
Geef deze rechten aan de rol die deze koppeling beheert (Instellingen → Rollen). Standaard alleen voor beheerders, en nooit voor de rol client.
-
marketing.metrics.readDe marketingcijfers van een klant lezen, inclusief de uitgaven. Standaard voor beheerder, medewerker en klantportaal; een bureau dat advertentiebudget gevoelig vindt, beperkt dit recht tot beheerders. -
marketing.link.manageAds-accounts koppelen en ontkoppelen, de accountkiezer openen en het ontwikkelaarstoken opslaan onder Instellingen → Marketing. Standaard alleen beheerder. -
marketing.overview.readHet cross-klantoverzicht onder Overzicht → Marketing, waar de kolom Uitgaven vandaan komt. Standaard alleen beheerder.
Wat het bewust niet doet
- Er wordt niets teruggeschreven: geen budgetten, biedingen, campagnes of advertenties wijzigen. De koppeling leest alleen.
- Beheerdersaccounts zijn niet koppelbaar; je koppelt de klantaccounts eronder.
- De campagne-uitsplitsing toont tien campagnes op uitgaven gesorteerd. Advertentiegroepen, zoekwoorden en losse advertenties zitten er niet in.
- Bedragen komen in de valuta van het Ads-account zelf en worden nooit omgerekend.
- Per beheerdersaccount worden maximaal 500 klantaccounts in de kiezer gezet.
- Een koppeling van vóór het uitklappen van beheerdersaccounts draagt niet mee via welk account hij bereikt wordt. Ontkoppel hem en kies het account opnieuw; de kiezer verbergt accounts die al gekoppeld zijn, dus het ontkoppelen is wat hem terugzet in de lijst.
Waar je het vindt Instellingen → Marketing voor het ontwikkelaarstoken, en Klanten → de klant → paneel Marketing om een account te koppelen.
Lees de handleiding