Ad Campaigns

Connect Google Ads and Facebook Ads for campaign analytics and management

Overview

Ad campaign integrations give your AI agents access to advertising data. Agents can analyze campaign performance, report on metrics, pause underperforming campaigns, and answer questions about ad spend — all through natural conversation.

Supported Platforms

Platform	Auth	Tools	Capabilities
Google Ads	Google OAuth	3	Campaigns, keywords, pause campaigns
Facebook Ads	Meta OAuth	4	Campaigns, ad sets, insights, pause campaigns

Google Ads

Authentication

Uses the same Google OAuth flow as Google Workspace, with additional requirements:

Field	Description
OAuth	Google account with access to the Ads account
Customer ID	Your Google Ads account ID (format: 123-456-7890)
Developer Token	Obtained from Google Ads API Center

Setup

1. Add Integration

   Go to Integrations → Add Integration → select Google Ads from the Advertising category.

2. OAuth

   Click “Connect with Google” and authorize access to your Google Ads account.

3. Enter Details

   Enter your Customer ID and Developer Token.

4. Verify

   Revol tests the connection by fetching your campaigns.

Agent Tools

Tool	Description
get_campaigns	List campaigns with status, budget, impressions, clicks, cost, and conversions
get_keywords	Keyword performance data by ad group — impressions, clicks, cost, quality score
pause_campaign	Pause a campaign by its ID

---

Facebook Ads

Authentication

Uses Meta OAuth with the ads_management scope. Supports both Facebook and Instagram ad campaigns managed through Meta Ads Manager.

Field	Description
OAuth	Meta account with access to the ad account
Ad Account ID	Format: act_XXXXXXXXX (found in Meta Ads Manager)

Setup

1. Add Integration

   Go to Integrations → Add Integration → select Facebook Ads.

2. OAuth

   Click “Connect with Meta” and authorize access to your ad account.

3. Enter Details

   Enter your Ad Account ID.

4. Verify

   Revol tests the connection by fetching your campaigns.

Agent Tools

Tool	Description
get_campaigns	List campaigns with status, budget, and 30-day performance (impressions, clicks, spend, CTR)
get_ad_sets	List ad sets within a campaign with targeting and scheduling info
get_insights	Detailed performance insights by custom date range
pause_campaign	Pause a campaign by its ID

Using Tools in Workflow Nodes

Ad campaign tools work like any other agent tool:

1. Connect the ad platform and verify via OAuth
2. Tools appear in the agent’s Tools tab
3. Add them to custom nodes in the workflow editor
4. The LLM calls them when the user asks about campaign data

Example: A user asks “How are our Google Ads doing this week?” → the agent calls get_campaigns with a date filter and returns a summary of spend, clicks, and conversions in plain language.

Use Cases

Performance reporting

“What’s our ROAS on Google Ads this month?” → agent calls get_campaigns and calculates return on ad spend from the metrics.

Cross-platform comparison

Agent pulls data from both Google Ads and Facebook Ads to compare cost-per-lead across platforms.

Campaign management

“Pause the Spring Promo campaign on Facebook” → agent calls pause_campaign with the campaign ID.

Lead source attribution

When a lead comes through the website widget, the agent checks UTM parameters from the tracking session and correlates with campaign data to identify which ad generated the lead.