Google Ads¶
The HTTP API supports querying Google Ads data just like the internal analytics data.
Note
You must configure the Google Ads integration before any data from it will become available. This can be done in the Settings / Integrations application’s section.
Metrics¶
The table below lists metrics provided by Google Ads integration.
| Metric Name | Column ID | Scope | Type |
|---|---|---|---|
| Impressions (Google Ads) | google_ads_impressions | external | int |
| Clicks (Google Ads) | google_ads_clicks | external | int |
| Cost (Google Ads) | google_ads_cost | external | float |
| Average CPC (Google Ads) | google_ads_average_cpc | external | float |
| CTR (Google Ads) | google_ads_ctr | external | float |
| ROAS (Google Ads) | google_ads_roas | session | float |
Dimensions¶
The table below lists dimensions provided by Google Ads integration.
| Dimension Name | Column ID | Scope | Type | Nullable | Notes |
|---|---|---|---|---|---|
| Source | source | session | str | False | |
| Medium | medium | session | str | False | |
| Source/Medium | source_medium | session | str | False | |
| Keyword | keyword | session | str | False | |
| Device type | device_type | session | [int, str] | True | device_type.json |
| Session entry URL | session_entry_url | session | str | False | |
| Timestamp | timestamp | session | date | False | not available in Raw data API |
| Website Name | website_name | session | [str, str] | False | website UUID |
| Customer ID (Google Ads) | google_ads_customer_id | session | str_id | False | |
| Customer Name (Google Ads) | google_ads_customer_name | session | [str, str] | False | |
| Campaign ID (Google Ads) | google_ads_campaign_id | session | int_id | False | |
| Campaign Name (Google Ads) | google_ads_campaign_name | session | [int, str] | False | |
| Ad Group ID (Google Ads) | google_ads_ad_group_id | session | int_id | False | |
| Ad Group Name (Google Ads) | google_ads_ad_group_name | session | [int, str] | False | |
| Ad Group Ad ID (Google Ads) | google_ads_ad_group_ad_id | session | str_id | False | |
| Ad Group Ad Network Type (Google Ads) | google_ads_ad_network_type | session | [str, str] | False | google_ads_ad_network_type.json |
| Ad Group Keyword Match Type (Google Ads) | google_ads_keyword_match_type | external | [str, str] | False | google_ads_keyword_match_type.json, not available in Raw data API |
Mixed Queries¶
It is possible to request both internal analytics and Google Ads metrics in a single query (for example: “Sessions” and “Clicks (Google Ads)”), however only the common dimensions listed below may be used in such queries.
| Dimension Name | Column ID | Scope | Type | Nullable | Notes |
|---|---|---|---|---|---|
| Source | source | session | str | False | |
| Medium | medium | session | str | False | |
| Source/Medium | source_medium | session | str | False | |
| Keyword | keyword | session | str | False | |
| Device type | device_type | session | [int, str] | True | device_type.json |
| Session entry URL | session_entry_url | session | str | False | |
| Timestamp | timestamp | session | date | False | not available in Raw data API |
| Website Name | website_name | session | [str, str] | False | website UUID |
| Customer ID (Google Ads) | google_ads_customer_id | session | str_id | False | |
| Customer Name (Google Ads) | google_ads_customer_name | session | [str, str] | False | |
| Campaign ID (Google Ads) | google_ads_campaign_id | session | int_id | False | |
| Campaign Name (Google Ads) | google_ads_campaign_name | session | [int, str] | False | |
| Ad Group ID (Google Ads) | google_ads_ad_group_id | session | int_id | False | |
| Ad Group Name (Google Ads) | google_ads_ad_group_name | session | [int, str] | False | |
| Ad Group Ad ID (Google Ads) | google_ads_ad_group_ad_id | session | str_id | False | |
| Ad Group Ad Network Type (Google Ads) | google_ads_ad_network_type | session | [str, str] | False | google_ads_ad_network_type.json |
Warning
Using dimensions that are not explicitly listed in the table above in such queries (either as query columns or as filters) will result in a Bad Request response.