Google Ads — Connector Overview
The Google Ads connector lets you connect Google Ads accounts to LightLead and pull statistics for search, display, and video campaigns. Levels: customer → campaign → ad_group → ad_group_ad / keyword_view.
Capabilities
- Full funnel: from impressions to conversions across all hierarchy levels
- Search metrics: impression share (
search_*_is), quality score on keyword_view - GAQL queries: searchStream with aliases from
GOOGLE_ADS_FIELDS - Manager & Customer accounts: MCC → linked customer IDs
- Conversions: conversions, conversions_value, view_through, computed ROAS/CPA
- Segmentation: device, network (split rows)
Supported Entities
| Entity | Description |
|---|---|
| Account (customer) | Customer ID, name, currency; manager ≠ reportable |
| Campaign | id, name, status, channel_type |
| Ad Group | aliases adset_* ← ad_group.* |
| Ad | ad_group_ad — id, name, type, final_url |
| Keyword | keyword_view — text, match_type, quality_score |
Key Detail: cost_micros
All monetary values in the Google Ads API are returned in microdollars (1/1,000,000 of base currency). LightLead auto-converts them:
python
real_cost = cost_micros / 1_000_000