Advertising Platforms

Connect your advertising accounts to Iverton AI for centralized campaign management, cross-platform analytics, and AI-powered optimization recommendations.

Overview

Iverton AI integrates with major advertising platforms:

Platform	Features	Status
Google Ads	Campaign management, keyword bidding, performance tracking	Available
Facebook Ads	Campaign creation, audience targeting, creative management	Available
Instagram Ads	Managed through Facebook Ads	Available

---

Google Ads

Connect your Google Ads account to view campaign performance, manage budgets, and get optimization recommendations.

Prerequisites

Before connecting, ensure you have:

• A Google Ads account
• Admin or Standard access to the account
• At least one active or paused campaign

Connecting Google Ads

1. Go to Integrations in the main sidebar
2. Find Google Ads in the Advertising category
3. Click Connect
4. Sign in with your Google account
5. Select the Google Ads account to connect
6. Grant the requested permissions
7. Click Allow

Permissions Requested

Permission	What It Allows
View campaigns	Read campaign structure and settings
View performance	Access metrics and reporting data
Manage campaigns	Create and edit campaigns (optional)
Manage billing	View spend and budget info

Available Data

Account Overview

Metric	Description
Total spend	Amount spent in period
Impressions	Number of ad impressions
Clicks	Number of ad clicks
CTR	Click-through rate
Conversions	Conversion actions completed
Cost per conversion	Average cost per conversion
ROAS	Return on ad spend

Campaign Metrics

Metric	Description
Campaign status	Active, paused, ended
Budget	Daily or total budget
Spend	Amount spent
Impressions	Campaign impressions
Clicks	Campaign clicks
CTR	Click-through rate
Avg. CPC	Average cost per click
Conversions	Campaign conversions

Keyword Performance (Search campaigns)

Metric	Description
Keyword	Search term
Match type	Broad, phrase, exact
Quality score	1-10 quality rating
Impressions	Keyword impressions
Clicks	Keyword clicks
CPC	Cost per click
Conversions	Keyword conversions

Ad Performance

Metric	Description
Ad type	Responsive, text, display
Headlines	Ad headlines
Descriptions	Ad descriptions
Impressions	Ad impressions
CTR	Click-through rate
Conversions	Ad conversions

Features

Dashboard Widgets

• Total spend overview
• Campaign performance table
• Conversion trends
• Top performing keywords
• Budget utilization

Cross-Platform Reports

• Combine Google Ads data with Facebook Ads
• Compare performance across channels
• Calculate blended ROAS

AI Recommendations

• Budget reallocation suggestions
• Keyword optimization tips
• Ad copy improvement ideas
• Audience expansion recommendations

Sync Schedule

Data Type	Sync Frequency
Account summary	Every hour
Campaign data	Every 2 hours
Keyword data	Every 4 hours
Full sync	Daily

Troubleshooting Google Ads

"Account not appearing"

• Verify you have Admin or Standard access
• Check you're signed into the correct Google account
• Ensure the account has at least one campaign

"Data not syncing"

• Google Ads API may have a 3-hour delay
• Check that API access is enabled in your Google Ads account
• Verify the connection is still authorized

"Permission denied"

• Your access level may have changed
• Reconnect with the account owner's credentials
• Check for account-level restrictions

---

Facebook Ads

Connect your Facebook Ads account to manage campaigns, track performance, and optimize spend across Facebook and Instagram.

Prerequisites

Before connecting, ensure you have:

• A Facebook Business account
• Access to an Ad Account (Admin or Advertiser role)
• At least Advertiser permissions on the ad account

Connecting Facebook Ads

1. Go to Integrations in the main sidebar
2. Find Facebook Ads in the Advertising category
3. Click Connect
4. Log in to your Facebook account
5. Select the Business Account
6. Choose the Ad Account(s) to connect
7. Grant the requested permissions

If you've already connected Facebook Pages, you may be able to connect ads without re-authenticating.

Permissions Requested

Permission	What It Allows
ads_read	View campaign data and performance
ads_management	Create and manage campaigns
business_management	Access business assets

Available Data

Account Overview

Metric	Description
Amount spent	Total spend in period
Reach	Unique people who saw ads
Impressions	Total ad impressions
Clicks	Total link clicks
CTR	Click-through rate
CPM	Cost per 1,000 impressions
CPC	Cost per click
Conversions	Conversion events
ROAS	Return on ad spend

Campaign Breakdown

Metric	Description
Campaign name	Campaign identifier
Status	Active, paused, completed
Objective	Awareness, traffic, conversions, etc.
Budget	Daily or lifetime budget
Spend	Amount spent
Results	Primary metric based on objective
Cost per result	Efficiency metric

Ad Set Metrics

Metric	Description
Audience	Target audience definition
Placement	Facebook, Instagram, Audience Network
Reach	People reached
Frequency	Average times shown per person
Performance	Key metrics for the ad set

Ad Creative Performance

Metric	Description
Creative type	Image, video, carousel
Headline	Ad headline text
Engagement	Likes, comments, shares
CTR	Click-through rate
Conversions	Attributed conversions

Features

Dashboard Integration

• Spend and ROAS overview
• Campaign performance cards
• Audience insights
• Creative performance comparison

Audience Insights

• Demographics of reached users
• Interests and behaviors
• Geographic breakdown
• Device usage

Cross-Platform Reporting

• Combine with Google Ads data
• Calculate total marketing spend
• Compare channel efficiency

Instagram Ads

Instagram Ads are managed through the Facebook Ads integration. When you connect Facebook Ads:

• Instagram campaigns appear automatically
• Placement breakdown shows Instagram vs Facebook
• All metrics are available for both platforms

Instagram Placements

Placement	Description
Feed	Instagram main feed
Stories	Instagram Stories
Explore	Explore tab
Reels	Reels tab

Sync Schedule

Data Type	Sync Frequency
Account summary	Every hour
Campaign data	Every 2 hours
Ad set data	Every 4 hours
Creative performance	Every 6 hours
Full sync	Daily

Troubleshooting Facebook Ads

"Ad account not appearing"

• Verify you have Advertiser access to the ad account
• Check Business Manager permissions
• Ensure the ad account is active (not disabled)

"No data showing"

• New campaigns may take 24 hours to report data
• Check that campaigns have delivered impressions
• Verify date range includes active campaign period

"Metrics don't match Ads Manager"

• Attribution windows may differ
• Check for currency conversion issues
• Time zone differences can affect daily totals

"Connection expired"

• Facebook tokens need periodic refresh
• Reconnect the integration
• Check if your Facebook password changed

---

Disconnecting Ad Platforms

Disconnecting Google Ads

1. Go to Integrations → Google Ads
2. Click Disconnect
3. Confirm the disconnection

Your campaign data in Iverton AI is retained for historical reporting, but:

• No new data will sync
• Campaign management features will be disabled
• Cross-platform reports will exclude Google Ads data

To fully revoke access, also remove Iverton AI in Google:

1. Go to Google Account Permissions
2. Find "Iverton AI" and click Remove Access

Disconnecting Facebook Ads

1. Go to Integrations → Facebook Ads
2. Click Disconnect
3. Confirm the disconnection

To fully revoke access:

1. Go to Facebook Settings → Security and Login → Apps and Websites
2. Find "Iverton AI" and click Remove

Data Retention

After disconnecting, your historical ad performance data remains in Iverton AI for reporting purposes. To delete this data, contact support.

---

Cross-Platform Analytics

Unified Dashboard

View all advertising data in one place:

1. Go to Analytics → Advertising
2. See combined metrics across platforms
3. Filter by date range, campaign, or platform
4. Export unified reports

Metrics Comparison

Metric	Google Ads Term	Facebook Ads Term
Spend	Cost	Amount Spent
Impressions	Impressions	Impressions
Clicks	Clicks	Link Clicks
CTR	CTR	CTR (Link Click-Through Rate)
Conversions	Conversions	Results
CPA	Cost/Conv	Cost per Result

Attribution Considerations

Different platforms count conversions differently:

Platform	Default Attribution
Google Ads	30-day click, 1-day view
Facebook Ads	7-day click, 1-day view

When comparing, consider:

• Attribution windows
• Cross-device tracking differences
• Conversion counting methods

---

Best Practices

Budget Management

1. Set realistic budgets based on historical performance
2. Monitor daily during campaign launches
3. Use automated rules for budget adjustments
4. Allocate budget to top-performing campaigns

Campaign Optimization

1. Test regularly - A/B test ads, audiences, and placements
2. Review performance weekly - Identify trends and issues
3. Pause underperformers - Cut spend on low-ROI campaigns
4. Scale winners - Increase budget on high-performers

Reporting

1. Track the right metrics for your goals
2. Use consistent date ranges for comparison
3. Consider attribution when analyzing conversions
4. Combine with other data (GA4, CRM) for full picture

---

Environment Variables

For self-hosted deployments:

# Google Ads
GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token
GOOGLE_ADS_CLIENT_ID=your-client-id
GOOGLE_ADS_CLIENT_SECRET=your-client-secret
GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token
GOOGLE_ADS_CUSTOMER_ID=your-customer-id

# Facebook Ads (uses Facebook OAuth)
FACEBOOK_APP_ID=your-app-id
FACEBOOK_APP_SECRET=your-app-secret

---

API Endpoints Reference

# Google Ads
GET  /api/ad-platforms/google/auth       - Initiate OAuth
GET  /api/ad-platforms/google/callback   - OAuth callback
GET  /api/ad-platforms/google/accounts   - List ad accounts
GET  /api/ad-platforms/google/campaigns  - Get campaigns
GET  /api/ad-platforms/google/performance - Get performance data

# Facebook Ads
GET  /api/ad-platforms/facebook/accounts  - List ad accounts
GET  /api/ad-platforms/facebook/campaigns - Get campaigns
GET  /api/ad-platforms/facebook/insights  - Get performance insights

---

Continue to Settings