Toegang geven tot je Meta-advertentiegegevens

Meta laat je geen wachtwoord delen om bij advertentiecijfers te komen. In plaats daarvan maak je een toegangstoken: een sleutel die precies één ding mag, in dit geval meekijken met je advertenties. Je trekt hem op elk moment weer in, zonder gevolgen voor je lopende campagnes.

Het lastige is niet de moeilijkheid, maar de spreiding. Je klikt in twee omgevingen van Meta die er anders uitzien, en één vergeten vinkje merk je pas drie stappen later. Daarom staat hieronder elke klik uitgeschreven.

1 Voorbereiding controleren

business.facebook.com/settings

Drie dingen moeten kloppen. Kloppen ze niet, dan loop je halverwege vast op een melding die niet uitlegt wat eraan scheelt.

1a. Je advertentieaccount zit in een bedrijfsportfolio

1. Ga naar business.facebook.com/settings.
2. Kijk linksboven welk bedrijf geselecteerd staat. Heb je er meerdere: alle volgende stappen moeten in hetzelfde bedrijf gebeuren.
3. Klik links op Accounts en dan op Advertentieaccounts. Staat je account in die lijst, dan zit je goed.

Staat hij er niet, dan is het nog een persoonlijk advertentieaccount. Voeg het toe via Toevoegen en dan Een advertentieaccount toevoegen. Let op dat dit onomkeerbaar is: eruit halen kan later niet meer.

1b. Je bent beheerder van dat bedrijfsportfolio

Klik links op Gebruikers en dan op Personen, en zoek jezelf op. Er moet Beheerder van het bedrijfsportfolio achter je naam staan. Staat er Werknemer, dan zie je in stap 6 het menu Systeemgebruikers niet eens. Laat in dat geval de beheerder deze handleiding doorlopen.

1c. Tweestapsverificatie staat aan

Zonder tweestapsverificatie blokkeert Meta het aanmaken van een systeemgebruiker. Zet het aan via facebook.com/security/2fac/settings, met een authenticatie-app of sms.

2 Ontwikkelaarsaccount aanmaken

developers.facebook.com

Dit klinkt zwaarder dan het is: je zet eenmalig een vinkje dat je het ontwikkelaarsportaal mag gebruiken. Er wordt niets geïnstalleerd en het kost niets.

1. Ga naar developers.facebook.com en log in met hetzelfde Facebook-account waarmee je in stap 1b beheerder bleek. Een ander account werkt niet.
2. Klik rechtsboven op Aan de slag. Staat er Mijn apps, dan heb je al een ontwikkelaarsaccount en ga je door naar stap 3.
3. Accepteer de voorwaarden en bevestig je telefoonnummer of e-mailadres met de code die je krijgt.
4. Kies bij de vraag naar je rol bijvoorbeeld Ondernemer. Dat heeft verder geen gevolgen.
5. Klik op Registratie voltooien.

3 De app aanmaken

developers.facebook.com/apps

De app is hier een sleutelhouder, meer niet. Er komt geen software in, hij komt nergens in een appstore, en hij hoeft niet door een goedkeuring van Meta.

1. Ga naar developers.facebook.com/apps en klik op App maken.
2. Vul bij Appnaam iets herkenbaars in, bijvoorbeeld Rapportagekoppeling. Niet de woorden Facebook, Instagram of Meta erin, die weigert Meta.
3. Vul je eigen adres in bij Contact-e-mailadres.
4. Kies bij Bedrijfsportfolio het portfolio uit stap 1a en klik op Volgende.
5. Meta vraagt nu wat je app moet doen. Kies Advertenties maken en beheren met de Marketing API (in het Engels: Create and manage ads with the Marketing API) en klik op Volgende.
6. Klik op App maken en vul je wachtwoord in.

Je komt daarna meteen op het dashboard van de app. Door die keuze bij punt 5 zit de Marketing API er al in, dus stap 4 is voor jou waarschijnlijk alleen nog een controle.

4 Marketing API controleren

Het dashboard van je nieuwe app

Zonder de Marketing API mag je app niets met advertentiegegevens en staan de permissies uit stap 8 simpelweg niet in de lijst.

Kijk links in het menu van je app of Marketing API ertussen staat. Heb je in stap 3 de use case voor advertenties gekozen, dan staat hij er al en ben je hier klaar. Meer hoef je namelijk niet te doen: geen token genereren op die pagina en geen beoordeling aanvragen.

Staat hij er niet, voeg hem dan alsnog toe:

1. Zoek op het app-dashboard het blok Producten toevoegen aan je app. Zie je het niet, klik dan links op Producten toevoegen of op het plusteken naast Producten.
2. Zoek Marketing API en klik in dat vak op Instellen.

Laat de app in ontwikkelmodus staan. Aan de schakelaar tussen Ontwikkeling en Live bovenaan hoef je niets te veranderen.

5 Het App-ID noteren

App-instellingen, Algemeen

Klik links op App-instellingen en dan op Algemeen. Bovenaan staat het App-ID, een getal van vijftien cijfers. Zet dat in een kladblok. Je mag het gewoon doorgeven, want een App-ID is geen geheim.

6 De systeemgebruiker aanmaken

business.facebook.com/settings

Een systeemgebruiker is een medewerker zonder mens erachter. Hij hoort bij het bedrijf en niet bij een persoon, dus de koppeling blijft werken als iemand uit dienst gaat of zijn wachtwoord wijzigt.

1. Ga terug naar business.facebook.com/settings en controleer linksboven dat hetzelfde bedrijf geselecteerd staat als in stap 1a en 3.
2. Klik links op Gebruikers en dan op Systeemgebruikers.
3. Klik op de blauwe knop Toevoegen. Verschijnen er voorwaarden, klik dan op Ik ga akkoord.
4. Vul een herkenbare naam in, bijvoorbeeld die van het bureau of de tool die gaat meekijken.
5. Kies als rol Werknemer. Beheerder is niet nodig, en hoe minder rechten hoe beter.
6. Klik op Systeemgebruiker maken.

7 App en advertentieaccount toewijzen

Bij de systeemgebruiker die je net maakte

Twee losse toewijzingen. Doe ze allebei, want met maar één van de twee mislukt stap 8.

7a. De app toewijzen

1. Klik in de lijst op de nieuwe systeemgebruiker en dan op Assets toewijzen. In sommige weergaves heet die knop Assets toevoegen.
2. Kies in de linkerkolom de optie Apps.
3. Vink in de middelste kolom de app uit stap 3 aan.
4. Zet in de rechterkolom de schakelaar App beheren aan.
5. Klik op Wijzigingen opslaan en dan op Gereed.

7b. Het advertentieaccount toewijzen

1. Klik nogmaals op Assets toewijzen.
2. Kies in de linkerkolom de optie Advertentieaccounts.
3. Vink in de middelste kolom je advertentieaccount aan.
4. Zet in de rechterkolom de schakelaar Advertentieaccount bekijken aan. Zet Advertentieaccount beheren bewust niet aan: dat zou wijzigen en geld uitgeven toestaan.
5. Klik op Wijzigingen opslaan en dan op Gereed.

8 Het token genereren

Bij dezelfde systeemgebruiker

1. Klik op Nieuw token genereren.
2. Kies bij App de app uit stap 3. Staat hij er niet, dan is stap 3 punt 4 of stap 7a misgegaan; zie de tabel onderaan.
3. Zet Vervaldatum token op Nooit.
4. Vink in de permissielijst precies twee dingen aan. Gebruik het zoekveld erboven:
   • ads_read, het recht om advertentiecijfers te lezen
   • business_management, het recht om te zien bij welk bedrijf het account hoort
5. Klik op Token genereren.
6. Je krijgt een lange reeks tekens te zien die begint met EAA. Klik op Kopiëren en plak het meteen ergens veilig neer.
7. Klik op Gereed.

Staan ads_read en business_management niet in de lijst? Dan mist de Marketing API bij je app. Voeg hem alsnog toe zoals in stap 4, ververs de pagina en probeer opnieuw.

Controleer het token voor je het opstuurt

Ga naar de tokencontrole van Meta, plak het token en klik op Fouten opsporen. Er hoort te staan: bij Verloopt de waarde Nooit, en bij Bereiken of Scopes zowel ads_read als business_management. Klopt dat niet, doe stap 8 dan opnieuw.

9 Account-ID opzoeken en doorsturen

Ads Manager

Open Ads Manager. Linksboven staat de naam van je advertentieaccount met daaronder een nummer. Zie je het niet, klik dan op de naam om de accountkiezer te openen. Het staat ook in de adresbalk, achter ?act=.

Stuur deze drie dingen door:

Het advertentieaccount-ID en het App-ID zijn geen geheimen, die mogen gewoon per mail.

Wat er met deze toegang wel en niet kan

Wel: campagnes, advertentiesets en advertenties inzien, met uitgaven, vertoningen, klikken, conversies, kosten per resultaat en ROAS.

Niet: budgetten wijzigen, campagnes starten of stoppen, advertenties aanpassen, geld uitgeven, of bij je pagina's, berichten, klantenbestand of betaalgegevens komen. De permissie ads_read is leesrecht en staat de rest domweg niet toe.

Toegang intrekken

Kan op elk moment, zonder tussenkomst van de partij die meekijkt en zonder gevolgen voor je campagnes. Ga naar Bedrijfsinstellingen, dan Gebruikers, dan Systeemgebruikers, klik op de systeemgebruiker uit stap 6 en kies Verwijderen. Al zijn tokens zijn dan direct ongeldig. Wil je alleen dit ene token intrekken, klik dan bij de systeemgebruiker op het token zelf en kies Intrekken.

Als er iets misgaat

Twee dingen die goed zijn om te weten

Je app hoeft niet beoordeeld te worden door Meta. Zolang de koppeling alleen advertentieaccounts uit je eigen bedrijfsportfolio uitleest, is de standaardtoegang genoeg. De beoordelingsprocedure is bedoeld voor apps waarop andere bedrijven inloggen.

Er zit een limiet op het aantal opvragingen. Zonder die beoordeling zit de app op het laagste toegangsniveau van de Marketing API. Voor een dagelijkse of wekelijkse rapportage van één advertentieaccount is dat ruim voldoende; gaat het om veel accounts tegelijk of om cijfers die elk uur ververst worden, dan vraag je een verhoging aan bij Meta.

Alles in de kennisbank