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. En anders dan de andere bronnen kun je hier ook iets veranderen.
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
- Voor het werkscherm en de wijzigingen: de integratie Google Ads aan onder Instellingen → Integraties, met een licentie die hem dekt
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 → Google Ads. 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 Koppel het account aan de klant: kies het onder Instellingen → Google Ads en hang er de klant aan, of open Klanten → de klant, klik in het paneel Marketing op bewerken en kies het bij
Ads-account. Het is één koppeling: wat je op de ene plek legt, staat ook op de andere. 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, waarbij de laatste 30 dagen opnieuw worden opgehaald.
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.
Een conversie telt pas als Google klaar is met tellen
Google schrijft een conversie toe aan de dag van de klik, tot het einde van het conversievenster, standaard 30 dagen. Een nachtelijke run die alleen de laatste week opnieuw ophaalt, bevriest elke dag voordat Google klaar is, terwijl dezelfde periode vorig jaar allang afgerond is. Dan vergelijk je een onaf jaar met een af jaar en ziet elke maand er slechter uit dan hij was. Daarom haalt de synchronisatie voor Ads de laatste 30 dagen opnieuw op; de andere bronnen houden het bij een week. De vergelijking staat standaard op dezelfde periode vorig jaar, en een tegel zegt dat ook in woorden, met het bedrag waartegen hij gemeten is.
Lezen en wijzigen, met een beleid als vangrail
Het werkscherm onder Marketing → Google Ads leest campagnes, advertentiegroepen, advertenties, zoekwoorden, zoektermen, uitsluitingen, apparaten, locaties, aanbevelingen, de wijzigingsgeschiedenis en de conversiegezondheid. Wijzigen is opgesplitst in vier rechten, zodat je een sleutel kunt maken die 's nachts zoektermen mag opruimen en nooit een budget aanraakt. Per adverteerdersaccount, met dat van je bureau als huisstandaard, leg je een beleid vast: beschermde termen die nooit uitgesloten mogen worden, verboden zinnen in advertenties, een dagbudgetplafond, een maximale kosten per klik en een budget dat in één wijziging hoogstens verdubbelt. Alles wat hier wordt aangemaakt komt gepauzeerd binnen. Omdat elke route ook een MCP-tool is, werkt een assistent binnen precies dezelfde grenzen.
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 aan een klant koppelen vanuit het paneel Marketing en de accountkiezer openen. Standaard alleen beheerder. -
marketing.overview.readHet cross-klantoverzicht onder Overzicht → Marketing, waar de kolom Uitgaven vandaan komt. Standaard alleen beheerder. -
google_ads.settings.manageHet ontwikkelaarstoken, accounts koppelen en controleren. Standaard alleen beheerder. -
google_ads.account.readAlles wat het werkscherm leest. Standaard beheerder en medewerker, nooit de rol Klant. -
google_ads.policy.manageHet beleid per klant, het huisbeleid en het beslissingenlogboek. Standaard alleen beheerder. -
google_ads.query.runHet doorgeefluik voor eigen queries, alleen-lezen en begrensd. Standaard alleen beheerder. -
google_ads.campaign.writeCampagnes, advertentiegroepen en advertenties wijzigen. Standaard alleen beheerder. -
google_ads.budget.writeBudgetten wijzigen, apart omdat dit het geld is. Standaard alleen beheerder. -
google_ads.keyword.writeZoekwoorden wijzigen. Standaard alleen beheerder. -
google_ads.negative.writeUitsluitingen en gedeelde lijsten wijzigen, en vastleggen welke zoektermen je bewust houdt. Standaard alleen beheerder.
Wat het bewust niet doet
- Wijzigen kan alleen via het werkscherm en de API, binnen de vier rechten en het beleid van de klant. De marketingcijfers zelf lezen alleen.
- Beheerdersaccounts zijn niet koppelbaar; je koppelt de klantaccounts eronder.
- De campagne-uitsplitsing op het dashboard toont tien campagnes op uitgaven gesorteerd. Advertentiegroepen, zoekwoorden en losse advertenties staan op het werkscherm.
- 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 → Google Ads voor het ontwikkelaarstoken en de accounts, Marketing → Google Ads voor het werkscherm, en Klanten → de klant → paneel Marketing voor de cijfers.
Lees de handleiding