Browse guidesTracking & analytics

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.

8 min read Updated 23 Sept 2026 For admins
On this page8 sections
  1. 01Before you start
  2. 021. Create an app for your business
  3. 032. Add a system user
  4. 043. Give the system user the app
  5. 054. Give the system user the ad account
  6. 065. Generate the token
  7. 076. Connect it in Bottega
  8. 08Troubleshooting

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.
Meta Business settingsAccountsAppsAddCreate a new app ID

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.

  1. Start a new app

    Click Add, then Create a new app ID. Meta opens the app builder on developers.facebook.com.

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

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

Meta Business settingsUsersSystem usersAdd

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.

Meta Business settingsAccountsAppsYour appAssign people

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.

Meta Business settingsUsersSystem usersBottegaAssign assets

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.

Meta Business settingsUsersSystem usersBottegaGenerate token
  1. Choose the app

    Pick the app from step 1.

  2. Set the expiry to Never

    A token that never expires keeps spend syncing without anyone having to come back.

  3. Tick ads_read

    That's the only permission Bottega needs. Then Generate token.

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

BottegaMarketingTrackingSetup & healthAd spend

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 seeWhyWhat to do
No app to choose when generating the tokenThe 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 accountThe 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 IDA 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 revokedSomeone 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 assetsIt 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 salesThe ad account's currency differs from the space's sales currency.Set Settings › Sales & payments › Sales currency to match.

Something here out of date? Tell us and we'll fix the guide.

Still stuck?

Ask a person, not a bot.

Tell us your space and the page you were on. A screenshot helps. Someone on the GOATEDX team reads every email and replies.

bottega@goatedx.com