Documentation

Start typing to search.

Meta Ads (formerly Facebook Ads)

Written by Ilya Sudakov

Updated on Oct 27, 2026

Description

Meta Ads (formerly Facebook Ads) provides statistics about ads, ad sets and campaigns on Facebook and Instagram.

Setup guide

Follow our setup guide to connect Meta Ads to Improvado.

Choose authorization option:

Connect to Meta Ads

Authorize your Facebook account via OAuth. Before authorizing, make sure that the Facebook account you are signed in to has access to the business ad accounts you want to connect, not just a personal profile. Switch accounts first if needed.

Grant Improvado your permission to:

                                                                                       
PermissionAdditional information
ManageAds for ad accounts that you have access to
Your business
AccessYour Facebook ads and related stats
Create and manageAds for your Page
ReadContent posted on the Page
User content on your Page
ShowList of the Pages you manage

Note: All required permissions are mandatory. If you limit any permission - it could cause connection errors!

System User Access Token

A system user belongs to your business portfolio rather than to a person, so this connection keeps working when an employee changes their password or leaves the company. You need admin access to the business portfolio.

In a new tab, open your Business settings, go to Accounts > Apps, choose Connect an app ID and then Request access to an app ID, and enter the Improvado app ID 1619990124898052.

Go to Users > System users and click Add new system user. Give it a name, for example Improvado.

Assign the ad accounts you want to sync. You can assign more ad accounts later on the same screen without reconnecting in Improvado.

Click Generate new token and select the improvado app.

Tick all of the following permissions: ads_read, ads_management, business_management, pages_read_engagement, pages_manage_ads, pages_show_list, pages_read_user_content and catalog_management.

Note: All listed permissions are mandatory. If you limit any permission - it could cause connection errors!

Copy the token. Meta shows it only once.

Paste the token into the System User Access Token field on the Improvado authorization form and click Connect.

After the connection process is completed successfully, the Meta Ads connection will appear in your Connected sources list.

When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.

To extract data from the connected sources, check the instruction on how to set up data extraction.

Schema information

The schema information shows all report types you can use to extract data from Meta Ads.

Release notes

You can find information about the latest API changes in the official Release notes.

Troubleshooting

Having trouble with your setup? Find solutions to common issues →

Was this article helpful?

Questions? The Improvado team is always happy to help. Send us an email, contact your Customer Success Manager, or raise a request in the Improvado Service Desk.