Meta Ads Connection
The Meta Ads connection integrates your Facebook/Instagram ad account with OpsTower via OAuth, giving agents the ability to list campaigns, query performance insights, and break down metrics by audience segments.
Prerequisites
Section titled “Prerequisites”You need a Meta Business account with at least one ad account. The connection uses OAuth 2.0 for secure authorization.
Important Note
Section titled “Important Note”Meta access tokens expire after approximately 60 days. When the token expires, you will need to reconnect by re-authorizing through the OAuth flow. OpsTower will display a warning when the token is approaching expiration.
Setting Up the Connection in OpsTower
Section titled “Setting Up the Connection in OpsTower”- In OpsTower, navigate to Connections in the sidebar.
- Click Add Connection and select Meta Ads.
- Click Connect with Facebook to start the OAuth flow.
- Authorize OpsTower and select the ad account you want to connect.
- You will be redirected back to OpsTower with the connection active.
What Agents Can Do
Section titled “What Agents Can Do”Once connected and enabled on an agent, the agent can:
- List campaigns — view campaigns with their status, budget remaining, and objectives
- Query performance insights — retrieve metrics including impressions, reach, spend, clicks, CTR, CPC, CPM, and ROAS
- Get campaign details — inspect individual campaign configuration and ad groups
- List ad accounts — discover all ad accounts you have access to
- Break down by audience — segment metrics by age, gender, country, region, device platform, publisher platform (Facebook vs Instagram), and placement
Use Cases
Section titled “Use Cases”- Daily founder report: Include ad spend, ROAS, and campaign performance alongside product analytics
- Acquisition analysis: Correlate Meta Ads spend with signup and conversion data from your analytics tools
- Platform comparison: Compare Facebook vs Instagram ad performance using publisher_platform breakdowns
- Budget optimization: Identify which campaigns and audiences drive the highest-quality users
Troubleshooting
Section titled “Troubleshooting”- Token expired: Meta tokens last approximately 60 days. Reconnect through the connection settings page.
- No ad accounts found: Your Facebook user must have access to at least one ad account in Meta Business Manager.
- Reach unavailable: Reach metrics are not available for queries with breakdowns and start dates older than 13 months.