Connection flow
OAuth 2.0 with provider account discovery. Customers choose from accounts returned by the provider rather than entering an unverified inventory endpoint.
Google Ads connector for governed marketing data.
Bring Google Ads campaign, ad group, ad, creative asset, keyword, search term, product, geo, device, and conversion reporting into a governed marketing data model. This page is generated from the same customer catalog, source schemas, live-fetch classifier, semantic contracts, and export registry used by the product.
16Available, live-fetch-ready reports
257Verified report-field definitions
SemanticPublished semantic tier
Setup and fit
What the Google Ads connection proves.
Registration alone is not enough for this page. The connector must be customer-discoverable, OAuth based, connectable at runtime, and backed by non-placeholder fetch implementations.
Best for
Paid-search and Performance Max teams that need comparable entities, declared grains, and export-safe reporting instead of provider-shaped tables.
Semantic coverage
12 declared base entities across the published reports: Ad, Ad Group, Asset Group, Campaign, Conversion Action, Creative, Device, Geo, Keyword, Landing Page, Product Group, Search Term.
ConnectableConnection provider and at least one live fetcher are registered.
16 availableHidden, planned, deferred, and catalog-unlisted reports are excluded.
1 eligible datasetEvery listed report passes the query and export registry contract checks; customer rollout is still gated.
Report contract
Supported Google Ads reports, entities, and grains.
The grain column is the declared uniqueness contract for a report row. A semantic tier includes a base entity and full semantic contract; a basic tier defines a safe report grain and common mappings without promising complete relationships.
| Report | What it contains | Tier / entity | Declared grain | Field contract |
|---|---|---|---|---|
Ad creative asset performancead_group_ad_asset |
Daily Google Ads ad-linked creative asset delivery, cost, conversion, and conversion-value metrics. | Semantic Creative |
date, provider_account_id, campaign_id, ad_group_id, ad_id, creative_id, google_ads_asset_field_typeTime key: date |
23 schema fields 22 report fields export-visible |
Ad group ad conversion action performancead_group_ad_conversion_action |
Daily Google Ads conversion and conversion-value metrics by ad group ad and conversion action. | Semantic Conversion Action |
date, provider_account_id, campaign_id, ad_group_id, ad_id, conversion_action_idTime key: date |
14 schema fields 13 report fields export-visible |
Ad group conversion action performancead_group_conversion_action |
Daily Google Ads conversion and conversion-value metrics by ad group and conversion action. | Semantic Conversion Action |
date, provider_account_id, campaign_id, ad_group_id, conversion_action_idTime key: date |
12 schema fields 11 report fields export-visible |
Ad group performancead_group |
Daily ad-group-level Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Ad Group |
date, provider_account_id, campaign_id, ad_group_idTime key: date |
16 schema fields 15 report fields export-visible |
Ad performancead |
Daily ad-level Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Ad |
date, provider_account_id, campaign_id, ad_group_id, ad_idTime key: date |
18 schema fields 17 report fields export-visible |
Asset group creative asset performanceasset_group_asset |
Daily Performance Max asset-group creative asset delivery, cost, conversion, and conversion-value metrics. | Semantic Creative |
date, provider_account_id, campaign_id, asset_group_id, creative_id, google_ads_asset_field_typeTime key: date |
21 schema fields 20 report fields export-visible |
Asset group performanceasset_group |
Daily Performance Max asset-group Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Asset Group |
date, provider_account_id, campaign_id, asset_group_idTime key: date |
18 schema fields 15 report fields export-visible |
Asset group product performanceasset_group_product_group |
Daily Performance Max asset-group product delivery, cost, conversion, and conversion-value metrics. | Semantic Product Group |
date, provider_account_id, campaign_id, asset_group_id, product_group_idTime key: date |
14 schema fields 14 report fields export-visible |
Campaign performancecampaign |
Daily campaign-level Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Campaign |
date, provider_account_id, campaign_idTime key: date |
14 schema fields 13 report fields export-visible |
Conversion action performanceconversion_action |
Daily conversion-action Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Conversion Action |
date, provider_account_id, campaign_id, conversion_action_idTime key: date |
10 schema fields 9 report fields export-visible |
Device performancedevice |
Daily device-level Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Device |
date, provider_account_id, campaign_id, device_idTime key: date |
16 schema fields 15 report fields export-visible |
Geo performancegeo |
Daily geographic Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Geo |
date, provider_account_id, campaign_id, geo_idTime key: date |
16 schema fields 15 report fields export-visible |
Keyword performancekeyword |
Daily paid-keyword Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Keyword |
date, provider_account_id, campaign_id, ad_group_id, keyword_idTime key: date |
18 schema fields 17 report fields export-visible |
Landing page performancelanding_page |
Daily landing-page Google Ads delivery, cost, conversion, and conversion-value metrics. | Semantic Landing Page |
date, provider_account_id, campaign_id, landing_page_idTime key: date |
16 schema fields 15 report fields export-visible |
Product group performanceproduct_group |
Daily Google Ads product-group shopping delivery, cost, conversion, and conversion-value metrics. | Semantic Product Group |
date, provider_account_id, campaign_id, ad_group_id, product_group_idTime key: date |
13 schema fields 13 report fields export-visible |
Search term performancesearch_term |
Daily Google Ads search-term delivery, cost, conversion, and conversion-value metrics. | Semantic Search Term |
date, provider_account_id, campaign_id, ad_group_id, search_term_idTime key: date |
18 schema fields 17 report fields export-visible |
Export contract
Modeled outputs, with blocked fields kept blocked.
Export eligibility is not inferred from a connector page. The generator resolves each report through the query catalog and requires a registry contract with allowlisted default columns and modes. Eligibility does not mean a destination or production export is enabled for a customer.
ad_performance
Public dataset contract covering 16 supported reports on this connector.
Eligibility241 report-field definitions are marked export-visible; 20 default columns pass the dataset registry policy.
ModesSource Replication, Source Replication With Semantic Views are contract-eligible, subject to destination support and rollout gates.
ReportsAd creative asset performance, Ad group ad conversion action performance, Ad group conversion action performance, Ad group performance, Ad performance, Asset group creative asset performance, Asset group performance, Asset group product performance, Campaign performance, Conversion action performance, Device performance, Geo performance, Keyword performance, Landing page performance, Product group performance, Search term performance
Truthful limitations
What this page does not promise.
A static contract page documents implemented product boundaries. It is not evidence that a specific tenant credential has permission to every provider account, that an upstream API is currently healthy, or that every provider field is publishable.
Provider-specific boundary
Metric Hive publishes only the report types listed on this page. Arbitrary GAQL, undocumented fields, and provider-native payloads are not part of the public connector contract.
Export rollout remains gated
Registry eligibility is not customer enablement. Destination support, deployment rollout, plan entitlement, tenant and account scope, date behavior, selected-field validation, PII policies, provider-native restrictions, and raw-payload blocks still apply.
Runtime evidence, not a blanket SLA
“Live-fetch ready” means the implementation is not a detected placeholder. It does not replace provider permissions, production smoke evidence, upstream API limits, or plan entitlement checks.
Related diagnostics
Use the contract to explain the numbers.
Connector availability is only the first question. These guides show how definitions, identifiers, attribution, time, currency, and report grain can still create different answers.
Platform ROAS vs. blended ROAS
Keep attributed channel revenue separate from observed business revenue and recompute each ratio from its own bases.
Metric aggregation and report grain
See why ratios, reach, distinct counts, snapshots, and attributed metrics cannot all be summed the same way.
Connector FAQ
Common Google Ads connector questions.
These answers use the same verified contract data as the report table and the page’s structured data.
What Google Ads data can Metric Hive load?
Metric Hive exposes 16 reviewed, live-fetch-ready Google Ads reports. The exact reports, entities, grains, fields, and semantic tiers are listed on this page.
Does the Google Ads connector use a semantic layer?
The published reports use the semantic tier. Semantic reports declare a base entity and complete semantic contract; basic reports declare a safe grain and common mappings without claiming complete relationship metadata.
Can I export modeled Google Ads data?
Each report on this page passes the query and export registry eligibility checks. That does not prove a destination is enabled for a customer: plan entitlement, destination support, rollout gates, tenant scope, and field policies still apply.
Inspect the contract, then connect your account.
Browse the full connector catalog, review canonical semantic definitions, or check pricing before starting an OAuth connection. Provider setup documentation