Google Ads Source

Renta поддерживает экспорт данных из Google Ads в следующие пункты назначения:

  • Google BigQuery
  • Clickhouse
  • SQL Server
  • Google Spreadsheets

Создание интеграции в хранилище данных (DWH)

  1. Перейдите в каталог интеграций;
  2. Выберите Google Ads;
  3. Добавьте аккаунт Google Ads, в котором находятся необходимые данные;
  4. Выберите добавленный аккаунт Google Ads;
  5. Укажите место назначения, в которое вы хотите импортировать данные;
  6. Перейдите на экран настроек и установите необходимую конфигурацию:

Customer accounts

Здесь вы можете выбрать нужный из доступных рекламных аккаунтов.

Report type

Тип отчета — состоит из уникального набора параметров и метрик, доступных для выгрузки в DWH. Каждый тип отчета соответствует одноименному методу API Google Ads. 

NameDescription
KEYWORDS_PERFORMANCE_REPORTThe Keywords Performance report includes all statistics aggregated at the keyword level, one row per keyword. If other segment fields are used, you may get more than one row per keyword.
AD_PERFORMANCE_REPORTThe Account Performance report includes all statistics aggregated by default at the account level, one row per account. If other segment fields are used, you may get more than one row per account.
URL_PERFORMANCE_REPORTThe URL Performance report includes all statistics aggregated at the URL and criterion level, one row per combination of: URL where your ads have been displayed (Url) Targeting criterion (CriteriaParameters) If other segment fields are used, you may get more than one row per combination of URL and placement criterion.
ADGROUP_PERFORMANCE_REPORTThe Ad Group Performance report includes all statistics aggregated by default at the ad group level, one row per ad group. If other segment fields are used, you may get more than one row per ad group.
CAMPAIGN_PERFORMANCE_REPORTThe Campaigns Performance report includes all statistics aggregated by default at the campaign level, one row per campaign. If other segment fields are used, you may get more than one row per campaign.
ACCOUNT_PERFORMANCE_REPORTThe Account Performance report includes all statistics aggregated by default at the account level, one row per account. If other segment fields are used, you may get more than one row per account.
GEO_PERFORMANCE_REPORTThe Geo Performance report includes all statistics aggregated at the country/territory level, one row per country/territory. If other segment fields are used, you may get more than one row per country/territory.
SEARCH_QUERY_PERFORMANCE_REPORTThe Search Terms report includes all statistics aggregated at the search terms level, one row per combination of search terms. If other segment fields are used, you may get more than one row per combination of search terms
AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORTThe Automatic Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement
CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORTAlthough negative keywords do not hold statistics, you can use this structured report to efficiently retrieve attributes of keyword-based NegativeCampaignCriterion objects.
CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORTAlthough negative placements do not hold statistics, you can use this structured report to efficiently retrieve attributes of placement-based NegativeCampaignCriterion objects.
DESTINATION_URL_REPORTDestination url
SHARED_SET_REPORTThe Shared Set report includes all SharedSet objects that can be shareable across campaigns.
CAMPAIGN_SHARED_SET_REPORTThe Campaign Shared Set report includes all relationships between SharedSet objects and campaigns.
SHARED_SET_CRITERIA_REPORTThe Shared Set Criteria report includes criteria for each SharedSet.
CREATIVE_CONVERSION_REPORTFree clicks are interactions that take place before a clickthrough for certain ads, product extensions and location extensions, e.g., interactions like "Get directions".
CALL_METRICS_CALL_DETAILS_REPORTThe Call Metrics Call Details report includes data for call tracking of call-only ads or call extensions.
KEYWORDLESS_QUERY_REPORTThe Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms.
KEYWORDLESS_CATEGORY_REPORTThe Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category.
CRITERIA_PERFORMANCE_REPORTThe Criteria Performance report includes statistics aggregated at the ad group criteria level, one row per ad group and criteria combination. If other segment fields are used, you may get more than one row per criteria.
CLICK_PERFORMANCE_REPORTThe Click Performance report includes stats aggregated at each click level, and includes both valid and invalid clicks.
BUDGET_PERFORMANCE_REPORTThe Budget Performance report includes all statistics aggregated by default at the budget level, one row per budget. If other segment fields are used, you may get more than one row per budget.
BID_GOAL_PERFORMANCE_REPORTThe Bid Goal Performance report includes statistics for your portfolio bid strategies. Standard strategies will not appear in this report's output.
DISPLAY_KEYWORD_PERFORMANCE_REPORTThe Display Keyword Performance report includes all Display Network and YouTube Network statistics aggregated at the keyword level, one row per keyword. If other segment fields are used, you may get more than one row per keyword.
PLACEHOLDER_FEED_ITEM_REPORTThe Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink). If other segment fields are used, you may get more than one row per feed item.
PLACEMENT_PERFORMANCE_REPORTThe Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement.
CAMPAIGN_NEGATIVE_LOCATIONS_REPORTAlthough negative locations do not hold statistics, you can use this structured report to efficiently retrieve attributes of location-based NegativeCampaignCriterion objects.
GENDER_PERFORMANCE_REPORTThe Gender Performance report includes all statistics aggregated by gender. It also includes automatic audience performance. If other segment fields are used, you may get more than one row per gender.
AGE_RANGE_PERFORMANCE_REPORTThe Age Range Performance report includes all Display Network and YouTube Network statistics aggregated by age range. It also includes automatic audience performance. If other segment fields are used, you may get more than one row per age range.
CAMPAIGN_LOCATION_TARGET_REPORTThe Campaign Location Target Report summarizes the performance of campaigns by location-based CampaignCriterion.
CAMPAIGN_AD_SCHEDULE_TARGET_REPORTThe Campaign Ad Schedule Target report summarizes the performance of campaigns by AdSchedule criteria.
PAID_ORGANIC_QUERY_REPORTThe Paid and Organic Query report provides a holistic view of your search stats across ads and organic listings at the query level. This lets you analyze strengths and gaps in your overall search presence, and gives insight into how your paid and organic search listings work together to connect your business with people searching on Google.
AUDIENCE_PERFORMANCE_REPORTThe Audience Performance report includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level—one row per audience. If other segment fields are used, you may get more than one row per topic.
DISPLAY_TOPICS_PERFORMANCE_REPORTThe Display Topics Performance report includes all Display Network and YouTube Network statistics aggregated at the topic level, one row per topic. If other segment fields are used, you may get more than one row per topic.
USER_AD_DISTANCE_REPORTThe User Ad Distance Report provides statistics aggregated by the user's distance from your location extensions. Each DistanceBucket shows all impressions that fall within its distance. As a result, an impression will contribute to the stats for all DistanceBucket objects that include the user's distance.
SHOPPING_PERFORMANCE_REPORTThe Shopping Performance report provides shopping campaign statistics aggregated at the product (OfferId field) level. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when AdWords recorded the corresponding event.
PRODUCT_PARTITION_REPORTThe Product Partition report provides shopping campaign statistics aggregated at the product partition (Id field) level. If other segment fields are used, you may get more than one row per product partition
PARENTAL_STATUS_PERFORMANCE_REPORTThe Parental Status Performance report includes statistics aggregated at the parental status level, one row per parental status. If other segment fields are used, you may get more than one row per parental status.
PLACEHOLDER_REPORTThe Placeholder Report provides statistics for feed-based ad extensions, one row per placeholder type. If other segment fields are used, you may get more than one row per placeholder type.
AD_CUSTOMIZERS_FEED_ITEM_REPORTThe Ad Customizers Feed Item report provides statistics for feed items used in Ad Customizers. Statistics are aggregated at the feed item level, one row per feed item. If other segment fields are used, you may get more than one row per feed item.
LABEL_REPORTThe Label report is a structure report that lists all labels for your account.
FINAL_URL_REPORTThe Final URL report includes all statistics aggregated at the final URL level, one row per final URL. If other segment fields are used, you may get more than one row per final URL. This report doesn't show any stats for ad extensions
VIDEO_PERFORMANCE_REPORTThe Video Performance report includes statistics for your account's upgraded AdWords for Video campaigns.
TOP_CONTENT_PERFORMANCE_REPORTThe Top Content Performance report includes statistics for top content bid modifier criteria, one row per ad group and criteria combination. If other segment fields are used, you may get more than one row per criteria.
CAMPAIGN_CRITERIA_REPORTThe Campaign Criteria report is a structure report that allows you to efficiently retrieve campaign-level criteria.
CAMPAIGN_GROUP_PERFORMANCE_REPORTThe Campaign Group Performance report includes the overall performance statistics of campaigns that you have included in campaign groups. Statistics are aggregated by default at the campaign group level. If other segment fields are used, you may get more than one row per campaign group.
LANDING_PAGE_REPORTThe Landing Page report includes all statistics aggregated by default by the UnexpandedFinalUrlString, one row per the URL string. If other segment fields are used, you may get more than one row per the URL string.

Parameters

Параметры — содержат список параметров и метрик, доступных для экспорта. Укажите необходимые для выгрузки параметры.

В результате Renta создаст таблицу, которая будет содержать данные выбранных параметров. Порядок выбранных параметров в интерфейсе будет соответствовать порядку столбцов таблицы.

Date range type

Диапазон дат — укажите период, за который необходимо экспортировать данные. Вы можете указать любой исторический временной интервал.

Чтобы выбрать необходимое время, введите в поле «From» дату, с которой вы хотите начать выгрузку данных, затем введите дату окончания в поле «To».

Если вы хотите, чтобы данные в таблице обновлялись ежедневно и дополнялись новыми днями, тогда в поле «To» укажите «Yesterday».
Подробная инструкция по работе с диапазоном дат

Integration name

Имя интеграции — при создании интеграции автоматически генерируется её имя. В этом поле вы можете переименовать название интеграции. Разрешены как кириллица, так и латиница, но не более 100 символов.

Название интеграции отображается на странице Integration List.

Table name

Имя таблицы — при создании интеграции автоматически генерируется имя таблицы, которая будет создана в DWH. В этом поле вы можете переименовать её.

Разрешена только латиница, цифры и символ «_».

Update time

Время обновления — вы можете указать любое время обновления, которое вам нужно. Рента обновляет интеграции ежедневно в интервале выбранного часа. 

Обычно наши пользователи выбирают время обновления интеграций рано утром, например, в 5 утра. В этом случае ваша интеграция будет обновляться в период с 5 утра до 6 утра. 

Обновление интеграций происходит по часовому поясу, выбранном в настройках вашего профайла. 

Overwrite period

Период перезаписи данных — это ретроспективное обновление данных за выбранный период.

Например, вы выбираете период перезаписи «Последние 7 дней» — это означает, что все данные за последние 7 дней будут удалены из таблицы и вставлены снова с обновленными данными.

Примечание: данная настройка доступна только в том случае, если был выбран параметр с типом date или dateTime. 

Создание интеграции в Google Spreadsheets

Воспользуйтесь бесплатным расширением, доступным в Google Workspace Marketplace. Для этого:

  1. Установите расширение Renta Spreadsheets Add-on.
  2. Затем зайдите в Google Sheets, и во вкладке Tools выберите Renta, после чего нажмите кнопку Run. 

После чего в правом сайдбаре откроется рабочая область с настройками интеграций. Подробная инструкция по созданию интеграции доступна по данной ссылке. Обратите внимание, что все созданные интеграции в Google Spreadsheets также доступны для управления в веб-версии Renta. 

Структура данных

NameDescriptionType
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING
AbsoluteTopImpressionPercentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.STRING
AccountCurrencyCodeThe currency of the Customer account.STRING
AccountDescriptiveNameThe descriptive name of the Customer account.STRING
AccountTimeZoneName of the timezone selected for the Customer accountSTRING
ActiveViewCpmAverage cost of viewable impressions (ActiveViewImpressions).STRING
ActiveViewCtrHow often people clicked your ad after it became viewable.STRING
ActiveViewImpressionsHow often your ad has become viewable on a Display Network site.STRING
ActiveViewMeasurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.STRING
ActiveViewMeasurableCostThe cost of the impressions you received that were measurable by Active View.STRING
ActiveViewMeasurableImpressionsThe number of times your ads are appearing on placements in positions where they can be seen.STRING
ActiveViewViewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).STRING
AdGroupIdThe ID of the AdGroup.STRING
AdGroupNameThe name of the AdGroup.STRING
AdGroupStatusStatus of the ad group.STRING
AdNetworkType1First level network type.STRING
AdNetworkType2Second level network type (includes search partners).STRING
AllConversionRateAllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion.STRING
AllConversionsBest estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions.STRING
AllConversionValueThe total value of all of your conversions, including those that are estimated.STRING
ApprovalStatusApproval status of the criterion.STRING
AverageCostThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.STRING
AverageCpcThe total cost of all clicks divided by the total number of clicks received.STRING
AverageCpeThe average amount that you havee been charged for an ad engagement.STRING
AverageCpmAverage Cost-per-thousand impressions (CPM).STRING
AverageCpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.STRING
AveragePageviewsAverage number of pages viewed per session. Imported from Google Analytics.STRING
AveragePositionYour ads position relative to those of other advertisers.STRING
AverageTimeOnSiteTotal duration of all sessions (in seconds) / number of sessions.STRING
BaseAdGroupIdThe ID of base ad group of trial ad groups.STRING
BaseCampaignIdThe ID of base campaign of trial campaigns.STRING
BiddingStrategyIdThe ID of the BiddingStrategyConfiguration.STRING
BiddingStrategyNameThe name of the BiddingStrategyConfiguration.STRING
BiddingStrategySourceIndicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.STRING
BiddingStrategyTypeThe type of the BiddingStrategyConfiguration.STRING
BounceRatePercentage of clicks where the user only visited a single page on your site, formatted as "x.xx%".STRING
CampaignIdThe ID of the Campaign.STRING
CampaignNameThe name of the Campaign.STRING
CampaignStatusThe status of the Campaign.STRING
ClickAssistedConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks.STRING
ClickAssistedConversionsOverLastClickConversionsThe total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.STRING
ClickAssistedConversionValueThe total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.STRING
ClicksThe number of clicks.FLOAT
ClickTypeIndicates the click type for metric fields such as Impressions.STRING
ConversionAdjustmentWhether the conversion was adjusted or the conversion is original one.STRING
ConversionAdjustmentLagBucketThe number of days between the impression and the conversion or between the impression and adjustments to the conversion.STRING
ConversionCategoryNameA category that describes the action the user will take to complete a conversion.STRING
ConversionLagBucketDays between click and conversion.STRING
ConversionRateThe number of conversions divided by total clicks that can be tracked to conversions.STRING
ConversionsThe number of conversions for all conversion actions that you have opted into optimization.STRING
ConversionTrackerIdID of the conversion tracker.STRING
ConversionTypeNameThe name of the conversion type. Prevents zero-conversion rows from being returned.STRING
ConversionValueThe sum of conversion values for all conversions.STRING
CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.FLOAT
CostPerAllConversionTotal cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.STRING
CostPerConversionThe Cost attributable to conversion-tracked clicks divided by the number of conversionsSTRING
CostPerCurrentModelAttributedConversionShows how your historic CostPerConversion data would look under the attribution model you have currently selected.STRING
CpcBidCost per click bid.STRING
CpcBidSourceSource of the CPC bid.STRING
CpmBidCPM (cost per thousand impressions) bid.STRING
CreativeQualityScoreThe quality score of the ad.STRING
CriteriaDescriptive string for the Criterion.STRING
CriteriaDestinationUrlDestination URL of the criterion that triggered ads.STRING
CrossDeviceConversionsConversions from when a customer clicks on an ad on one device, then converts on a different device or browser.STRING
CtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).STRING
CurrentModelAttributedConversionsShows how your historic Conversions data would look under the attribution model you have currently selected.STRING
CurrentModelAttributedConversionValueShows how your historic ConversionValue data would look under the attribution model you have currently selected.STRING
CustomerDescriptiveNameThe descriptive name of the Customer.STRING
DateThe date formatted as yyyy-MM-dd.STRING
DayOfWeekThe name of the day of the week, e.g., "Monday".STRING
DeviceDevice type where the impression was shown.STRING
EngagementRateHow often people engage with your ad after it is shown to them. This is the number of ad expansions divided by the number of times your ad is shown.STRING
EngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox adSTRING
EnhancedCpcEnabledIndicates if enhanced CPC is enabled on the bidding strategy.STRING
EstimatedAddClicksAtFirstPositionCpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc.STRING
EstimatedAddCostAtFirstPositionCpcEstimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc.STRING
ExternalConversionSourceThe source of conversion such as website, import from calls.STRING
ExternalCustomerIdThe Customer ID.STRING
FinalAppUrlsList of final app URLs of the main object of this row.STRING
FinalMobileUrlsList of final mobile URLs of the main object of this row.STRING
FinalUrls List of final URLs of the main object of this row.STRING
FinalUrlSuffixURL template for appending params to final URL.STRING
FirstPageCpcEstimate of the CPC bid required in order to show your ad on the first page of search results.STRING
FirstPositionCpcEstimate of the amount you might need to pay for your ad to be displayed in the first position at the top of the first page of Google search results.STRING
GmailForwardsThe number of times your ad was forwarded to someone else as a message.STRING
GmailSavesThe number of times someone has saved your Gmail ad to their inbox as a message.STRING
GmailSecondaryClicksThe number of clicks to your landing page on the expanded state of Gmail ads.STRING
HasQualityScoreWhether the QualityScore field of the criterion has value.STRING
HistoricalCreativeQualityScoreThe quality of historical ad relevance.STRING
HistoricalLandingPageQualityScoreThe quality of historical landing page experience.STRING
HistoricalQualityScoreThe historical quality score.STRING
HistoricalSearchPredictedCtrThe historical expected clickthrough rate.STRING
IdID of the main object of this row.STRING
ImpressionAssistedConversionsTotal number of conversions for which this object triggered assist impressions prior to the last click.STRING
ImpressionAssistedConversionsOverLastClickConversionsTotal number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.STRING
ImpressionAssistedConversionValueTotal value of all conversions for which this object triggered assist impressions.STRING
ImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.FLOAT
InteractionRateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.STRING
InteractionsThe number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.STRING
InteractionTypesThe types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.STRING
IsNegativeIndicates if the criterion for this row is a negative (exclusion) criterion.STRING
KeywordMatchTypeThe match type for the Keyword.STRING
LabelIdsList of label IDs for the main object of this row.STRING
LabelsList of label names for the main object of this row.STRING
MonthThe first day of the month, formatted as yyyy-MM-dd.STRING
MonthOfYearThe name of the month of the year, e.g., "December".STRING
PercentNewVisitorsPercentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%".STRING
PostClickQualityScoreThe quality score of the landing page.STRING
QualityScoreThe quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest).STRING
QuarterThe first day of the quarter, formatted as yyyy-MM-dd.STRING
SearchAbsoluteTopImpressionShareThe impressions you have received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.STRING
SearchBudgetLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to a low budget.STRING
SearchBudgetLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to a low budget.STRING
SearchExactMatchImpressionShareThe impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types.STRING
SearchImpressionShareThe impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive.STRING
SearchPredictedCtrClickthrough rate compared to that of other advertisers.STRING
SearchRankLostAbsoluteTopImpressionShareThe number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank.STRING
SearchRankLostImpressionShareThe estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank.STRING
SearchRankLostTopImpressionShareThe number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank.STRING
SearchTopImpressionShareThe impressions you have received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.STRING
SlotThe position of the Ad.STRING
StatusThe status of the main object in this row.STRING
SystemServingStatusServing status of the criterion.STRING
TopImpressionPercentageThe percent of your ad impressions that are shown anywhere above the organic search results.STRING
TopOfPageCpcEstimate of the CPC bid required in order to show your ad on the top of the first page of search results.STRING
TrackingUrlTemplateTracking template of the main object of this row.STRING
UrlCustomParametersCustom URL parameters of the main object of this row.STRING
ValuePerAllConversionThe value, on average, of all conversions.STRING
ValuePerConversionThe total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
ValuePerCurrentModelAttributedConversionShows how your historic ValuePerConversion data would look under the attribution model you have currently selected.STRING
VerticalIdThe ID of vertical.STRING
VideoQuartile100RatePercentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile25RatePercentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile50RatePercentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators are allowed in the WHERE clause.STRING
VideoQuartile75RatePercentage of impressions where the viewer watched 75% of your video.STRING
VideoViewRateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.STRING
VideoViewsThe number of times your video ads were viewed.STRING
ViewThroughConversionsThe total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.STRING
WeekThe date for the Monday of the week, formatted as yyyy-MM-dd.STRING
YearThe year, formatted as yyyy.STRING

Квоты и лимиты

Важное примечание: Renta не предусматривает никакие ограничения, такие как количество учетных записей или временной промежуток выгрузки данных.

Лимиты Google Ads:

  • Запросы с разбивкой на страницы — 10 000 строк на страницу
  • All with Basic Access — 15,000 API operations per day
  • Все с базовым доступом — 15 000 операций API в день
  • Видоизменённые запросы — 5000 операций на запрос
  • Запросы к сервиса планирования — 1 QPS
  • Запросы на выгрузку конверсий — 2000 конверсий на запрос
  • Сервис биллинга и бюджета аккаунта — 1 операция на запрос изменения

Ссылка на официальную документацию Google Ads

_______________________________________________
Если у вас есть вопросы — свяжитесь с нами!