Connect the Meta ad account for spend and ROI
Give Bottega read-only access to your ad account so it can show spend, cost per lead, cost per show-up and return on ad spend next to every lead and sale.
On this page8 sections
Bottega already knows which ad every registrant clicked. With read-only access to the ad account it also knows what each ad cost, so Marketing › Ads & ROI can show cost per lead, cost per show-up, cost per call and return on ad spend. Meta only gives this access through a token that belongs to a system user, issued through an app your business owns. It takes about five minutes, once.
- You need to be an admin of the Meta business portfolio that has the ad account. Only admins can create apps and system users.
- If the ad account belongs to the client's business and you work from your agency's business, the client first shares it with you as a partner (their Business settings › Partners). It then shows up in your own Business settings.
- In Bottega, you need edit access to Ad account & spend. By default GOATEDX connects it for clients.
- Have the ad account ID ready: it's the number after
act=in the Ads Manager address bar, also listed under Business settings › Accounts › Ad accounts.
Tokens for system users are always issued through an app, and the app has to be owned by your business. If your business already owns one (for example the app behind your Conversions API setup), use it and skip to step 2.
Start a new app
Click Add, then Create a new app ID. Meta opens the app builder on developers.facebook.com.
Name it and pick the use case
Call it something your team recognises, such as Bottega. For the use case, choose Create and manage ads with the Marketing API.
Connect it to your business portfolio
Pick the business that has the ad account, then Create app. The app now appears under Business settings › Apps.
A system user belongs to the business rather than a person, so the connection keeps working when someone leaves the team or changes their password. Name it Bottega and choose the Employee role, then Create system user.
Select the Bottega system user and switch on Develop app (some screens still say Manage app), then Assign. This is the step most people miss: without it, the app doesn't appear in the list when you generate the token.
Choose Ad accounts, tick the account your ads run from and switch on View performance. Leave Manage campaigns off: Bottega only reads spend and never changes your ads. Click Assign assets.
Choose the app
Pick the app from step 1.
Set the expiry to Never
A token that never expires keeps spend syncing without anyone having to come back.
Tick ads_read
That's the only permission Bottega needs. Then Generate token.
Copy it straight away
Meta shows the token once. If you lose it, generate another one; the old one keeps working until you revoke it.
Paste the ad account ID (with or without act_) and the token, then click Connect. Bottega checks the token, pulls the last 90 days of spend straight away and updates every hour after that. The token is stored encrypted and can be replaced but never viewed.
Check that it worked
- The card shows Connected, the spend for the last 30 days and when it last updated.
- Marketing › Ads & ROI shows spend, cost per lead and ROAS for each campaign, ad set and ad.
- Analytics › Sales shows each webinar run's share of the spend next to its sales.
| What you see | Why | What to do |
|---|---|---|
| No app to choose when generating the token | The system user hasn't been given the app, or the business doesn't own one. | Do step 3 (or step 1 first). |
| This token can't read that ad account | The system user doesn't have the ad account, or the token was made without ads_read. | Do step 4, then generate a new token with ads_read ticked. |
| Meta can't find that ad account ID | A typo, or the ID of a different account. | Copy the number after act= in Ads Manager's address bar. |
| The access token expired or was revoked | Someone revoked it, or it was made with an expiry date. | Generate a new one with expiry set to Never and paste it in. |
| The ad account isn't listed under Assign assets | It belongs to another business that hasn't shared it with yours. | Ask the owner to add your business as a partner on the ad account. |
| Spend shows, but in a different currency than sales | The ad account's currency differs from the space's sales currency. | Set Settings › Sales & payments › Sales currency to match. |
Read next
Something here out of date? Tell us and we'll fix the guide.