Overview
Pull ad performance data from the Meta Marketing API for reporting and analysis. This integration allows you to sync data related to your advertising campaigns across Facebook and Instagram.
The connector provides access to key objects such as Ads, Ad Sets, and Campaigns, along with detailed performance metrics. You can use this data to build custom reports, analyze campaign effectiveness, and integrate advertising data with other business systems like CRMs or data warehouses.
Capability summary
Authentication
Auth method: oauth2
Required scopes
ads_read
read_insights
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| Ad | Yes | No | Represents an individual ad. |
| Ad Set | Yes | No | Represents a group of ads. |
| Campaign | Yes | No | Represents an advertising campaign. |
| Ad Account | Yes | No | Represents the ad account details. |
Supported actions
| Action | Description |
|---|---|
| Get Ad | Retrieves a specific ad by its ID. |
| Get Ad Set | Retrieves a specific ad set by its ID. |
| Get Campaign | Retrieves a specific campaign by its ID. |
| List Ads | Lists all ads within an ad set. |
| List Ad Sets | Lists all ad sets within a campaign. |
| List Campaigns | Lists all campaigns within an ad account. |
| Get Insights | Retrieves performance metrics for campaigns, ad sets, or ads. |
Setup steps
- Navigate to the "Integrations" tab in Flows360 and click "Add Integration".
- Select "Meta Ads" from the list of available providers.
- Click "Connect" and you will be redirected to Facebook to authenticate.
- Log in to your Facebook account that has administrative access to the desired Ad Account.
- Grant Flows360 the requested permissions to access your ad account data.
- After successful authentication, you will be returned to Flows360. Your Meta Ads integration is now active.
Limitations
- The API has a rate limit that may impact very high-volume data syncs.
- Access is limited to the ad accounts for which the authenticated user has at least "View performance" permissions.
- This integration is read-only. It cannot be used to create or modify campaigns, ad sets, or ads.
Troubleshooting
Why can't I see my ad account?
Ensure the Facebook user you authenticated with has the necessary permissions (at least 'View performance') for the desired ad account in the Meta Business Suite.
The data seems to be incomplete or missing.
Check the date range and filtering parameters in your query. Also, verify in the Meta Business Suite that the data you are expecting exists for the selected ad account.
I'm receiving a rate limit error.
You have exceeded the number of allowed API calls in a given time frame. Try reducing the frequency of your data syncs or narrowing the scope of your queries (e.g., pulling data for fewer campaigns at once).