> ## Documentation Index
> Fetch the complete documentation index at: https://docs.customeros.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads

> Import campaign data and costs for attribution

## What It Does

Imports Google Ads campaign data and costs into CustomerOS for attribution and ROI analysis. Attribution connects ad spend to lead generation and revenue.

**Note:** This is an **inbound-only integration** (Google Ads → CustomerOS). CustomerOS does not push conversion data back to Google Ads. Attribution happens by matching utm parameters from ad clicks to CustomerOS sessions.

**Setup:** OAuth connection → Automatic account discovery → Campaigns and costs sync every 2 hours

## Data Flow

### Inbound Only (Google Ads → CustomerOS)

* **Campaigns** sync: name, status, budget, channel type, sub-type
* **Daily costs** import at campaign and ad level (in micros, converted to currency)
* **Campaign hierarchy**: Stores campaign IDs, ad group IDs, and ad IDs for granular tracking
* **Historical data**: 90-day cost lookback on first sync

### Attribution (Within CustomerOS)

When visitors arrive from Google Ads with utm parameters:

1. CustomerOS captures campaign, ad group, and keyword data from utm parameters
2. Tracks visitor journey and engagement across your website
3. Attributes lead creation to originating campaign when they convert
4. Calculates ROI automatically using imported cost data as leads progress to opportunity/customer

## What You Can Do

**Calculate true ROI**: See which campaigns generate customers, not just clicks—track from ad spend to closed revenue

**Optimize budget**: Shift spend to campaigns driving high-engagement evaluation leads vs. low-quality traffic

**Compare lead quality**: View ICP fit rates and lead stages by campaign to improve targeting

**Track full funnel**: Measure conversion rates from click → lead → opportunity → customer by campaign

**Cost per qualified lead**: Calculate actual cost per qualified lead, not just cost per click

## Reporting Capabilities (Within CustomerOS)

* Campaign-level lead quality and ICP fit analysis
* Cost per lead by stage (using imported cost data)
* Conversion rates from click → lead → opportunity → customer
* ROI by campaign with closed revenue attribution (based on CustomerOS pipeline data)
* Time-to-conversion metrics by campaign source

## Smart Features

* **Multi-account support**: Syncs campaigns from all client accounts you manage (MCC/Manager account support)
* **Granular cost tracking**: Daily cost data at campaign and ad level in micros (converted to currency)
* **Attribution via utm**: Matches utm parameters to campaigns for lead attribution
* **Historical sync**: 90 days of cost data on first connection
* **Incremental updates**: Efficient delta syncs every 2 hours
* **Currency handling**: Properly handles cost micros and currency conversion

## Technical Details

* OAuth 2.0 with Google Ads API v20 (configurable)
* Supports Google Ads Manager (MCC) and individual accounts
* Automatic token refresh for uninterrupted sync
* Batch processing with SOQL queries for campaign, ad group, and ad data
* Telemetry and error tracking for reliability
* Configurable sync schedules (default every 2 hours)