Renta поддерживает экспорт данных из Google Ads в следующие пункты назначения:
- Google BigQuery
- Clickhouse
- SQL Server
- Google Spreadsheets
Создание интеграции в хранилище данных (DWH)
- Перейдите в каталог интеграций;
- Выберите Google Ads;
- Добавьте аккаунт Google Ads, в котором находятся необходимые данные;
- Выберите добавленный аккаунт Google Ads;
- Укажите место назначения, в которое вы хотите импортировать данные;
- Перейдите на экран настроек и установите необходимую конфигурацию:
Customer accounts
Здесь вы можете выбрать нужный из доступных рекламных аккаунтов.
Report type
Тип отчета — состоит из уникального набора параметров и метрик, доступных для выгрузки в DWH. Каждый тип отчета соответствует одноименному методу API Google Ads.
Name | Description |
---|---|
KEYWORDS_PERFORMANCE_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | Although 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_REPORT | Although negative placements do not hold statistics, you can use this structured report to efficiently retrieve attributes of placement-based NegativeCampaignCriterion objects. |
DESTINATION_URL_REPORT | Destination url |
SHARED_SET_REPORT | The Shared Set report includes all SharedSet objects that can be shareable across campaigns. |
CAMPAIGN_SHARED_SET_REPORT | The Campaign Shared Set report includes all relationships between SharedSet objects and campaigns. |
SHARED_SET_CRITERIA_REPORT | The Shared Set Criteria report includes criteria for each SharedSet. |
CREATIVE_CONVERSION_REPORT | Free 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_REPORT | The Call Metrics Call Details report includes data for call tracking of call-only ads or call extensions. |
KEYWORDLESS_QUERY_REPORT | The Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms. |
KEYWORDLESS_CATEGORY_REPORT | The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category. |
CRITERIA_PERFORMANCE_REPORT | The 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_REPORT | The Click Performance report includes stats aggregated at each click level, and includes both valid and invalid clicks. |
BUDGET_PERFORMANCE_REPORT | The 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_REPORT | The Bid Goal Performance report includes statistics for your portfolio bid strategies. Standard strategies will not appear in this report's output. |
DISPLAY_KEYWORD_PERFORMANCE_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | Although negative locations do not hold statistics, you can use this structured report to efficiently retrieve attributes of location-based NegativeCampaignCriterion objects. |
GENDER_PERFORMANCE_REPORT | The 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_REPORT | The 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_REPORT | The Campaign Location Target Report summarizes the performance of campaigns by location-based CampaignCriterion. |
CAMPAIGN_AD_SCHEDULE_TARGET_REPORT | The Campaign Ad Schedule Target report summarizes the performance of campaigns by AdSchedule criteria. |
PAID_ORGANIC_QUERY_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The 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_REPORT | The Label report is a structure report that lists all labels for your account. |
FINAL_URL_REPORT | The 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_REPORT | The Video Performance report includes statistics for your account's upgraded AdWords for Video campaigns. |
TOP_CONTENT_PERFORMANCE_REPORT | The 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_REPORT | The Campaign Criteria report is a structure report that allows you to efficiently retrieve campaign-level criteria. |
CAMPAIGN_GROUP_PERFORMANCE_REPORT | The 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_REPORT | The 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. Для этого:
- Установите расширение Renta Spreadsheets Add-on.
- Затем зайдите в Google Sheets, и во вкладке Tools выберите Renta, после чего нажмите кнопку Run.
После чего в правом сайдбаре откроется рабочая область с настройками интеграций. Подробная инструкция по созданию интеграции доступна по данной ссылке. Обратите внимание, что все созданные интеграции в Google Spreadsheets также доступны для управления в веб-версии Renta.
Структура данных
Name | Description | Type |
---|---|---|
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |
TopOfPageCpc | Estimate of the CPC bid required in order to show your ad on the top of the first page of search results. | STRING |
TrackingUrlTemplate | Tracking template of the main object of this row. | STRING |
UrlCustomParameters | Custom URL parameters of the main object of this row. | STRING |
ValuePerAllConversion | The value, on average, of all conversions. | STRING |
ValuePerConversion | The 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 |
ValuePerCurrentModelAttributedConversion | Shows how your historic ValuePerConversion data would look under the attribution model you have currently selected. | STRING |
VerticalId | The ID of vertical. | STRING |
VideoQuartile100Rate | Percentage 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 |
VideoQuartile25Rate | Percentage 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 |
VideoQuartile50Rate | Percentage 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 |
VideoQuartile75Rate | Percentage of impressions where the viewer watched 75% of your video. | STRING |
VideoViewRate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | STRING |
VideoViews | The number of times your video ads were viewed. | STRING |
ViewThroughConversions | The 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 |
Week | The date for the Monday of the week, formatted as yyyy-MM-dd. | STRING |
Year | The year, formatted as yyyy. | STRING |
AbsoluteTopImpressionPercentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. | STRING |
AccountCurrencyCode | The currency of the Customer account. | STRING |
AccountDescriptiveName | The descriptive name of the Customer account. | STRING |
AccountTimeZone | Name of the timezone selected for the Customer account | STRING |
ActiveViewCpm | Average cost of viewable impressions (ActiveViewImpressions). | STRING |
ActiveViewCtr | How often people clicked your ad after it became viewable. | STRING |
ActiveViewImpressions | How often your ad has become viewable on a Display Network site. | STRING |
ActiveViewMeasurability | The ratio of impressions that could be measured by Active View over the number of served impressions. | STRING |
ActiveViewMeasurableCost | The cost of the impressions you received that were measurable by Active View. | STRING |
ActiveViewMeasurableImpressions | The number of times your ads are appearing on placements in positions where they can be seen. | STRING |
ActiveViewViewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | STRING |
AdGroupId | The ID of the AdGroup. | STRING |
AdGroupName | The name of the AdGroup. | STRING |
AdGroupStatus | Status of the ad group. | STRING |
AdNetworkType1 | First level network type. | STRING |
AdNetworkType2 | Second level network type (includes search partners). | STRING |
AllConversionRate | AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. | STRING |
AllConversions | Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. | STRING |
AllConversionValue | The total value of all of your conversions, including those that are estimated. | STRING |
ApprovalStatus | Approval status of the criterion. | STRING |
AverageCost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | STRING |
AverageCpc | The total cost of all clicks divided by the total number of clicks received. | STRING |
AverageCpe | The average amount that you havee been charged for an ad engagement. | STRING |
AverageCpm | Average Cost-per-thousand impressions (CPM). | STRING |
AverageCpv | The 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 |
AveragePageviews | Average number of pages viewed per session. Imported from Google Analytics. | STRING |
AveragePosition | Your ads position relative to those of other advertisers. | STRING |
AverageTimeOnSite | Total duration of all sessions (in seconds) / number of sessions. | STRING |
BaseAdGroupId | The ID of base ad group of trial ad groups. | STRING |
BaseCampaignId | The ID of base campaign of trial campaigns. | STRING |
BiddingStrategyId | The ID of the BiddingStrategyConfiguration. | STRING |
BiddingStrategyName | The name of the BiddingStrategyConfiguration. | STRING |
BiddingStrategySource | Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. | STRING |
BiddingStrategyType | The type of the BiddingStrategyConfiguration. | STRING |
BounceRate | Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". | STRING |
CampaignId | The ID of the Campaign. | STRING |
CampaignName | The name of the Campaign. | STRING |
CampaignStatus | The status of the Campaign. | STRING |
ClickAssistedConversions | The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. | STRING |
ClickAssistedConversionsOverLastClickConversions | The 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 |
ClickAssistedConversionValue | The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks. | STRING |
Clicks | The number of clicks. | FLOAT |
ClickType | Indicates the click type for metric fields such as Impressions. | STRING |
ConversionAdjustment | Whether the conversion was adjusted or the conversion is original one. | STRING |
ConversionAdjustmentLagBucket | The number of days between the impression and the conversion or between the impression and adjustments to the conversion. | STRING |
ConversionCategoryName | A category that describes the action the user will take to complete a conversion. | STRING |
ConversionLagBucket | Days between click and conversion. | STRING |
ConversionRate | The number of conversions divided by total clicks that can be tracked to conversions. | STRING |
Conversions | The number of conversions for all conversion actions that you have opted into optimization. | STRING |
ConversionTrackerId | ID of the conversion tracker. | STRING |
ConversionTypeName | The name of the conversion type. Prevents zero-conversion rows from being returned. | STRING |
ConversionValue | The sum of conversion values for all conversions. | STRING |
Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | FLOAT |
CostPerAllConversion | Total 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 |
CostPerConversion | The Cost attributable to conversion-tracked clicks divided by the number of conversions | STRING |
CostPerCurrentModelAttributedConversion | Shows how your historic CostPerConversion data would look under the attribution model you have currently selected. | STRING |
CpcBid | Cost per click bid. | STRING |
CpcBidSource | Source of the CPC bid. | STRING |
CpmBid | CPM (cost per thousand impressions) bid. | STRING |
CreativeQualityScore | The quality score of the ad. | STRING |
Criteria | Descriptive string for the Criterion. | STRING |
CriteriaDestinationUrl | Destination URL of the criterion that triggered ads. | STRING |
CrossDeviceConversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. | STRING |
Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | STRING |
CurrentModelAttributedConversions | Shows how your historic Conversions data would look under the attribution model you have currently selected. | STRING |
CurrentModelAttributedConversionValue | Shows how your historic ConversionValue data would look under the attribution model you have currently selected. | STRING |
CustomerDescriptiveName | The descriptive name of the Customer. | STRING |
Date | The date formatted as yyyy-MM-dd. | STRING |
DayOfWeek | The name of the day of the week, e.g., "Monday". | STRING |
Device | Device type where the impression was shown. | STRING |
EngagementRate | How 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 |
Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad | STRING |
EnhancedCpcEnabled | Indicates if enhanced CPC is enabled on the bidding strategy. | STRING |
EstimatedAddClicksAtFirstPositionCpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in FirstPositionCpc. | STRING |
EstimatedAddCostAtFirstPositionCpc | Estimate of how your cost per week might change when changing your keyword bid to the value in FirstPositionCpc. | STRING |
ExternalConversionSource | The source of conversion such as website, import from calls. | STRING |
ExternalCustomerId | The Customer ID. | STRING |
FinalAppUrls | List of final app URLs of the main object of this row. | STRING |
FinalMobileUrls | List 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 |
FinalUrlSuffix | URL template for appending params to final URL. | STRING |
FirstPageCpc | Estimate of the CPC bid required in order to show your ad on the first page of search results. | STRING |
FirstPositionCpc | Estimate 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 |
GmailForwards | The number of times your ad was forwarded to someone else as a message. | STRING |
GmailSaves | The number of times someone has saved your Gmail ad to their inbox as a message. | STRING |
GmailSecondaryClicks | The number of clicks to your landing page on the expanded state of Gmail ads. | STRING |
HasQualityScore | Whether the QualityScore field of the criterion has value. | STRING |
HistoricalCreativeQualityScore | The quality of historical ad relevance. | STRING |
HistoricalLandingPageQualityScore | The quality of historical landing page experience. | STRING |
HistoricalQualityScore | The historical quality score. | STRING |
HistoricalSearchPredictedCtr | The historical expected clickthrough rate. | STRING |
Id | ID of the main object of this row. | STRING |
ImpressionAssistedConversions | Total number of conversions for which this object triggered assist impressions prior to the last click. | STRING |
ImpressionAssistedConversionsOverLastClickConversions | Total 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 |
ImpressionAssistedConversionValue | Total value of all conversions for which this object triggered assist impressions. | STRING |
Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. | FLOAT |
InteractionRate | How 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 |
Interactions | The 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 |
InteractionTypes | The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns. | STRING |
IsNegative | Indicates if the criterion for this row is a negative (exclusion) criterion. | STRING |
KeywordMatchType | The match type for the Keyword. | STRING |
LabelIds | List of label IDs for the main object of this row. | STRING |
Labels | List of label names for the main object of this row. | STRING |
Month | The first day of the month, formatted as yyyy-MM-dd. | STRING |
MonthOfYear | The name of the month of the year, e.g., "December". | STRING |
PercentNewVisitors | Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". | STRING |
PostClickQualityScore | The quality score of the landing page. | STRING |
QualityScore | The quality score of the AdGroupCriterion. Ranges from 1 (lowest) to 10 (highest). | STRING |
Quarter | The first day of the quarter, formatted as yyyy-MM-dd. | STRING |
SearchAbsoluteTopImpressionShare | The 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 |
SearchBudgetLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. | STRING |
SearchBudgetLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. | STRING |
SearchExactMatchImpressionShare | The 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 |
SearchImpressionShare | The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. | STRING |
SearchPredictedCtr | Clickthrough rate compared to that of other advertisers. | STRING |
SearchRankLostAbsoluteTopImpressionShare | The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. | STRING |
SearchRankLostImpressionShare | The estimated percentage of impressions on the Search Network that your ads did SearchRankLostImpressionShare receive due to poor Ad Rank. | STRING |
SearchRankLostTopImpressionShare | The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. | STRING |
SearchTopImpressionShare | The 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 |
Slot | The position of the Ad. | STRING |
Status | The status of the main object in this row. | STRING |
SystemServingStatus | Serving status of the criterion. | STRING |
TopImpressionPercentage | The percent of your ad impressions that are shown anywhere above the organic search results. | STRING |