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.v17.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 TRAVEL_ACTIVITIES UNKNOWN UNSPECIFIED VIDEO_ACTION VIDEO_NON_SKIPPABLE VIDEO_OUTSTREAM VIDEO_REACH_TARGET_FREQUENCY VIDEO_SEQUENCE
|
Type URL | google.ads.googleads.v17.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
DEMAND_GEN DISPLAY HOTEL LOCAL LOCAL_SERVICES MULTI_CHANNEL PERFORMANCE_MAX SEARCH SHOPPING SMART TRAVEL UNKNOWN UNSPECIFIED VIDEO
|
Type URL | google.ads.googleads.v17.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.v17.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.v17.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.asset_automation_settings |
Field description | Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v17.resources.Campaign.AssetAutomationSetting |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | True |
|
campaign.audience_setting.use_audience_grouped |
Field description | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign 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.v17.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 FIXED_CPM INVALID MANUAL_CPA MANUAL_CPC MANUAL_CPM MANUAL_CPV MAXIMIZE_CONVERSIONS MAXIMIZE_CONVERSION_VALUE PAGE_ONE_PROMOTED PERCENT_CPC TARGET_CPA TARGET_CPM TARGET_CPV TARGET_IMPRESSION_SHARE TARGET_OUTRANK_SHARE TARGET_ROAS TARGET_SPEND UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.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.demand_gen_campaign_settings.upgraded_targeting |
Field description | Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to true , you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to false , and can only be set when creating a campaign. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
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_LOGO BUSINESS_NAME CALL CALLOUT CALL_TO_ACTION_SELECTION DEMAND_GEN_CAROUSEL_CARD DESCRIPTION HEADLINE HOTEL_CALLOUT HOTEL_PROPERTY 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.v17.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 HOTEL_PROPERTY LOCATION_SYNC MERCHANT_CENTER_FEED PAGE_FEED STATIC_LOCATION_GROUP UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.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.v17.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.fixed_cpm.goal |
Field description | Fixed CPM bidding goal. Determines the exact bidding optimization parameters. |
Category | ATTRIBUTE |
Data Type |
ENUM
REACH TARGET_FREQUENCY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.FixedCpmGoalEnum.FixedCpmGoal |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.fixed_cpm.target_frequency_info.target_count |
Field description | Target frequency count represents the number of times an advertiser wants to show the ad to target a single user. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.fixed_cpm.target_frequency_info.time_unit |
Field description | Time window expressing the period over which you want to reach the specified target_count. |
Category | ATTRIBUTE |
Data Type |
ENUM
MONTHLY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.FixedCpmTargetFrequencyTimeUnitEnum.FixedCpmTargetFrequencyTimeUnit |
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.v17.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.v17.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.v17.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.hotel_property_asset_set |
Field description | Immutable. The set of hotel properties for Performance Max for travel goals campaigns. |
Category | ATTRIBUTE |
Data Type | RESOURCE_NAME |
Type URL | N/A |
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.keyword_match_type |
Field description | Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign. |
Category | ATTRIBUTE |
Data Type |
ENUM
BROAD UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.CampaignKeywordMatchTypeEnum.CampaignKeywordMatchType |
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.listing_type |
Field description | Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns. |
Category | ATTRIBUTE |
Data Type |
ENUM
UNKNOWN UNSPECIFIED VEHICLES
|
Type URL | google.ads.googleads.v17.enums.ListingTypeEnum.ListingType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
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.v17.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.v17.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.v17.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.v17.common.ManualCpm |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.manual_cpv |
Field description | A bidding strategy that pays a configurable amount per video view. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v17.common.ManualCpv |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.maximize_conversion_value.target_roas |
Field description | Output only. 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 | Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. |
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_google_tv_network |
Field description | Whether ads will be served on the Google TV network. |
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.network_settings.target_youtube |
Field description | Whether ads will be served on YouTube. |
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.v17.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.v17.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_ELIGIBLE UPGRADE_FAILED UPGRADE_IN_PROGRESS
|
Type URL | google.ads.googleads.v17.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.v17.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 ASSET_GROUPS_PAUSED 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 HAS_ASSET_GROUPS_DISAPPROVED HAS_ASSET_GROUPS_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 MOST_ASSET_GROUPS_UNDER_REVIEW NO_AD_GROUPS NO_AD_GROUP_ADS NO_ASSET_GROUPS NO_KEYWORDS NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA SEARCH_VOLUME_LIMITED UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.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.v17.enums.CampaignServingStatusEnum.CampaignServingStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Immutable. The ads account IDs of advertising partners cooperating within the campaign. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | False |
Repeated | True |
|
|
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 | Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
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 | 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 | Immutable. Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns. For setting Vehicle Listing inventory in Performance Max campaigns, use listing_type instead. |
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.v17.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 | Output only. 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.target_frequency_goal.target_count |
Field description | Target Frequency count representing how many times you want to reach a single user. |
Category | ATTRIBUTE |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_cpm.target_frequency_goal.time_unit |
Field description | Time window expressing the period over which you want to reach the specified target_count. |
Category | ATTRIBUTE |
Data Type |
ENUM
UNKNOWN UNSPECIFIED WEEKLY
|
Type URL | google.ads.googleads.v17.enums.TargetFrequencyTimeUnitEnum.TargetFrequencyTimeUnit |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.target_cpv |
Field description | An automated bidding strategy that sets bids to optimize performance given the target CPV you set. |
Category | ATTRIBUTE |
Data Type | MESSAGE |
Type URL | google.ads.googleads.v17.common.TargetCpv |
Filterable | False |
Selectable | True |
Sortable | False |
Repeated | False |
|
campaign.target_impression_share.cpc_bid_ceiling_micros |
Field description | Output only. 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 | Output only. 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.v17.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 | Output only. 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 | Output only. 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.v17.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.travel_campaign_settings.travel_account_id |
Field description | Immutable. The Travel account ID associated with the Travel campaign. |
Category | ATTRIBUTE |
Data Type | INT64 |
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.v17.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.v17.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.v17.enums.VanityPharmaTextEnum.VanityPharmaText |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.video_brand_safety_suitability |
Field description | Brand Safety setting at the individual campaign level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513. |
Category | ATTRIBUTE |
Data Type |
ENUM
EXPANDED_INVENTORY LIMITED_INVENTORY STANDARD_INVENTORY UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed |
Field description | Determine if VideoResponsiveAds can be used for in-feed video ads. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream |
Field description | Determine if VideoResponsiveAds can be used for in-stream video ads. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts |
Field description | Determine if VideoResponsiveAds can be used as shorts format. |
Category | ATTRIBUTE |
Data Type | BOOLEAN |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_account_id |
Field description | Activity account ID. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_city |
Field description | The city where the travel activity is available. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_country |
Field description | The country where the travel activity is available. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_rating |
Field description | Activity rating. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.activity_state |
Field description | The state where the travel activity is available. |
Category | SEGMENT |
Data Type | RESOURCE_NAME |
Type URL | N/A |
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.v17.enums.AdDestinationTypeEnum.AdDestinationType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
|
Field description | Ad Format type. |
Category | SEGMENT |
Data Type |
ENUM
AUDIO BUMPER INFEED INSTREAM_NON_SKIPPABLE INSTREAM_SKIPPABLE MASTHEAD OTHER OUTSTREAM SHORTS UNKNOWN UNSEGMENTED UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.AdFormatTypeEnum.AdFormatType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.ad_network_type |
Field description | Ad network type. |
Category | SEGMENT |
Data Type |
ENUM
CONTENT GOOGLE_TV MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE
|
Type URL | google.ads.googleads.v17.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.v17.enums.BudgetCampaignAssociationStatusEnum.BudgetCampaignAssociationStatus |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.click_type |
Field description | Click type. |
Category | SEGMENT |
Data Type |
ENUM
AD_IMAGE 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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.enums.DeviceEnum.Device |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.external_activity_id |
Field description | Advertiser supplied activity ID. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.enums.MonthOfYearEnum.MonthOfYear |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.new_versus_returning_customers |
Field description | This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. |
Category | SEGMENT |
Data Type |
ENUM
NEW NEW_AND_HIGH_LTV RETURNING UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.ConvertingUserPriorEngagementTypeAndLtvBucketEnum.ConvertingUserPriorEngagementTypeAndLtvBucket |
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.v17.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_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_category_level1 |
Field description | 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_category_level2 |
Field description | 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_category_level3 |
Field description | 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_category_level4 |
Field description | 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_category_level5 |
Field description | 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_channel |
Field description | Channel of the product. |
Category | SEGMENT |
Data Type |
ENUM
LOCAL ONLINE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.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.v17.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.v17.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_feed_label |
Field description | Feed label 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_ASSET CALL_ASSET CAMPAIGN_BUDGET CUSTOM_AUDIENCE_OPT_IN DISPLAY_EXPANSION_OPT_IN DYNAMIC_IMAGE_EXTENSION_OPT_IN ENHANCED_CPC_OPT_IN FORECASTING_CAMPAIGN_BUDGET FORECASTING_SET_TARGET_CPA FORECASTING_SET_TARGET_ROAS IMPROVE_DEMAND_GEN_AD_STRENGTH IMPROVE_GOOGLE_TAG_COVERAGE IMPROVE_PERFORMANCE_MAX_AD_STRENGTH KEYWORD KEYWORD_MATCH_TYPE LEAD_FORM_ASSET LOWER_TARGET_ROAS MARGINAL_ROI_CAMPAIGN_BUDGET MAXIMIZE_CLICKS_OPT_IN MAXIMIZE_CONVERSIONS_OPT_IN MAXIMIZE_CONVERSION_VALUE_OPT_IN MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX MOVE_UNUSED_BUDGET OPTIMIZE_AD_ROTATION PERFORMANCE_MAX_FINAL_URL_OPT_IN PERFORMANCE_MAX_OPT_IN RAISE_TARGET_CPA RAISE_TARGET_CPA_BID_TOO_LOW REFRESH_CUSTOMER_MATCH_LIST RESPONSIVE_SEARCH_AD RESPONSIVE_SEARCH_AD_ASSET RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH SEARCH_PARTNERS_OPT_IN SET_TARGET_CPA SET_TARGET_ROAS SHOPPING_ADD_AGE_GROUP SHOPPING_ADD_COLOR SHOPPING_ADD_GENDER SHOPPING_ADD_GTIN SHOPPING_ADD_MORE_IDENTIFIERS SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN SHOPPING_ADD_SIZE SHOPPING_FIX_DISAPPROVED_PRODUCTS SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX SHOPPING_TARGET_ALL_OFFERS SITELINK_ASSET 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.v17.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.v17.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.v17.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.v17.enums.SkAdNetworkAttributionCreditEnum.SkAdNetworkAttributionCredit |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_coarse_conversion_value |
Field description | iOS Store Kit Ad Network coarse conversion value. |
Category | SEGMENT |
Data Type |
ENUM
HIGH LOW MEDIUM NONE UNAVAILABLE UNKNOWN UNSPECIFIED
|
Type URL | google.ads.googleads.v17.enums.SkAdNetworkCoarseConversionValueEnum.SkAdNetworkCoarseConversionValue |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_fine_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_postback_sequence_index |
Field description | iOS Store Kit Ad Network postback sequence index. |
Category | SEGMENT |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_redistributed_fine_conversion_value |
Field description | iOS Store Kit Ad Network redistributed fine conversion value. Google uses modeling on observed conversion values(obtained from Apple) to calculate conversions from SKAN postbacks where NULLs are returned. This column represents the sum of the modeled conversion values and the observed conversion values. See https://support.google.com/google-ads/answer/14892597 to lean more. |
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_source_domain |
Field description | Website where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_source_type |
Field description | The source type where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or neither source domain nor source app were present in any postbacks sent by Apple. |
Category | SEGMENT |
Data Type |
ENUM
MOBILE_APPLICATION UNAVAILABLE UNKNOWN UNSPECIFIED WEBSITE
|
Type URL | google.ads.googleads.v17.enums.SkAdNetworkSourceTypeEnum.SkAdNetworkSourceType |
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.v17.enums.SkAdNetworkUserTypeEnum.SkAdNetworkUserType |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
segments.sk_ad_network_version |
Field description | The version of the SKAdNetwork API used. |
Category | SEGMENT |
Data Type | STRING |
Type URL | N/A |
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.v17.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 | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
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 the 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.all_new_customer_lifetime_value |
Field description | All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "all_conversions_value". See https://support.google.com/google-ads/answer/12080169 for more details. |
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 in the most prominent position on the search results page. 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 adjacent to the top 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_cart_size |
Field description | Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. |
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_impression_frequency_per_user |
Field description | The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_order_value_micros |
Field description | Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
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_target_cpa_micros |
Field description | The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA). |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.average_target_roas |
Field description | The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS). |
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_of_goods_sold_micros |
Field description | Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. |
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.cross_device_conversions_value_micros |
Field description | The sum of the value of cross-device conversions, in micros. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_cost_of_goods_sold_micros |
Field description | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_gross_profit_micros |
Field description | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_revenue_micros |
Field description | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.cross_sell_units_sold |
Field description | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
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.gross_profit_margin |
Field description | Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.gross_profit_micros |
Field description | Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
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.v17.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.v17.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.v17.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.v17.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.lead_cost_of_goods_sold_micros |
Field description | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_gross_profit_micros |
Field description | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_revenue_micros |
Field description | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.lead_units_sold |
Field description | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
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.new_customer_lifetime_value |
Field description | New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversions_value" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. |
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.orders |
Field description | Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | DOUBLE |
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.revenue_micros |
Field description | Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. |
Category | METRIC |
Data Type | INT64 |
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 among the top ads in the 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 adjacent to the top 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 among the top ads in the 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 adjacent to the top 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 among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. 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. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.sk_ad_network_installs |
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.sk_ad_network_total_conversions |
Field description | The total 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 adjacent to the top organic search results. |
Category | METRIC |
Data Type | DOUBLE |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.unique_users |
Field description | The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. |
Category | METRIC |
Data Type | INT64 |
Type URL | N/A |
Filterable | True |
Selectable | True |
Sortable | True |
Repeated | False |
|
metrics.units_sold |
Field description | Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. |
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 |
|