campaign.accessible_bidding_strategy |
Field description | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.ad_serving_optimization_status |
Field description | The ad serving optimization status of the campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
CONVERSION_OPTIMIZE OPTIMIZE ROTATE ROTATE_INDEFINITELY UNAVAILABLE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.advertising_channel_sub_type |
Field description | Immutable. Optional refinement to advertising_channel_type . Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Category | ATTRIBUTE |
Data Type |
ENUM
APP_CAMPAIGN APP_CAMPAIGN_FOR_ENGAGEMENT APP_CAMPAIGN_FOR_PRE_REGISTRATION DISPLAY_EXPRESS DISPLAY_GMAIL_AD DISPLAY_MOBILE_APP DISPLAY_SMART_CAMPAIGN LOCAL_CAMPAIGN SEARCH_EXPRESS SEARCH_MOBILE_APP SHOPPING_COMPARISON_LISTING_ADS SHOPPING_SMART_ADS SMART_CAMPAIGN UNKNOWN UNSPECIFIED VIDEO_ACTION VIDEO_NON_SKIPPABLE VIDEO_OUTSTREAM VIDEO_SEQUENCE
|
Type URL | google.ads.googleads.v12.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.advertising_channel_type |
Field description | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings . This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Category | ATTRIBUTE |
Data Type |
ENUM
DISCOVERY DISPLAY HOTEL LOCAL LOCAL_SERVICES MULTI_CHANNEL PERFORMANCE_MAX SEARCH SHOPPING SMART UNKNOWN UNSPECIFIED VIDEO
|
Type URL | google.ads.googleads.v12.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.app_campaign_setting.app_id |
Field description | Immutable. A string that uniquely identifies a mobile application. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.app_campaign_setting.app_store |
Field description | Immutable. The application store that distributes this specific app. |
Category | ATTRIBUTE |
Data Type |
ENUM
APPLE_APP_STORE GOOGLE_APP_STORE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.AppCampaignAppStoreEnum.AppCampaignAppStore |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.app_campaign_setting.bidding_strategy_goal_type |
Field description | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Category | ATTRIBUTE |
Data Type |
ENUM
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME OPTIMIZE_RETURN_ON_ADVERTISING_SPEND UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.audience_setting.use_audience_grouped |
Field description | Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.base_campaign |
Field description | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name . This field is read-only. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.bidding_strategy |
Field description | Portfolio bidding strategy used by campaign. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.bidding_strategy_system_status |
Field description | Output only. The system status of the campaign's bidding strategy. |
Category | ATTRIBUTE |
Data Type |
ENUM
ENABLED LEARNING_BUDGET_CHANGE LEARNING_COMPOSITION_CHANGE LEARNING_CONVERSION_SETTING_CHANGE LEARNING_CONVERSION_TYPE_CHANGE LEARNING_NEW LEARNING_SETTING_CHANGE LIMITED_BY_BUDGET LIMITED_BY_CPC_BID_CEILING LIMITED_BY_CPC_BID_FLOOR LIMITED_BY_DATA LIMITED_BY_INVENTORY LIMITED_BY_LOW_PRIORITY_SPEND LIMITED_BY_LOW_QUALITY MISCONFIGURED_CONVERSION_SETTINGS MISCONFIGURED_CONVERSION_TYPES MISCONFIGURED_SHARED_BUDGET MISCONFIGURED_STRATEGY_TYPE MISCONFIGURED_ZERO_ELIGIBILITY MULTIPLE MULTIPLE_LEARNING MULTIPLE_LIMITED MULTIPLE_MISCONFIGURED PAUSED UNAVAILABLE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.BiddingStrategySystemStatusEnum.BiddingStrategySystemStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.bidding_strategy_type |
Field description | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Category | ATTRIBUTE |
Data Type |
ENUM
COMMISSION ENHANCED_CPC INVALID MANUAL_CPA MANUAL_CPC MANUAL_CPM MANUAL_CPV MAXIMIZE_CONVERSIONS MAXIMIZE_CONVERSION_VALUE PAGE_ONE_PROMOTED PERCENT_CPC TARGET_CPA TARGET_CPM TARGET_IMPRESSION_SHARE TARGET_OUTRANK_SHARE TARGET_ROAS TARGET_SPEND UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.BiddingStrategyTypeEnum.BiddingStrategyType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.campaign_budget |
Field description | The budget of the campaign. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.campaign_group |
Field description | The campaign group this campaign belongs to. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.commission.commission_rate_micros |
Field description | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.dynamic_search_ads_setting.domain_name |
Field description | Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com". |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.dynamic_search_ads_setting.feeds |
Field description | The list of page feeds associated with the campaign. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.dynamic_search_ads_setting.language_code |
Field description | Required. The language code specifying the language of the domain, for example, "en". |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.dynamic_search_ads_setting.use_supplied_urls_only |
Field description | Whether the campaign uses advertiser supplied URLs exclusively. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.end_date |
Field description | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30. |
Category | ATTRIBUTE |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.excluded_parent_asset_field_types |
Field description | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_IMAGE BOOK_ON_GOOGLE BUSINESS_NAME CALL CALLOUT CALL_TO_ACTION_SELECTION DESCRIPTION HEADLINE HOTEL_CALLOUT LANDSCAPE_LOGO LEAD_FORM LOGO LONG_HEADLINE MANDATORY_AD_TEXT MARKETING_IMAGE MEDIA_BUNDLE MOBILE_APP PORTRAIT_MARKETING_IMAGE PRICE PROMOTION SITELINK SQUARE_MARKETING_IMAGE STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED VIDEO YOUTUBE_VIDEO
|
Type URL | google.ads.googleads.v12.enums.AssetFieldTypeEnum.AssetFieldType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.excluded_parent_asset_set_types |
Field description | The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported. |
Category | ATTRIBUTE |
Data Type |
ENUM
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP CHAIN_DYNAMIC_LOCATION_GROUP DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL LOCATION_SYNC MERCHANT_CENTER_FEED PAGE_FEED STATIC_LOCATION_GROUP UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.AssetSetTypeEnum.AssetSetType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.experiment_type |
Field description | Output only. The type of campaign: normal, draft, or experiment. |
Category | ATTRIBUTE |
Data Type |
ENUM
BASE DRAFT EXPERIMENT UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.CampaignExperimentTypeEnum.CampaignExperimentType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.final_url_suffix |
Field description | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.frequency_caps |
Field description | A list that limits how often each user will see this campaign's ads. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.FrequencyCapEntry |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.geo_target_type_setting.negative_geo_target_type |
Field description | The setting used for negative geotargeting in this particular campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
PRESENCE PRESENCE_OR_INTEREST UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.geo_target_type_setting.positive_geo_target_type |
Field description | The setting used for positive geotargeting in this particular campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
PRESENCE PRESENCE_OR_INTEREST SEARCH_INTEREST UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.hotel_setting.hotel_center_id |
Field description | Immutable. The linked Hotel Center account. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.id |
Field description | Output only. The ID of the campaign. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.labels |
Field description | Output only. The resource names of labels attached to this campaign. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.local_campaign_setting.location_source_type |
Field description | The location source type for this local campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
AFFILIATE GOOGLE_MY_BUSINESS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.LocationSourceTypeEnum.LocationSourceType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.local_services_campaign_settings.category_bids |
Field description | Categorical level bids associated with MANUAL_CPA bidding strategy. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.resources.Campaign.CategoryBid |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.manual_cpa |
Field description | Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.ManualCpa |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.manual_cpc.enhanced_cpc_enabled |
Field description | Whether bids are to be enhanced based on conversion optimizer data. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.manual_cpm |
Field description | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.ManualCpm |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.manual_cpv |
Field description | Output only. A bidding strategy that pays a configurable amount per video view. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.ManualCpv |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.maximize_conversion_value.target_roas |
Field description | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
Category | ATTRIBUTE |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.maximize_conversions.target_cpa_micros |
Field description | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.name |
Field description | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.network_settings.target_content_network |
Field description | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.network_settings.target_google_search |
Field description | Whether ads will be served with google.com search results. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.network_settings.target_partner_search_network |
Field description | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.network_settings.target_search_network |
Field description | Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true ). |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.optimization_goal_setting.optimization_goal_types |
Field description | The list of optimization goal types. |
Category | ATTRIBUTE |
Data Type |
ENUM
APP_PRE_REGISTRATION CALL_CLICKS DRIVING_DIRECTIONS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.OptimizationGoalTypeEnum.OptimizationGoalType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.optimization_score |
Field description | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Category | ATTRIBUTE |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.payment_mode |
Field description | Payment mode for the campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
CLICKS CONVERSIONS CONVERSION_VALUE GUEST_STAY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.PaymentModeEnum.PaymentMode |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.percent_cpc.cpc_bid_ceiling_micros |
Field description | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.percent_cpc.enhanced_cpc_enabled |
Field description | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Output only. Indicates which Performance Max campaign the campaign is upgraded to. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Output only. Indicates legacy campaign upgraded to Performance Max. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Output only. The upgrade status of a campaign requested to be upgraded to Performance Max. |
Category | ATTRIBUTE |
Data Type |
ENUM
UNKNOWN UNSPECIFIED UPGRADE_COMPLETE UPGRADE_ELIBIGLE UPGRADE_FAILED UPGRADE_IN_PROGRESS
|
Type URL | google.ads.googleads.v12.enums.PerformanceMaxUpgradeStatusEnum.PerformanceMaxUpgradeStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.primary_status |
Field description | Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status. |
Category | ATTRIBUTE |
Data Type |
ENUM
ELIGIBLE ENDED LEARNING LIMITED MISCONFIGURED NOT_ELIGIBLE PAUSED PENDING REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.CampaignPrimaryStatusEnum.CampaignPrimaryStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.primary_status_reasons |
Field description | Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus. |
Category | ATTRIBUTE |
Data Type |
ENUM
AD_GROUPS_PAUSED AD_GROUP_ADS_PAUSED APP_NOT_RELEASED APP_PARTIALLY_RELEASED BIDDING_STRATEGY_CONSTRAINED BIDDING_STRATEGY_LEARNING BIDDING_STRATEGY_LIMITED BIDDING_STRATEGY_MISCONFIGURED BUDGET_CONSTRAINED BUDGET_MISCONFIGURED CALL_EXTENSION_DISAPPROVED CALL_EXTENSION_UNDER_REVIEW CAMPAIGN_DRAFT CAMPAIGN_ENDED CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED CAMPAIGN_GROUP_PAUSED CAMPAIGN_PAUSED CAMPAIGN_PENDING CAMPAIGN_REMOVED HAS_ADS_DISAPPROVED HAS_ADS_LIMITED_BY_POLICY KEYWORDS_PAUSED LEAD_FORM_EXTENSION_DISAPPROVED LEAD_FORM_EXTENSION_UNDER_REVIEW MISSING_CALL_EXTENSION MISSING_LEAD_FORM_EXTENSION MOST_ADS_UNDER_REVIEW NO_AD_GROUPS NO_AD_GROUP_ADS NO_KEYWORDS NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA SEARCH_VOLUME_LIMITED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.CampaignPrimaryStatusReasonEnum.CampaignPrimaryStatusReason |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.real_time_bidding_setting.opt_in |
Field description | Whether the campaign is opted in to real-time bidding. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.resource_name |
Field description | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.selective_optimization.conversion_actions |
Field description | The selected set of conversion actions for optimizing this campaign. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.serving_status |
Field description | Output only. The ad serving status of the campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
ENDED NONE PENDING SERVING SUSPENDED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.CampaignServingStatusEnum.CampaignServingStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Category | ATTRIBUTE |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Whether to include local products. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Feed label of products to include in the campaign. Only one of feed_label or sales_country can be set. If used instead of sales_country, the feed_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Sales country of products to include in the campaign. Only one of feed_label or sales_country can be set. Field is immutable except for clearing. Once this field is cleared, you must use feed_label if you want to set the sales country. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Immutable. Whether to target Vehicle Listing inventory. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.start_date |
Field description | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Category | ATTRIBUTE |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.status |
Field description | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Category | ATTRIBUTE |
Data Type |
ENUM
ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.CampaignStatusEnum.CampaignStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_cpa.cpc_bid_ceiling_micros |
Field description | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_cpa.cpc_bid_floor_micros |
Field description | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_cpa.target_cpa_micros |
Field description | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_cpm |
Field description | A bidding strategy that automatically optimizes cost per thousand impressions. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.TargetCpm |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.target_impression_share.cpc_bid_ceiling_micros |
Field description | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_impression_share.location |
Field description | The targeted location on the search results page. |
Category | ATTRIBUTE |
Data Type |
ENUM
ABSOLUTE_TOP_OF_PAGE ANYWHERE_ON_PAGE TOP_OF_PAGE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.TargetImpressionShareLocationEnum.TargetImpressionShareLocation |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_impression_share.location_fraction_micros |
Field description | The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_roas.cpc_bid_ceiling_micros |
Field description | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_roas.cpc_bid_floor_micros |
Field description | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_roas.target_roas |
Field description | Output only. The chosen revenue (based on conversion data) per unit of spend. |
Category | ATTRIBUTE |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_spend.cpc_bid_ceiling_micros |
Field description | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_spend.target_spend_micros |
Field description | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.targeting_setting.target_restrictions |
Field description | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.TargetRestriction |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.tracking_setting.tracking_url |
Field description | Output only. The url used for dynamic tracking. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.tracking_url_template |
Field description | The URL template for constructing a tracking URL. |
Category | ATTRIBUTE |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.url_custom_parameters |
Field description | The list of mappings used to substitute custom parameter tags in a tracking_url_template , final_urls , or mobile_final_urls . |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v12.common.CustomParameter |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.url_expansion_opt_out |
Field description | Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.vanity_pharma.vanity_pharma_display_url_mode |
Field description | The display mode for vanity pharma URLs. |
Category | ATTRIBUTE |
Data Type |
ENUM
MANUFACTURER_WEBSITE_URL UNKNOWN UNSPECIFIED WEBSITE_DESCRIPTION
|
Type URL | google.ads.googleads.v12.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.vanity_pharma.vanity_pharma_text |
Field description | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Category | ATTRIBUTE |
Data Type |
ENUM
MEDICAL_DEVICE_WEBSITE_EN MEDICAL_DEVICE_WEBSITE_ES PRESCRIPTION_CONTRACEPTION_WEBSITE_EN PRESCRIPTION_CONTRACEPTION_WEBSITE_ES PRESCRIPTION_DEVICE_WEBSITE_EN PRESCRIPTION_DEVICE_WEBSITE_ES PRESCRIPTION_TREATMENT_WEBSITE_EN PRESCRIPTION_TREATMENT_WEBSITE_ES PRESCRIPTION_VACCINE_WEBSITE_EN PRESCRIPTION_VACCINE_WEBSITE_ES PREVENTATIVE_TREATMENT_WEBSITE_EN PREVENTATIVE_TREATMENT_WEBSITE_ES UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.VanityPharmaTextEnum.VanityPharmaText |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.video_brand_safety_suitability |
Field description | Output only. 3-Tier Brand Safety setting for the campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
EXPANDED_INVENTORY LIMITED_INVENTORY STANDARD_INVENTORY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_destination_type |
Field description | Ad Destination type. |
Category | SEGMENT |
Data Type |
ENUM
APP_DEEP_LINK APP_STORE LEAD_FORM LOCATION_LISTING MAP_DIRECTIONS MESSAGE NOT_APPLICABLE PHONE_CALL UNKNOWN UNMODELED_FOR_CONVERSIONS UNSPECIFIED WEBSITE YOUTUBE
|
Type URL | google.ads.googleads.v12.enums.AdDestinationTypeEnum.AdDestinationType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_network_type |
Field description | Ad network type. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH
|
Type URL | google.ads.googleads.v12.enums.AdNetworkTypeEnum.AdNetworkType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.asset_interaction_target.asset |
Field description | The asset resource name. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.asset_interaction_target.interaction_on_this_asset |
Field description | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.auction_insight_domain |
Field description | Domain (visible URL) of a participant in the Auction Insights report. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | False |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.budget_campaign_association_status.campaign |
Field description | The campaign resource name. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.budget_campaign_association_status.status |
Field description | Budget campaign association status. |
Category | SEGMENT |
Data Type |
ENUM
ENABLED REMOVED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.BudgetCampaignAssociationStatusEnum.BudgetCampaignAssociationStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.click_type |
Field description | Click type. |
Category | SEGMENT |
Data Type |
ENUM
APP_DEEPLINK BREADCRUMBS BROADBAND_PLAN CALLS CALL_TRACKING CLICK_ON_ENGAGEMENT_AD CROSS_NETWORK GET_DIRECTIONS HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION HOTEL_PRICE LOCATION_EXPANSION LOCATION_FORMAT_CALL LOCATION_FORMAT_DIRECTIONS LOCATION_FORMAT_IMAGE LOCATION_FORMAT_LANDING_PAGE LOCATION_FORMAT_MAP LOCATION_FORMAT_STORE_INFO LOCATION_FORMAT_TEXT MOBILE_CALL_TRACKING OFFER_PRINTS OTHER PRICE_EXTENSION PRODUCT_AD_APP_DEEPLINK PRODUCT_EXTENSION_CLICKS PRODUCT_LISTING_ADS_COUPON PRODUCT_LISTING_AD_CLICKS PRODUCT_LISTING_AD_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE PRODUCT_LISTING_AD_TRANSACTABLE PROMOTION_EXTENSION SHOPPING_COMPARISON_LISTING SHOWCASE_AD_CATEGORY_LINK SHOWCASE_AD_LOCAL_PRODUCT_LINK SHOWCASE_AD_LOCAL_STOREFRONT_LINK SHOWCASE_AD_ONLINE_PRODUCT_LINK SITELINKS STORE_LOCATOR SWIPEABLE_GALLERY_AD_HEADLINE SWIPEABLE_GALLERY_AD_SEE_MORE SWIPEABLE_GALLERY_AD_SITELINK_FIVE SWIPEABLE_GALLERY_AD_SITELINK_FOUR SWIPEABLE_GALLERY_AD_SITELINK_ONE SWIPEABLE_GALLERY_AD_SITELINK_THREE SWIPEABLE_GALLERY_AD_SITELINK_TWO SWIPEABLE_GALLERY_AD_SWIPES UNKNOWN UNSPECIFIED URL_CLICKS VIDEO_APP_STORE_CLICKS VIDEO_CALL_TO_ACTION_CLICKS VIDEO_CARD_ACTION_HEADLINE_CLICKS VIDEO_END_CAP_CLICKS VIDEO_WEBSITE_CLICKS VISUAL_SITELINKS WIRELESS_PLAN
|
Type URL | google.ads.googleads.v12.enums.ClickTypeEnum.ClickType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action |
Field description | Resource name of the conversion action. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action_category |
Field description | Conversion action category. |
Category | SEGMENT |
Data Type |
ENUM
ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ConversionActionCategoryEnum.ConversionActionCategory |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_action_name |
Field description | Conversion action name. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_adjustment |
Field description | This segments your conversion columns by the original conversion and conversion value versus the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_attribution_event_type |
Field description | Conversion attribution event type. |
Category | SEGMENT |
Data Type |
ENUM
IMPRESSION INTERACTION UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_lag_bucket |
Field description | An enum value representing the number of days between the impression and the conversion. |
Category | SEGMENT |
Data Type |
ENUM
EIGHT_TO_NINE_DAYS ELEVEN_TO_TWELVE_DAYS FIVE_TO_SIX_DAYS FORTY_FIVE_TO_SIXTY_DAYS FOURTEEN_TO_TWENTY_ONE_DAYS FOUR_TO_FIVE_DAYS LESS_THAN_ONE_DAY NINE_TO_TEN_DAYS ONE_TO_TWO_DAYS SEVEN_TO_EIGHT_DAYS SIXTY_TO_NINETY_DAYS SIX_TO_SEVEN_DAYS TEN_TO_ELEVEN_DAYS THIRTEEN_TO_FOURTEEN_DAYS THIRTY_TO_FORTY_FIVE_DAYS THREE_TO_FOUR_DAYS TWELVE_TO_THIRTEEN_DAYS TWENTY_ONE_TO_THIRTY_DAYS TWO_TO_THREE_DAYS UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ConversionLagBucketEnum.ConversionLagBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_or_adjustment_lag_bucket |
Field description | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
Category | SEGMENT |
Data Type |
ENUM
ADJUSTMENT_EIGHT_TO_NINE_DAYS ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS ADJUSTMENT_FIVE_TO_SIX_DAYS ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS ADJUSTMENT_FOUR_TO_FIVE_DAYS ADJUSTMENT_LESS_THAN_ONE_DAY ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS ADJUSTMENT_NINE_TO_TEN_DAYS ADJUSTMENT_ONE_TO_TWO_DAYS ADJUSTMENT_SEVEN_TO_EIGHT_DAYS ADJUSTMENT_SIXTY_TO_NINETY_DAYS ADJUSTMENT_SIX_TO_SEVEN_DAYS ADJUSTMENT_TEN_TO_ELEVEN_DAYS ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS ADJUSTMENT_THREE_TO_FOUR_DAYS ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS ADJUSTMENT_TWO_TO_THREE_DAYS ADJUSTMENT_UNKNOWN CONVERSION_EIGHT_TO_NINE_DAYS CONVERSION_ELEVEN_TO_TWELVE_DAYS CONVERSION_FIVE_TO_SIX_DAYS CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS CONVERSION_FOUR_TO_FIVE_DAYS CONVERSION_LESS_THAN_ONE_DAY CONVERSION_NINE_TO_TEN_DAYS CONVERSION_ONE_TO_TWO_DAYS CONVERSION_SEVEN_TO_EIGHT_DAYS CONVERSION_SIXTY_TO_NINETY_DAYS CONVERSION_SIX_TO_SEVEN_DAYS CONVERSION_TEN_TO_ELEVEN_DAYS CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS CONVERSION_THREE_TO_FOUR_DAYS CONVERSION_TWELVE_TO_THIRTEEN_DAYS CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS CONVERSION_TWO_TO_THREE_DAYS CONVERSION_UNKNOWN UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.conversion_value_rule_primary_dimension |
Field description | Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. |
Category | SEGMENT |
Data Type |
ENUM
AUDIENCE DEVICE GEO_LOCATION MULTIPLE NEW_VS_RETURNING_USER NO_RULE_APPLIED ORIGINAL UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ConversionValueRulePrimaryDimensionEnum.ConversionValueRulePrimaryDimension |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.date |
Field description | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.day_of_week |
Field description | Day of the week, for example, MONDAY. |
Category | SEGMENT |
Data Type |
ENUM
FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY
|
Type URL | google.ads.googleads.v12.enums.DayOfWeekEnum.DayOfWeek |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.device |
Field description | Device to which metrics apply. |
Category | SEGMENT |
Data Type |
ENUM
CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.DeviceEnum.Device |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.external_conversion_source |
Field description | External conversion source. |
Category | SEGMENT |
Data Type |
ENUM
AD_CALL_METRICS ANALYTICS ANALYTICS_SEARCH_ADS_360 ANDROID_FIRST_OPEN ANDROID_IN_APP APP_UNSPECIFIED CLICK_TO_CALL DISPLAY_AND_VIDEO_360_FLOODLIGHT FIREBASE FIREBASE_SEARCH_ADS_360 FLOODLIGHT GOOGLE_ATTRIBUTION GOOGLE_HOSTED GOOGLE_PLAY IOS_FIRST_OPEN IOS_IN_APP SALESFORCE SEARCH_ADS_360 STORE_SALES STORE_SALES_CRM STORE_SALES_DIRECT_UPLOAD STORE_SALES_PAYMENT_NETWORK STORE_VISITS THIRD_PARTY_APP_ANALYTICS UNKNOWN UNSPECIFIED UPLOAD UPLOAD_CALLS WEBPAGE WEBSITE_CALL_METRICS
|
Type URL | google.ads.googleads.v12.enums.ExternalConversionSourceEnum.ExternalConversionSource |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_airport |
Field description | Resource name of the geo target constant that represents an airport. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_canton |
Field description | Resource name of the geo target constant that represents a canton. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_city |
Field description | Resource name of the geo target constant that represents a city. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_country |
Field description | Resource name of the geo target constant that represents a country. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_county |
Field description | Resource name of the geo target constant that represents a county. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_district |
Field description | Resource name of the geo target constant that represents a district. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_metro |
Field description | Resource name of the geo target constant that represents a metro. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_most_specific_location |
Field description | Resource name of the geo target constant that represents the most specific location. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_postal_code |
Field description | Resource name of the geo target constant that represents a postal code. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_province |
Field description | Resource name of the geo target constant that represents a province. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_region |
Field description | Resource name of the geo target constant that represents a region. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.geo_target_state |
Field description | Resource name of the geo target constant that represents a state. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_booking_window_days |
Field description | Hotel booking window in days. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_center_id |
Field description | Hotel center ID. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_check_in_date |
Field description | Hotel check-in date. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_check_in_day_of_week |
Field description | Hotel check-in day of week. |
Category | SEGMENT |
Data Type |
ENUM
FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY
|
Type URL | google.ads.googleads.v12.enums.DayOfWeekEnum.DayOfWeek |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_city |
Field description | Hotel city. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_class |
Field description | Hotel class. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_country |
Field description | Hotel country. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_date_selection_type |
Field description | Hotel date selection type. |
Category | SEGMENT |
Data Type |
ENUM
DEFAULT_SELECTION UNKNOWN UNSPECIFIED USER_SELECTED
|
Type URL | google.ads.googleads.v12.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_length_of_stay |
Field description | Hotel length of stay. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_price_bucket |
Field description | Hotel price bucket. |
Category | SEGMENT |
Data Type |
ENUM
LOWEST_TIED LOWEST_UNIQUE NOT_LOWEST ONLY_PARTNER_SHOWN UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.HotelPriceBucketEnum.HotelPriceBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_rate_rule_id |
Field description | Hotel rate rule ID. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_rate_type |
Field description | Hotel rate type. |
Category | SEGMENT |
Data Type |
ENUM
PRIVATE_RATE PUBLIC_RATE QUALIFIED_RATE UNAVAILABLE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.HotelRateTypeEnum.HotelRateType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hotel_state |
Field description | Hotel state. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.hour |
Field description | Hour of day as a number between 0 and 23, inclusive. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.interaction_on_this_extension |
Field description | Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. |
Category | SEGMENT |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.month |
Field description | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.month_of_year |
Field description | Month of the year, for example, January. |
Category | SEGMENT |
Data Type |
ENUM
APRIL AUGUST DECEMBER FEBRUARY JANUARY JULY JUNE MARCH MAY NOVEMBER OCTOBER SEPTEMBER UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.MonthOfYearEnum.MonthOfYear |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.partner_hotel_id |
Field description | Partner hotel ID. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.placeholder_type |
Field description | Placeholder type. This is only used with feed item metrics. |
Category | SEGMENT |
Data Type |
ENUM
AD_CUSTOMIZER AFFILIATE_LOCATION APP CALL CALLOUT DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHT DYNAMIC_HOTEL DYNAMIC_JOB DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL IMAGE LOCATION MESSAGE PRICE PROMOTION SITELINK STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.PlaceholderTypeEnum.PlaceholderType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_aggregator_id |
Field description | Aggregator ID of the product. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_bidding_category_level1 |
Field description | Bidding category (level 1) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_bidding_category_level2 |
Field description | Bidding category (level 2) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_bidding_category_level3 |
Field description | Bidding category (level 3) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_bidding_category_level4 |
Field description | Bidding category (level 4) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_bidding_category_level5 |
Field description | Bidding category (level 5) of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | False |
|
segments.product_brand |
Field description | Brand of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_channel |
Field description | Channel of the product. |
Category | SEGMENT |
Data Type |
ENUM
LOCAL ONLINE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ProductChannelEnum.ProductChannel |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_channel_exclusivity |
Field description | Channel exclusivity of the product. |
Category | SEGMENT |
Data Type |
ENUM
MULTI_CHANNEL SINGLE_CHANNEL UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_condition |
Field description | Condition of the product. |
Category | SEGMENT |
Data Type |
ENUM
NEW REFURBISHED UNKNOWN UNSPECIFIED USED
|
Type URL | google.ads.googleads.v12.enums.ProductConditionEnum.ProductCondition |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_country |
Field description | Resource name of the geo target constant for the country of sale of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute0 |
Field description | Custom attribute 0 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute1 |
Field description | Custom attribute 1 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute2 |
Field description | Custom attribute 2 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute3 |
Field description | Custom attribute 3 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_custom_attribute4 |
Field description | Custom attribute 4 of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_item_id |
Field description | Item ID of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_language |
Field description | Resource name of the language constant for the language of the product. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_merchant_id |
Field description | Merchant ID of the product. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_store_id |
Field description | Store ID of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_title |
Field description | Title of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l1 |
Field description | Type (level 1) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l2 |
Field description | Type (level 2) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l3 |
Field description | Type (level 3) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l4 |
Field description | Type (level 4) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.product_type_l5 |
Field description | Type (level 5) of the product. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.quarter |
Field description | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.recommendation_type |
Field description | Recommendation type. |
Category | SEGMENT |
Data Type |
ENUM
CALLOUT_EXTENSION CALL_EXTENSION CAMPAIGN_BUDGET DISPLAY_EXPANSION_OPT_IN ENHANCED_CPC_OPT_IN FORECASTING_CAMPAIGN_BUDGET FORECASTING_SET_TARGET_ROAS KEYWORD KEYWORD_MATCH_TYPE MARGINAL_ROI_CAMPAIGN_BUDGET MAXIMIZE_CLICKS_OPT_IN MAXIMIZE_CONVERSIONS_OPT_IN MOVE_UNUSED_BUDGET OPTIMIZE_AD_ROTATION RAISE_TARGET_CPA_BID_TOO_LOW RESPONSIVE_SEARCH_AD RESPONSIVE_SEARCH_AD_ASSET RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH SEARCH_PARTNERS_OPT_IN SITELINK_EXTENSION TARGET_CPA_OPT_IN TARGET_ROAS_OPT_IN TEXT_AD UNKNOWN UNSPECIFIED UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX USE_BROAD_MATCH_KEYWORD
|
Type URL | google.ads.googleads.v12.enums.RecommendationTypeEnum.RecommendationType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.search_engine_results_page_type |
Field description | Type of the search engine results page. |
Category | SEGMENT |
Data Type |
ENUM
ADS_AND_ORGANIC ADS_ONLY ORGANIC_ONLY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.SearchEngineResultsPageTypeEnum.SearchEngineResultsPageType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_ad_event_type |
Field description | iOS Store Kit Ad Network ad event type. |
Category | SEGMENT |
Data Type |
ENUM
INTERACTION UNAVAILABLE UNKNOWN UNSPECIFIED VIEW
|
Type URL | google.ads.googleads.v12.enums.SkAdNetworkAdEventTypeEnum.SkAdNetworkAdEventType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_attribution_credit |
Field description | iOS Store Kit Ad Network attribution credit |
Category | SEGMENT |
Data Type |
ENUM
CONTRIBUTED UNAVAILABLE UNKNOWN UNSPECIFIED WON
|
Type URL | google.ads.googleads.v12.enums.SkAdNetworkAttributionCreditEnum.SkAdNetworkAttributionCredit |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_conversion_value |
Field description | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
Field description | App id where the ad that drove the iOS Store Kit Ad Network install was shown. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_user_type |
Field description | iOS Store Kit Ad Network user type. |
Category | SEGMENT |
Data Type |
ENUM
NEW_INSTALLER REINSTALLER UNAVAILABLE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.SkAdNetworkUserTypeEnum.SkAdNetworkUserType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.slot |
Field description | Position of the ad. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT MIXED SEARCH_OTHER SEARCH_PARTNER_OTHER SEARCH_PARTNER_TOP SEARCH_SIDE SEARCH_TOP UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v12.enums.SlotEnum.Slot |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.week |
Field description | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Category | SEGMENT |
Data Type | DATE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.year |
Field description | Year, formatted as yyyy. |
Category | SEGMENT |
Data Type | INT32 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.absolute_top_impression_percentage |
Field description | The percent of your ad impressions that are shown as the very first ad above the organic search results. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_cpm |
Field description | Average cost of viewable impressions (active_view_impressions ). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_ctr |
Field description | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_impressions |
Field description | A measurement of how often your ad has become viewable on a Display Network site. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurability |
Field description | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurable_cost_micros |
Field description | The cost of the impressions you received that were measurable by Active View. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_measurable_impressions |
Field description | The number of times your ads are appearing on placements in positions where they can be seen. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.active_view_viewability |
Field description | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions |
Field description | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_by_conversion_date |
Field description | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_click_to_call |
Field description | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_directions |
Field description | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_interactions_rate |
Field description | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_interactions_value_per_interaction |
Field description | The value of all conversions from interactions divided by the total number of interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_location_asset_click_to_call |
Field description | Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_location_asset_directions |
Field description | Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_location_asset_order |
Field description | Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_location_asset_other_engagement |
Field description | Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_location_asset_store_visits |
Field description | Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_location_asset_website |
Field description | Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_order |
Field description | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_other_engagement |
Field description | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_store_visit |
Field description | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_from_store_website |
Field description | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value |
Field description | The value of all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value_by_conversion_date |
Field description | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.all_conversions_value_per_cost |
Field description | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_absolute_top_impression_percentage |
Field description | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed as the very first ad above the organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_impression_share |
Field description | This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_outranking_share |
Field description | This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_overlap_rate |
Field description | This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_position_above_rate |
Field description | This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.auction_insight_search_top_impression_percentage |
Field description | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed above the organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cost |
Field description | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpc |
Field description | The total cost of all clicks divided by the total number of clicks received. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpe |
Field description | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpm |
Field description | Average cost-per-thousand impressions (CPM). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_cpv |
Field description | 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_page_views |
Field description | Average number of pages viewed per session. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_time_on_site |
Field description | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.benchmark_average_max_cpc |
Field description | An indication of how other advertisers are bidding on similar products. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.bounce_rate |
Field description | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.clicks |
Field description | The number of clicks. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_budget_lost_impression_share |
Field description | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_impression_share |
Field description | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.content_rank_lost_impression_share |
Field description | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions |
Field description | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_by_conversion_date |
Field description | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_from_interactions_rate |
Field description | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_from_interactions_value_per_interaction |
Field description | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value |
Field description | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value_by_conversion_date |
Field description | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.conversions_value_per_cost |
Field description | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_micros |
Field description | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_all_conversions |
Field description | The cost of ad interactions divided by all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_conversion |
Field description | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cost_per_current_model_attributed_conversion |
Field description | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_device_conversions |
Field description | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.ctr |
Field description | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions |
Field description | Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_from_interactions_rate |
Field description | Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_from_interactions_value_per_interaction |
Field description | The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_value |
Field description | The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.current_model_attributed_conversions_value_per_cost |
Field description | The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.eligible_impressions_from_location_asset_store_reach |
Field description | Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.engagement_rate |
Field description | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.engagements |
Field description | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_forwards |
Field description | The number of times the ad was forwarded to someone else as a message. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_saves |
Field description | The number of times someone has saved your Gmail ad to their inbox as a message. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gmail_secondary_clicks |
Field description | The number of clicks to the landing page on the expanded state of Gmail ads. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_creative_quality_score |
Field description | The creative historical quality score. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v12.enums.QualityScoreBucketEnum.QualityScoreBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_landing_page_quality_score |
Field description | The quality of historical landing page experience. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v12.enums.QualityScoreBucketEnum.QualityScoreBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_quality_score |
Field description | The historical quality score. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.historical_search_predicted_ctr |
Field description | The historical search predicted click through rate (CTR). |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v12.enums.QualityScoreBucketEnum.QualityScoreBucket |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.hotel_average_lead_value_micros |
Field description | Average lead value based on clicks. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.hotel_eligible_impressions |
Field description | The number of impressions that hotel partners could have had given their feed performance. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.hotel_price_difference_percentage |
Field description | The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.impressions |
Field description | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.interaction_event_types |
Field description | The types of payable and free interactions. |
Category | METRIC |
Data Type | ENUM |
Type URL | google.ads.googleads.v12.enums.InteractionEventTypeEnum.InteractionEventType |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
metrics.interaction_rate |
Field description | 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. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.interactions |
Field description | 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. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.invalid_click_rate |
Field description | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.invalid_clicks |
Field description | Number of clicks Google considers illegitimate and doesn't charge you for. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.message_chat_rate |
Field description | Number of message chats initiated (message_chats) divided by the number of message impressions (message_impressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.message_chats |
Field description | Number of message chats initiated for Click To Message impressions that were message tracking eligible. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.message_impressions |
Field description | Number of Click To Message impressions that were message tracking eligible. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.mobile_friendly_clicks_percentage |
Field description | The percentage of mobile clicks that go to a mobile-friendly page. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.optimization_score_uplift |
Field description | Total optimization score uplift of all recommendations. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.optimization_score_url |
Field description | URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign , and can be segmented by segments.recommendation_type . For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendation_type) combination. |
Category | METRIC |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.percent_new_visitors |
Field description | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_calls |
Field description | Number of offline phone calls. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_impressions |
Field description | Number of offline phone impressions. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.phone_through_rate |
Field description | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.publisher_organic_clicks |
Field description | Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.publisher_purchased_clicks |
Field description | Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.publisher_unknown_clicks |
Field description | Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.relative_ctr |
Field description | Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_absolute_top_impression_share |
Field description | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_absolute_top_impression_share |
Field description | The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_impression_share |
Field description | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_budget_lost_top_impression_share |
Field description | The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_click_share |
Field description | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_exact_match_impression_share |
Field description | The impressions you've 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. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_impression_share |
Field description | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_absolute_top_impression_share |
Field description | The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_impression_share |
Field description | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_rank_lost_top_impression_share |
Field description | The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.search_top_impression_share |
Field description | The impressions you've 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. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.sk_ad_network_conversions |
Field description | The number of iOS Store Kit Ad Network conversions. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.speed_score |
Field description | A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.top_impression_percentage |
Field description | The percent of your ad impressions that are shown anywhere above the organic search results. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.valid_accelerated_mobile_pages_clicks_percentage |
Field description | The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_all_conversions |
Field description | The value of all conversions divided by the number of all conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_all_conversions_by_conversion_date |
Field description | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_conversion |
Field description | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_conversions_by_conversion_date |
Field description | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.value_per_current_model_attributed_conversion |
Field description | The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p100_rate |
Field description | Percentage of impressions where the viewer watched all of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p25_rate |
Field description | Percentage of impressions where the viewer watched 25% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p50_rate |
Field description | Percentage of impressions where the viewer watched 50% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_quartile_p75_rate |
Field description | Percentage of impressions where the viewer watched 75% of your video. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_view_rate |
Field description | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.video_views |
Field description | The number of times your video ads were viewed. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions |
Field description | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions_from_location_asset_click_to_call |
Field description | Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions_from_location_asset_directions |
Field description | Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions_from_location_asset_order |
Field description | Number of order clicks on any location surface after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions_from_location_asset_other_engagement |
Field description | Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions_from_location_asset_store_visits |
Field description | Estimated number of visits to the store after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.view_through_conversions_from_location_asset_website |
Field description | Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|