Integrations

Google Ads datasets and fields

The 25 datasets Maven lands from Google Ads, every field in them, and how the connection syncs.

Maven lands 25 datasets from Google Ads in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the Google Ads integration page.

Connection and sync#

You connect Google Ads by signing in to it and approving access, so nobody shares a password.

The first Google Ads sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 1125 days in total. After that, each scheduled sync re-reads the last 7 days, so late changes are picked up.

Datasets#

Customer settings#

Authoritative Google Ads customer currency, reporting timezone and auto-tagging snapshot.

FieldType
account IDText
account nameText
account currencyText
account timezoneText
metadata provenanceText
auto tagging enabledTrue/false

Campaigns#

Current Google Ads campaign entities with provider schedule, bidding, and budget metadata.

FieldType
account IDText
account nameText
account currencyText
account timezoneText
campaign IDText
campaign nameText
campaign statusText
campaign start date timeText
campaign end date timeText
channel typeText
channel sub typeText
bidding strategyText
bidding strategy resourceText
target cpa microsInteger
target ROASNumber
campaign budget resourceText
campaign budget IDText
campaign budget nameText
campaign budget statusText
campaign budget periodText
daily budget microsInteger
lifetime budget microsInteger
campaign budget explicitly sharedTrue/false
campaign budget delivery methodText
budget periodText
campaign objectiveText
campaign typeText
daily budgetNumber
lifetime budgetNumber
start dateText
end dateText

Campaign performance#

Campaign-level daily performance — impressions, clicks, cost, conversions.

FieldType
dateDate
account IDText
account nameText
account currencyText
account timezoneText
campaign IDText
campaign nameText
campaign statusText
channel typeText
bidding strategyText
bidding strategy resourceText
target cpa microsInteger
target ROASNumber
impressionsInteger
clicksInteger
engagementsInteger
cost microsInteger
conversionsNumber
conversion valueNumber
all conversionsNumber
CTRNumber
avg CPCNumber
avg CPMNumber
final URL suffixText
tracking URL templateText
URL custom parametersText
campaign final URL suffixText
campaign tracking URL templateText
campaign URL custom parametersText
customer final URL suffixText
customer tracking URL templateText
customer URL custom parametersText
video viewsInteger
all conversion valueNumber

Ad performance#

Ad-level daily performance with ad, ad group, campaign, and customer URL option fields.

FieldType
dateDate
account IDText
account nameText
account currencyText
account timezoneText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad group statusText
ad group typeText
ad IDText
ad nameText
ad statusText
ad typeText
impressionsInteger
clicksInteger
engagementsInteger
cost microsInteger
conversionsNumber
conversion valueNumber
final URLText
final URLsText
final URL suffixText
tracking URL templateText
URL custom parametersText
ad final URLText
ad final URLsText
ad final URL suffixText
ad tracking URL templateText
ad URL custom parametersText
ad group final URL suffixText
ad group tracking URL templateText
ad group URL custom parametersText
campaign final URL suffixText
campaign tracking URL templateText
campaign URL custom parametersText
customer final URL suffixText
customer tracking URL templateText
customer URL custom parametersText
video viewsInteger
all conversion valueNumber

Ad group performance#

Ad group-level daily performance with ad group, campaign, and customer URL option fields.

FieldType
dateDate
account IDText
account nameText
account currencyText
account timezoneText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad group statusText
ad group typeText
impressionsInteger
clicksInteger
engagementsInteger
cost microsInteger
conversionsNumber
conversion valueNumber
final URL suffixText
tracking URL templateText
URL custom parametersText
ad group final URL suffixText
ad group tracking URL templateText
ad group URL custom parametersText
campaign final URL suffixText
campaign tracking URL templateText
campaign URL custom parametersText
customer final URL suffixText
customer tracking URL templateText
customer URL custom parametersText
video viewsInteger
all conversion valueNumber

Device performance#

Campaign performance by device type.

FieldType
dateDate
deviceText
account IDText
account nameText
campaign IDText
campaign nameText
impressionsInteger
clicksInteger
engagementsInteger
cost microsInteger
conversionsNumber
conversion valueNumber
final URL suffixText
tracking URL templateText
URL custom parametersText
campaign final URL suffixText
campaign tracking URL templateText
campaign URL custom parametersText
customer final URL suffixText
customer tracking URL templateText
customer URL custom parametersText

Geo performance#

Campaign performance by geo region (state/province).

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
country criterion IDText
location typeText
region resource nameText
region criterion IDText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber

Geo performance metro#

Daily campaign performance by DMA.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
country criterion IDText
location typeText
metro resource nameText
metro criterion IDText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber

Geo performance county#

Daily campaign performance by county.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
country criterion IDText
location typeText
county resource nameText
county criterion IDText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber

Geo performance postal#

Daily campaign performance by postal code.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
country criterion IDText
location typeText
postal code resource nameText
postal code criterion IDText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber

Geo target constants#

Geo target constants for country, region, DMA region, county and postal code.

FieldType
criterion IDText
nameText
canonical nameText
country codeText
target typeText
statusText
account IDText
account nameText

Conversion action performance#

Lowest provider-returned conversion metrics segmented by Google Ads conversion action and conversion date.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
campaign channel typeText
ad group IDText
ad group nameText
ad IDText
ad nameText
asset group IDText
asset group nameText
conversion action resource nameText
conversion action IDText
conversion action nameText
conversionsNumber
conversion valueNumber
reported grainText

Conversion report coverage daily#

Successful native Google Ads conversion-action report coverage, including zero-row account-days.

FieldType
dateDate
account IDText
report nameText
requested grainText
reported grainText
report statusText
row countInteger
is partialTrue/false

Conversion actions#

Conversion-action dimension with gtag tag-snippet labels.

FieldType
account IDText
account nameText
conversion action IDText
conversion action resource nameText
conversion action nameText
conversion action typeText
conversion action statusText
conversion action categoryText
counting typeText
originText
primary for goalTrue/false
include in conversions metricTrue/false
click through lookback window daysInteger
view through lookback window daysInteger
default valueNumber
default currency codeText
always use default valueTrue/false
owner customerText
conversion IDText
conversion labelText
conversion last received request date timeText
conversion last conversion dateText

Customer conversion settings#

Account-level Google Ads conversion tracking settings.

FieldType
account IDText
account nameText
conversion tracking IDText
cross account conversion tracking IDText
accepted customer data termsTrue/false
conversion tracking statusText
enhanced conversions for leads enabledTrue/false
google ads conversion customerText

Campaign conversion goals#

Per-campaign biddable conversion categories — the campaign's optimization target.

FieldType
account IDText
account nameText
campaign IDText
conversion categoryText
conversion originText
biddableTrue/false

Configured target coverage#

Current completeness status for Google Ads campaign conversion-goal collection.

FieldType
coverage keyText
account IDText
scope levelText
collection statusText
source entity countInteger
configured target countInteger
capability reasonText
collected atTimestamp

Asset group performance#

Performance Max asset-group daily performance and raw status diagnostics.

FieldType
dateDate
account IDText
campaign IDText
campaign nameText
campaign statusText
asset group IDText
asset group nameText
asset group statusText
asset group primary statusText
asset group primary status reasonsText
asset group ad strengthText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber
account nameText

Asset group asset performance#

Performance Max asset-link daily performance, serving status, and policy diagnostics.

FieldType
dateDate
account IDText
campaign IDText
campaign nameText
asset group IDText
asset group nameText
asset resource nameText
asset IDText
asset nameText
asset typeText
asset textText
image URLText
image widthInteger
image heightInteger
mime typeText
youtube video IDText
field typeText
asset group asset statusText
asset group asset primary statusText
asset group asset primary status detailsText
asset group asset primary status reasonsText
policy approval statusText
policy review statusText
policy topic entriesText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber
video viewsInteger
preview asset IDText
preview storage pathText
preview source URLText
preview statusText
preview failure codeText
preview verified atTimestamp
preview content typeText
preview widthInteger
preview heightInteger
account nameText
creative IDText

Ad asset performance#

Native daily creative performance at ad and asset grain.

FieldType
dateDate
account IDText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
creative IDText
creative nameText
asset typeText
field typeText
enabledTrue/false
performance labelText
pinned fieldText
asset sourceText
asset textText
image URLText
image widthInteger
image heightInteger
mime typeText
youtube video IDText
video thumbnail URLText
landing page URLText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber
video viewsInteger
ad typeText
campaign advertising channel typeText
preview asset IDText
preview storage pathText
preview source URLText
preview statusText
preview failure codeText
preview verified atTimestamp
preview content typeText
preview widthInteger
preview heightInteger
account nameText

Video asset performance#

Daily per-video delivery from the Google Ads video report at date x ad x YouTube video grain. Written by account-scoped date-window replace.

FieldType
dateDate
account IDText
campaign IDText
campaign nameText
campaign advertising channel typeText
ad group IDText
ad group nameText
ad IDText
ad nameText
ad typeText
youtube video IDText
video titleText
video channel IDText
video duration millisInteger
video thumbnail URLText
impressionsInteger
clicksInteger
cost microsInteger
conversionsNumber
conversion valueNumber
video viewsInteger
account nameText

Creative assets#

Text, image, and video assets attached to ads with durable Maven preview metadata.

FieldType
asset link resource nameText
account IDText
campaign IDText
ad group IDText
ad IDText
ad nameText
creative IDText
creative nameText
asset typeText
field typeText
enabledTrue/false
performance labelText
pinned fieldText
asset sourceText
asset textText
image URLText
image widthInteger
image heightInteger
mime typeText
youtube video IDText
video thumbnail URLText
landing page URLText
preview asset IDText
preview storage pathText
preview source URLText
preview statusText
preview failure codeText
preview verified atTimestamp
preview content typeText
preview widthInteger
preview heightInteger
account nameText

Offline upload client summaries#

Offline-conversion-upload health per uploading client (rolling ~7-day snapshot).

FieldType
account IDText
account nameText
clientText
snapshot dateDate
statusText
success rateNumber
total event countInteger
successful event countInteger
pending event countInteger
last upload date timeText
alerts jsonText
daily summaries jsonText
job summaries jsonText

Offline upload action summaries#

Offline-conversion-upload health per conversion action (rolling ~7-day snapshot).

FieldType
account IDText
account nameText
conversion action IDText
conversion action nameText
clientText
snapshot dateDate
statusText
success rateNumber
total event countInteger
successful event countInteger
pending event countInteger
last upload date timeText
alerts jsonText
daily summaries jsonText
job summaries jsonText

Offline upload daily summaries#

Per-day offline-conversion-upload counts per account, summed across uploading clients.

FieldType
account IDText
account nameText
upload dateDate
successful countInteger
failed countInteger
pending countInteger