Google Ads Field Reference

Sample

 

https://connectors.windsor.ai/google_ads?api_key=[your API key]&date_preset=last_7d&fields=source,campaign,spend,date&_renderer=csv

 


Fields

IDTypeNameDescription
absolute_top_impression_percentageNUMERICAbsolute top impression percentageSearch absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.
access_reasonTEXTAccess reasonIndicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only.
accessible_bidding_strategyTEXTAccessible bidding strategyResource 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.
accessible_bidding_strategy_idNUMERICAccessible bidding strategy idThe ID of the bidding strategy.
accessible_bidding_strategy_maximize_conversion_value_target_roasNUMERICAccessible bidding strategy maximize conversion value target roasThe 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.
accessible_bidding_strategy_maximize_conversions_target_cpa_microsNUMERICAccessible bidding strategy maximize conversions target cpa microsThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
accessible_bidding_strategy_nameTEXTAccessible bidding strategy nameThe name of the bidding strategy.
accessible_bidding_strategy_owner_customer_idNUMERICAccessible bidding strategy owner customer idThe ID of the Customer which owns the bidding strategy.
accessible_bidding_strategy_owner_descriptive_nameTEXTAccessible bidding strategy owner descriptive namedescriptive_name of the Customer which owns the bidding strategy.
accessible_bidding_strategy_resource_nameTEXTAccessible bidding strategy resource nameThe resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
accessible_bidding_strategy_target_cpa_target_cpa_microsNUMERICAccessible bidding strategy target cpa target cpa microsAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
accessible_bidding_strategy_target_impression_share_cpc_bid_ceiling_microsNUMERICAccessible bidding strategy target impression share cpc bid ceiling microsThe 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.
accessible_bidding_strategy_target_impression_share_locationTEXTAccessible bidding strategy target impression share locationThe targeted location on the search results page.
accessible_bidding_strategy_target_impression_share_location_fraction_microsNUMERICAccessible bidding strategy target impression share location fraction microsThe chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
accessible_bidding_strategy_target_roas_target_roasNUMERICAccessible bidding strategy target roas target roasThe chosen revenue (based on conversion data) per unit of spend.
accessible_bidding_strategy_target_spend_cpc_bid_ceiling_microsNUMERICAccessible bidding strategy target spend cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
accessible_bidding_strategy_target_spend_target_spend_microsNUMERICAccessible bidding strategy target spend target spend microsThe 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.
accessible_bidding_strategy_typeTEXTAccessible bidding strategy typeThe type of the bidding strategy.
account_currency_codeTEXTAccount currency codeThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
account_descriptive_nameTEXTAccount descriptive nameOptional, non-unique descriptive name of the customer.
account_idTEXTAccount IDThe Google Ads account ID.
account_nameTEXTAccount NameOptional, non-unique descriptive name of the customer.
account_time_zoneTEXTAccount time zoneThe local timezone ID of the customer.
account_user_list_statusTEXTAccount user list statusIndicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED.
action_itemsTEXTAction itemsA list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.".
active_view_cpmNUMERICActive view cpmAverage cost of viewable impressions (active_view_impressions).
active_view_ctrNUMERICActive view ctrActive view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network.
active_view_impressionsNUMERICActive view impressionsA measurement of how often your ad has become viewable on a Display Network site.
active_view_measurabilityNUMERICActive view measurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.
active_view_measurable_costNUMERICActive view measurable costThe cost of the impressions you received that were measurable by Active View.
active_view_measurable_cost_microsNUMERICActive view measurable cost microsThe cost of the impressions you received that were measurable by Active View.
active_view_measurable_impressionsNUMERICActive view measurable impressionsThe number of times your ads are appearing on placements in positions where they can be seen.
active_view_viewabilityNUMERICActive view viewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
activity_account_idNUMERICActivity account idActivity account ID.
activity_ratingNUMERICActivity ratingActivity rating.
BOOLEANAd added by google adsIndicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing.
ad_app_ad_descriptionsTEXTAd app ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_app_ad_headlinesTEXTAd app ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_app_ad_html5_media_bundlesTEXTAd app ad html5 media bundlesList of media bundle assets that may be used with the ad.
ad_app_ad_html5_media_bundles_assetTEXTAd app ad html5 media bundles assetThe Asset resource name of this media bundle.
ad_app_ad_imagesTEXTAd app ad imagesList of image assets that may be displayed with the ad.
ad_app_ad_images_assetTEXTAd app ad images assetThe Asset resource name of this image.
ad_app_ad_mandatory_ad_textTEXTAd app ad mandatory ad textMandatory ad text.
ad_app_ad_youtube_videosTEXTAd app ad youtube videosList of YouTube video assets that may be displayed with the ad.
ad_app_ad_youtube_videos_assetTEXTAd app ad youtube videos assetThe Asset resource name of this video.
ad_app_engagement_ad_descriptionsTEXTAd app engagement ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_app_engagement_ad_headlinesTEXTAd app engagement ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_app_engagement_ad_imagesTEXTAd app engagement ad imagesList of image assets that may be displayed with the ad.
ad_app_engagement_ad_images_assetTEXTAd app engagement ad images assetThe Asset resource name of this image.
ad_app_engagement_ad_videosTEXTAd app engagement ad videosList of video assets that may be displayed with the ad.
ad_app_engagement_ad_videos_assetTEXTAd app engagement ad videos assetThe Asset resource name of this video.
ad_app_pre_registration_ad_descriptionsTEXTAd app pre registration ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_app_pre_registration_ad_headlinesTEXTAd app pre registration ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_app_pre_registration_ad_imagesTEXTAd app pre registration ad imagesList of image asset IDs whose images may be displayed with the ad.
ad_app_pre_registration_ad_images_assetTEXTAd app pre registration ad images assetThe Asset resource name of this image.
ad_app_pre_registration_ad_youtube_videosTEXTAd app pre registration ad youtube videosList of YouTube video asset IDs whose videos may be displayed with the ad.
ad_app_pre_registration_ad_youtube_videos_assetTEXTAd app pre registration ad youtube videos assetThe Asset resource name of this video.
ad_call_ad_business_nameTEXTAd call ad business nameThe business name in the ad.
ad_call_ad_call_trackedBOOLEANAd call ad call trackedWhether to enable call tracking for the creative. Enabling call tracking also enables call conversions.
ad_call_ad_conversion_actionTEXTAd call ad conversion actionThe conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored.
ad_call_ad_conversion_reporting_stateTEXTAd call ad conversion reporting stateThe call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled.
ad_call_ad_country_codeCOUNTRYAd call ad country codeThe country code in the ad.
ad_call_ad_description1TEXTAd call ad description1The first line of the ad's description.
ad_call_ad_description2TEXTAd call ad description2The second line of the ad's description.
ad_call_ad_disable_call_conversionBOOLEANAd call ad disable call conversionWhether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored.
ad_call_ad_headline1TEXTAd call ad headline1First headline in the ad.
ad_call_ad_headline2TEXTAd call ad headline2Second headline in the ad.
ad_call_ad_path1TEXTAd call ad path1First part of text that can be appended to the URL in the ad. Optional.
ad_call_ad_path2TEXTAd call ad path2Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional.
ad_call_ad_phone_numberTEXTAd call ad phone numberThe phone number in the ad.
ad_call_ad_phone_number_verification_urlTEXTAd call ad phone number verification urlThe URL to be used for phone number verification.
ad_destination_typeTEXTAd destination typeAd Destination type.
ad_device_preferenceTEXTAd device preferenceThe device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
TEXTAd discovery carousel ad business nameRequired. The Advertiser/brand name.
TEXTAd discovery carousel ad call to action textCall to action text.
TEXTAd discovery carousel ad carousel cardsRequired. Carousel cards that will display with the ad. Min 2 max 10.
TEXTAd discovery carousel ad carousel cards assetThe Asset resource name of this discovery carousel card.
TEXTAd discovery carousel ad descriptionRequired. The descriptive text of the ad.
TEXTAd discovery carousel ad headlineRequired. Headline of the ad.
TEXTAd discovery carousel ad logo imageRequired. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
TEXTAd discovery carousel ad logo image assetThe Asset resource name of this image.
ad_discovery_multi_asset_ad_business_nameTEXTAd discovery multi asset ad business nameThe Advertiser/brand name. Maximum display width is 25. Required.
ad_discovery_multi_asset_ad_call_to_action_textTEXTAd discovery multi asset ad call to action textCall to action text.
ad_discovery_multi_asset_ad_descriptionsTEXTAd discovery multi asset ad descriptionsThe descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
ad_discovery_multi_asset_ad_headlinesTEXTAd discovery multi asset ad headlinesHeadline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
ad_discovery_multi_asset_ad_lead_form_onlyBOOLEANAd discovery multi asset ad lead form onlyBoolean option that indicates if this ad must be served with lead form.
ad_discovery_multi_asset_ad_logo_imagesTEXTAd discovery multi asset ad logo imagesLogo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified.
ad_discovery_multi_asset_ad_logo_images_assetTEXTAd discovery multi asset ad logo images assetThe Asset resource name of this image.
ad_discovery_multi_asset_ad_marketing_imagesTEXTAd discovery multi asset ad marketing imagesMarketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20.
ad_discovery_multi_asset_ad_marketing_images_assetTEXTAd discovery multi asset ad marketing images assetThe Asset resource name of this image.
ad_discovery_multi_asset_ad_portrait_marketing_imagesTEXTAd discovery multi asset ad portrait marketing imagesPortrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20.
ad_discovery_multi_asset_ad_portrait_marketing_images_assetTEXTAd discovery multi asset ad portrait marketing images assetThe Asset resource name of this image.
ad_discovery_multi_asset_ad_square_marketing_imagesTEXTAd discovery multi asset ad square marketing imagesSquare marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20.
ad_discovery_multi_asset_ad_square_marketing_images_assetTEXTAd discovery multi asset ad square marketing images assetThe Asset resource name of this image.
ad_discovery_video_responsive_ad_breadcrumb1TEXTAd discovery video responsive ad breadcrumb1First part of text that appears in the ad with the displayed URL.
ad_discovery_video_responsive_ad_breadcrumb2TEXTAd discovery video responsive ad breadcrumb2Second part of text that appears in the ad with the displayed URL.
ad_discovery_video_responsive_ad_business_nameTEXTAd discovery video responsive ad business nameRequired. The advertiser/brand name.
ad_discovery_video_responsive_ad_call_to_actionsTEXTAd discovery video responsive ad call to actionsAssets of type CallToActionAsset used for the "Call To Action" button.
ad_discovery_video_responsive_ad_call_to_actions_assetTEXTAd discovery video responsive ad call to actions assetThe Asset resource name of this call to action asset.
ad_discovery_video_responsive_ad_descriptionsTEXTAd discovery video responsive ad descriptionsList of text assets used for the description.
ad_discovery_video_responsive_ad_headlinesTEXTAd discovery video responsive ad headlinesList of text assets used for the short headline.
ad_discovery_video_responsive_ad_logo_imagesTEXTAd discovery video responsive ad logo imagesLogo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
ad_discovery_video_responsive_ad_logo_images_assetTEXTAd discovery video responsive ad logo images assetThe Asset resource name of this image.
ad_discovery_video_responsive_ad_long_headlinesTEXTAd discovery video responsive ad long headlinesList of text assets used for the long headline.
ad_discovery_video_responsive_ad_videosTEXTAd discovery video responsive ad videosList of YouTube video assets used for the ad.
ad_discovery_video_responsive_ad_videos_assetTEXTAd discovery video responsive ad videos assetThe Asset resource name of this video.
ad_display_upload_ad_display_upload_product_typeTEXTAd display upload ad display upload product typeThe product type of this ad. See comments on the enum for details.
ad_display_upload_ad_media_bundleTEXTAd display upload ad media bundleA media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
ad_display_upload_ad_media_bundle_assetTEXTAd display upload ad media bundle assetThe Asset resource name of this media bundle.
ad_display_urlTEXTAd display urlThe URL that appears in the ad description for some ad formats.
ad_expanded_dynamic_search_ad_descriptionTEXTAd expanded dynamic search ad descriptionThe description of the ad.
ad_expanded_dynamic_search_ad_description2TEXTAd expanded dynamic search ad description2The second description of the ad.
ad_expanded_text_ad_descriptionTEXTAd expanded text ad descriptionThe description of the ad.
ad_expanded_text_ad_description2TEXTAd expanded text ad description2The second description of the ad.
ad_expanded_text_ad_headline_part1TEXTAd expanded text ad headline part1The first part of the ad's headline.
ad_expanded_text_ad_headline_part2TEXTAd expanded text ad headline part2The second part of the ad's headline.
ad_expanded_text_ad_headline_part3TEXTAd expanded text ad headline part3The third part of the ad's headline.
ad_expanded_text_ad_path1TEXTAd expanded text ad path1The text that can appear alongside the ad's displayed URL.
ad_expanded_text_ad_path2TEXTAd expanded text ad path2Additional text that can appear alongside the ad's displayed URL.
ad_final_app_urlsTEXTAd final app urlsA list of final app URLs that will be used on mobile if the user has the specific app installed.
ad_final_mobile_urlsTEXTAd final mobile urlsThe list of possible final mobile URLs after all cross-domain redirects for the ad.
ad_final_url_suffixTEXTAd final url suffixThe suffix to use when constructing a final URL.
ad_final_urlsTEXTAd final urlsThe list of possible final URLs after all cross-domain redirects for the ad.
ad_groupTEXTAd group pathThe ad group to which the criterion belongs.
ad_group_adTEXTAd group adThe ad group ad to which the asset is linked.
ad_group_ad_action_itemsTEXTAd group ad action itemsA list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.".
ad_group_ad_ad_added_by_google_adsBOOLEANAd group ad ad added by google adsIndicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing.
ad_group_ad_ad_app_ad_descriptionsTEXTAd group ad ad app ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_group_ad_ad_app_ad_headlinesTEXTAd group ad ad app ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_group_ad_ad_app_ad_html5_media_bundlesTEXTAd group ad ad app ad html5 media bundlesList of media bundle assets that may be used with the ad.
ad_group_ad_ad_app_ad_html5_media_bundles_assetTEXTAd group ad ad app ad html5 media bundles assetThe Asset resource name of this media bundle.
ad_group_ad_ad_app_ad_imagesTEXTAd group ad ad app ad imagesList of image assets that may be displayed with the ad.
ad_group_ad_ad_app_ad_images_assetTEXTAd group ad ad app ad images assetThe Asset resource name of this image.
ad_group_ad_ad_app_ad_mandatory_ad_textTEXTAd group ad ad app ad mandatory ad textMandatory ad text.
ad_group_ad_ad_app_ad_youtube_videosTEXTAd group ad ad app ad youtube videosList of YouTube video assets that may be displayed with the ad.
ad_group_ad_ad_app_ad_youtube_videos_assetTEXTAd group ad ad app ad youtube videos assetThe Asset resource name of this video.
ad_group_ad_ad_app_engagement_ad_descriptionsTEXTAd group ad ad app engagement ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_group_ad_ad_app_engagement_ad_headlinesTEXTAd group ad ad app engagement ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_group_ad_ad_app_engagement_ad_imagesTEXTAd group ad ad app engagement ad imagesList of image assets that may be displayed with the ad.
ad_group_ad_ad_app_engagement_ad_images_assetTEXTAd group ad ad app engagement ad images assetThe Asset resource name of this image.
ad_group_ad_ad_app_engagement_ad_videosTEXTAd group ad ad app engagement ad videosList of video assets that may be displayed with the ad.
ad_group_ad_ad_app_engagement_ad_videos_assetTEXTAd group ad ad app engagement ad videos assetThe Asset resource name of this video.
ad_group_ad_ad_app_pre_registration_ad_descriptionsTEXTAd group ad ad app pre registration ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_group_ad_ad_app_pre_registration_ad_headlinesTEXTAd group ad ad app pre registration ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_group_ad_ad_app_pre_registration_ad_imagesTEXTAd group ad ad app pre registration ad imagesList of image asset IDs whose images may be displayed with the ad.
ad_group_ad_ad_app_pre_registration_ad_images_assetTEXTAd group ad ad app pre registration ad images assetThe Asset resource name of this image.
ad_group_ad_ad_app_pre_registration_ad_youtube_videosTEXTAd group ad ad app pre registration ad youtube videosList of YouTube video asset IDs whose videos may be displayed with the ad.
ad_group_ad_ad_app_pre_registration_ad_youtube_videos_assetTEXTAd group ad ad app pre registration ad youtube videos assetThe Asset resource name of this video.
ad_group_ad_ad_call_ad_business_nameTEXTAd group ad ad call ad business nameThe business name in the ad.
ad_group_ad_ad_call_ad_call_trackedBOOLEANAd group ad ad call ad call trackedWhether to enable call tracking for the creative. Enabling call tracking also enables call conversions.
ad_group_ad_ad_call_ad_conversion_actionTEXTAd group ad ad call ad conversion actionThe conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored.
ad_group_ad_ad_call_ad_conversion_reporting_stateTEXTAd group ad ad call ad conversion reporting stateThe call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled.
ad_group_ad_ad_call_ad_country_codeCOUNTRYAd group ad ad call ad country codeThe country code in the ad.
ad_group_ad_ad_call_ad_description1TEXTAd group ad ad call ad description1The first line of the ad's description.
ad_group_ad_ad_call_ad_description2TEXTAd group ad ad call ad description2The second line of the ad's description.
ad_group_ad_ad_call_ad_disable_call_conversionBOOLEANAd group ad ad call ad disable call conversionWhether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored.
ad_group_ad_ad_call_ad_headline1TEXTAd group ad ad call ad headline1First headline in the ad.
ad_group_ad_ad_call_ad_headline2TEXTAd group ad ad call ad headline2Second headline in the ad.
ad_group_ad_ad_call_ad_path1TEXTAd group ad ad call ad path1First part of text that can be appended to the URL in the ad. Optional.
ad_group_ad_ad_call_ad_path2TEXTAd group ad ad call ad path2Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional.
ad_group_ad_ad_call_ad_phone_numberTEXTAd group ad ad call ad phone numberThe phone number in the ad.
ad_group_ad_ad_call_ad_phone_number_verification_urlTEXTAd group ad ad call ad phone number verification urlThe URL to be used for phone number verification.
ad_group_ad_ad_device_preferenceTEXTAd group ad ad device preferenceThe device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
TEXTAd group ad ad discovery carousel ad business nameRequired. The Advertiser/brand name.
TEXTAd group ad ad discovery carousel ad call to action textCall to action text.
TEXTAd group ad ad discovery carousel ad carousel cardsRequired. Carousel cards that will display with the ad. Min 2 max 10.
TEXTAd group ad ad discovery carousel ad carousel cards assetThe Asset resource name of this discovery carousel card.
TEXTAd group ad ad discovery carousel ad descriptionRequired. The descriptive text of the ad.
TEXTAd group ad ad discovery carousel ad headlineRequired. Headline of the ad.
TEXTAd group ad ad discovery carousel ad logo imageRequired. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
TEXTAd group ad ad discovery carousel ad logo image assetThe Asset resource name of this image.
ad_group_ad_ad_discovery_multi_asset_ad_business_nameTEXTAd group ad ad discovery multi asset ad business nameThe Advertiser/brand name. Maximum display width is 25. Required.
ad_group_ad_ad_discovery_multi_asset_ad_call_to_action_textTEXTAd group ad ad discovery multi asset ad call to action textCall to action text.
ad_group_ad_ad_discovery_multi_asset_ad_descriptionsTEXTAd group ad ad discovery multi asset ad descriptionsThe descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
ad_group_ad_ad_discovery_multi_asset_ad_headlinesTEXTAd group ad ad discovery multi asset ad headlinesHeadline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
ad_group_ad_ad_discovery_multi_asset_ad_lead_form_onlyBOOLEANAd group ad ad discovery multi asset ad lead form onlyBoolean option that indicates if this ad must be served with lead form.
ad_group_ad_ad_discovery_multi_asset_ad_logo_imagesTEXTAd group ad ad discovery multi asset ad logo imagesLogo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified.
ad_group_ad_ad_discovery_multi_asset_ad_logo_images_assetTEXTAd group ad ad discovery multi asset ad logo images assetThe Asset resource name of this image.
ad_group_ad_ad_discovery_multi_asset_ad_marketing_imagesTEXTAd group ad ad discovery multi asset ad marketing imagesMarketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20.
ad_group_ad_ad_discovery_multi_asset_ad_marketing_images_assetTEXTAd group ad ad discovery multi asset ad marketing images assetThe Asset resource name of this image.
ad_group_ad_ad_discovery_multi_asset_ad_portrait_marketing_imagesTEXTAd group ad ad discovery multi asset ad portrait marketing imagesPortrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20.
ad_group_ad_ad_discovery_multi_asset_ad_portrait_marketing_images_assetTEXTAd group ad ad discovery multi asset ad portrait marketing images assetThe Asset resource name of this image.
ad_group_ad_ad_discovery_multi_asset_ad_square_marketing_imagesTEXTAd group ad ad discovery multi asset ad square marketing imagesSquare marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20.
ad_group_ad_ad_discovery_multi_asset_ad_square_marketing_images_assetTEXTAd group ad ad discovery multi asset ad square marketing images assetThe Asset resource name of this image.
ad_group_ad_ad_discovery_video_responsive_ad_breadcrumb1TEXTAd group ad ad discovery video responsive ad breadcrumb1First part of text that appears in the ad with the displayed URL.
ad_group_ad_ad_discovery_video_responsive_ad_breadcrumb2TEXTAd group ad ad discovery video responsive ad breadcrumb2Second part of text that appears in the ad with the displayed URL.
ad_group_ad_ad_discovery_video_responsive_ad_business_nameTEXTAd group ad ad discovery video responsive ad business nameRequired. The advertiser/brand name.
ad_group_ad_ad_discovery_video_responsive_ad_call_to_actionsTEXTAd group ad ad discovery video responsive ad call to actionsAssets of type CallToActionAsset used for the "Call To Action" button.
ad_group_ad_ad_discovery_video_responsive_ad_call_to_actions_assetTEXTAd group ad ad discovery video responsive ad call to actions assetThe Asset resource name of this call to action asset.
ad_group_ad_ad_discovery_video_responsive_ad_descriptionsTEXTAd group ad ad discovery video responsive ad descriptionsList of text assets used for the description.
ad_group_ad_ad_discovery_video_responsive_ad_headlinesTEXTAd group ad ad discovery video responsive ad headlinesList of text assets used for the short headline.
ad_group_ad_ad_discovery_video_responsive_ad_logo_imagesTEXTAd group ad ad discovery video responsive ad logo imagesLogo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
ad_group_ad_ad_discovery_video_responsive_ad_logo_images_assetTEXTAd group ad ad discovery video responsive ad logo images assetThe Asset resource name of this image.
ad_group_ad_ad_discovery_video_responsive_ad_long_headlinesTEXTAd group ad ad discovery video responsive ad long headlinesList of text assets used for the long headline.
ad_group_ad_ad_discovery_video_responsive_ad_videosTEXTAd group ad ad discovery video responsive ad videosList of YouTube video assets used for the ad.
ad_group_ad_ad_discovery_video_responsive_ad_videos_assetTEXTAd group ad ad discovery video responsive ad videos assetThe Asset resource name of this video.
ad_group_ad_ad_display_upload_ad_display_upload_product_typeTEXTAd group ad ad display upload ad display upload product typeThe product type of this ad. See comments on the enum for details.
ad_group_ad_ad_display_upload_ad_media_bundleTEXTAd group ad ad display upload ad media bundleA media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
ad_group_ad_ad_display_upload_ad_media_bundle_assetTEXTAd group ad ad display upload ad media bundle assetThe Asset resource name of this media bundle.
ad_group_ad_ad_display_urlTEXTAd group ad ad display urlThe URL that appears in the ad description for some ad formats.
ad_group_ad_ad_expanded_dynamic_search_ad_descriptionTEXTAd group ad ad expanded dynamic search ad descriptionThe description of the ad.
ad_group_ad_ad_expanded_dynamic_search_ad_description2TEXTAd group ad ad expanded dynamic search ad description2The second description of the ad.
ad_group_ad_ad_expanded_text_ad_descriptionTEXTAd group ad ad expanded text ad descriptionThe description of the ad.
ad_group_ad_ad_expanded_text_ad_description2TEXTAd group ad ad expanded text ad description2The second description of the ad.
ad_group_ad_ad_expanded_text_ad_headline_part1TEXTAd group ad ad expanded text ad headline part1The first part of the ad's headline.
ad_group_ad_ad_expanded_text_ad_headline_part2TEXTAd group ad ad expanded text ad headline part2The second part of the ad's headline.
ad_group_ad_ad_expanded_text_ad_headline_part3TEXTAd group ad ad expanded text ad headline part3The third part of the ad's headline.
ad_group_ad_ad_expanded_text_ad_path1TEXTAd group ad ad expanded text ad path1The text that can appear alongside the ad's displayed URL.
ad_group_ad_ad_expanded_text_ad_path2TEXTAd group ad ad expanded text ad path2Additional text that can appear alongside the ad's displayed URL.
ad_group_ad_ad_final_app_urlsTEXTAd group ad ad final app urlsA list of final app URLs that will be used on mobile if the user has the specific app installed.
ad_group_ad_ad_final_mobile_urlsTEXTAd group ad ad final mobile urlsThe list of possible final mobile URLs after all cross-domain redirects for the ad.
ad_group_ad_ad_final_url_suffixTEXTAd group ad ad final url suffixThe suffix to use when constructing a final URL.
ad_group_ad_ad_final_urlsTEXTAd group ad ad final urlsThe list of possible final URLs after all cross-domain redirects for the ad.
ad_group_ad_ad_groupTEXTAd group ad ad groupThe ad group to which the ad belongs.
ad_group_ad_ad_hotel_adTEXTAd group ad ad hotel adDetails pertaining to a hotel ad.
ad_group_ad_ad_idNUMERICAd group ad ad idThe ID of the ad.
ad_group_ad_ad_image_ad_image_asset_assetTEXTAd group ad ad image ad image asset assetThe Asset resource name of this image.
ad_group_ad_ad_image_ad_image_urlTEXTAd group ad ad image ad image urlURL of the full size image.
ad_group_ad_ad_image_ad_mime_typeTEXTAd group ad ad image ad mime typeThe mime type of the image.
ad_group_ad_ad_image_ad_nameTEXTAd group ad ad image ad nameThe name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty.
ad_group_ad_ad_image_ad_pixel_heightNUMERICAd group ad ad image ad pixel heightHeight in pixels of the full size image.
ad_group_ad_ad_image_ad_pixel_widthNUMERICAd group ad ad image ad pixel widthWidth in pixels of the full size image.
ad_group_ad_ad_image_ad_preview_image_urlTEXTAd group ad ad image ad preview image urlURL of the preview size image.
ad_group_ad_ad_image_ad_preview_pixel_heightNUMERICAd group ad ad image ad preview pixel heightHeight in pixels of the preview size image.
ad_group_ad_ad_image_ad_preview_pixel_widthNUMERICAd group ad ad image ad preview pixel widthWidth in pixels of the preview size image.
ad_group_ad_ad_legacy_app_install_adTEXTAd group ad ad legacy app install adDetails pertaining to a legacy app install ad.
ad_group_ad_ad_legacy_responsive_display_ad_accent_colorTEXTAd group ad ad legacy responsive display ad accent colorThe accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_group_ad_ad_legacy_responsive_display_ad_allow_flexible_colorBOOLEANAd group ad ad legacy responsive display ad allow flexible colorAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
ad_group_ad_ad_legacy_responsive_display_ad_business_nameTEXTAd group ad ad legacy responsive display ad business nameThe business name in the ad.
ad_group_ad_ad_legacy_responsive_display_ad_call_to_action_textTEXTAd group ad ad legacy responsive display ad call to action textThe call-to-action text for the ad.
ad_group_ad_ad_legacy_responsive_display_ad_descriptionTEXTAd group ad ad legacy responsive display ad descriptionThe description of the ad.
ad_group_ad_ad_legacy_responsive_display_ad_format_settingTEXTAd group ad ad legacy responsive display ad format settingSpecifies which format the ad will be served in. Default is ALL_FORMATS.
ad_group_ad_ad_legacy_responsive_display_ad_logo_imageTEXTAd group ad ad legacy responsive display ad logo imageThe MediaFile resource name of the logo image used in the ad.
ad_group_ad_ad_legacy_responsive_display_ad_long_headlineTEXTAd group ad ad legacy responsive display ad long headlineThe long version of the ad's headline.
ad_group_ad_ad_legacy_responsive_display_ad_main_colorTEXTAd group ad ad legacy responsive display ad main colorThe main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_group_ad_ad_legacy_responsive_display_ad_marketing_imageTEXTAd group ad ad legacy responsive display ad marketing imageThe MediaFile resource name of the marketing image used in the ad.
ad_group_ad_ad_legacy_responsive_display_ad_price_prefixTEXTAd group ad ad legacy responsive display ad price prefixPrefix before price. For example, 'as low as'.
ad_group_ad_ad_legacy_responsive_display_ad_promo_textTEXTAd group ad ad legacy responsive display ad promo textPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
ad_group_ad_ad_legacy_responsive_display_ad_short_headlineTEXTAd group ad ad legacy responsive display ad short headlineThe short version of the ad's headline.
ad_group_ad_ad_legacy_responsive_display_ad_square_logo_imageTEXTAd group ad ad legacy responsive display ad square logo imageThe MediaFile resource name of the square logo image used in the ad.
ad_group_ad_ad_legacy_responsive_display_ad_square_marketing_imageTEXTAd group ad ad legacy responsive display ad square marketing imageThe MediaFile resource name of the square marketing image used in the ad.
ad_group_ad_ad_local_ad_call_to_actionsTEXTAd group ad ad local ad call to actionsList of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. At least 1 and at most 5 call-to-actions must be specified.
ad_group_ad_ad_local_ad_descriptionsTEXTAd group ad ad local ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified.
ad_group_ad_ad_local_ad_headlinesTEXTAd group ad ad local ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified.
ad_group_ad_ad_local_ad_logo_imagesTEXTAd group ad ad local ad logo imagesList of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified.
ad_group_ad_ad_local_ad_logo_images_assetTEXTAd group ad ad local ad logo images assetThe Asset resource name of this image.
ad_group_ad_ad_local_ad_marketing_imagesTEXTAd group ad ad local ad marketing imagesList of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified.
ad_group_ad_ad_local_ad_marketing_images_assetTEXTAd group ad ad local ad marketing images assetThe Asset resource name of this image.
ad_group_ad_ad_local_ad_path1TEXTAd group ad ad local ad path1First part of optional text that can be appended to the URL in the ad.
ad_group_ad_ad_local_ad_path2TEXTAd group ad ad local ad path2Second part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
ad_group_ad_ad_local_ad_videosTEXTAd group ad ad local ad videosList of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
ad_group_ad_ad_local_ad_videos_assetTEXTAd group ad ad local ad videos assetThe Asset resource name of this video.
ad_group_ad_ad_nameTEXTAd group ad ad nameThe name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
ad_group_ad_ad_resource_nameTEXTAd group ad ad resource nameThe resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
ad_group_ad_ad_responsive_display_ad_accent_colorTEXTAd group ad ad responsive display ad accent colorThe accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_group_ad_ad_responsive_display_ad_allow_flexible_colorBOOLEANAd group ad ad responsive display ad allow flexible colorAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
ad_group_ad_ad_responsive_display_ad_business_nameTEXTAd group ad ad responsive display ad business nameThe advertiser/brand name. Maximum display width is 25.
ad_group_ad_ad_responsive_display_ad_call_to_action_textTEXTAd group ad ad responsive display ad call to action textThe call-to-action text for the ad. Maximum display width is 30.
ad_group_ad_ad_responsive_display_ad_control_spec_enable_asset_enhancementsBOOLEANAd group ad ad responsive display ad control spec enable asset enhancementsWhether the advertiser has opted into the asset enhancements feature.
ad_group_ad_ad_responsive_display_ad_control_spec_enable_autogen_videoBOOLEANAd group ad ad responsive display ad control spec enable autogen videoWhether the advertiser has opted into auto-gen video feature.
ad_group_ad_ad_responsive_display_ad_descriptionsTEXTAd group ad ad responsive display ad descriptionsDescriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
ad_group_ad_ad_responsive_display_ad_format_settingTEXTAd group ad ad responsive display ad format settingSpecifies which format the ad will be served in. Default is ALL_FORMATS.
ad_group_ad_ad_responsive_display_ad_headlinesTEXTAd group ad ad responsive display ad headlinesShort format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
ad_group_ad_ad_responsive_display_ad_logo_imagesTEXTAd group ad ad responsive display ad logo imagesLogo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5.
ad_group_ad_ad_responsive_display_ad_logo_images_assetTEXTAd group ad ad responsive display ad logo images assetThe Asset resource name of this image.
ad_group_ad_ad_responsive_display_ad_long_headlineTEXTAd group ad ad responsive display ad long headlineA required long format headline. The maximum length is 90 characters.
ad_group_ad_ad_responsive_display_ad_main_colorTEXTAd group ad ad responsive display ad main colorThe main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_group_ad_ad_responsive_display_ad_marketing_imagesTEXTAd group ad ad responsive display ad marketing imagesMarketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15.
ad_group_ad_ad_responsive_display_ad_marketing_images_assetTEXTAd group ad ad responsive display ad marketing images assetThe Asset resource name of this image.
ad_group_ad_ad_responsive_display_ad_price_prefixTEXTAd group ad ad responsive display ad price prefixPrefix before price. For example, 'as low as'.
ad_group_ad_ad_responsive_display_ad_promo_textTEXTAd group ad ad responsive display ad promo textPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
ad_group_ad_ad_responsive_display_ad_square_logo_imagesTEXTAd group ad ad responsive display ad square logo imagesSquare logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with logo_images, the maximum is 5.
ad_group_ad_ad_responsive_display_ad_square_logo_images_assetTEXTAd group ad ad responsive display ad square logo images assetThe Asset resource name of this image.
ad_group_ad_ad_responsive_display_ad_square_marketing_imagesTEXTAd group ad ad responsive display ad square marketing imagesSquare marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15.
ad_group_ad_ad_responsive_display_ad_square_marketing_images_assetTEXTAd group ad ad responsive display ad square marketing images assetThe Asset resource name of this image.
ad_group_ad_ad_responsive_display_ad_youtube_videosTEXTAd group ad ad responsive display ad youtube videosOptional YouTube videos for the ad. A maximum of 5 videos can be specified.
ad_group_ad_ad_responsive_display_ad_youtube_videos_assetTEXTAd group ad ad responsive display ad youtube videos assetThe Asset resource name of this video.
ad_group_ad_ad_responsive_search_ad_descriptionsTEXTAd group ad ad responsive search ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_group_ad_ad_responsive_search_ad_headlinesTEXTAd group ad ad responsive search ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_group_ad_ad_responsive_search_ad_path1TEXTAd group ad ad responsive search ad path1First part of text that can be appended to the URL in the ad.
ad_group_ad_ad_responsive_search_ad_path2TEXTAd group ad ad responsive search ad path2Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
ad_group_ad_ad_shopping_comparison_listing_ad_headlineTEXTAd group ad ad shopping comparison listing ad headlineHeadline of the ad. This field is required. Allowed length is between 25 and 45 characters.
ad_group_ad_ad_shopping_product_adTEXTAd group ad ad shopping product adDetails pertaining to a Shopping product ad.
ad_group_ad_ad_shopping_smart_adTEXTAd group ad ad shopping smart adDetails pertaining to a Smart Shopping ad.
ad_group_ad_ad_smart_campaign_ad_descriptionsTEXTAd group ad ad smart campaign ad descriptionsList of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets.
ad_group_ad_ad_smart_campaign_ad_headlinesTEXTAd group ad ad smart campaign ad headlinesList of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets.
ad_group_ad_ad_strengthTEXTAd group ad ad strengthOverall ad strength for this ad group ad.
ad_group_ad_ad_system_managed_resource_sourceTEXTAd group ad ad system managed resource sourceIf this ad is system managed, then this field will indicate the source. This field is read-only.
ad_group_ad_ad_text_ad_description1TEXTAd group ad ad text ad description1The first line of the ad's description.
ad_group_ad_ad_text_ad_description2TEXTAd group ad ad text ad description2The second line of the ad's description.
ad_group_ad_ad_text_ad_headlineTEXTAd group ad ad text ad headlineThe headline of the ad.
ad_group_ad_ad_tracking_url_templateTEXTAd group ad ad tracking url templateThe URL template for constructing a tracking URL.
ad_group_ad_ad_travel_adTEXTAd group ad ad travel adDetails pertaining to a travel ad.
ad_group_ad_ad_typeTEXTAd group ad ad typeThe type of ad.
ad_group_ad_ad_url_collectionsTEXTAd group ad ad url collectionsAdditional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
ad_group_ad_ad_url_custom_parametersTEXTAd group ad ad url custom parametersThe list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations.
ad_group_ad_ad_video_ad_bumper_action_button_labelTEXTAd group ad ad video ad bumper action button labelLabel on the "Call To Action" button taking the user to the video ad's final URL.
ad_group_ad_ad_video_ad_bumper_action_headlineTEXTAd group ad ad video ad bumper action headlineAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
ad_group_ad_ad_video_ad_bumper_companion_banner_assetTEXTAd group ad ad video ad bumper companion banner assetThe Asset resource name of this image.
ad_group_ad_ad_video_ad_in_feed_description1TEXTAd group ad ad video ad in feed description1First text line for the ad.
ad_group_ad_ad_video_ad_in_feed_description2TEXTAd group ad ad video ad in feed description2Second text line for the ad.
ad_group_ad_ad_video_ad_in_feed_headlineTEXTAd group ad ad video ad in feed headlineThe headline of the ad.
ad_group_ad_ad_video_ad_in_feed_thumbnailTEXTAd group ad ad video ad in feed thumbnailVideo thumbnail image to use.
ad_group_ad_ad_video_ad_in_stream_action_button_labelTEXTAd group ad ad video ad in stream action button labelLabel on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise.
ad_group_ad_ad_video_ad_in_stream_action_headlineTEXTAd group ad ad video ad in stream action headlineAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
ad_group_ad_ad_video_ad_in_stream_companion_banner_assetTEXTAd group ad ad video ad in stream companion banner assetThe Asset resource name of this image.
ad_group_ad_ad_video_ad_non_skippable_action_button_labelTEXTAd group ad ad video ad non skippable action button labelLabel on the "Call To Action" button taking the user to the video ad's final URL.
ad_group_ad_ad_video_ad_non_skippable_action_headlineTEXTAd group ad ad video ad non skippable action headlineAdditional text displayed with the "Call To Action" button to give context and encourage clicking on the button.
ad_group_ad_ad_video_ad_non_skippable_companion_banner_assetTEXTAd group ad ad video ad non skippable companion banner assetThe Asset resource name of this image.
ad_group_ad_ad_video_ad_out_stream_descriptionTEXTAd group ad ad video ad out stream descriptionThe description line.
ad_group_ad_ad_video_ad_out_stream_headlineTEXTAd group ad ad video ad out stream headlineThe headline of the ad.
ad_group_ad_ad_video_ad_video_assetTEXTAd group ad ad video ad video assetThe Asset resource name of this video.
ad_group_ad_ad_video_responsive_ad_breadcrumb1TEXTAd group ad ad video responsive ad breadcrumb1First part of text that appears in the ad with the displayed URL.
ad_group_ad_ad_video_responsive_ad_breadcrumb2TEXTAd group ad ad video responsive ad breadcrumb2Second part of text that appears in the ad with the displayed URL.
ad_group_ad_ad_video_responsive_ad_call_to_actionsTEXTAd group ad ad video responsive ad call to actionsList of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported.
ad_group_ad_ad_video_responsive_ad_companion_bannersTEXTAd group ad ad video responsive ad companion bannersList of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
ad_group_ad_ad_video_responsive_ad_companion_banners_assetTEXTAd group ad ad video responsive ad companion banners assetThe Asset resource name of this image.
ad_group_ad_ad_video_responsive_ad_descriptionsTEXTAd group ad ad video responsive ad descriptionsList of text assets used for the description. Currently, only a single value for the description is supported.
ad_group_ad_ad_video_responsive_ad_headlinesTEXTAd group ad ad video responsive ad headlinesList of text assets used for the short headline. Currently, only a single value for the short headline is supported.
ad_group_ad_ad_video_responsive_ad_long_headlinesTEXTAd group ad ad video responsive ad long headlinesList of text assets used for the long headline. Currently, only a single value for the long headline is supported.
ad_group_ad_ad_video_responsive_ad_videosTEXTAd group ad ad video responsive ad videosList of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported.
ad_group_ad_ad_video_responsive_ad_videos_assetTEXTAd group ad ad video responsive ad videos assetThe Asset resource name of this video.
ad_group_ad_asset_view_ad_group_adTEXTAd group ad asset view ad group adThe ad group ad to which the asset is linked.
ad_group_ad_asset_view_assetTEXTAd group ad asset view assetThe asset which is linked to the ad group ad.
ad_group_ad_asset_view_enabledBOOLEANAd group ad asset view enabledThe status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad.
ad_group_ad_asset_view_field_typeTEXTAd group ad asset view field typeRole that the asset takes in the ad.
ad_group_ad_asset_view_performance_labelTEXTAd group ad asset view performance labelPerformance of an asset linkage.
ad_group_ad_asset_view_pinned_fieldTEXTAd group ad asset view pinned fieldPinned field.
ad_group_ad_asset_view_policy_summaryTEXTAd group ad asset view policy summaryPolicy information for the ad group ad asset.
ad_group_ad_asset_view_resource_nameTEXTAd group ad asset view resource nameThe resource name of the ad group ad asset view. Ad group ad asset view resource names have the form (Before V4): customers/{customer_id}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type} Ad group ad asset view resource names have the form (Beginning from V4): customers/{customer_id}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}
ad_group_ad_asset_view_sourceTEXTAd group ad asset view sourceSource of the ad group ad asset.
ad_group_ad_asset_view_source_assetTEXTAd group ad asset view source assetSource of the ad group ad asset.
ad_group_ad_labelsTEXTAd group ad labelsThe resource names of labels attached to this ad group ad.
ad_group_ad_policy_summary_approval_statusTEXTAd group ad policy summary approval statusThe overall approval status of this ad, calculated based on the status of its individual policy topic entries.
ad_group_ad_policy_summary_policy_topic_entriesTEXTAd group ad policy summary policy topic entriesThe list of policy findings for this ad.
ad_group_ad_policy_summary_review_statusTEXTAd group ad policy summary review statusWhere in the review process this ad is.
ad_group_ad_resource_nameTEXTAd group ad resource nameThe resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
ad_group_ad_statusTEXTAd group ad statusThe status of the ad.
ad_group_audience_setting_use_audience_groupedBOOLEANAd group audience setting use audience groupedIf true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
ad_group_criterion_ad_groupTEXTAd group criterion ad groupThe ad group to which the criterion belongs.
ad_group_criterion_app_payment_model_typeTEXTAd group criterion app payment model typeType of the app payment model.
ad_group_criterion_audience_audienceTEXTAd group criterion audience audienceThe Audience resource name.
ad_group_criterion_combined_audience_combined_audienceTEXTAd group criterion combined audience combined audienceThe CombinedAudience resource name.
ad_group_criterion_cpc_bid_microsNUMERICAd group criterion cpc bid microsThe CPC (cost-per-click) bid.
ad_group_criterion_cpm_bid_microsNUMERICAd group criterion cpm bid microsThe CPM (cost-per-thousand viewable impressions) bid.
ad_group_criterion_cpv_bid_microsNUMERICAd group criterion cpv bid microsThe CPV (cost-per-view) bid.
ad_group_criterion_custom_affinity_custom_affinityTEXTAd group criterion custom affinity custom affinityThe CustomInterest resource name.
ad_group_criterion_custom_audience_custom_audienceTEXTAd group criterion custom audience custom audienceThe CustomAudience resource name.
ad_group_criterion_custom_intent_custom_intentTEXTAd group criterion custom intent custom intentThe CustomInterest resource name.
ad_group_criterion_disapproval_reasonsTEXTAd group criterion disapproval reasonsList of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only.
ad_group_criterion_display_nameTEXTAd group criterion display nameThe display name of the criterion. This field is ignored for mutates.
ad_group_criterion_effective_cpv_bid_microsNUMERICAd group criterion effective cpv bid microsThe effective CPV (cost-per-view) bid.
ad_group_criterion_effective_cpv_bid_sourceTEXTAd group criterion effective cpv bid sourceSource of the effective CPV bid.
ad_group_criterion_effective_percent_cpc_bid_microsNUMERICAd group criterion effective percent cpc bid microsThe effective Percent CPC bid amount.
ad_group_criterion_effective_percent_cpc_bid_sourceTEXTAd group criterion effective percent cpc bid sourceSource of the effective Percent CPC bid.
ad_group_criterion_income_range_typeTEXTAd group criterion income range typeType of the income range.
ad_group_criterion_labelsTEXTAd group criterion labelsThe resource names of labels attached to this ad group criterion.
ad_group_criterion_language_language_constantTEXTAd group criterion language language constantThe language constant resource name.
ad_group_criterion_listing_group_case_value_activity_country_valueCOUNTRYAd group criterion listing group case value activity country valueString value of the activity country. The Geo Target Constant resource name.
ad_group_criterion_listing_group_case_value_activity_id_valueTEXTAd group criterion listing group case value activity id valueString value of the activity ID.
ad_group_criterion_listing_group_case_value_activity_rating_valueNUMERICAd group criterion listing group case value activity rating valueLong value of the activity rating.
ad_group_criterion_listing_group_case_value_hotel_city_city_criterionCITYAd group criterion listing group case value hotel city city criterionThe Geo Target Constant resource name.
ad_group_criterion_listing_group_case_value_hotel_class_valueNUMERICAd group criterion listing group case value hotel class valueLong value of the hotel class.
ad_group_criterion_listing_group_case_value_hotel_country_region_country_region_criterionREGIONAd group criterion listing group case value hotel country region country region criterionThe Geo Target Constant resource name.
ad_group_criterion_listing_group_case_value_hotel_id_valueTEXTAd group criterion listing group case value hotel id valueString value of the hotel ID.
ad_group_criterion_listing_group_case_value_hotel_state_state_criterionTEXTAd group criterion listing group case value hotel state state criterionThe Geo Target Constant resource name.
ad_group_criterion_listing_group_case_value_product_brand_valueTEXTAd group criterion listing group case value product brand valueString value of the product brand.
ad_group_criterion_listing_group_case_value_product_category_category_idNUMERICAd group criterion listing group case value product category category idID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
ad_group_criterion_listing_group_case_value_product_category_levelTEXTAd group criterion listing group case value product category levelLevel of the product category.
ad_group_criterion_listing_group_case_value_product_channel_channelTEXTAd group criterion listing group case value product channel channelValue of the locality.
ad_group_criterion_listing_group_case_value_product_channel_exclusivity_channel_exclusivityTEXTAd group criterion listing group case value product channel exclusivity channel exclusivityValue of the availability.
ad_group_criterion_listing_group_case_value_product_condition_conditionTEXTAd group criterion listing group case value product condition conditionValue of the condition.
ad_group_criterion_listing_group_case_value_product_custom_attribute_indexTEXTAd group criterion listing group case value product custom attribute indexIndicates the index of the custom attribute.
ad_group_criterion_listing_group_case_value_product_custom_attribute_valueTEXTAd group criterion listing group case value product custom attribute valueString value of the product custom attribute.
ad_group_criterion_listing_group_case_value_product_item_id_valueTEXTAd group criterion listing group case value product item id valueValue of the id.
ad_group_criterion_listing_group_case_value_product_type_levelTEXTAd group criterion listing group case value product type levelLevel of the type.
ad_group_criterion_listing_group_case_value_product_type_valueTEXTAd group criterion listing group case value product type valueValue of the type.
ad_group_criterion_listing_group_parent_ad_group_criterionTEXTAd group criterion listing group parent ad group criterionResource name of ad group criterion which is the parent listing group subdivision. Null for the root group.
ad_group_criterion_listing_group_pathTEXTAd group criterion listing group pathThe path of dimensions defining this listing group.
ad_group_criterion_listing_group_typeTEXTAd group criterion listing group typeType of the listing group.
ad_group_criterion_location_geo_target_constantTEXTAd group criterion location geo target constantThe geo target constant resource name.
ad_group_criterion_mobile_app_category_mobile_app_category_constantTEXTAd group criterion mobile app category mobile app category constantThe mobile app category constant resource name.
ad_group_criterion_mobile_application_app_idTEXTAd group criterion mobile application app idA string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations.
ad_group_criterion_mobile_application_nameTEXTAd group criterion mobile application nameName of this mobile application.
ad_group_criterion_parental_status_typeTEXTAd group criterion parental status typeType of the parental status.
ad_group_criterion_percent_cpc_bid_microsNUMERICAd group criterion percent cpc bid microsThe CPC bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].
ad_group_criterion_placement_urlTEXTAd group criterion placement urlURL of the placement. For example, "http://www.domain.com".
ad_group_criterion_resource_nameTEXTAd group criterion resource nameThe resource name of the ad group criterion. Ad group criterion resource names have the form: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
ad_group_criterion_topic_pathTEXTAd group criterion topic pathThe category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category.
ad_group_criterion_typeTEXTAd group criterion typeThe type of the criterion.
ad_group_criterion_user_interest_user_interest_categoryTEXTAd group criterion user interest user interest categoryThe UserInterest resource name.
ad_group_criterion_user_list_user_listTEXTAd group criterion user list user listThe User List resource name.
ad_group_criterion_webpage_conditionsTEXTAd group criterion webpage conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_coverage_percentageNUMERICAd group criterion webpage coverage percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
ad_group_criterion_webpage_criterion_nameTEXTAd group criterion webpage criterion nameThe name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_group_criterion_webpage_sample_sample_urlsTEXTAd group criterion webpage sample sample urlsWebpage sample urls
ad_group_criterion_youtube_channel_channel_idTEXTAd group criterion youtube channel channel idThe YouTube uploader channel id or the channel code of a YouTube channel.
ad_group_criterion_youtube_video_video_idTEXTAd group criterion youtube video video idYouTube video id as it appears on the YouTube watch page.
ad_group_effective_cpc_bid_microsNUMERICAd group effective cpc bid microsValue will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null.
ad_group_excluded_parent_asset_field_typesTEXTAd group excluded parent asset field typesThe asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels.
ad_group_excluded_parent_asset_set_typesTEXTAd group excluded parent asset set typesThe asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. 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 ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported.
ad_group_idTEXTAd group idThe ID of the ad group.
ad_group_labelsTEXTAd group labelsThe resource names of labels attached to this ad group.
ad_group_nameTEXTAd group nameThe name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
ad_group_optimized_targeting_enabledBOOLEANAd group optimized targeting enabledTrue if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.
ad_group_percent_cpc_bid_microsNUMERICAd group percent cpc bid microsThe percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].
ad_group_resource_nameTEXTAd group resource nameThe resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id}
ad_group_statusTEXTAd group statusThe status of the ad group.
ad_group_target_cpa_microsNUMERICAd group target cpa microsThe target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored.
ad_group_target_cpm_microsNUMERICAd group target cpm microsAverage amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
ad_group_target_roasNUMERICAd group target roasThe target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
ad_group_typeTEXTAd group typeThe type of the ad group.
ad_hotel_adTEXTAd hotel adDetails pertaining to a hotel ad.
ad_idTEXTAd idThe ID of the ad.
ad_image_ad_image_asset_assetTEXTAd image ad image asset assetThe Asset resource name of this image.
ad_image_ad_image_urlTEXTAd image ad image urlURL of the full size image.
ad_image_ad_mime_typeTEXTAd image ad mime typeThe mime type of the image.
ad_image_ad_nameTEXTAd image ad nameThe name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty.
ad_image_ad_pixel_heightNUMERICAd image ad pixel heightHeight in pixels of the full size image.
ad_image_ad_pixel_widthNUMERICAd image ad pixel widthWidth in pixels of the full size image.
ad_image_ad_preview_image_urlTEXTAd image ad preview image urlURL of the preview size image.
ad_image_ad_preview_pixel_heightNUMERICAd image ad preview pixel heightHeight in pixels of the preview size image.
ad_image_ad_preview_pixel_widthNUMERICAd image ad preview pixel widthWidth in pixels of the preview size image.
ad_legacy_app_install_adTEXTAd legacy app install adDetails pertaining to a legacy app install ad.
ad_legacy_responsive_display_ad_accent_colorTEXTAd legacy responsive display ad accent colorThe accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_legacy_responsive_display_ad_allow_flexible_colorBOOLEANAd legacy responsive display ad allow flexible colorAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
ad_legacy_responsive_display_ad_business_nameTEXTAd legacy responsive display ad business nameThe business name in the ad.
ad_legacy_responsive_display_ad_call_to_action_textTEXTAd legacy responsive display ad call to action textThe call-to-action text for the ad.
ad_legacy_responsive_display_ad_descriptionTEXTAd legacy responsive display ad descriptionThe description of the ad.
ad_legacy_responsive_display_ad_format_settingTEXTAd legacy responsive display ad format settingSpecifies which format the ad will be served in. Default is ALL_FORMATS.
ad_legacy_responsive_display_ad_logo_imageTEXTAd legacy responsive display ad logo imageThe MediaFile resource name of the logo image used in the ad.
ad_legacy_responsive_display_ad_long_headlineTEXTAd legacy responsive display ad long headlineThe long version of the ad's headline.
ad_legacy_responsive_display_ad_main_colorTEXTAd legacy responsive display ad main colorThe main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_legacy_responsive_display_ad_marketing_imageTEXTAd legacy responsive display ad marketing imageThe MediaFile resource name of the marketing image used in the ad.
ad_legacy_responsive_display_ad_price_prefixTEXTAd legacy responsive display ad price prefixPrefix before price. For example, 'as low as'.
ad_legacy_responsive_display_ad_promo_textTEXTAd legacy responsive display ad promo textPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
ad_legacy_responsive_display_ad_short_headlineTEXTAd legacy responsive display ad short headlineThe short version of the ad's headline.
ad_legacy_responsive_display_ad_square_logo_imageTEXTAd legacy responsive display ad square logo imageThe MediaFile resource name of the square logo image used in the ad.
ad_legacy_responsive_display_ad_square_marketing_imageTEXTAd legacy responsive display ad square marketing imageThe MediaFile resource name of the square marketing image used in the ad.
ad_local_ad_call_to_actionsTEXTAd local ad call to actionsList of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. At least 1 and at most 5 call-to-actions must be specified.
ad_local_ad_descriptionsTEXTAd local ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified.
ad_local_ad_headlinesTEXTAd local ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified.
ad_local_ad_logo_imagesTEXTAd local ad logo imagesList of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified.
ad_local_ad_logo_images_assetTEXTAd local ad logo images assetThe Asset resource name of this image.
ad_local_ad_marketing_imagesTEXTAd local ad marketing imagesList of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified.
ad_local_ad_marketing_images_assetTEXTAd local ad marketing images assetThe Asset resource name of this image.
ad_local_ad_path1TEXTAd local ad path1First part of optional text that can be appended to the URL in the ad.
ad_local_ad_path2TEXTAd local ad path2Second part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
ad_local_ad_videosTEXTAd local ad videosList of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
ad_local_ad_videos_assetTEXTAd local ad videos assetThe Asset resource name of this video.
ad_nameTEXTAd nameThe name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
ad_network_typeTEXTAd network typeAd network type.
ad_network_type1TEXTAd network type1Ad network type.
ad_network_type2TEXTAd network type2Ad network type.
ad_resource_nameTEXTAd resource nameThe resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
ad_responsive_display_ad_accent_colorTEXTAd responsive display ad accent colorThe accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_responsive_display_ad_allow_flexible_colorBOOLEANAd responsive display ad allow flexible colorAdvertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
ad_responsive_display_ad_business_nameTEXTAd responsive display ad business nameThe advertiser/brand name. Maximum display width is 25.
ad_responsive_display_ad_call_to_action_textTEXTAd responsive display ad call to action textThe call-to-action text for the ad. Maximum display width is 30.
ad_responsive_display_ad_control_spec_enable_asset_enhancementsBOOLEANAd responsive display ad control spec enable asset enhancementsWhether the advertiser has opted into the asset enhancements feature.
ad_responsive_display_ad_control_spec_enable_autogen_videoBOOLEANAd responsive display ad control spec enable autogen videoWhether the advertiser has opted into auto-gen video feature.
ad_responsive_display_ad_descriptionsTEXTAd responsive display ad descriptionsDescriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
ad_responsive_display_ad_format_settingTEXTAd responsive display ad format settingSpecifies which format the ad will be served in. Default is ALL_FORMATS.
ad_responsive_display_ad_headlinesTEXTAd responsive display ad headlinesShort format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
ad_responsive_display_ad_logo_imagesTEXTAd responsive display ad logo imagesLogo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5.
ad_responsive_display_ad_logo_images_assetTEXTAd responsive display ad logo images assetThe Asset resource name of this image.
ad_responsive_display_ad_long_headlineTEXTAd responsive display ad long headlineA required long format headline. The maximum length is 90 characters.
ad_responsive_display_ad_main_colorTEXTAd responsive display ad main colorThe main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
ad_responsive_display_ad_marketing_imagesTEXTAd responsive display ad marketing imagesMarketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15.
ad_responsive_display_ad_marketing_images_assetTEXTAd responsive display ad marketing images assetThe Asset resource name of this image.
ad_responsive_display_ad_price_prefixTEXTAd responsive display ad price prefixPrefix before price. For example, 'as low as'.
ad_responsive_display_ad_promo_textTEXTAd responsive display ad promo textPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
ad_responsive_display_ad_square_logo_imagesTEXTAd responsive display ad square logo imagesSquare logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with logo_images, the maximum is 5.
ad_responsive_display_ad_square_logo_images_assetTEXTAd responsive display ad square logo images assetThe Asset resource name of this image.
ad_responsive_display_ad_square_marketing_imagesTEXTAd responsive display ad square marketing imagesSquare marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15.
ad_responsive_display_ad_square_marketing_images_assetTEXTAd responsive display ad square marketing images assetThe Asset resource name of this image.
ad_responsive_display_ad_youtube_videosTEXTAd responsive display ad youtube videosOptional YouTube videos for the ad. A maximum of 5 videos can be specified.
ad_responsive_display_ad_youtube_videos_assetTEXTAd responsive display ad youtube videos assetThe Asset resource name of this video.
ad_responsive_search_ad_descriptionsTEXTAd responsive search ad descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
ad_responsive_search_ad_headlinesTEXTAd responsive search ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
ad_responsive_search_ad_path1TEXTAd responsive search ad path1First part of text that can be appended to the URL in the ad.
ad_responsive_search_ad_path2TEXTAd responsive search ad path2Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
ad_rotation_modeTEXTAd rotation modeThe ad rotation mode of the ad group.
ad_schedule_day_of_weekTEXTAd schedule day of weekDay of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_schedule_end_hourNUMERICAd schedule end hourEnding hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_schedule_end_minuteTEXTAd schedule end minuteMinutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_schedule_start_hourNUMERICAd schedule start hourStarting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_schedule_start_minuteTEXTAd schedule start minuteMinutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
ad_serving_optimization_statusTEXTAd serving optimization statusThe ad serving optimization status of the campaign.
ad_shopping_comparison_listing_ad_headlineTEXTAd shopping comparison listing ad headlineHeadline of the ad. This field is required. Allowed length is between 25 and 45 characters.
ad_shopping_product_adTEXTAd shopping product adDetails pertaining to a Shopping product ad.
ad_shopping_smart_adTEXTAd shopping smart adDetails pertaining to a Smart Shopping ad.
ad_smart_campaign_ad_descriptionsTEXTAd smart campaign ad descriptionsList of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets.
ad_smart_campaign_ad_headlinesTEXTAd smart campaign ad headlinesList of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets.
ad_strengthTEXTAd strengthOverall ad strength for this ad group ad.
ad_system_managed_resource_sourceTEXTAd system managed resource sourceIf this ad is system managed, then this field will indicate the source. This field is read-only.
ad_text_ad_description1TEXTAd text ad description1The first line of the ad's description.
ad_text_ad_description2TEXTAd text ad description2The second line of the ad's description.
ad_text_ad_headlineTEXTAd text ad headlineThe headline of the ad.
ad_tracking_url_templateTEXTAd tracking url templateThe URL template for constructing a tracking URL.
ad_travel_adTEXTAd travel adDetails pertaining to a travel ad.
ad_typeTEXTAd typeThe type of ad.
ad_url_collectionsTEXTAd url collectionsAdditional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
ad_url_custom_parametersTEXTAd url custom parametersThe list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations.
ad_video_ad_bumper_action_button_labelTEXTAd video ad bumper action button labelLabel on the "Call To Action" button taking the user to the video ad's final URL.
ad_video_ad_bumper_action_headlineTEXTAd video ad bumper action headlineAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
ad_video_ad_bumper_companion_banner_assetTEXTAd video ad bumper companion banner assetThe Asset resource name of this image.
ad_video_ad_in_feed_description1TEXTAd video ad in feed description1First text line for the ad.
ad_video_ad_in_feed_description2TEXTAd video ad in feed description2Second text line for the ad.
ad_video_ad_in_feed_headlineTEXTAd video ad in feed headlineThe headline of the ad.
ad_video_ad_in_feed_thumbnailTEXTAd video ad in feed thumbnailVideo thumbnail image to use.
ad_video_ad_in_stream_action_button_labelTEXTAd video ad in stream action button labelLabel on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise.
ad_video_ad_in_stream_action_headlineTEXTAd video ad in stream action headlineAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
ad_video_ad_in_stream_companion_banner_assetTEXTAd video ad in stream companion banner assetThe Asset resource name of this image.
ad_video_ad_non_skippable_action_button_labelTEXTAd video ad non skippable action button labelLabel on the "Call To Action" button taking the user to the video ad's final URL.
ad_video_ad_non_skippable_action_headlineTEXTAd video ad non skippable action headlineAdditional text displayed with the "Call To Action" button to give context and encourage clicking on the button.
ad_video_ad_non_skippable_companion_banner_assetTEXTAd video ad non skippable companion banner assetThe Asset resource name of this image.
ad_video_ad_out_stream_descriptionTEXTAd video ad out stream descriptionThe description line.
ad_video_ad_out_stream_headlineTEXTAd video ad out stream headlineThe headline of the ad.
ad_video_ad_video_assetTEXTAd video ad video assetThe Asset resource name of this video.
ad_video_responsive_ad_breadcrumb1TEXTAd video responsive ad breadcrumb1First part of text that appears in the ad with the displayed URL.
ad_video_responsive_ad_breadcrumb2TEXTAd video responsive ad breadcrumb2Second part of text that appears in the ad with the displayed URL.
ad_video_responsive_ad_call_to_actionsTEXTAd video responsive ad call to actionsList of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported.
ad_video_responsive_ad_companion_bannersTEXTAd video responsive ad companion bannersList of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
ad_video_responsive_ad_companion_banners_assetTEXTAd video responsive ad companion banners assetThe Asset resource name of this image.
ad_video_responsive_ad_descriptionsTEXTAd video responsive ad descriptionsList of text assets used for the description. Currently, only a single value for the description is supported.
ad_video_responsive_ad_headlinesTEXTAd video responsive ad headlinesList of text assets used for the short headline. Currently, only a single value for the short headline is supported.
ad_video_responsive_ad_long_headlinesTEXTAd video responsive ad long headlinesList of text assets used for the long headline. Currently, only a single value for the long headline is supported.
ad_video_responsive_ad_videosTEXTAd video responsive ad videosList of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported.
ad_video_responsive_ad_videos_assetTEXTAd video responsive ad videos assetThe Asset resource name of this video.
adnetwork_conversionsNUMERICAdnetwork conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
adnetwork_revenueNUMERICAdnetwork revenueThe value of all conversions.
advertising_channel_sub_typeTEXTAdvertising channel sub typeOptional 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.
advertising_channel_typeTEXTAdvertising channel typeThe 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.
age_range_typeTEXTAge range typeType of the age range.
age_range_view_resource_nameTEXTAge range view resource nameThe resource name of the age range view. Age range view resource names have the form: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}
aggregator_idNUMERICAggregator idAggregator ID of the product.
aligned_bidding_strategy_idNUMERICAligned bidding strategy idID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy.
aligned_campaign_budget_idNUMERICAligned campaign budget idID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget.
all_conversion_ratePERCENTAll conversion rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
all_conversion_valueNUMERICAll conversion valueThe value of all conversions.
all_conversionsNUMERICAll conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
all_conversions_by_conversion_dateNUMERICAll conversions by conversion dateThe 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.
all_conversions_from_click_to_callNUMERICAll conversions from click to callThe 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.
all_conversions_from_directionsNUMERICAll conversions from directionsThe 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.
all_conversions_from_interactions_rateNUMERICAll conversions from interactions rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
all_conversions_from_interactions_value_per_interactionNUMERICAll conversions from interactions value per interactionThe value of all conversions from interactions divided by the total number of interactions.
all_conversions_from_location_asset_click_to_callNUMERICAll conversions from location asset click to callNumber of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
all_conversions_from_location_asset_directionsNUMERICAll conversions from location asset directionsNumber of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
all_conversions_from_location_asset_menuNUMERICAll conversions from location asset menuNumber of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
all_conversions_from_location_asset_orderNUMERICAll conversions from location asset orderNumber of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
all_conversions_from_location_asset_other_engagementNUMERICAll conversions from location asset other engagementNumber 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.
all_conversions_from_location_asset_store_visitsNUMERICAll conversions from location asset store visitsEstimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location.
all_conversions_from_location_asset_websiteNUMERICAll conversions from location asset websiteNumber of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
all_conversions_from_menuNUMERICAll conversions from menuThe number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
all_conversions_from_orderNUMERICAll conversions from orderThe number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
all_conversions_from_other_engagementNUMERICAll conversions from other engagementThe 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.
all_conversions_from_store_visitNUMERICAll conversions from store visitEstimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
all_conversions_from_store_websiteNUMERICAll conversions from store websiteThe number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
all_conversions_valueNUMERICAll conversions valueThe value of all conversions.
all_conversions_value_by_conversion_dateNUMERICAll conversions value by conversion dateThe 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.
all_conversions_value_per_costNUMERICAll conversions value per costThe value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
all_new_customer_lifetime_valueNUMERICAll new customer lifetime valueAll 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.
amountNUMERICAmountThe amount of the budget for the selected date range, in the local currency for the account.
amount_microsNUMERICAmount microsThe amount of the budget for the selected date range, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
app_campaign_setting_app_idTEXTApp campaign setting app idA string that uniquely identifies a mobile application.
app_campaign_setting_app_storeTEXTApp campaign setting app storeThe application store that distributes this specific app.
app_campaign_setting_bidding_strategy_goal_typeTEXTApp campaign setting bidding strategy goal typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
app_payment_model_typeTEXTApp payment model typeType of the app payment model.
approval_statusTEXTApproval statusApproval status of the criterion.
assetTEXTAsset IDThe asset which is linked to the ad group ad.
asset_automation_settingsTEXTAsset automation settingsContains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior.
asset_book_on_google_assetTEXTAsset book on google assetA book on google asset.
asset_call_asset_ad_schedule_targetsTEXTAsset call asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
asset_call_asset_call_conversion_actionTEXTAsset call asset call conversion actionThe conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
asset_call_asset_call_conversion_reporting_stateTEXTAsset call asset call conversion reporting stateIndicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
asset_call_asset_country_codeTEXTAsset call asset country codeRequired. Two-letter country code of the phone number. Examples: 'US', 'us'.
asset_call_asset_phone_numberTEXTAsset call asset phone numberRequired. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
asset_call_to_action_asset_call_to_actionTEXTAsset call to action asset call to actionCall to action.
asset_callout_asset_ad_schedule_targetsTEXTAsset callout asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
asset_callout_asset_callout_textTEXTAsset callout asset callout textRequired. The callout text. The length of this string should be between 1 and 25, inclusive.
asset_callout_asset_end_dateDATEAsset callout asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
asset_callout_asset_start_dateDATEAsset callout asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
TEXTAsset discovery carousel card asset call to action textCall to action text.
TEXTAsset discovery carousel card asset headlineRequired. Headline of the carousel card.
TEXTAsset discovery carousel card asset marketing image assetAsset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required.
TEXTAsset discovery carousel card asset portrait marketing image assetAsset resource name of the associated 4:5 portrait marketing image.
TEXTAsset discovery carousel card asset square marketing image assetAsset resource name of the associated square marketing image. This and/or a marketing image asset is required.
TEXTAsset dynamic custom asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_custom_asset_contextual_keywordsTEXTAsset dynamic custom asset contextual keywordsContextual keywords, for example, Sedans, 4 door sedans.
asset_dynamic_custom_asset_formatted_priceTEXTAsset dynamic custom asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00.
asset_dynamic_custom_asset_formatted_sale_priceTEXTAsset dynamic custom asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00.
asset_dynamic_custom_asset_idTEXTAsset dynamic custom asset idRequired. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required.
asset_dynamic_custom_asset_id2TEXTAsset dynamic custom asset id2ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique.
asset_dynamic_custom_asset_image_urlTEXTAsset dynamic custom asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic custom asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_custom_asset_ios_app_store_idNUMERICAsset dynamic custom asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_custom_asset_item_addressTEXTAsset dynamic custom asset item addressItem address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
asset_dynamic_custom_asset_item_categoryTEXTAsset dynamic custom asset item categoryItem category, for example, Sedans.
asset_dynamic_custom_asset_item_descriptionTEXTAsset dynamic custom asset item descriptionItem description, for example, Best selling mid-size car.
asset_dynamic_custom_asset_item_subtitleTEXTAsset dynamic custom asset item subtitleItem subtitle, for example, At your Mountain View dealership.
asset_dynamic_custom_asset_item_titleTEXTAsset dynamic custom asset item titleRequired. Item title, for example, Mid-size sedan. Required.
asset_dynamic_custom_asset_priceTEXTAsset dynamic custom asset pricePrice which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD.
asset_dynamic_custom_asset_sale_priceTEXTAsset dynamic custom asset sale priceSale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field.
asset_dynamic_custom_asset_similar_idsTEXTAsset dynamic custom asset similar idsSimilar IDs.
asset_dynamic_education_asset_addressTEXTAsset dynamic education asset addressSchool address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
TEXTAsset dynamic education asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_education_asset_contextual_keywordsTEXTAsset dynamic education asset contextual keywordsContextual keywords, for example, Nursing certification, Health, Mountain View.
asset_dynamic_education_asset_image_urlTEXTAsset dynamic education asset image urlImage url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic education asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_education_asset_ios_app_store_idNUMERICAsset dynamic education asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_education_asset_location_idTEXTAsset dynamic education asset location idLocation ID which can be any sequence of letters and digits and must be unique.
asset_dynamic_education_asset_program_descriptionTEXTAsset dynamic education asset program descriptionProgram description, for example, Nursing Certification.
asset_dynamic_education_asset_program_idTEXTAsset dynamic education asset program idRequired. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_education_asset_program_nameTEXTAsset dynamic education asset program nameRequired. Program name, for example, Nursing. Required.
asset_dynamic_education_asset_school_nameTEXTAsset dynamic education asset school nameSchool name, for example, Mountain View School of Nursing.
asset_dynamic_education_asset_similar_program_idsTEXTAsset dynamic education asset similar program idsSimilar program IDs.
asset_dynamic_education_asset_subjectTEXTAsset dynamic education asset subjectSubject of study, for example, Health.
asset_dynamic_education_asset_thumbnail_image_urlTEXTAsset dynamic education asset thumbnail image urlThumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset.
TEXTAsset dynamic flights asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_flights_asset_custom_mappingTEXTAsset dynamic flights asset custom mappingA custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32".
asset_dynamic_flights_asset_destination_idTEXTAsset dynamic flights asset destination idRequired. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_flights_asset_destination_nameTEXTAsset dynamic flights asset destination nameDestination name, for example, Paris.
asset_dynamic_flights_asset_flight_descriptionTEXTAsset dynamic flights asset flight descriptionRequired. Flight description, for example, Book your ticket. Required.
asset_dynamic_flights_asset_flight_priceTEXTAsset dynamic flights asset flight priceFlight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
asset_dynamic_flights_asset_flight_sale_priceTEXTAsset dynamic flights asset flight sale priceFlight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field.
asset_dynamic_flights_asset_formatted_priceTEXTAsset dynamic flights asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
asset_dynamic_flights_asset_formatted_sale_priceTEXTAsset dynamic flights asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
asset_dynamic_flights_asset_image_urlTEXTAsset dynamic flights asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic flights asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_flights_asset_ios_app_store_idNUMERICAsset dynamic flights asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_flights_asset_origin_idTEXTAsset dynamic flights asset origin idOrigin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
asset_dynamic_flights_asset_origin_nameTEXTAsset dynamic flights asset origin nameOrigin name, for example, London.
asset_dynamic_flights_asset_similar_destination_idsTEXTAsset dynamic flights asset similar destination idsSimilar destination IDs, for example, PAR,LON.
asset_dynamic_hotels_and_rentals_asset_addressTEXTAsset dynamic hotels and rentals asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
TEXTAsset dynamic hotels and rentals asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_hotels_and_rentals_asset_categoryTEXTAsset dynamic hotels and rentals asset categoryCategory, for example, Hotel suite.
asset_dynamic_hotels_and_rentals_asset_contextual_keywordsTEXTAsset dynamic hotels and rentals asset contextual keywordsContextual keywords, for example, Mountain View "Hotels", South Bay hotels.
asset_dynamic_hotels_and_rentals_asset_descriptionTEXTAsset dynamic hotels and rentals asset descriptionDescription, for example, Close to SJC Airport.
asset_dynamic_hotels_and_rentals_asset_destination_nameTEXTAsset dynamic hotels and rentals asset destination nameDestination name, for example, Downtown Mountain View.
asset_dynamic_hotels_and_rentals_asset_formatted_priceTEXTAsset dynamic hotels and rentals asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
asset_dynamic_hotels_and_rentals_asset_formatted_sale_priceTEXTAsset dynamic hotels and rentals asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
asset_dynamic_hotels_and_rentals_asset_image_urlTEXTAsset dynamic hotels and rentals asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic hotels and rentals asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_hotels_and_rentals_asset_ios_app_store_idNUMERICAsset dynamic hotels and rentals asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_hotels_and_rentals_asset_priceTEXTAsset dynamic hotels and rentals asset pricePrice which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
asset_dynamic_hotels_and_rentals_asset_property_idTEXTAsset dynamic hotels and rentals asset property idRequired. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_hotels_and_rentals_asset_property_nameTEXTAsset dynamic hotels and rentals asset property nameRequired. Property name, for example, Mountain View Hotel. Required.
asset_dynamic_hotels_and_rentals_asset_sale_priceTEXTAsset dynamic hotels and rentals asset sale priceISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
asset_dynamic_hotels_and_rentals_asset_similar_property_idsTEXTAsset dynamic hotels and rentals asset similar property idsSimilar property IDs.
asset_dynamic_hotels_and_rentals_asset_star_ratingNUMERICAsset dynamic hotels and rentals asset star ratingStar rating. Must be a number between 1 to 5, inclusive.
asset_dynamic_jobs_asset_addressTEXTAsset dynamic jobs asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
TEXTAsset dynamic jobs asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_jobs_asset_contextual_keywordsTEXTAsset dynamic jobs asset contextual keywordsContextual keywords, for example, Software engineering job.
asset_dynamic_jobs_asset_descriptionTEXTAsset dynamic jobs asset descriptionDescription, for example, Apply your technical skills.
asset_dynamic_jobs_asset_image_urlTEXTAsset dynamic jobs asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic jobs asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_jobs_asset_ios_app_store_idNUMERICAsset dynamic jobs asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_jobs_asset_job_categoryTEXTAsset dynamic jobs asset job categoryJob category, for example, Technical.
asset_dynamic_jobs_asset_job_idTEXTAsset dynamic jobs asset job idRequired. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_jobs_asset_job_subtitleTEXTAsset dynamic jobs asset job subtitleJob subtitle, for example, Level II.
asset_dynamic_jobs_asset_job_titleTEXTAsset dynamic jobs asset job titleRequired. Job title, for example, Software engineer. Required.
asset_dynamic_jobs_asset_location_idTEXTAsset dynamic jobs asset location idLocation ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique.
asset_dynamic_jobs_asset_salaryTEXTAsset dynamic jobs asset salarySalary, for example, $100,000.
asset_dynamic_jobs_asset_similar_job_idsTEXTAsset dynamic jobs asset similar job idsSimilar job IDs, for example, 1275.
asset_dynamic_local_asset_addressTEXTAsset dynamic local asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
TEXTAsset dynamic local asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_local_asset_categoryTEXTAsset dynamic local asset categoryCategory, for example, Food.
asset_dynamic_local_asset_contextual_keywordsTEXTAsset dynamic local asset contextual keywordsContextual keywords, for example, Save groceries coupons.
asset_dynamic_local_asset_deal_idTEXTAsset dynamic local asset deal idRequired. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_local_asset_deal_nameTEXTAsset dynamic local asset deal nameRequired. Deal name, for example, 50% off at Mountain View Grocers. Required.
asset_dynamic_local_asset_descriptionTEXTAsset dynamic local asset descriptionDescription, for example, Save on your weekly bill.
asset_dynamic_local_asset_formatted_priceTEXTAsset dynamic local asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
asset_dynamic_local_asset_formatted_sale_priceTEXTAsset dynamic local asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
asset_dynamic_local_asset_image_urlTEXTAsset dynamic local asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic local asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_local_asset_ios_app_store_idNUMERICAsset dynamic local asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_local_asset_priceTEXTAsset dynamic local asset pricePrice which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
asset_dynamic_local_asset_sale_priceTEXTAsset dynamic local asset sale priceSale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
asset_dynamic_local_asset_similar_deal_idsTEXTAsset dynamic local asset similar deal idsSimilar deal IDs, for example, 1275.
asset_dynamic_local_asset_subtitleTEXTAsset dynamic local asset subtitleSubtitle, for example, Groceries.
asset_dynamic_real_estate_asset_addressTEXTAsset dynamic real estate asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
TEXTAsset dynamic real estate asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_real_estate_asset_city_nameCITYAsset dynamic real estate asset city nameCity name, for example, Mountain View, California.
asset_dynamic_real_estate_asset_contextual_keywordsTEXTAsset dynamic real estate asset contextual keywordsContextual keywords, for example, For sale; Houses for sale.
asset_dynamic_real_estate_asset_descriptionTEXTAsset dynamic real estate asset descriptionDescription, for example, 3 beds, 2 baths, 1568 sq. ft.
asset_dynamic_real_estate_asset_formatted_priceTEXTAsset dynamic real estate asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00.
asset_dynamic_real_estate_asset_image_urlTEXTAsset dynamic real estate asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic real estate asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_real_estate_asset_ios_app_store_idNUMERICAsset dynamic real estate asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_real_estate_asset_listing_idTEXTAsset dynamic real estate asset listing idRequired. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_real_estate_asset_listing_nameTEXTAsset dynamic real estate asset listing nameRequired. Listing name, for example, Boulevard Bungalow. Required.
asset_dynamic_real_estate_asset_listing_typeTEXTAsset dynamic real estate asset listing typeListing type, for example, For sale.
asset_dynamic_real_estate_asset_priceTEXTAsset dynamic real estate asset pricePrice which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD.
asset_dynamic_real_estate_asset_property_typeTEXTAsset dynamic real estate asset property typeProperty type, for example, House.
asset_dynamic_real_estate_asset_similar_listing_idsTEXTAsset dynamic real estate asset similar listing idsSimilar listing IDs.
TEXTAsset dynamic travel asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
asset_dynamic_travel_asset_categoryTEXTAsset dynamic travel asset categoryCategory, for example, Express.
asset_dynamic_travel_asset_contextual_keywordsTEXTAsset dynamic travel asset contextual keywordsContextual keywords, for example, Paris trains.
asset_dynamic_travel_asset_destination_addressTEXTAsset dynamic travel asset destination addressDestination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
asset_dynamic_travel_asset_destination_idTEXTAsset dynamic travel asset destination idRequired. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
asset_dynamic_travel_asset_destination_nameTEXTAsset dynamic travel asset destination nameDestination name, for example, Paris.
asset_dynamic_travel_asset_formatted_priceTEXTAsset dynamic travel asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
asset_dynamic_travel_asset_formatted_sale_priceTEXTAsset dynamic travel asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
asset_dynamic_travel_asset_image_urlTEXTAsset dynamic travel asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTAsset dynamic travel asset ios app linkiOS deep link, for example, exampleApp://content/page.
asset_dynamic_travel_asset_ios_app_store_idNUMERICAsset dynamic travel asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
asset_dynamic_travel_asset_origin_idTEXTAsset dynamic travel asset origin idOrigin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
asset_dynamic_travel_asset_origin_nameTEXTAsset dynamic travel asset origin nameOrigin name, for example, London.
asset_dynamic_travel_asset_priceTEXTAsset dynamic travel asset pricePrice which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
asset_dynamic_travel_asset_sale_priceTEXTAsset dynamic travel asset sale priceSale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
asset_dynamic_travel_asset_similar_destination_idsTEXTAsset dynamic travel asset similar destination idsSimilar destination IDs, for example, NYC.
asset_dynamic_travel_asset_titleTEXTAsset dynamic travel asset titleRequired. Title, for example, Book your train ticket. Required.
asset_field_type_policy_summariesTEXTAsset field type policy summariesPolicy information for the asset for each FieldType.
asset_final_mobile_urlsTEXTAsset final mobile urlsA list of possible final mobile URLs after all cross domain redirects.
asset_final_url_suffixTEXTAsset final url suffixURL template for appending params to landing page URLs served with parallel tracking.
asset_final_urlsTEXTAsset final urlsA list of possible final URLs after all cross domain redirects.
asset_groupTEXTAsset groupThe asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared.
asset_group_ad_strengthTEXTAsset group ad strengthOverall ad strength of this asset group.
asset_group_campaignTEXTAsset group campaignThe campaign with which this asset group is associated. The asset which is linked to the asset group.
asset_group_final_mobile_urlsTEXTAsset group final mobile urlsA list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
asset_group_final_urlsTEXTAsset group final urlsA list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
asset_group_idTEXTAsset group idThe ID of the asset group.
asset_group_nameTEXTAsset group nameRequired. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign.
asset_group_path1TEXTAsset group path1First part of text that may appear appended to the url displayed in the ad.
asset_group_path2TEXTAsset group path2Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
asset_group_primary_statusTEXTAsset group primary statusThe primary status of the asset group. Provides insights into why an asset group is not serving or not serving optimally.
asset_group_primary_status_reasonsTEXTAsset group primary status reasonsProvides reasons into why an asset group is not serving or not serving optimally. It will be empty when the asset group is serving without issues.
asset_group_resource_nameTEXTAsset group resource nameThe resource name of the asset group. Asset group resource names have the form: customers/{customer_id}/assetGroups/{asset_group_id}
asset_group_statusTEXTAsset group statusThe status of the asset group.
asset_hotel_callout_asset_language_codeTEXTAsset hotel callout asset language codeRequired. The language of the hotel callout. Represented as BCP 47 language tag.
asset_hotel_callout_asset_textTEXTAsset hotel callout asset textRequired. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive.
asset_hotel_property_asset_hotel_addressTEXTAsset hotel property asset hotel addressAddress of the hotel. Read-only.
asset_hotel_property_asset_hotel_nameTEXTAsset hotel property asset hotel nameName of the hotel. Read-only.
asset_hotel_property_asset_place_idTEXTAsset hotel property asset place idPlace IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more.
asset_idTEXTAsset idThe ID of the asset.
asset_image_asset_file_sizeNUMERICAsset image asset file sizeFile size of the image asset in bytes.
asset_image_asset_full_size_height_pixelsNUMERICAsset image asset full size height pixelsHeight of the image.
asset_image_asset_full_size_urlIMAGE_URLAsset image asset full size urlA URL that returns the image with this height and width.
asset_image_asset_full_size_width_pixelsNUMERICAsset image asset full size width pixelsWidth of the image.
asset_image_asset_mime_typeTEXTAsset image asset mime typeMIME type of the image asset.
asset_interaction_target_assetTEXTAsset interaction target assetThe asset resource name.
asset_interaction_target_interaction_on_this_assetBOOLEANAsset interaction target interaction on this assetOnly used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.
asset_lead_form_asset_background_image_assetTEXTAsset lead form asset background image assetAsset resource name of the background image. The image dimensions must be exactly 1200x628.
asset_lead_form_asset_business_nameTEXTAsset lead form asset business nameRequired. The name of the business being advertised.
asset_lead_form_asset_call_to_action_descriptionTEXTAsset lead form asset call to action descriptionRequired. Text giving a clear value proposition of what users expect once they expand the form.
asset_lead_form_asset_call_to_action_typeTEXTAsset lead form asset call to action typeRequired. Pre-defined display text that encourages user to expand the form.
asset_lead_form_asset_custom_disclosureTEXTAsset lead form asset custom disclosureCustom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
asset_lead_form_asset_custom_question_fieldsTEXTAsset lead form asset custom question fieldsOrdered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form.
asset_lead_form_asset_delivery_methodsTEXTAsset lead form asset delivery methodsConfigured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
asset_lead_form_asset_descriptionTEXTAsset lead form asset descriptionRequired. Detailed description of the expanded form to describe what the form is asking for or facilitating.
asset_lead_form_asset_desired_intentTEXTAsset lead form asset desired intentChosen intent for the lead form, for example, more volume or more qualified.
asset_lead_form_asset_fieldsTEXTAsset lead form asset fieldsOrdered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions.
asset_lead_form_asset_headlineTEXTAsset lead form asset headlineRequired. Headline of the expanded form to describe what the form is asking for or facilitating.
asset_lead_form_asset_post_submit_call_to_action_typeTEXTAsset lead form asset post submit call to action typePre-defined display text that encourages user action after the form is submitted.
asset_lead_form_asset_post_submit_descriptionTEXTAsset lead form asset post submit descriptionDetailed description shown after form submission that describes how the advertiser will follow up with the user.
asset_lead_form_asset_post_submit_headlineTEXTAsset lead form asset post submit headlineHeadline of text shown after form submission that describes how the advertiser will follow up with the user.
asset_lead_form_asset_privacy_policy_urlTEXTAsset lead form asset privacy policy urlRequired. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
asset_location_asset_business_profile_locationsTEXTAsset location asset business profile locationsThe list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
asset_location_asset_location_ownership_typeTEXTAsset location asset location ownership typeThe type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
asset_location_asset_place_idTEXTAsset location asset place idPlace IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
asset_mobile_app_asset_app_idTEXTAsset mobile app asset app idRequired. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
asset_mobile_app_asset_app_storeTEXTAsset mobile app asset app storeRequired. The application store that distributes this specific app.
asset_mobile_app_asset_end_dateDATEAsset mobile app asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
TEXTAsset mobile app asset link textRequired. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive.
asset_mobile_app_asset_start_dateDATEAsset mobile app asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
asset_nameTEXTAsset nameOptional name of the asset.
asset_page_feed_asset_labelsTEXTAsset page feed asset labelsLabels used to group the page urls.
asset_page_feed_asset_page_urlTEXTAsset page feed asset page urlRequired. The webpage that advertisers want to target.
asset_policy_summary_approval_statusTEXTAsset policy summary approval statusThe overall approval status of this asset, calculated based on the status of its individual policy topic entries.
asset_policy_summary_policy_topic_entriesTEXTAsset policy summary policy topic entriesThe list of policy findings for this asset.
asset_policy_summary_review_statusTEXTAsset policy summary review statusWhere in the review process this asset is.
asset_price_asset_language_codeTEXTAsset price asset language codeRequired. The language of the price asset. Represented as BCP 47 language tag.
asset_price_asset_price_offeringsTEXTAsset price asset price offeringsThe price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive.
asset_price_asset_price_qualifierTEXTAsset price asset price qualifierThe price qualifier of the price asset.
asset_price_asset_typeTEXTAsset price asset typeRequired. The type of the price asset.
asset_promotion_asset_ad_schedule_targetsTEXTAsset promotion asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
asset_promotion_asset_discount_modifierTEXTAsset promotion asset discount modifierA modifier for qualification of the discount.
asset_promotion_asset_end_dateDATEAsset promotion asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
asset_promotion_asset_language_codeTEXTAsset promotion asset language codeThe language of the promotion. Represented as BCP 47 language tag.
asset_promotion_asset_money_amount_off_amount_microsNUMERICAsset promotion asset money amount off amount microsAmount in micros. One million is equivalent to one unit.
asset_promotion_asset_money_amount_off_currency_codeTEXTAsset promotion asset money amount off currency codeThree-character ISO 4217 currency code.
asset_promotion_asset_occasionTEXTAsset promotion asset occasionThe occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.
asset_promotion_asset_orders_over_amount_amount_microsNUMERICAsset promotion asset orders over amount amount microsAmount in micros. One million is equivalent to one unit.
asset_promotion_asset_orders_over_amount_currency_codeTEXTAsset promotion asset orders over amount currency codeThree-character ISO 4217 currency code.
asset_promotion_asset_percent_offNUMERICAsset promotion asset percent offPercentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
asset_promotion_asset_promotion_codeTEXTAsset promotion asset promotion codeA code the user should use in order to be eligible for the promotion.
asset_promotion_asset_promotion_targetTEXTAsset promotion asset promotion targetRequired. A freeform description of what the promotion is targeting.
asset_promotion_asset_redemption_end_dateDATEAsset promotion asset redemption end dateLast date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
asset_promotion_asset_redemption_start_dateDATEAsset promotion asset redemption start dateStart date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
asset_promotion_asset_start_dateDATEAsset promotion asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
asset_resource_nameTEXTAsset resource nameThe resource name of the asset. Asset resource names have the form: customers/{customer_id}/assets/{asset_id}
TEXTAsset sitelink asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
TEXTAsset sitelink asset description1First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
TEXTAsset sitelink asset description2Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
DATEAsset sitelink asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
TEXTAsset sitelink asset link textRequired. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
DATEAsset sitelink asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
asset_sourceTEXTAsset sourceSource of the asset.
asset_structured_snippet_asset_headerTEXTAsset structured snippet asset headerRequired. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
asset_structured_snippet_asset_valuesTEXTAsset structured snippet asset valuesRequired. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
asset_text_asset_textTEXTAsset text asset textText content of the text asset.
asset_tracking_url_templateTEXTAsset tracking url templateURL template for constructing a tracking URL.
asset_typeTEXTAsset typeType of the asset.
asset_url_custom_parametersTEXTAsset url custom parametersA list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls.
asset_youtube_video_asset_youtube_video_idTEXTAsset youtube video asset youtube video idYouTube video id. This is the 11 character string value used in the YouTube video URL.
asset_youtube_video_asset_youtube_video_titleTEXTAsset youtube video asset youtube video titleYouTube video title.
auction_insight_domainTEXTAuction insight domainDomain (visible URL) of a participant in the Auction Insights report.
auction_insight_search_absolute_top_impression_percentageNUMERICAuction insight search absolute top impression percentageThis 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.
auction_insight_search_impression_shareNUMERICAuction insight search impression shareThis 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.
auction_insight_search_outranking_shareNUMERICAuction insight search outranking shareThis 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.
auction_insight_search_overlap_rateNUMERICAuction insight search overlap rateThis 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.
auction_insight_search_position_above_rateNUMERICAuction insight search position above rateThis 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.
auction_insight_search_top_impression_percentageNUMERICAuction insight search top impression percentageThis 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.
audience_asset_groupTEXTAudience asset groupThe asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared.
audience_audienceTEXTAudience audienceThe Audience resource name.
audience_descriptionTEXTAudience descriptionDescription of this audience.
audience_dimensionsTEXTAudience dimensionsPositive dimensions specifying the audience composition.
audience_dimensions_audience_segments_segments_custom_audience_custom_audienceTEXTAudience dimensions audience segments segments custom audience custom audienceThe custom audience resource.
audience_dimensions_audience_segments_segments_detailed_demographic_detailed_demographicTEXTAudience dimensions audience segments segments detailed demographic detailed demographicThe detailed demographic resource.
audience_dimensions_audience_segments_segments_life_event_life_eventTEXTAudience dimensions audience segments segments life event life eventThe life event resource.
audience_dimensions_audience_segments_segments_user_interest_user_interest_categoryTEXTAudience dimensions audience segments segments user interest user interest categoryThe user interest resource.
audience_dimensions_audience_segments_segments_user_list_user_listTEXTAudience dimensions audience segments segments user list user listThe user list resource.
audience_exclusion_dimensionTEXTAudience exclusion dimensionNegative dimension specifying the audience composition.
audience_exclusion_dimension_exclusions_user_list_user_listTEXTAudience exclusion dimension exclusions user list user listThe user list resource.
audience_idTEXTAudience idID of the audience.
audience_nameTEXTAudience nameName of the audience. It should be unique across all audiences within the account. It must have a minimum length of 1 and maximum length of 255. Required when scope is not set or is set to CUSTOMER. Cannot be set or updated when scope is ASSET_GROUP.
audience_resource_nameTEXTAudience resource nameThe resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id}
audience_scopeTEXTAudience scopeDefines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP.
audience_setting_use_audience_groupedBOOLEANAudience setting use audience groupedIf true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
audience_statusTEXTAudience statusStatus of this audience. Indicates whether the audience is enabled or removed.
auto_tagging_enabledBOOLEANAuto tagging enabledWhether auto-tagging is enabled for the customer.
availabilitiesTEXTAvailabilitiesAvailability information of the user interest.
average_cart_sizeNUMERICAverage cart sizeAverage 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.
average_costNUMERICAverage costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
average_cpcNUMERICAverage cpcThe total cost of all clicks divided by the total number of clicks received.
average_cpeNUMERICAverage cpeThe 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.
average_cpmNUMERICAverage cpmAverage cost-per-thousand impressions (CPM).
average_cpvNUMERICAverage cpvThe 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.
average_impression_frequency_per_userNUMERICAverage impression frequency per userThe 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.
average_order_value_microsNUMERICAverage order value microsAverage 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.
average_page_viewsNUMERICAverage page viewsAverage number of pages viewed per session.
average_pageviewsNUMERICAverage pageviewsAverage number of pages viewed per session.
average_target_cpa_microsNUMERICAverage target cpa microsThe average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA).
average_target_roasNUMERICAverage target roasThe average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS).
average_time_on_siteNUMERICAverage time on siteTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
base_ad_groupTEXTBase ad groupFor draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only.
base_ad_group_idTEXTBase ad group idFor draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only.
base_campaignTEXTBase campaignThe 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.
base_campaign_idTEXTBase campaign idThe 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.
basic_user_list_actionsTEXTBasic user list actionsActions associated with this user list.
benchmark_average_max_cpcNUMERICBenchmark average max cpcAn indication of how other advertisers are bidding on similar products.
bid_modifierNUMERICBid modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
biddable_app_install_conversionsNUMERICBiddable app install conversionsNumber of app installs.
biddable_app_post_install_conversionsNUMERICBiddable app post install conversionsNumber of in-app actions.
bidding_strategyTEXTBidding strategyPortfolio bidding strategy used by campaign.
bidding_strategy_aligned_campaign_budget_idNUMERICBidding strategy aligned campaign budget idID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget.
bidding_strategy_campaign_countNUMERICBidding strategy campaign countThe number of campaigns attached to this bidding strategy. This field is read-only.
bidding_strategy_currency_codeTEXTBidding strategy currency codeThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
bidding_strategy_effective_currency_codeTEXTBidding strategy effective currency codeThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
bidding_strategy_enhanced_cpcTEXTBidding strategy enhanced cpcA bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
bidding_strategy_idTEXTBidding strategy idPortfolio bidding strategy used by campaign.
bidding_strategy_maximize_conversion_value_cpc_bid_ceiling_microsNUMERICBidding strategy maximize conversion value cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
bidding_strategy_maximize_conversion_value_cpc_bid_floor_microsNUMERICBidding strategy maximize conversion value cpc bid floor microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
bidding_strategy_maximize_conversion_value_target_roasNUMERICBidding strategy maximize conversion value target roasThe 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.
bidding_strategy_maximize_conversions_cpc_bid_ceiling_microsNUMERICBidding strategy maximize conversions cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
bidding_strategy_maximize_conversions_cpc_bid_floor_microsNUMERICBidding strategy maximize conversions cpc bid floor microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
bidding_strategy_maximize_conversions_target_cpa_microsNUMERICBidding strategy maximize conversions target cpa microsThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
bidding_strategy_nameTEXTBidding strategy nameThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
bidding_strategy_non_removed_campaign_countNUMERICBidding strategy non removed campaign countThe number of non-removed campaigns attached to this bidding strategy. This field is read-only.
bidding_strategy_resource_nameTEXTBidding strategy resource nameThe resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
bidding_strategy_sourceTEXTBidding strategy sourceThe 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.
bidding_strategy_statusTEXTBidding strategy statusThe status of the bidding strategy. This field is read-only.
bidding_strategy_system_statusTEXTBidding strategy system statusThe system status of the campaign's bidding strategy.
bidding_strategy_target_cpa_cpc_bid_ceiling_microsNUMERICBidding strategy target cpa cpc bid ceiling microsMaximum 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.
bidding_strategy_target_cpa_cpc_bid_floor_microsNUMERICBidding strategy target cpa cpc bid floor microsMinimum 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.
bidding_strategy_target_cpa_target_cpa_microsNUMERICBidding strategy target cpa target cpa microsAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
bidding_strategy_target_impression_share_cpc_bid_ceiling_microsNUMERICBidding strategy target impression share cpc bid ceiling microsThe 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.
bidding_strategy_target_impression_share_locationTEXTBidding strategy target impression share locationThe targeted location on the search results page.
bidding_strategy_target_impression_share_location_fraction_microsNUMERICBidding strategy target impression share location fraction microsThe chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
bidding_strategy_target_roas_cpc_bid_ceiling_microsNUMERICBidding strategy target roas cpc bid ceiling microsMaximum 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.
bidding_strategy_target_roas_cpc_bid_floor_microsNUMERICBidding strategy target roas cpc bid floor microsMinimum 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.
bidding_strategy_target_roas_target_roasNUMERICBidding strategy target roas target roasThe chosen revenue (based on conversion data) per unit of spend.
bidding_strategy_target_spend_cpc_bid_ceiling_microsNUMERICBidding strategy target spend cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
bidding_strategy_target_spend_target_spend_microsNUMERICBidding strategy target spend target spend microsThe 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.
bidding_strategy_typeTEXTBidding strategy typeThe 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.
book_on_google_assetTEXTBook on google assetA book on google asset.
bounce_rateNUMERICBounce ratePercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
brandTEXTBrandBrand of the product.
brand_list_shared_setTEXTBrand list shared setShared set resource name of the brand list.
budget_amountNUMERICBudget amountThe amount of the budget for the selected date range, in the local currency for the account.
budget_campaign_association_status_campaignTEXTBudget campaign association status campaignThe campaign resource name.
budget_campaign_association_status_statusTEXTBudget campaign association status statusBudget campaign association status.
budget_idTEXTBudget idThe budget of the campaign.
call_asset_ad_schedule_targetsTEXTCall asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
call_asset_call_conversion_actionTEXTCall asset call conversion actionThe conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
call_asset_call_conversion_reporting_stateTEXTCall asset call conversion reporting stateIndicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
call_asset_country_codeTEXTCall asset country codeRequired. Two-letter country code of the phone number. Examples: 'US', 'us'.
call_asset_phone_numberTEXTCall asset phone numberRequired. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
call_reporting_setting_call_conversion_actionTEXTCall reporting setting call conversion actionCustomer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
call_reporting_setting_call_conversion_reporting_enabledBOOLEANCall reporting setting call conversion reporting enabledWhether to enable call conversion reporting.
call_reporting_setting_call_reporting_enabledBOOLEANCall reporting setting call reporting enabledEnable reporting of phone call events by redirecting them through Google System.
call_to_action_asset_call_to_actionTEXTCall to action asset call to actionCall to action.
callout_asset_ad_schedule_targetsTEXTCallout asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
callout_asset_callout_textTEXTCallout asset callout textRequired. The callout text. The length of this string should be between 1 and 25, inclusive.
callout_asset_end_dateDATECallout asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
callout_asset_start_dateDATECallout asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
campaignTEXTCampaignThe 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.
campaign_accessible_bidding_strategyTEXTCampaign accessible bidding strategyResource 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.
campaign_ad_serving_optimization_statusTEXTCampaign ad serving optimization statusThe ad serving optimization status of the campaign.
campaign_app_campaign_setting_app_idTEXTCampaign app campaign setting app idA string that uniquely identifies a mobile application.
campaign_app_campaign_setting_app_storeTEXTCampaign app campaign setting app storeThe application store that distributes this specific app.
campaign_app_campaign_setting_bidding_strategy_goal_typeTEXTCampaign app campaign setting bidding strategy goal typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
campaign_asset_automation_settingsTEXTCampaign asset automation settingsContains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior.
campaign_audience_setting_use_audience_groupedBOOLEANCampaign audience setting use audience groupedIf true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
campaign_audience_view_resource_nameTEXTCampaign audience view resource nameThe resource name of the campaign audience view. Campaign audience view resource names have the form: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}
campaign_bidding_strategy_system_statusTEXTCampaign bidding strategy system statusThe system status of the campaign's bidding strategy.
campaign_budgetNUMERICCampaign budgetThe budget of the campaign.
campaign_budget_aligned_bidding_strategy_idNUMERICCampaign budget aligned bidding strategy idID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy.
campaign_budget_delivery_methodTEXTCampaign budget delivery methodThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
campaign_budget_idTEXTCampaign budget idThe ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
campaign_budget_nameTEXTCampaign budget nameThe name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
NUMERICCampaign budget recommended budget estimated change weekly clicksThe estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
NUMERICCampaign budget recommended budget estimated change weekly cost microsThe estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
NUMERICCampaign budget recommended budget estimated change weekly interactionsThe estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
NUMERICCampaign budget recommended budget estimated change weekly viewsThe estimated change in weekly views if the recommended budget is applied. This field is read-only.
campaign_budget_reference_countNUMERICCampaign budget reference countThe number of campaigns actively using the budget. This field is read-only.
campaign_budget_resource_nameTEXTCampaign budget resource nameThe resource name of the campaign budget. Campaign budget resource names have the form: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
campaign_budget_statusTEXTCampaign budget statusThe status of this campaign budget. This field is read-only.
campaign_budget_typeTEXTCampaign budget typeThe type of the campaign budget.
campaign_campaign_groupTEXTCampaign campaign groupThe campaign group this campaign belongs to.
campaign_commission_commission_rate_microsNUMERICCampaign commission commission rate microsCommission 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%).
campaign_countNUMERICCampaign countThe number of campaigns attached to this bidding strategy. This field is read-only.
campaign_criterion_ad_schedule_day_of_weekTEXTCampaign criterion ad schedule day of weekDay of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_ad_schedule_end_hourNUMERICCampaign criterion ad schedule end hourEnding hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_ad_schedule_end_minuteTEXTCampaign criterion ad schedule end minuteMinutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_ad_schedule_start_hourNUMERICCampaign criterion ad schedule start hourStarting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_ad_schedule_start_minuteTEXTCampaign criterion ad schedule start minuteMinutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_age_range_typeTEXTCampaign criterion age range typeType of the age range.
campaign_criterion_bid_modifierNUMERICCampaign criterion bid modifierThe modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
campaign_criterion_brand_list_shared_setTEXTCampaign criterion brand list shared setShared set resource name of the brand list.
campaign_criterion_campaignTEXTCampaign criterion campaignThe campaign to which the criterion belongs.
campaign_criterion_carrier_carrier_constantTEXTCampaign criterion carrier carrier constantThe Carrier constant resource name.
campaign_criterion_combined_audience_combined_audienceTEXTCampaign criterion combined audience combined audienceThe CombinedAudience resource name.
campaign_criterion_content_label_typeTEXTCampaign criterion content label typeContent label type, required for CREATE operations.
campaign_criterion_custom_affinity_custom_affinityTEXTCampaign criterion custom affinity custom affinityThe CustomInterest resource name.
campaign_criterion_custom_audience_custom_audienceTEXTCampaign criterion custom audience custom audienceThe CustomAudience resource name.
campaign_criterion_device_typeTEXTCampaign criterion device typeType of the device.
campaign_criterion_display_nameTEXTCampaign criterion display nameThe display name of the criterion. This field is ignored for mutates.
campaign_criterion_gender_typeTEXTCampaign criterion gender typeType of the gender.
campaign_criterion_income_range_typeTEXTCampaign criterion income range typeType of the income range.
campaign_criterion_ip_block_ip_addressTEXTCampaign criterion ip block ip addressThe IP address of this IP block.
campaign_criterion_keyword_match_typeTEXTCampaign criterion keyword match typeThe match type of the keyword.
campaign_criterion_keyword_theme_free_form_keyword_themeTEXTCampaign criterion keyword theme free form keyword themeFree-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
campaign_criterion_keyword_theme_keyword_theme_constantTEXTCampaign criterion keyword theme keyword theme constantThe resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
campaign_criterion_language_language_constantTEXTCampaign criterion language language constantThe language constant resource name.
campaign_criterion_listing_scope_dimensionsTEXTCampaign criterion listing scope dimensionsScope of the campaign criterion.
campaign_criterion_listing_scope_dimensions_activity_country_valueCOUNTRYCampaign criterion listing scope dimensions activity country valueString value of the activity country. The Geo Target Constant resource name.
campaign_criterion_listing_scope_dimensions_hotel_city_city_criterionCITYCampaign criterion listing scope dimensions hotel city city criterionThe Geo Target Constant resource name.
campaign_criterion_listing_scope_dimensions_hotel_country_region_country_region_criterionREGIONCampaign criterion listing scope dimensions hotel country region country region criterionThe Geo Target Constant resource name.
campaign_criterion_listing_scope_dimensions_hotel_state_state_criterionTEXTCampaign criterion listing scope dimensions hotel state state criterionThe Geo Target Constant resource name.
campaign_criterion_local_service_id_service_idTEXTCampaign criterion local service id service idThe criterion resource name.
campaign_criterion_location_geo_target_constantTEXTCampaign criterion location geo target constantThe geo target constant resource name.
campaign_criterion_location_groupTEXTCampaign criterion location groupLocation Group
campaign_criterion_location_group_enable_customer_level_location_asset_setBOOLEANCampaign criterion location group enable customer level location asset setDenotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
campaign_criterion_location_group_feedTEXTCampaign criterion location group feedFeed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations.
campaign_criterion_location_group_geo_target_constantsTEXTCampaign criterion location group geo target constantsGeo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. Cannot be set with AssetSet fields.
campaign_criterion_mobile_app_category_mobile_app_category_constantTEXTCampaign criterion mobile app category mobile app category constantThe mobile app category constant resource name.
campaign_criterion_mobile_application_app_idTEXTCampaign criterion mobile application app idA string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations.
campaign_criterion_mobile_application_nameTEXTCampaign criterion mobile application nameName of this mobile application.
campaign_criterion_mobile_device_mobile_device_constantTEXTCampaign criterion mobile device mobile device constantThe mobile device constant resource name.
campaign_criterion_operating_system_version_operating_system_version_constantTEXTCampaign criterion operating system version operating system version constantThe operating system version constant resource name.
campaign_criterion_parental_status_typeTEXTCampaign criterion parental status typeType of the parental status.
campaign_criterion_placement_urlTEXTCampaign criterion placement urlURL of the placement. For example, "http://www.domain.com".
campaign_criterion_proximity_address_city_nameCITYCampaign criterion proximity address city nameName of the city.
campaign_criterion_proximity_address_country_codeCOUNTRYCampaign criterion proximity address country codeCountry code.
campaign_criterion_proximity_address_postal_codeTEXTCampaign criterion proximity address postal codePostal code.
campaign_criterion_proximity_address_province_codeTEXTCampaign criterion proximity address province codeProvince or state code.
campaign_criterion_proximity_address_province_nameTEXTCampaign criterion proximity address province nameProvince or state name.
campaign_criterion_proximity_address_street_addressTEXTCampaign criterion proximity address street addressStreet address line 1.
campaign_criterion_proximity_geo_point_latitude_in_micro_degreesNUMERICCampaign criterion proximity geo point latitude in micro degreesMicro degrees for the latitude.
campaign_criterion_proximity_geo_point_longitude_in_micro_degreesNUMERICCampaign criterion proximity geo point longitude in micro degreesMicro degrees for the longitude.
campaign_criterion_proximity_radiusNUMERICCampaign criterion proximity radiusThe radius of the proximity.
campaign_criterion_proximity_radius_unitsTEXTCampaign criterion proximity radius unitsThe unit of measurement of the radius. Default is KILOMETERS.
campaign_criterion_resource_nameTEXTCampaign criterion resource nameThe resource name of the campaign criterion. Campaign criterion resource names have the form: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
campaign_criterion_statusTEXTCampaign criterion statusThe status of the criterion.
campaign_criterion_topic_pathTEXTCampaign criterion topic pathThe category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category.
campaign_criterion_topic_topic_constantTEXTCampaign criterion topic topic constantThe Topic Constant resource name.
campaign_criterion_user_interest_user_interest_categoryTEXTCampaign criterion user interest user interest categoryThe UserInterest resource name.
campaign_criterion_user_list_user_listTEXTCampaign criterion user list user listThe User List resource name.
campaign_criterion_webpage_conditionsTEXTCampaign criterion webpage conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_webpage_coverage_percentageNUMERICCampaign criterion webpage coverage percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
campaign_criterion_webpage_criterion_nameTEXTCampaign criterion webpage criterion nameThe name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
campaign_criterion_webpage_sample_sample_urlsTEXTCampaign criterion webpage sample sample urlsWebpage sample urls
campaign_criterion_youtube_channel_channel_idTEXTCampaign criterion youtube channel channel idThe YouTube uploader channel id or the channel code of a YouTube channel.
campaign_criterion_youtube_video_video_idTEXTCampaign criterion youtube video video idYouTube video id as it appears on the YouTube watch page.
campaign_discovery_campaign_settings_upgraded_targetingBOOLEANCampaign discovery campaign settings upgraded targetingSpecifies 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.
campaign_dynamic_search_ads_setting_domain_nameTEXTCampaign dynamic search ads setting domain nameRequired. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
campaign_dynamic_search_ads_setting_feedsTEXTCampaign dynamic search ads setting feedsThe list of page feeds associated with the campaign.
campaign_dynamic_search_ads_setting_language_codeTEXTCampaign dynamic search ads setting language codeRequired. The language code specifying the language of the domain, for example, "en".
campaign_dynamic_search_ads_setting_use_supplied_urls_onlyBOOLEANCampaign dynamic search ads setting use supplied urls onlyWhether the campaign uses advertiser supplied URLs exclusively.
campaign_excluded_parent_asset_field_typesTEXTCampaign excluded parent asset field typesThe 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.
campaign_excluded_parent_asset_set_typesTEXTCampaign excluded parent asset set typesThe 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.
campaign_frequency_capsTEXTCampaign frequency capsA list that limits how often each user will see this campaign's ads.
campaign_geo_target_type_setting_negative_geo_target_typeTEXTCampaign geo target type setting negative geo target typeThe setting used for negative geotargeting in this particular campaign.
campaign_geo_target_type_setting_positive_geo_target_typeTEXTCampaign geo target type setting positive geo target typeThe setting used for positive geotargeting in this particular campaign.
campaign_groupTEXTCampaign groupThe campaign group this campaign belongs to.
campaign_hotel_property_asset_setTEXTCampaign hotel property asset setThe set of hotel properties for Performance Max for travel goals campaigns.
campaign_hotel_setting_hotel_center_idNUMERICCampaign hotel setting hotel center idThe linked Hotel Center account.
campaign_idTEXTCampaign idThe ID of the campaign.
campaign_labelsTEXTCampaign labelsThe resource names of labels attached to this campaign.
campaign_listing_typeTEXTCampaign listing typeListing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns.
campaign_local_campaign_setting_location_source_typeTEXTCampaign local campaign setting location source typeThe location source type for this local campaign.
campaign_local_services_campaign_settings_category_bidsTEXTCampaign local services campaign settings category bidsCategorical level bids associated with MANUAL_CPA bidding strategy.
campaign_manual_cpaTEXTCampaign manual cpaStandard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
campaign_manual_cpc_enhanced_cpc_enabledBOOLEANCampaign manual cpc enhanced cpc enabledWhether bids are to be enhanced based on conversion optimizer data.
campaign_manual_cpmTEXTCampaign manual cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
campaign_manual_cpvTEXTCampaign manual cpvA bidding strategy that pays a configurable amount per video view.
campaign_maximize_conversions_target_cpa_microsNUMERICCampaign maximize conversions target cpa microsThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
campaign_nameTEXTCampaign nameThe 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.
campaign_network_settings_target_content_networkBOOLEANCampaign network settings target content networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
BOOLEANCampaign network settings target google searchWhether ads will be served with google.com search results.
campaign_network_settings_target_google_tv_networkBOOLEANCampaign network settings target google tv networkWhether ads will be served on the Google TV network.
campaign_network_settings_target_partner_search_networkBOOLEANCampaign network settings target partner search networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
campaign_network_settings_target_search_networkBOOLEANCampaign network settings target search networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
campaign_network_settings_target_youtubeBOOLEANCampaign network settings target youtubeWhether ads will be served on YouTube.
campaign_optimization_goal_setting_optimization_goal_typesTEXTCampaign optimization goal setting optimization goal typesThe list of optimization goal types.
campaign_optimization_scoreNUMERICCampaign optimization scoreOptimization 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.
campaign_payment_modeTEXTCampaign payment modePayment mode for the campaign.
campaign_percent_cpc_cpc_bid_ceiling_microsNUMERICCampaign percent cpc cpc bid ceiling microsMaximum 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.
campaign_percent_cpc_enhanced_cpc_enabledBOOLEANCampaign percent cpc enhanced cpc enabledAdjusts 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.
campaign_performance_max_upgrade_performance_max_campaignTEXTCampaign performance max upgrade performance max campaignIndicates which Performance Max campaign the campaign is upgraded to.
campaign_performance_max_upgrade_pre_upgrade_campaignTEXTCampaign performance max upgrade pre upgrade campaignIndicates legacy campaign upgraded to Performance Max.
campaign_performance_max_upgrade_statusTEXTCampaign performance max upgrade statusThe upgrade status of a campaign requested to be upgraded to Performance Max.
campaign_primary_statusTEXTCampaign primary statusThe 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.
campaign_primary_status_reasonsTEXTCampaign primary status reasonsThe 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.
campaign_real_time_bidding_setting_opt_inBOOLEANCampaign real time bidding setting opt inWhether the campaign is opted in to real-time bidding.
campaign_resource_nameTEXTCampaign resource nameThe resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
campaign_selective_optimization_conversion_actionsTEXTCampaign selective optimization conversion actionsThe selected set of conversion actions for optimizing this campaign.
campaign_shopping_setting_advertising_partner_idsNUMERICCampaign shopping setting advertising partner idsThe ads account IDs of advertising partners cooperating within the campaign.
campaign_shopping_setting_campaign_priorityNUMERICCampaign shopping setting campaign priorityPriority 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.
campaign_shopping_setting_enable_localBOOLEANCampaign shopping setting enable localWhether to include local products.
campaign_shopping_setting_feed_labelTEXTCampaign shopping setting feed labelFeed 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.
campaign_shopping_setting_merchant_idNUMERICCampaign shopping setting merchant idID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
campaign_shopping_setting_use_vehicle_inventoryBOOLEANCampaign shopping setting use vehicle inventoryWhether 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.
campaign_statusTEXTCampaign statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
campaign_sub_typeTEXTCampaign sub typeOptional refinement to Campaign type. Alias for Advertising channel sub type.
campaign_target_cpa_cpc_bid_ceiling_microsNUMERICCampaign target cpa cpc bid ceiling microsMaximum 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.
campaign_target_cpa_cpc_bid_floor_microsNUMERICCampaign target cpa cpc bid floor microsMinimum 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.
campaign_target_cpa_target_cpa_microsNUMERICCampaign target cpa target cpa microsAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
campaign_target_cpm_target_frequency_goal_target_countNUMERICCampaign target cpm target frequency goal target countTarget Frequency count representing how many times you want to reach a single user.
campaign_target_cpm_target_frequency_goal_time_unitTEXTCampaign target cpm target frequency goal time unitTime window expressing the period over which you want to reach the specified target_count.
campaign_target_impression_share_cpc_bid_ceiling_microsNUMERICCampaign target impression share cpc bid ceiling microsThe 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.
campaign_target_impression_share_locationTEXTCampaign target impression share locationThe targeted location on the search results page.
campaign_target_impression_share_location_fraction_microsNUMERICCampaign target impression share location fraction microsThe chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
campaign_target_roas_cpc_bid_ceiling_microsNUMERICCampaign target roas cpc bid ceiling microsMaximum 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.
campaign_target_roas_cpc_bid_floor_microsNUMERICCampaign target roas cpc bid floor microsMinimum 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.
campaign_target_roas_target_roasNUMERICCampaign target roas target roasThe chosen revenue (based on conversion data) per unit of spend.
campaign_target_spend_cpc_bid_ceiling_microsNUMERICCampaign target spend cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
campaign_target_spend_target_spend_microsNUMERICCampaign target spend target spend microsThe 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.
campaign_targeting_setting_target_restrictionsTEXTCampaign targeting setting target restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
campaign_tracking_setting_tracking_urlTEXTCampaign tracking setting tracking urlThe url used for dynamic tracking.
campaign_travel_campaign_settings_travel_account_idNUMERICCampaign travel campaign settings travel account idThe Travel account ID associated with the Travel campaign.
campaign_trial_typeTEXTCampaign trial typeThe type of campaign: normal, draft, or experiment.
campaign_typeTEXTCampaign typeThe primary serving target for ads within the campaign. Alias for Advertising channel type.
campaign_url_expansion_opt_outBOOLEANCampaign url expansion opt outRepresents 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.
campaign_vanity_pharma_vanity_pharma_display_url_modeTEXTCampaign vanity pharma vanity pharma display url modeThe display mode for vanity pharma URLs.
campaign_vanity_pharma_vanity_pharma_textTEXTCampaign vanity pharma vanity pharma textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
campaign_video_brand_safety_suitabilityTEXTCampaign video brand safety suitability3-Tier Brand Safety setting for the campaign.
carrier_carrier_constantTEXTCarrier carrier constantThe Carrier constant resource name.
channelTEXTChannelChannel of the product.
channel_exclusivityTEXTChannel exclusivityChannel exclusivity of the product.
channel_idTEXTChannel idThe owner channel id of the video.
cityCITYGeo target cityGeo target city name.
click_typeTEXTClick typeClick type.
clicksNUMERICClicksThe number of clicks.
closing_reasonTEXTClosing reasonIndicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open.
combined_audience_combined_audienceTEXTCombined audience combined audienceThe CombinedAudience resource name.
commission_commission_rate_microsNUMERICCommission commission rate microsCommission 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%).
content_bid_criterion_type_groupTEXTContent bid criterion type groupAllows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search.
content_budget_lost_impression_shareNUMERICContent budget lost impression shareThe 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.
content_impression_shareNUMERICContent impression shareThe 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.
content_label_typeTEXTContent label typeContent label type, required for CREATE operations.
content_rank_lost_impression_shareNUMERICContent rank lost impression shareThe 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.
conversion_actionTEXTConversion actionResource name of the conversion action.
conversion_action_categoryTEXTConversion action categoryConversion action category.
conversion_action_nameTEXTConversion action nameConversion action name.
conversion_adjustmentBOOLEANConversion adjustmentThis 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.
conversion_adjustment_lag_bucketTEXTConversion adjustment lag bucketAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
conversion_attribution_event_typeTEXTConversion attribution event typeConversion attribution event type.
conversion_category_nameTEXTConversion category nameConversion action category.
conversion_lag_bucketTEXTConversion lag bucketAn enum value representing the number of days between the impression and the conversion.
conversion_last_conversion_dateDATEConversion last conversion dateThe date of the most recent conversion for this conversion action. The date is in the customer's time zone.
conversion_last_received_request_date_timeDATEConversion last received request date timeThe last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (for example, because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone.
conversion_or_adjustment_lag_bucketTEXTConversion or adjustment lag bucketAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
conversion_ratePERCENTConversion rateConversions 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.
conversion_tracker_idTEXTConversion tracker idResource name of the conversion action.
conversion_tracking_setting_accepted_customer_data_termsBOOLEANConversion tracking setting accepted customer data termsWhether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_setting_conversion_tracking_idNUMERICConversion tracking setting conversion tracking idThe conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
conversion_tracking_setting_conversion_tracking_statusTEXTConversion tracking setting conversion tracking statusConversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.
conversion_tracking_setting_cross_account_conversion_tracking_idNUMERICConversion tracking setting cross account conversion tracking idThe conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
conversion_tracking_setting_enhanced_conversions_for_leads_enabledBOOLEANConversion tracking setting enhanced conversions for leads enabledWhether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
conversion_tracking_setting_google_ads_conversion_customerTEXTConversion tracking setting google ads conversion customerThe resource name of the customer where conversions are created and managed. This field is read-only.
conversion_type_nameTEXTConversion type nameConversion action name.
conversion_valueNUMERICConversion valueThe 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.
conversion_value_rule_primary_dimensionTEXTConversion value rule primary dimensionPrimary 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.
conversionsNUMERICConversionsThe 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.
conversions_by_conversion_dateNUMERICConversions by conversion dateThe 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.
conversions_from_interactions_rateNUMERICConversions from interactions rateConversions 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.
conversions_from_interactions_value_per_interactionNUMERICConversions from interactions value per interactionThe 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.
conversions_valueNUMERICConversions valueThe 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.
conversions_value_by_conversion_dateNUMERICConversions value by conversion dateThe 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.
conversions_value_per_costNUMERICConversions value per costThe 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.
costNUMERICCostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
cost_microsNUMERICCost microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
cost_of_goods_sold_microsNUMERICCost of goods sold microsCost 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.
cost_per_all_conversionNUMERICCost per all conversionThe cost of ad interactions divided by all conversions.
cost_per_all_conversionsNUMERICCost per all conversionsThe cost of ad interactions divided by all conversions.
cost_per_conversionNUMERICCost per conversionThe 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.
cost_per_current_model_attributed_conversionNUMERICCost per current model attributed conversionThe 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.
countryCOUNTRYGeo target country codeGeo target country code.
country_criteria_idCOUNTRYCountry criteria idResource name of the geo target constant for the country of sale of the product.
country_criterion_idCOUNTRYCountry criterion idCriterion Id for the country.
cpc_bidNUMERICCpc bidThe maximum CPC (cost-per-click) bid.
cpc_bid_microsNUMERICCpc bid microsThe maximum CPC (cost-per-click) bid.
cpc_bid_sourceTEXTCpc bid sourceSource of the effective CPC bid.
cpm_bidNUMERICCpm bidThe maximum CPM (cost-per-thousand viewable impressions) bid.
cpm_bid_microsNUMERICCpm bid microsThe maximum CPM (cost-per-thousand viewable impressions) bid.
cpm_bid_sourceTEXTCpm bid sourceSource of the effective CPM bid.
cpv_bidNUMERICCpv bidThe CPV (cost-per-view) bid.
cpv_bid_microsNUMERICCpv bid microsThe CPV (cost-per-view) bid.
creative_idTEXTCreative idThe ID of the ad.
creative_quality_scoreTEXTCreative quality scoreThe performance of the ad compared to other advertisers.
creative_statusTEXTCreative statusThe status of the ad.
criteriaTEXTCriteriaType of the age range.
criteria_typeTEXTCriteria typeThe type of the criterion.
criterion_idNUMERICCriterion idThe ID of the criterion. This field is ignored for mutates.
crm_based_user_list_app_idTEXTCrm based user list app idA string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs.
crm_based_user_list_data_source_typeTEXTCrm based user list data source typeData source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists.
crm_based_user_list_upload_key_typeTEXTCrm based user list upload key typeMatching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation.
cross_device_conversionsNUMERICCross device conversionsConversions 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.
cross_device_conversions_value_microsNUMERICCross device conversions value microsThe sum of the value of cross-device conversions, in micros.
cross_sell_cost_of_goods_sold_microsNUMERICCross sell cost of goods sold microsCross-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.
cross_sell_gross_profit_microsNUMERICCross sell gross profit microsCross-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.
cross_sell_revenue_microsNUMERICCross sell revenue microsCross-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.
cross_sell_units_soldNUMERICCross sell units soldCross-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.
ctrPERCENTCtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
currencyTEXTCurrencyThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
currency_codeTEXTCurrency codeThe currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
current_model_attributed_conversion_valueNUMERICCurrent model attributed conversion valueThe 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.
current_model_attributed_conversionsNUMERICCurrent model attributed conversionsShows 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.
current_model_attributed_conversions_from_interactions_rateNUMERICCurrent model attributed conversions from interactions rateCurrent 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.
current_model_attributed_conversions_from_interactions_value_per_interactionNUMERICCurrent model attributed conversions from interactions value per interactionThe 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.
current_model_attributed_conversions_valueNUMERICCurrent model attributed conversions valueThe 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.
current_model_attributed_conversions_value_per_costNUMERICCurrent model attributed conversions value per costThe 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.
custom_affinity_custom_affinityTEXTCustom affinity custom affinityThe CustomInterest resource name.
custom_attribute0TEXTCustom attribute0Custom attribute 0 of the product.
custom_attribute1TEXTCustom attribute1Custom attribute 1 of the product.
custom_attribute2TEXTCustom attribute2Custom attribute 2 of the product.
custom_attribute3TEXTCustom attribute3Custom attribute 3 of the product.
custom_attribute4TEXTCustom attribute4Custom attribute 4 of the product.
custom_audience_custom_audienceTEXTCustom audience custom audienceThe CustomAudience resource name.
custom_intent_custom_intentTEXTCustom intent custom intentThe CustomInterest resource name.
customer_agreement_setting_accepted_lead_form_termsBOOLEANCustomer agreement setting accepted lead form termsWhether the customer has accepted lead form term of service.
customer_auto_tagging_enabledBOOLEANCustomer auto tagging enabledWhether auto-tagging is enabled for the customer.
customer_call_reporting_setting_call_conversion_actionTEXTCustomer call reporting setting call conversion actionCustomer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
customer_call_reporting_setting_call_conversion_reporting_enabledBOOLEANCustomer call reporting setting call conversion reporting enabledWhether to enable call conversion reporting.
customer_call_reporting_setting_call_reporting_enabledBOOLEANCustomer call reporting setting call reporting enabledEnable reporting of phone call events by redirecting them through Google System.
customer_conversion_tracking_setting_accepted_customer_data_termsBOOLEANCustomer conversion tracking setting accepted customer data termsWhether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
customer_conversion_tracking_setting_conversion_tracking_idNUMERICCustomer conversion tracking setting conversion tracking idThe conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
customer_conversion_tracking_setting_conversion_tracking_statusTEXTCustomer conversion tracking setting conversion tracking statusConversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.
customer_conversion_tracking_setting_cross_account_conversion_tracking_idNUMERICCustomer conversion tracking setting cross account conversion tracking idThe conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
customer_conversion_tracking_setting_enhanced_conversions_for_leads_enabledBOOLEANCustomer conversion tracking setting enhanced conversions for leads enabledWhether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
customer_conversion_tracking_setting_google_ads_conversion_customerTEXTCustomer conversion tracking setting google ads conversion customerThe resource name of the customer where conversions are created and managed. This field is read-only.
customer_customer_agreement_setting_accepted_lead_form_termsBOOLEANCustomer customer agreement setting accepted lead form termsWhether the customer has accepted lead form term of service.
customer_descriptive_nameTEXTCustomer descriptive nameOptional, non-unique descriptive name of the customer.
customer_final_url_suffixTEXTCustomer final url suffixThe URL template for appending params to the final URL. Only mutable in an update operation.
customer_has_partners_badgeBOOLEANCustomer has partners badgeWhether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
customer_image_asset_auto_migration_doneBOOLEANCustomer image asset auto migration doneTrue if feed based image has been migrated to asset based image.
customer_image_asset_auto_migration_done_date_timeDATECustomer image asset auto migration done date timeTimestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format.
customer_local_services_settings_granular_insurance_statusesTEXTCustomer local services settings granular insurance statusesA read-only list of geo vertical level insurance statuses.
customer_local_services_settings_granular_license_statusesTEXTCustomer local services settings granular license statusesA read-only list of geo vertical level license statuses.
customer_location_asset_auto_migration_doneBOOLEANCustomer location asset auto migration doneTrue if feed based location has been migrated to asset based location.
customer_location_asset_auto_migration_done_date_timeDATECustomer location asset auto migration done date timeTimestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format.
customer_managerBOOLEANCustomer managerWhether the customer is a manager.
customer_optimization_scoreNUMERICCustomer optimization scoreOptimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
customer_optimization_score_weightNUMERICCustomer optimization score weightOptimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
customer_pay_per_conversion_eligibility_failure_reasonsTEXTCustomer pay per conversion eligibility failure reasonsReasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
customer_remarketing_setting_google_global_site_tagTEXTCustomer remarketing setting google global site tagThe Google tag.
customer_resource_nameTEXTCustomer resource nameThe resource name of the customer. Customer resource names have the form: customers/{customer_id}
customer_statusTEXTCustomer statusThe status of the customer.
customer_test_accountBOOLEANCustomer test accountWhether the customer is a test account.
customer_tracking_url_templateTEXTCustomer tracking url templateThe URL template for constructing a tracking URL out of parameters. Only mutable in an update operation.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateDate to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
day_of_monthTEXTDay of monthDay of the month
day_of_weekTEXTDay of weekDay of the week, for example, MONDAY.
delivery_methodTEXTDelivery methodThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
descriptionTEXTDescriptionDescription of this user list.
descriptive_nameTEXTDescriptive nameOptional, non-unique descriptive name of the customer.
detail_placement_view_display_nameTEXTDetail placement view display nameThe display name is URL name for websites, YouTube video name for YouTube videos, and translated mobile app name for mobile apps.
detail_placement_view_group_placement_target_urlTEXTDetail placement view group placement target urlURL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL.
detail_placement_view_placementTEXTDetail placement view placementThe automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID.
detail_placement_view_placement_typeTEXTDetail placement view placement typeType of the placement, for example, Website, YouTube Video, and Mobile Application.
detail_placement_view_resource_nameTEXTDetail placement view resource nameThe resource name of the detail placement view. Detail placement view resource names have the form: customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}
detail_placement_view_target_urlTEXTDetail placement view target urlURL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL.
deviceTEXTDeviceDevice to which metrics apply.
device_typeTEXTDevice typeType of the device.
dimensionsTEXTDimensionsPositive dimensions specifying the audience composition.
dimensions_audience_segments_segments_custom_audience_custom_audienceTEXTDimensions audience segments segments custom audience custom audienceThe custom audience resource.
dimensions_audience_segments_segments_detailed_demographic_detailed_demographicTEXTDimensions audience segments segments detailed demographic detailed demographicThe detailed demographic resource.
dimensions_audience_segments_segments_life_event_life_eventTEXTDimensions audience segments segments life event life eventThe life event resource.
dimensions_audience_segments_segments_user_interest_user_interest_categoryTEXTDimensions audience segments segments user interest user interest categoryThe user interest resource.
dimensions_audience_segments_segments_user_list_user_listTEXTDimensions audience segments segments user list user listThe user list resource.
disapproval_reasonsTEXTDisapproval reasonsList of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only.
discovery_campaign_settings_upgraded_targetingBOOLEANDiscovery campaign settings upgraded targetingSpecifies 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.
TEXTDiscovery carousel card asset call to action textCall to action text.
TEXTDiscovery carousel card asset headlineRequired. Headline of the carousel card.
TEXTDiscovery carousel card asset marketing image assetAsset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required.
TEXTDiscovery carousel card asset portrait marketing image assetAsset resource name of the associated 4:5 portrait marketing image.
TEXTDiscovery carousel card asset square marketing image assetAsset resource name of the associated square marketing image. This and/or a marketing image asset is required.
display_custom_bid_dimensionTEXTDisplay custom bid dimensionAllows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search.
display_nameTEXTDisplay nameThe display name of the criterion. This field is ignored for mutates.
duration_millisNUMERICVideo duration millisThe duration of the video in milliseconds.
TEXTDynamic custom asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_custom_asset_contextual_keywordsTEXTDynamic custom asset contextual keywordsContextual keywords, for example, Sedans, 4 door sedans.
dynamic_custom_asset_formatted_priceTEXTDynamic custom asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00.
dynamic_custom_asset_formatted_sale_priceTEXTDynamic custom asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00.
dynamic_custom_asset_idTEXTDynamic custom asset idRequired. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required.
dynamic_custom_asset_id2TEXTDynamic custom asset id2ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique.
dynamic_custom_asset_image_urlTEXTDynamic custom asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic custom asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_custom_asset_ios_app_store_idNUMERICDynamic custom asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_custom_asset_item_addressTEXTDynamic custom asset item addressItem address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
dynamic_custom_asset_item_categoryTEXTDynamic custom asset item categoryItem category, for example, Sedans.
dynamic_custom_asset_item_descriptionTEXTDynamic custom asset item descriptionItem description, for example, Best selling mid-size car.
dynamic_custom_asset_item_subtitleTEXTDynamic custom asset item subtitleItem subtitle, for example, At your Mountain View dealership.
dynamic_custom_asset_item_titleTEXTDynamic custom asset item titleRequired. Item title, for example, Mid-size sedan. Required.
dynamic_custom_asset_priceTEXTDynamic custom asset pricePrice which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD.
dynamic_custom_asset_sale_priceTEXTDynamic custom asset sale priceSale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field.
dynamic_custom_asset_similar_idsTEXTDynamic custom asset similar idsSimilar IDs.
dynamic_education_asset_addressTEXTDynamic education asset addressSchool address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
TEXTDynamic education asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_education_asset_contextual_keywordsTEXTDynamic education asset contextual keywordsContextual keywords, for example, Nursing certification, Health, Mountain View.
dynamic_education_asset_image_urlTEXTDynamic education asset image urlImage url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic education asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_education_asset_ios_app_store_idNUMERICDynamic education asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_education_asset_location_idTEXTDynamic education asset location idLocation ID which can be any sequence of letters and digits and must be unique.
dynamic_education_asset_program_descriptionTEXTDynamic education asset program descriptionProgram description, for example, Nursing Certification.
dynamic_education_asset_program_idTEXTDynamic education asset program idRequired. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_education_asset_program_nameTEXTDynamic education asset program nameRequired. Program name, for example, Nursing. Required.
dynamic_education_asset_school_nameTEXTDynamic education asset school nameSchool name, for example, Mountain View School of Nursing.
dynamic_education_asset_similar_program_idsTEXTDynamic education asset similar program idsSimilar program IDs.
dynamic_education_asset_subjectTEXTDynamic education asset subjectSubject of study, for example, Health.
dynamic_education_asset_thumbnail_image_urlTEXTDynamic education asset thumbnail image urlThumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset.
TEXTDynamic flights asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_flights_asset_custom_mappingTEXTDynamic flights asset custom mappingA custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32".
dynamic_flights_asset_destination_idTEXTDynamic flights asset destination idRequired. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_flights_asset_destination_nameTEXTDynamic flights asset destination nameDestination name, for example, Paris.
dynamic_flights_asset_flight_descriptionTEXTDynamic flights asset flight descriptionRequired. Flight description, for example, Book your ticket. Required.
dynamic_flights_asset_flight_priceTEXTDynamic flights asset flight priceFlight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
dynamic_flights_asset_flight_sale_priceTEXTDynamic flights asset flight sale priceFlight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field.
dynamic_flights_asset_formatted_priceTEXTDynamic flights asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
dynamic_flights_asset_formatted_sale_priceTEXTDynamic flights asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
dynamic_flights_asset_image_urlTEXTDynamic flights asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic flights asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_flights_asset_ios_app_store_idNUMERICDynamic flights asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_flights_asset_origin_idTEXTDynamic flights asset origin idOrigin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
dynamic_flights_asset_origin_nameTEXTDynamic flights asset origin nameOrigin name, for example, London.
dynamic_flights_asset_similar_destination_idsTEXTDynamic flights asset similar destination idsSimilar destination IDs, for example, PAR,LON.
dynamic_hotels_and_rentals_asset_addressTEXTDynamic hotels and rentals asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
TEXTDynamic hotels and rentals asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_hotels_and_rentals_asset_categoryTEXTDynamic hotels and rentals asset categoryCategory, for example, Hotel suite.
dynamic_hotels_and_rentals_asset_contextual_keywordsTEXTDynamic hotels and rentals asset contextual keywordsContextual keywords, for example, Mountain View "Hotels", South Bay hotels.
dynamic_hotels_and_rentals_asset_descriptionTEXTDynamic hotels and rentals asset descriptionDescription, for example, Close to SJC Airport.
dynamic_hotels_and_rentals_asset_destination_nameTEXTDynamic hotels and rentals asset destination nameDestination name, for example, Downtown Mountain View.
dynamic_hotels_and_rentals_asset_formatted_priceTEXTDynamic hotels and rentals asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
dynamic_hotels_and_rentals_asset_formatted_sale_priceTEXTDynamic hotels and rentals asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
dynamic_hotels_and_rentals_asset_image_urlTEXTDynamic hotels and rentals asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic hotels and rentals asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_hotels_and_rentals_asset_ios_app_store_idNUMERICDynamic hotels and rentals asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_hotels_and_rentals_asset_priceTEXTDynamic hotels and rentals asset pricePrice which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
dynamic_hotels_and_rentals_asset_property_idTEXTDynamic hotels and rentals asset property idRequired. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_hotels_and_rentals_asset_property_nameTEXTDynamic hotels and rentals asset property nameRequired. Property name, for example, Mountain View Hotel. Required.
dynamic_hotels_and_rentals_asset_sale_priceTEXTDynamic hotels and rentals asset sale priceISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
dynamic_hotels_and_rentals_asset_similar_property_idsTEXTDynamic hotels and rentals asset similar property idsSimilar property IDs.
dynamic_hotels_and_rentals_asset_star_ratingNUMERICDynamic hotels and rentals asset star ratingStar rating. Must be a number between 1 to 5, inclusive.
dynamic_jobs_asset_addressTEXTDynamic jobs asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
TEXTDynamic jobs asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_jobs_asset_contextual_keywordsTEXTDynamic jobs asset contextual keywordsContextual keywords, for example, Software engineering job.
dynamic_jobs_asset_descriptionTEXTDynamic jobs asset descriptionDescription, for example, Apply your technical skills.
dynamic_jobs_asset_image_urlTEXTDynamic jobs asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic jobs asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_jobs_asset_ios_app_store_idNUMERICDynamic jobs asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_jobs_asset_job_categoryTEXTDynamic jobs asset job categoryJob category, for example, Technical.
dynamic_jobs_asset_job_idTEXTDynamic jobs asset job idRequired. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_jobs_asset_job_subtitleTEXTDynamic jobs asset job subtitleJob subtitle, for example, Level II.
dynamic_jobs_asset_job_titleTEXTDynamic jobs asset job titleRequired. Job title, for example, Software engineer. Required.
dynamic_jobs_asset_location_idTEXTDynamic jobs asset location idLocation ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique.
dynamic_jobs_asset_salaryTEXTDynamic jobs asset salarySalary, for example, $100,000.
dynamic_jobs_asset_similar_job_idsTEXTDynamic jobs asset similar job idsSimilar job IDs, for example, 1275.
dynamic_local_asset_addressTEXTDynamic local asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
TEXTDynamic local asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_local_asset_categoryTEXTDynamic local asset categoryCategory, for example, Food.
dynamic_local_asset_contextual_keywordsTEXTDynamic local asset contextual keywordsContextual keywords, for example, Save groceries coupons.
dynamic_local_asset_deal_idTEXTDynamic local asset deal idRequired. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_local_asset_deal_nameTEXTDynamic local asset deal nameRequired. Deal name, for example, 50% off at Mountain View Grocers. Required.
dynamic_local_asset_descriptionTEXTDynamic local asset descriptionDescription, for example, Save on your weekly bill.
dynamic_local_asset_formatted_priceTEXTDynamic local asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
dynamic_local_asset_formatted_sale_priceTEXTDynamic local asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
dynamic_local_asset_image_urlTEXTDynamic local asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic local asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_local_asset_ios_app_store_idNUMERICDynamic local asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_local_asset_priceTEXTDynamic local asset pricePrice which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
dynamic_local_asset_sale_priceTEXTDynamic local asset sale priceSale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
dynamic_local_asset_similar_deal_idsTEXTDynamic local asset similar deal idsSimilar deal IDs, for example, 1275.
dynamic_local_asset_subtitleTEXTDynamic local asset subtitleSubtitle, for example, Groceries.
dynamic_real_estate_asset_addressTEXTDynamic real estate asset addressAddress which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
TEXTDynamic real estate asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_real_estate_asset_city_nameCITYDynamic real estate asset city nameCity name, for example, Mountain View, California.
dynamic_real_estate_asset_contextual_keywordsTEXTDynamic real estate asset contextual keywordsContextual keywords, for example, For sale; Houses for sale.
dynamic_real_estate_asset_descriptionTEXTDynamic real estate asset descriptionDescription, for example, 3 beds, 2 baths, 1568 sq. ft.
dynamic_real_estate_asset_formatted_priceTEXTDynamic real estate asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00.
dynamic_real_estate_asset_image_urlTEXTDynamic real estate asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic real estate asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_real_estate_asset_ios_app_store_idNUMERICDynamic real estate asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_real_estate_asset_listing_idTEXTDynamic real estate asset listing idRequired. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_real_estate_asset_listing_nameTEXTDynamic real estate asset listing nameRequired. Listing name, for example, Boulevard Bungalow. Required.
dynamic_real_estate_asset_listing_typeTEXTDynamic real estate asset listing typeListing type, for example, For sale.
dynamic_real_estate_asset_priceTEXTDynamic real estate asset pricePrice which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD.
dynamic_real_estate_asset_property_typeTEXTDynamic real estate asset property typeProperty type, for example, House.
dynamic_real_estate_asset_similar_listing_idsTEXTDynamic real estate asset similar listing idsSimilar listing IDs.
dynamic_search_ads_setting_domain_nameTEXTDynamic search ads setting domain nameRequired. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
dynamic_search_ads_setting_feedsTEXTDynamic search ads setting feedsThe list of page feeds associated with the campaign.
dynamic_search_ads_setting_language_codeTEXTDynamic search ads setting language codeRequired. The language code specifying the language of the domain, for example, "en".
dynamic_search_ads_setting_use_supplied_urls_onlyBOOLEANDynamic search ads setting use supplied urls onlyWhether the campaign uses advertiser supplied URLs exclusively.
TEXTDynamic travel asset android app linkAndroid deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
dynamic_travel_asset_categoryTEXTDynamic travel asset categoryCategory, for example, Express.
dynamic_travel_asset_contextual_keywordsTEXTDynamic travel asset contextual keywordsContextual keywords, for example, Paris trains.
dynamic_travel_asset_destination_addressTEXTDynamic travel asset destination addressDestination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
dynamic_travel_asset_destination_idTEXTDynamic travel asset destination idRequired. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
dynamic_travel_asset_destination_nameTEXTDynamic travel asset destination nameDestination name, for example, Paris.
dynamic_travel_asset_formatted_priceTEXTDynamic travel asset formatted priceFormatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
dynamic_travel_asset_formatted_sale_priceTEXTDynamic travel asset formatted sale priceFormatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
dynamic_travel_asset_image_urlTEXTDynamic travel asset image urlImage URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
TEXTDynamic travel asset ios app linkiOS deep link, for example, exampleApp://content/page.
dynamic_travel_asset_ios_app_store_idNUMERICDynamic travel asset ios app store idiOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
dynamic_travel_asset_origin_idTEXTDynamic travel asset origin idOrigin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
dynamic_travel_asset_origin_nameTEXTDynamic travel asset origin nameOrigin name, for example, London.
dynamic_travel_asset_priceTEXTDynamic travel asset pricePrice which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
dynamic_travel_asset_sale_priceTEXTDynamic travel asset sale priceSale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
dynamic_travel_asset_similar_destination_idsTEXTDynamic travel asset similar destination idsSimilar destination IDs, for example, NYC.
dynamic_travel_asset_titleTEXTDynamic travel asset titleRequired. Title, for example, Book your train ticket. Required.
effective_cpc_bid_microsNUMERICEffective cpc bid microsValue will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null.
effective_cpc_bid_sourceTEXTEffective cpc bid sourceSource of the effective CPC bid.
effective_cpm_bid_microsNUMERICEffective cpm bid microsThe effective CPM (cost-per-thousand viewable impressions) bid.
effective_cpm_bid_sourceTEXTEffective cpm bid sourceSource of the effective CPM bid.
effective_cpv_bid_microsNUMERICEffective cpv bid microsThe effective CPV (cost-per-view) bid.
effective_cpv_bid_sourceTEXTEffective cpv bid sourceSource of the effective CPV bid.
effective_currency_codeTEXTEffective currency codeThe currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
effective_percent_cpc_bid_microsNUMERICEffective percent cpc bid microsThe effective Percent CPC bid amount.
effective_percent_cpc_bid_sourceTEXTEffective percent cpc bid sourceSource of the effective Percent CPC bid.
effective_target_cpa_microsNUMERICEffective target cpa microsThe effective target CPA (cost-per-acquisition). This field is read-only.
effective_target_cpa_sourceTEXTEffective target cpa sourceSource of the effective target CPA. This field is read-only.
effective_target_roasNUMERICEffective target roasThe effective target ROAS (return-on-ad-spend). This field is read-only.
effective_target_roas_sourceTEXTEffective target roas sourceSource of the effective target ROAS. This field is read-only.
eligible_for_displayBOOLEANEligible for displayIndicates this user list is eligible for Google Display Network. This field is read-only.
BOOLEANEligible for searchIndicates if this user list is eligible for Google Search Network.
eligible_impressions_from_location_asset_store_reachNUMERICEligible impressions from location asset store reachNumber of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location.
enabledBOOLEANEnabledThe status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad.
end_dateDATEEnd dateThe 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.
engagement_ratePERCENTEngagement rateHow 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.
engagementsNUMERICEngagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
enhanced_cpcTEXTEnhanced cpcA bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
estimated_add_clicks_at_first_position_cpcNUMERICEstimated add clicks at first position cpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros.
estimated_add_cost_at_first_position_cpcNUMERICEstimated add cost at first position cpcEstimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.
excluded_parent_asset_field_typesTEXTExcluded parent asset field typesThe 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.
excluded_parent_asset_set_typesTEXTExcluded parent asset set typesThe 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.
exclusion_dimensionTEXTExclusion dimensionNegative dimension specifying the audience composition.
exclusion_dimension_exclusions_user_list_user_listTEXTExclusion dimension exclusions user list user listThe user list resource.
experiment_typeTEXTExperiment typeThe type of campaign: normal, draft, or experiment.
explicitly_sharedBOOLEANExplicitly sharedSpecifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
external_activity_idTEXTExternal activity idAdvertiser supplied activity ID.
external_conversion_sourceTEXTExternal conversion sourceExternal conversion source.
external_customer_idNUMERICExternal customer idThe ID of the customer.
field_typeTEXTField typeRole that the asset takes in the ad.
field_type_policy_summariesTEXTField type policy summariesPolicy information for the asset for each FieldType.
final_mobile_urlsTEXTFinal mobile urlsThe list of possible final mobile URLs after all cross-domain redirects.
final_urlTEXTFinal urlThe advertiser-specified final URL.
final_url_suffixTEXTFinal url suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
final_urlsTEXTFinal urlsThe list of possible final URLs after all cross-domain redirects for the ad.
first_page_cpcNUMERICFirst page cpcThe estimate of the CPC bid required for ad to be shown on first page of search results.
first_position_cpcNUMERICFirst position cpcThe estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
frequency_capsTEXTFrequency capsA list that limits how often each user will see this campaign's ads.
gender_typeTEXTGender typeType of the gender.
gender_view_resource_nameTEXTGender view resource nameThe resource name of the gender view. Gender view resource names have the form: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}
geo_target_airportTEXTGeo target airportResource name of the geo target constant that represents an airport.
geo_target_cantonTEXTGeo target cantonResource name of the geo target constant that represents a canton.
geo_target_cityCITYGeo target city (Alias)Resource name of the geo target constant that represents a city.
geo_target_countryCOUNTRYGeo target country (Geographic View)The country of the user's actual physical location or an area of interest (Geographic View).
geo_target_countyTEXTGeo target countyResource name of the geo target constant that represents a county.
geo_target_districtTEXTGeo target districtResource name of the geo target constant that represents a district.
geo_target_metroTEXTGeo target metroResource name of the geo target constant that represents a metro.
geo_target_most_specific_locationTEXTGeo target most specific locationResource name of the geo target constant that represents the most specific location.
geo_target_postal_codeTEXTGeo target postal codeResource name of the geo target constant that represents a postal code.
geo_target_provinceTEXTGeo target provinceResource name of the geo target constant that represents a province.
geo_target_regionREGIONGeo target regionResource name of the geo target constant that represents a region.
geo_target_stateTEXTGeo target stateResource name of the geo target constant that represents a state.
geo_target_type_setting_negative_geo_target_typeTEXTGeo target type setting negative geo target typeThe setting used for negative geotargeting in this particular campaign.
geo_target_type_setting_positive_geo_target_typeTEXTGeo target type setting positive geo target typeThe setting used for positive geotargeting in this particular campaign.
geographic_view_country_criterion_idCOUNTRYGeographic view country criterion idCriterion Id for the country.
geographic_view_location_typeTEXTGeographic view location typeType of the geo targeting of the campaign.
geographic_view_resource_nameTEXTGeographic view resource nameThe resource name of the geographic view. Geographic view resource names have the form: customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type}
gmail_forwardsNUMERICGmail forwardsThe number of times the ad was forwarded to someone else as a message.
gmail_savesNUMERICGmail savesThe number of times someone has saved your Gmail ad to their inbox as a message.
gmail_secondary_clicksNUMERICGmail secondary clicksThe number of clicks to the landing page on the expanded state of Gmail ads.
gross_profit_marginNUMERICGross profit marginGross 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.
gross_profit_microsNUMERICGross profit microsGross 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.
group_placement_target_urlTEXTGroup placement target urlURL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL.
group_placement_view_display_nameTEXTGroup placement view display nameDomain name for websites and YouTube channel name for YouTube channels.
group_placement_view_placementTEXTGroup placement view placementThe automatic placement string at group level, e. g. web domain, mobile app ID, or a YouTube channel ID.
group_placement_view_placement_typeTEXTGroup placement view placement typeType of the placement, for example, Website, YouTube Channel, Mobile Application.
group_placement_view_resource_nameTEXTGroup placement view resource nameThe resource name of the group placement view. Group placement view resource names have the form: customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement}
group_placement_view_target_urlTEXTGroup placement view target urlURL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL.
has_partners_badgeBOOLEANHas partners badgeWhether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
BOOLEANHas recommended budgetIndicates whether there is a recommended budget for this campaign budget. This field is read-only.
historical_creative_quality_scoreTEXTHistorical creative quality scoreThe creative historical quality score.
historical_landing_page_quality_scoreTEXTHistorical landing page quality scoreThe quality of historical landing page experience.
historical_quality_scoreNUMERICHistorical quality scoreThe historical quality score.
historical_search_predicted_ctrTEXTHistorical search predicted ctrThe historical search predicted click through rate (CTR).
hotel_average_lead_value_microsNUMERICHotel average lead value microsAverage lead value based on clicks.
hotel_booking_window_daysNUMERICHotel booking window daysHotel booking window in days.
hotel_callout_asset_language_codeTEXTHotel callout asset language codeRequired. The language of the hotel callout. Represented as BCP 47 language tag.
hotel_callout_asset_textTEXTHotel callout asset textRequired. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive.
hotel_center_idNUMERICHotel center idHotel center ID.
hotel_check_in_dateDATEHotel check in dateHotel check-in date. Formatted as yyyy-MM-dd.
hotel_check_in_day_of_weekTEXTHotel check in day of weekHotel check-in day of week.
hotel_cityCITYHotel cityHotel city.
hotel_classNUMERICHotel classHotel class.
hotel_countryCOUNTRYHotel countryHotel country.
hotel_date_selection_typeTEXTHotel date selection typeHotel date selection type.
hotel_eligible_impressionsNUMERICHotel eligible impressionsThe number of impressions that hotel partners could have had given their feed performance.
hotel_length_of_stayNUMERICHotel length of stayHotel length of stay.
hotel_price_bucketTEXTHotel price bucketHotel price bucket.
hotel_price_difference_percentageNUMERICHotel price difference percentageThe average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser.
hotel_property_asset_hotel_addressTEXTHotel property asset hotel addressAddress of the hotel. Read-only.
hotel_property_asset_hotel_nameTEXTHotel property asset hotel nameName of the hotel. Read-only.
hotel_property_asset_place_idTEXTHotel property asset place idPlace IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more.
hotel_property_asset_setTEXTHotel property asset setThe set of hotel properties for Performance Max for travel goals campaigns.
hotel_rate_rule_idTEXTHotel rate rule idHotel rate rule ID.
hotel_rate_typeTEXTHotel rate typeHotel rate type.
hotel_setting_hotel_center_idNUMERICHotel setting hotel center idThe linked Hotel Center account.
hotel_stateTEXTHotel stateHotel state.
hourTEXTHourHour of day as a number between 0 and 23, inclusive.
hour_of_dayNUMERICHour of dayHour of day as a number between 0 and 23, inclusive.
idTEXTIdThe ID of the campaign.
image_asset_auto_migration_doneBOOLEANImage asset auto migration doneTrue if feed based image has been migrated to asset based image.
image_asset_auto_migration_done_date_timeDATEImage asset auto migration done date timeTimestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format.
image_asset_file_sizeNUMERICImage asset file sizeFile size of the image asset in bytes.
image_asset_full_size_height_pixelsNUMERICImage asset full size height pixelsHeight of the image.
image_asset_full_size_urlTEXTImage asset full size urlA URL that returns the image with this height and width.
image_asset_full_size_width_pixelsNUMERICImage asset full size width pixelsWidth of the image.
image_asset_mime_typeTEXTImage asset mime typeMIME type of the image asset.
impressionsNUMERICImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
income_range_typeTEXTIncome range typeType of the income range.
integration_codeTEXTIntegration codeAn ID from external system. It is used by user list sellers to correlate IDs on their systems.
interaction_event_typesTEXTInteraction event typesThe types of payable and free interactions.
interaction_on_this_extensionBOOLEANInteraction on this extensionOnly used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.
interaction_rateNUMERICInteraction rateHow 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.
interaction_typesTEXTInteraction typesThe types of payable and free interactions.
interactionsNUMERICInteractionsThe 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.
invalid_click_ratePERCENTInvalid click rateThe percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
invalid_clicksNUMERICInvalid clicksNumber of clicks Google considers illegitimate and doesn't charge you for.
ip_block_ip_addressTEXTIp block ip addressThe IP address of this IP block.
is_budget_explicitly_sharedBOOLEANIs budget explicitly sharedSpecifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
is_negativeBOOLEANIs negativeWhether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
is_restrictTEXTIs restrictThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
keyword_ad_group_criterionTEXTKeyword ad group criterionThe AdGroupCriterion resource name.
keyword_criterion_idTEXTKeyword Criterion IDThe Criterion ID for a keyword
keyword_info_match_typeTEXTKeyword info match typeThe match type of the keyword.
keyword_info_textTEXTKeyword info textThe text of the keyword (at most 80 characters and 10 words).
keyword_match_typeTEXTKeyword match typeThe match type of the keyword.
keyword_textTEXTKeyword textThe text of the keyword (at most 80 characters and 10 words).
keyword_theme_free_form_keyword_themeTEXTKeyword theme free form keyword themeFree-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
keyword_theme_keyword_theme_constantTEXTKeyword theme keyword theme constantThe resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
keyword_view_resource_nameTEXTKeyword view resource nameThe resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}
label_idNUMERICLabel idID of the label. Read only.
label_nameTEXTLabel nameThe name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
label_resource_nameTEXTLabel resource nameName of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id}
label_statusTEXTLabel statusStatus of the label. Read only.
label_text_label_background_colorTEXTLabel text label background colorBackground color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
label_text_label_descriptionTEXTLabel text label descriptionA short description of the label. The length must be no more than 200 characters.
labelsTEXTLabelsThe resource names of labels attached to this campaign.
landing_page_view_resource_nameTEXTLanding page view resource nameThe resource name of the landing page view. Landing page view resource names have the form: customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}
language_criteria_idTEXTLanguage criteria idResource name of the language constant for the language of the product.
language_language_constantTEXTLanguage language constantThe language constant resource name.
launched_to_allBOOLEANLaunched to allTrue if the user interest is launched to all channels and locales.
lead_cost_of_goods_sold_microsNUMERICLead cost of goods sold microsLead 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.
lead_form_asset_background_image_assetTEXTLead form asset background image assetAsset resource name of the background image. The image dimensions must be exactly 1200x628.
lead_form_asset_business_nameTEXTLead form asset business nameRequired. The name of the business being advertised.
lead_form_asset_call_to_action_descriptionTEXTLead form asset call to action descriptionRequired. Text giving a clear value proposition of what users expect once they expand the form.
lead_form_asset_call_to_action_typeTEXTLead form asset call to action typeRequired. Pre-defined display text that encourages user to expand the form.
lead_form_asset_custom_disclosureTEXTLead form asset custom disclosureCustom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
lead_form_asset_custom_question_fieldsTEXTLead form asset custom question fieldsOrdered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form.
lead_form_asset_delivery_methodsTEXTLead form asset delivery methodsConfigured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
lead_form_asset_descriptionTEXTLead form asset descriptionRequired. Detailed description of the expanded form to describe what the form is asking for or facilitating.
lead_form_asset_desired_intentTEXTLead form asset desired intentChosen intent for the lead form, for example, more volume or more qualified.
lead_form_asset_fieldsTEXTLead form asset fieldsOrdered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions.
lead_form_asset_headlineTEXTLead form asset headlineRequired. Headline of the expanded form to describe what the form is asking for or facilitating.
lead_form_asset_post_submit_call_to_action_typeTEXTLead form asset post submit call to action typePre-defined display text that encourages user action after the form is submitted.
lead_form_asset_post_submit_descriptionTEXTLead form asset post submit descriptionDetailed description shown after form submission that describes how the advertiser will follow up with the user.
lead_form_asset_post_submit_headlineTEXTLead form asset post submit headlineHeadline of text shown after form submission that describes how the advertiser will follow up with the user.
lead_form_asset_privacy_policy_urlTEXTLead form asset privacy policy urlRequired. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
lead_gross_profit_microsNUMERICLead gross profit microsLead 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.
lead_revenue_microsNUMERICLead revenue microsLead 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.
lead_units_soldNUMERICLead units soldLead 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.
listing_group_case_value_activity_country_valueCOUNTRYListing group case value activity country valueString value of the activity country. The Geo Target Constant resource name.
listing_group_case_value_activity_id_valueTEXTListing group case value activity id valueString value of the activity ID.
listing_group_case_value_activity_rating_valueNUMERICListing group case value activity rating valueLong value of the activity rating.
listing_group_case_value_hotel_city_city_criterionCITYListing group case value hotel city city criterionThe Geo Target Constant resource name.
listing_group_case_value_hotel_class_valueNUMERICListing group case value hotel class valueLong value of the hotel class.
listing_group_case_value_hotel_country_region_country_region_criterionREGIONListing group case value hotel country region country region criterionThe Geo Target Constant resource name.
listing_group_case_value_hotel_id_valueTEXTListing group case value hotel id valueString value of the hotel ID.
listing_group_case_value_hotel_state_state_criterionTEXTListing group case value hotel state state criterionThe Geo Target Constant resource name.
listing_group_case_value_product_brand_valueTEXTListing group case value product brand valueString value of the product brand.
listing_group_case_value_product_category_category_idNUMERICListing group case value product category category idID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
listing_group_case_value_product_category_levelTEXTListing group case value product category levelLevel of the product category.
listing_group_case_value_product_channel_channelTEXTListing group case value product channel channelValue of the locality.
listing_group_case_value_product_channel_exclusivity_channel_exclusivityTEXTListing group case value product channel exclusivity channel exclusivityValue of the availability.
listing_group_case_value_product_condition_conditionTEXTListing group case value product condition conditionValue of the condition.
listing_group_case_value_product_custom_attribute_indexTEXTListing group case value product custom attribute indexIndicates the index of the custom attribute.
listing_group_case_value_product_custom_attribute_valueTEXTListing group case value product custom attribute valueString value of the product custom attribute.
listing_group_case_value_product_item_id_valueTEXTListing group case value product item id valueValue of the id.
listing_group_case_value_product_type_levelTEXTListing group case value product type levelLevel of the type.
listing_group_case_value_product_type_valueTEXTListing group case value product type valueValue of the type.
listing_group_parent_ad_group_criterionTEXTListing group parent ad group criterionResource name of ad group criterion which is the parent listing group subdivision. Null for the root group.
listing_group_pathTEXTListing group pathThe path of dimensions defining this listing group.
listing_group_typeTEXTListing group typeType of the listing group.
listing_scope_dimensionsTEXTListing scope dimensionsScope of the campaign criterion.
listing_scope_dimensions_activity_country_valueCOUNTRYListing scope dimensions activity country valueString value of the activity country. The Geo Target Constant resource name.
listing_scope_dimensions_hotel_city_city_criterionCITYListing scope dimensions hotel city city criterionThe Geo Target Constant resource name.
listing_scope_dimensions_hotel_country_region_country_region_criterionREGIONListing scope dimensions hotel country region country region criterionThe Geo Target Constant resource name.
listing_scope_dimensions_hotel_state_state_criterionTEXTListing scope dimensions hotel state state criterionThe Geo Target Constant resource name.
listing_typeTEXTListing typeListing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns.
local_campaign_setting_location_source_typeTEXTLocal campaign setting location source typeThe location source type for this local campaign.
local_service_id_service_idTEXTLocal service id service idThe criterion resource name.
local_services_campaign_settings_category_bidsTEXTLocal services campaign settings category bidsCategorical level bids associated with MANUAL_CPA bidding strategy.
local_services_settings_granular_insurance_statusesTEXTLocal services settings granular insurance statusesA read-only list of geo vertical level insurance statuses.
local_services_settings_granular_license_statusesTEXTLocal services settings granular license statusesA read-only list of geo vertical level license statuses.
location_asset_auto_migration_doneBOOLEANLocation asset auto migration doneTrue if feed based location has been migrated to asset based location.
location_asset_auto_migration_done_date_timeDATELocation asset auto migration done date timeTimestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format.
location_asset_business_profile_locationsTEXTLocation asset business profile locationsThe list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
location_asset_location_ownership_typeTEXTLocation asset location ownership typeThe type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
location_asset_place_idTEXTLocation asset place idPlace IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
location_geo_target_constantTEXTLocation geo target constantThe geo target constant resource name.
location_groupTEXTLocation groupLocation Group
location_group_enable_customer_level_location_asset_setBOOLEANLocation group enable customer level location asset setDenotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
location_group_feedTEXTLocation group feedFeed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations.
location_group_geo_target_constantsTEXTLocation group geo target constantsGeo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. Cannot be set with AssetSet fields.
location_typeTEXTLocation typeType of the geo targeting of the campaign.
logical_user_list_rulesTEXTLogical user list rulesLogical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list.
lookalike_user_list_country_codesTEXTLookalike user list country codesCountries targeted by the Lookalike. Two-letter country code as defined by ISO-3166
lookalike_user_list_expansion_levelTEXTLookalike user list expansion levelExpansion level, reflecting the size of the lookalike audience
lookalike_user_list_seed_user_list_idsNUMERICLookalike user list seed user list idsSeed UserList ID from which this list is derived, provided by user.
managerBOOLEANManagerWhether the customer is a manager.
manual_cpaTEXTManual cpaStandard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
manual_cpc_enhanced_cpc_enabledBOOLEANManual cpc enhanced cpc enabledWhether bids are to be enhanced based on conversion optimizer data.
manual_cpmTEXTManual cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
manual_cpvTEXTManual cpvA bidding strategy that pays a configurable amount per video view.
match_rate_percentageNUMERICMatch rate percentageIndicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only.
maximize_conversion_value_cpc_bid_ceiling_microsNUMERICMaximize conversion value cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
maximize_conversion_value_cpc_bid_floor_microsNUMERICMaximize conversion value cpc bid floor microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
maximize_conversion_value_target_roasNUMERICMaximize conversion value target roasThe 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.
maximize_conversions_cpc_bid_ceiling_microsNUMERICMaximize conversions cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
maximize_conversions_cpc_bid_floor_microsNUMERICMaximize conversions cpc bid floor microsMinimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
maximize_conversions_target_cpa_microsNUMERICMaximize conversions target cpa microsThe target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
membership_life_spanNUMERICMembership life spanNumber of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. This field is ignored for logical_user_list and rule_based_user_list types. Membership to lists of these types depends on the rules defined by the lists.
membership_statusTEXTMembership statusMembership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to.
merchant_idNUMERICMerchant idMerchant ID of the product.
message_chat_rateNUMERICMessage chat rateNumber 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.
message_chatsNUMERICMessage chatsNumber of message chats initiated for Click To Message impressions that were message tracking eligible.
message_impressionsNUMERICMessage impressionsNumber of Click To Message impressions that were message tracking eligible.
metroTEXTGeo target metro areaGeo target metro area.
mobile_app_asset_app_idTEXTMobile app asset app idRequired. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
mobile_app_asset_app_storeTEXTMobile app asset app storeRequired. The application store that distributes this specific app.
mobile_app_asset_end_dateDATEMobile app asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
TEXTMobile app asset link textRequired. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive.
mobile_app_asset_start_dateDATEMobile app asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
mobile_app_category_mobile_app_category_constantTEXTMobile app category mobile app category constantThe mobile app category constant resource name.
mobile_application_app_idTEXTMobile application app idA string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations.
mobile_application_nameTEXTMobile application nameName of this mobile application.
mobile_device_mobile_device_constantTEXTMobile device mobile device constantThe mobile device constant resource name.
mobile_friendly_clicks_percentageNUMERICMobile friendly clicks percentageThe percentage of mobile clicks that go to a mobile-friendly page.
monthTEXTMonthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
month_of_yearTEXTMonth of yearMonth of the year, for example, January.
nameTEXTNameThe 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.
negativeBOOLEANNegativeWhether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
network_settings_target_content_networkBOOLEANNetwork settings target content networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
BOOLEANNetwork settings target google searchWhether ads will be served with google.com search results.
network_settings_target_google_tv_networkBOOLEANNetwork settings target google tv networkWhether ads will be served on the Google TV network.
network_settings_target_partner_search_networkBOOLEANNetwork settings target partner search networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
network_settings_target_search_networkBOOLEANNetwork settings target search networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
network_settings_target_youtubeBOOLEANNetwork settings target youtubeWhether ads will be served on YouTube.
new_customer_lifetime_valueNUMERICNew customer lifetime valueNew 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.
new_versus_returning_customersTEXTNew versus returning customersThis 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.
non_removed_campaign_countNUMERICNon removed campaign countThe number of non-removed campaigns attached to this bidding strategy. This field is read-only.
num_offline_impressionsNUMERICNum offline impressionsNumber of offline phone impressions.
num_offline_interactionsNUMERICNum offline interactionsNumber of offline phone calls.
offer_idTEXTOffer idItem ID of the product.
offline_interaction_rateNUMERICOffline interaction rateNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
operating_system_version_operating_system_version_constantTEXTOperating system version operating system version constantThe operating system version constant resource name.
optimization_goal_setting_optimization_goal_typesTEXTOptimization goal setting optimization goal typesThe list of optimization goal types.
optimization_scoreNUMERICOptimization scoreOptimization 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.
optimization_score_upliftNUMERICOptimization score upliftTotal optimization score uplift of all recommendations.
optimization_score_urlTEXTOptimization score urlURL 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.
optimization_score_weightNUMERICOptimization score weightOptimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
optimized_targeting_enabledBOOLEANOptimized targeting enabledTrue if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.
ordersNUMERICOrdersOrders 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.
owner_customer_idNUMERICOwner customer idThe ID of the Customer which owns the bidding strategy.
owner_descriptive_nameTEXTOwner descriptive namedescriptive_name of the Customer which owns the bidding strategy.
page_feed_asset_labelsTEXTPage feed asset labelsLabels used to group the page urls.
page_feed_asset_page_urlTEXTPage feed asset page urlRequired. The webpage that advertisers want to target.
parental_status_typeTEXTParental status typeType of the parental status.
partner_hotel_idTEXTPartner hotel idPartner hotel ID.
path1TEXTPath1First part of text that may appear appended to the url displayed in the ad.
path2TEXTPath2Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
pay_per_conversion_eligibility_failure_reasonsTEXTPay per conversion eligibility failure reasonsReasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
payment_modeTEXTPayment modePayment mode for the campaign.
percent_cpc_bid_microsNUMERICPercent cpc bid microsThe percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].
percent_cpc_cpc_bid_ceiling_microsNUMERICPercent cpc cpc bid ceiling microsMaximum 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.
percent_cpc_enhanced_cpc_enabledBOOLEANPercent cpc enhanced cpc enabledAdjusts 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.
percent_new_visitorsNUMERICPercent new visitorsPercentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
performance_labelTEXTPerformance labelPerformance of an asset linkage.
performance_max_upgrade_performance_max_campaignTEXTPerformance max upgrade performance max campaignIndicates which Performance Max campaign the campaign is upgraded to.
performance_max_upgrade_pre_upgrade_campaignTEXTPerformance max upgrade pre upgrade campaignIndicates legacy campaign upgraded to Performance Max.
performance_max_upgrade_statusTEXTPerformance max upgrade statusThe upgrade status of a campaign requested to be upgraded to Performance Max.
periodTEXTPeriodPeriod over which to spend the budget. Defaults to DAILY if not specified.
phone_callsNUMERICPhone callsNumber of offline phone calls.
phone_impressionsNUMERICPhone impressionsNumber of offline phone impressions.
phone_through_rateNUMERICPhone through rateNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
pinned_fieldTEXTPinned fieldPinned field.
placeholder_typeTEXTPlaceholder typePlaceholder type. This is only used with feed item metrics.
placementTEXTPlacementThe automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID.
placement_typeTEXTPlacement typeType of the placement, for example, Website, YouTube Video, and Mobile Application.
placement_urlTEXTPlacement urlURL of the placement. For example, "http://www.domain.com".
policy_summaryTEXTPolicy summaryPolicy information for the ad group ad asset.
policy_summary_approval_statusTEXTPolicy summary approval statusThe overall approval status of this ad, calculated based on the status of its individual policy topic entries.
policy_summary_policy_topic_entriesTEXTPolicy summary policy topic entriesThe list of policy findings for this ad.
policy_summary_review_statusTEXTPolicy summary review statusWhere in the review process this ad is.
position_estimates_estimated_add_clicks_at_first_position_cpcNUMERICPosition estimates estimated add clicks at first position cpcEstimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros.
position_estimates_estimated_add_cost_at_first_position_cpcNUMERICPosition estimates estimated add cost at first position cpcEstimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.
position_estimates_first_page_cpc_microsNUMERICPosition estimates first page cpc microsThe estimate of the CPC bid required for ad to be shown on first page of search results.
position_estimates_first_position_cpc_microsNUMERICPosition estimates first position cpc microsThe estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
position_estimates_top_of_page_cpc_microsNUMERICPosition estimates top of page cpc microsThe estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
post_click_quality_scoreTEXTPost click quality scoreThe quality score of the landing page.
postal_codeTEXTGeo target postal code numbersGeo target postal code.
price_asset_language_codeTEXTPrice asset language codeRequired. The language of the price asset. Represented as BCP 47 language tag.
price_asset_price_offeringsTEXTPrice asset price offeringsThe price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive.
price_asset_price_qualifierTEXTPrice asset price qualifierThe price qualifier of the price asset.
price_asset_typeTEXTPrice asset typeRequired. The type of the price asset.
primary_statusTEXTPrimary statusThe 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.
primary_status_reasonsTEXTPrimary status reasonsThe 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.
product_aggregator_idNUMERICProduct aggregator idAggregator ID of the product.
product_brandTEXTProduct brandBrand of the product.
product_category_level1TEXTProduct category level1Category (level 1) of the product.
product_category_level2TEXTProduct category level2Category (level 2) of the product.
product_category_level3TEXTProduct category level3Category (level 3) of the product.
product_category_level4TEXTProduct category level4Category (level 4) of the product.
product_category_level5TEXTProduct category level5Category (level 5) of the product.
product_channelTEXTProduct channelChannel of the product.
product_channel_exclusivityTEXTProduct channel exclusivityChannel exclusivity of the product.
product_conditionTEXTProduct conditionCondition of the product.
product_countryCOUNTRYProduct countryResource name of the geo target constant for the country of sale of the product.
product_custom_attribute0TEXTProduct custom attribute0Custom attribute 0 of the product.
product_custom_attribute1TEXTProduct custom attribute1Custom attribute 1 of the product.
product_custom_attribute2TEXTProduct custom attribute2Custom attribute 2 of the product.
product_custom_attribute3TEXTProduct custom attribute3Custom attribute 3 of the product.
product_custom_attribute4TEXTProduct custom attribute4Custom attribute 4 of the product.
product_feed_labelTEXTProduct feed labelFeed label of the product.
product_item_idTEXTProduct item idItem ID of the product.
product_languageTEXTProduct languageResource name of the language constant for the language of the product.
product_merchant_idNUMERICProduct merchant idMerchant ID of the product.
product_store_idTEXTProduct store idStore ID of the product.
product_titleTEXTProduct titleTitle of the product.
product_type_l1TEXTProduct type l1Type (level 1) of the product.
product_type_l2TEXTProduct type l2Type (level 2) of the product.
product_type_l3TEXTProduct type l3Type (level 3) of the product.
product_type_l4TEXTProduct type l4Type (level 4) of the product.
product_type_l5TEXTProduct type l5Type (level 5) of the product.
promotion_asset_ad_schedule_targetsTEXTPromotion asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
promotion_asset_discount_modifierTEXTPromotion asset discount modifierA modifier for qualification of the discount.
promotion_asset_end_dateDATEPromotion asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
promotion_asset_language_codeTEXTPromotion asset language codeThe language of the promotion. Represented as BCP 47 language tag.
promotion_asset_money_amount_off_amount_microsNUMERICPromotion asset money amount off amount microsAmount in micros. One million is equivalent to one unit.
promotion_asset_money_amount_off_currency_codeTEXTPromotion asset money amount off currency codeThree-character ISO 4217 currency code.
promotion_asset_occasionTEXTPromotion asset occasionThe occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.
promotion_asset_orders_over_amount_amount_microsNUMERICPromotion asset orders over amount amount microsAmount in micros. One million is equivalent to one unit.
promotion_asset_orders_over_amount_currency_codeTEXTPromotion asset orders over amount currency codeThree-character ISO 4217 currency code.
promotion_asset_percent_offNUMERICPromotion asset percent offPercentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
promotion_asset_promotion_codeTEXTPromotion asset promotion codeA code the user should use in order to be eligible for the promotion.
promotion_asset_promotion_targetTEXTPromotion asset promotion targetRequired. A freeform description of what the promotion is targeting.
promotion_asset_redemption_end_dateDATEPromotion asset redemption end dateLast date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
promotion_asset_redemption_start_dateDATEPromotion asset redemption start dateStart date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
promotion_asset_start_dateDATEPromotion asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
proximity_address_city_nameCITYProximity address city nameName of the city.
proximity_address_country_codeCOUNTRYProximity address country codeCountry code.
proximity_address_postal_codeTEXTProximity address postal codePostal code.
proximity_address_province_codeTEXTProximity address province codeProvince or state code.
proximity_address_province_nameTEXTProximity address province nameProvince or state name.
proximity_address_street_addressTEXTProximity address street addressStreet address line 1.
proximity_geo_point_latitude_in_micro_degreesNUMERICProximity geo point latitude in micro degreesMicro degrees for the latitude.
proximity_geo_point_longitude_in_micro_degreesNUMERICProximity geo point longitude in micro degreesMicro degrees for the longitude.
proximity_radiusNUMERICProximity radiusThe radius of the proximity.
proximity_radius_unitsTEXTProximity radius unitsThe unit of measurement of the radius. Default is KILOMETERS.
publisher_organic_clicksNUMERICPublisher organic clicksClicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity
publisher_purchased_clicksNUMERICPublisher purchased clicksClicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity
publisher_unknown_clicksNUMERICPublisher unknown clicksClicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic"
quality_info_creative_quality_scoreTEXTQuality info creative quality scoreThe performance of the ad compared to other advertisers.
quality_info_post_click_quality_scoreTEXTQuality info post click quality scoreThe quality score of the landing page.
quality_info_quality_scoreNUMERICQuality info quality scoreThe quality score. This field may not be populated if Google does not have enough information to determine a value.
quality_info_search_predicted_ctrTEXTQuality info search predicted ctrThe click-through rate compared to that of other advertisers.
quality_scoreNUMERICQuality scoreThe quality score. This field may not be populated if Google does not have enough information to determine a value.
quarterTEXTQuarterQuarter 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.
read_onlyBOOLEANRead onlyAn option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only.
real_time_bidding_setting_opt_inBOOLEANReal time bidding setting opt inWhether the campaign is opted in to real-time bidding.
recommendation_typeTEXTRecommendation typeRecommendation type.
NUMERICRecommended budget amountThe recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
NUMERICRecommended budget amount microsThe recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
NUMERICRecommended budget estimated change weekly clicksThe estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
NUMERICRecommended budget estimated change weekly cost microsThe estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
NUMERICRecommended budget estimated change weekly interactionsThe estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
NUMERICRecommended budget estimated change weekly viewsThe estimated change in weekly views if the recommended budget is applied. This field is read-only.
reference_countNUMERICReference countThe number of campaigns actively using the budget. This field is read-only.
regionREGIONGeo target regionGeo target region name.
relative_ctrNUMERICRelative ctrYour 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.
remarketing_setting_google_global_site_tagTEXTRemarketing setting google global site tagThe Google tag.
resource_nameTEXTResource nameThe resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
revenue_microsNUMERICRevenue microsRevenue 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.
roasPERCENTROASReturn on Spend
rule_based_user_list_flexible_rule_user_list_exclusive_operandsTEXTRule based user list flexible rule user list exclusive operandsRules representing users that should be excluded from the user list. These are located on the right side of the AND_NOT operator, and joined together by OR.
rule_based_user_list_flexible_rule_user_list_inclusive_operandsTEXTRule based user list flexible rule user list inclusive operandsRules representing users that should be included in the user list. These are located on the left side of the AND_NOT operator, and joined together by either AND/OR as specified by the inclusive_rule_operator.
rule_based_user_list_flexible_rule_user_list_inclusive_rule_operatorTEXTRule based user list flexible rule user list inclusive rule operatorOperator that defines how the inclusive operands are combined.
rule_based_user_list_prepopulation_statusTEXTRule based user list prepopulation statusThe status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails.
scopeTEXTScopeDefines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP.
search_absolute_top_impression_shareNUMERICSearch absolute top impression shareThe 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.
search_budget_lost_absolute_top_impression_shareNUMERICSearch budget lost absolute top impression shareThe 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.
search_budget_lost_impression_shareNUMERICSearch budget lost impression shareThe 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.
search_budget_lost_top_impression_shareNUMERICSearch budget lost top impression shareThe 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.
search_click_shareNUMERICSearch click shareThe 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.
search_engine_results_page_typeTEXTSearch engine results page typeType of the search engine results page.
search_exact_match_impression_shareNUMERICSearch exact match impression shareThe 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.
search_impression_shareNUMERICSearch impression shareThe 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.
search_predicted_ctrTEXTSearch predicted ctrThe click-through rate compared to that of other advertisers.
search_rank_lost_absolute_top_impression_shareNUMERICSearch rank lost absolute top impression shareThe 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.
search_rank_lost_impression_shareNUMERICSearch rank lost impression shareThe 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.
search_rank_lost_top_impression_shareNUMERICSearch rank lost top impression shareThe 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.
search_termTEXTSearch termThe search term.
search_term_match_typeTEXTSearch term match typeMatch type of the keyword that triggered the ad, including variants.
search_term_view_ad_groupTEXTSearch term view ad groupThe ad group the search term served in.
search_term_view_ad_group_idTEXTSearch Term View Ad Group IDThe Ad Group ID for a search term
search_term_view_campaign_idTEXTSearch Term View Campaign IDThe Campaign ID for a search term
search_term_view_keyword_idTEXTSearch Term View Keyword IDThe Keyword ID for a search term
search_term_view_resource_nameTEXTSearch term view resource nameThe resource name of the search term view. Search term view resource names have the form: customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}
search_term_view_search_termTEXTSearch term view search termThe search term.
search_term_view_statusTEXTSearch term view statusIndicates whether the search term is currently one of your targeted or excluded keywords.
search_top_impression_shareNUMERICSearch top impression shareThe 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.
selective_optimization_conversion_actionsTEXTSelective optimization conversion actionsThe selected set of conversion actions for optimizing this campaign.
serving_statusTEXTServing statusThe ad serving status of the campaign.
shopping_performance_view_resource_nameTEXTShopping performance view resource nameThe resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView
shopping_setting_advertising_partner_idsNUMERICShopping setting advertising partner idsThe ads account IDs of advertising partners cooperating within the campaign.
shopping_setting_campaign_priorityNUMERICShopping setting campaign priorityPriority 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.
shopping_setting_enable_localBOOLEANShopping setting enable localWhether to include local products.
shopping_setting_feed_labelTEXTShopping setting feed labelFeed 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.
shopping_setting_merchant_idNUMERICShopping setting merchant idID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
shopping_setting_use_vehicle_inventoryBOOLEANShopping setting use vehicle inventoryWhether 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.
similar_user_list_seed_user_listTEXTSimilar user list seed user listSeed UserList from which this list is derived.
TEXTSitelink asset ad schedule targetsList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
TEXTSitelink asset description1First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
TEXTSitelink asset description2Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
DATESitelink asset end dateLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
TEXTSitelink asset link textRequired. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
DATESitelink asset start dateStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
size_for_displayNUMERICSize for displayEstimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only.
NUMERICSize for searchEstimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only.
size_range_for_displayTEXTSize range for displaySize range in terms of number of users of the UserList, on the Google Display Network. This field is read-only.
TEXTSize range for searchSize range in terms of number of users of the UserList, for Search ads. This field is read-only.
sk_ad_network_ad_event_typeTEXTSk ad network ad event typeiOS Store Kit Ad Network ad event type.
sk_ad_network_attribution_creditTEXTSk ad network attribution creditiOS Store Kit Ad Network attribution credit
sk_ad_network_coarse_conversion_valueTEXTSk ad network coarse conversion valueiOS Store Kit Ad Network coarse conversion value.
sk_ad_network_conversion_valueNUMERICSk ad network conversion valueiOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign.
sk_ad_network_installsNUMERICSk ad network installsThe number of iOS Store Kit Ad Network conversions.
sk_ad_network_postback_sequence_indexNUMERICSk ad network postback sequence indexiOS Store Kit Ad Network postback sequence index.
sk_ad_network_source_app_sk_ad_network_source_app_idTEXTSk ad network source app sk ad network source app idApp id where the ad that drove the iOS Store Kit Ad Network install was shown.
sk_ad_network_source_domainTEXTSk ad network source domainWebsite 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.
sk_ad_network_source_typeTEXTSk ad network source typeThe 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.
sk_ad_network_total_conversionsNUMERICSk ad network total conversionsThe total number of iOS Store Kit Ad Network conversions.
sk_ad_network_user_typeTEXTSk ad network user typeiOS Store Kit Ad Network user type.
slotTEXTSlotPosition of the ad.
sourceTEXTSourceThe name of the connector ("google_ads")
speed_scoreNUMERICSpeed scoreA 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.
spendNUMERICSpendThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
start_dateDATEStart dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
stateTEXTGeo target state name.Geo target state name.
statusTEXTStatusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
store_idTEXTStore idStore ID of the product.
structured_snippet_asset_headerTEXTStructured snippet asset headerRequired. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
structured_snippet_asset_valuesTEXTStructured snippet asset valuesRequired. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
system_serving_statusTEXTSystem serving statusServing status of the criterion.
target_cpaNUMERICTarget cpaThe effective target CPA (cost-per-acquisition). This field is read-only.
target_cpa_bid_sourceTEXTTarget cpa bid sourceSource of the effective target CPA. This field is read-only.
target_cpa_cpc_bid_ceiling_microsNUMERICTarget cpa cpc bid ceiling microsMaximum 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.
target_cpa_cpc_bid_floor_microsNUMERICTarget cpa cpc bid floor microsMinimum 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.
target_cpa_microsNUMERICTarget cpa microsThe target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored.
target_cpa_target_cpa_microsNUMERICTarget cpa target cpa microsAverage CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
target_cpm_microsNUMERICTarget cpm microsAverage amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
target_cpm_target_frequency_goal_target_countNUMERICTarget cpm target frequency goal target countTarget Frequency count representing how many times you want to reach a single user.
target_cpm_target_frequency_goal_time_unitTEXTTarget cpm target frequency goal time unitTime window expressing the period over which you want to reach the specified target_count.
target_impression_share_cpc_bid_ceiling_microsNUMERICTarget impression share cpc bid ceiling microsThe 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.
target_impression_share_locationTEXTTarget impression share locationThe targeted location on the search results page.
target_impression_share_location_fraction_microsNUMERICTarget impression share location fraction microsThe chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
target_roasNUMERICTarget roasThe target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
target_roas_cpc_bid_ceiling_microsNUMERICTarget roas cpc bid ceiling microsMaximum 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.
target_roas_cpc_bid_floor_microsNUMERICTarget roas cpc bid floor microsMinimum 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.
target_roas_target_roasNUMERICTarget roas target roasThe chosen revenue (based on conversion data) per unit of spend.
target_spend_cpc_bid_ceiling_microsNUMERICTarget spend cpc bid ceiling microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
target_spend_target_spend_microsNUMERICTarget spend target spend microsThe 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.
target_urlTEXTTarget urlURL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL.
targeting_locationBOOLEANTargeting locationIndicates whether location was targeted or not.
targeting_setting_target_restrictionsTEXTTargeting setting target restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
taxonomy_typeTEXTTaxonomy typeTaxonomy type of the user interest.
test_accountBOOLEANTest accountWhether the customer is a test account.
text_asset_textTEXTText asset textText content of the text asset.
text_label_background_colorTEXTText label background colorBackground color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
text_label_descriptionTEXTText label descriptionA short description of the label. The length must be no more than 200 characters.
time_zoneTEXTTime zoneThe local timezone ID of the customer.
titleTEXTTitleThe title of the video.
todayDATETodayToday's date
top_impression_percentageNUMERICTop impression percentageThe percent of your ad impressions that are shown adjacent to the top organic search results.
top_of_page_cpcNUMERICTop of page cpcThe estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
topic_pathTEXTTopic pathThe category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category.
topic_topic_constantTEXTTopic topic constantThe Topic Constant resource name.
total_amountNUMERICTotal amountThe lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
total_amount_microsNUMERICTotal amount microsThe lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
totalcostNUMERICTotal CostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
tracking_setting_tracking_urlTEXTTracking setting tracking urlThe url used for dynamic tracking.
tracking_url_templateTEXTTracking url templateThe URL template for constructing a tracking URL.
transactionrevenueNUMERICTransactionrevenueThe value of all conversions.
transactionsNUMERICTransactionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
travel_campaign_settings_travel_account_idNUMERICTravel campaign settings travel account idThe Travel account ID associated with the Travel campaign.
typeTEXTTypeThe type of the ad group.
unique_usersNUMERICUnique usersThe 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.
units_soldNUMERICUnits soldUnits 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.
url_custom_parametersTEXTUrl custom parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
url_expansion_opt_outBOOLEANUrl expansion opt outRepresents 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.
user_interest_availabilitiesTEXTUser interest availabilitiesAvailability information of the user interest.
user_interest_idNUMERICUser interest idThe ID of the user interest.
user_interest_launched_to_allBOOLEANUser interest launched to allTrue if the user interest is launched to all channels and locales.
user_interest_nameTEXTUser interest nameThe name of the user interest.
user_interest_parentTEXTUser interest parentThe parent of the user interest.
user_interest_resource_nameTEXTUser interest resource nameThe resource name of the user interest. User interest resource names have the form: customers/{customer_id}/userInterests/{user_interest_id}
user_interest_taxonomy_typeTEXTUser interest taxonomy typeTaxonomy type of the user interest.
user_interest_user_interest_categoryTEXTUser interest user interest categoryThe UserInterest resource name.
user_interest_user_interest_idNUMERICUser interest user interest idThe ID of the user interest.
user_interest_user_interest_parentTEXTUser interest user interest parentThe parent of the user interest.
user_list_access_reasonTEXTUser list access reasonIndicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only.
user_list_account_user_list_statusTEXTUser list account user list statusIndicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED.
user_list_basic_user_list_actionsTEXTUser list basic user list actionsActions associated with this user list.
user_list_closing_reasonTEXTUser list closing reasonIndicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open.
user_list_crm_based_user_list_app_idTEXTUser list crm based user list app idA string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs.
user_list_crm_based_user_list_data_source_typeTEXTUser list crm based user list data source typeData source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists.
user_list_crm_based_user_list_upload_key_typeTEXTUser list crm based user list upload key typeMatching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation.
user_list_descriptionTEXTUser list descriptionDescription of this user list.
user_list_eligible_for_displayBOOLEANUser list eligible for displayIndicates this user list is eligible for Google Display Network. This field is read-only.
BOOLEANUser list eligible for searchIndicates if this user list is eligible for Google Search Network.
user_list_idNUMERICUser list idId of the user list.
user_list_integration_codeTEXTUser list integration codeAn ID from external system. It is used by user list sellers to correlate IDs on their systems.
user_list_logical_user_list_rulesTEXTUser list logical user list rulesLogical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list.
user_list_lookalike_user_list_country_codesTEXTUser list lookalike user list country codesCountries targeted by the Lookalike. Two-letter country code as defined by ISO-3166
user_list_lookalike_user_list_expansion_levelTEXTUser list lookalike user list expansion levelExpansion level, reflecting the size of the lookalike audience
user_list_lookalike_user_list_seed_user_list_idsNUMERICUser list lookalike user list seed user list idsSeed UserList ID from which this list is derived, provided by user.
user_list_match_rate_percentageNUMERICUser list match rate percentageIndicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only.
user_list_membership_life_spanNUMERICUser list membership life spanNumber of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. This field is ignored for logical_user_list and rule_based_user_list types. Membership to lists of these types depends on the rules defined by the lists.
user_list_membership_statusTEXTUser list membership statusMembership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to.
user_list_nameTEXTUser list nameName of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED)
user_list_read_onlyBOOLEANUser list read onlyAn option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only.
user_list_resource_nameTEXTUser list resource nameThe resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id}
user_list_rule_based_user_list_flexible_rule_user_list_exclusive_operandsTEXTUser list rule based user list flexible rule user list exclusive operandsRules representing users that should be excluded from the user list. These are located on the right side of the AND_NOT operator, and joined together by OR.
user_list_rule_based_user_list_flexible_rule_user_list_inclusive_operandsTEXTUser list rule based user list flexible rule user list inclusive operandsRules representing users that should be included in the user list. These are located on the left side of the AND_NOT operator, and joined together by either AND/OR as specified by the inclusive_rule_operator.
user_list_rule_based_user_list_flexible_rule_user_list_inclusive_rule_operatorTEXTUser list rule based user list flexible rule user list inclusive rule operatorOperator that defines how the inclusive operands are combined.
user_list_rule_based_user_list_prepopulation_statusTEXTUser list rule based user list prepopulation statusThe status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails.
user_list_similar_user_list_seed_user_listTEXTUser list similar user list seed user listSeed UserList from which this list is derived.
user_list_size_for_displayNUMERICUser list size for displayEstimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only.
NUMERICUser list size for searchEstimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only.
user_list_size_range_for_displayTEXTUser list size range for displaySize range in terms of number of users of the UserList, on the Google Display Network. This field is read-only.
TEXTUser list size range for searchSize range in terms of number of users of the UserList, for Search ads. This field is read-only.
user_list_typeTEXTUser list typeType of this list. This field is read-only.
user_list_user_listTEXTUser list user listThe User List resource name.
user_location_view_country_criterion_idCOUNTRYUser location view country criterion idCriterion Id for the country.
user_location_view_geo_target_countryCOUNTRYGeo target country (User Location View)The country of the user's actual physical location by targeted or not targeted location (User Location View).
user_location_view_targeting_locationBOOLEANUser location view targeting locationIndicates whether location was targeted or not.
valid_accelerated_mobile_pages_clicks_percentageNUMERICValid accelerated mobile pages clicks percentageThe percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page.
value_per_all_conversionNUMERICValue per all conversionThe value of all conversions divided by the number of all conversions.
value_per_all_conversionsNUMERICValue per all conversionsThe value of all conversions divided by the number of all conversions.
value_per_all_conversions_by_conversion_dateNUMERICValue per all conversions by conversion dateThe 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.
value_per_conversionNUMERICValue per conversionThe 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.
value_per_conversions_by_conversion_dateNUMERICValue per conversions by conversion dateThe 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.
value_per_current_model_attributed_conversionNUMERICValue per current model attributed conversionThe 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.
vanity_pharma_vanity_pharma_display_url_modeTEXTVanity pharma vanity pharma display url modeThe display mode for vanity pharma URLs.
vanity_pharma_vanity_pharma_textTEXTVanity pharma vanity pharma textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
vertical_idTEXTVertical idThe Topic Constant resource name.
video_brand_safety_suitabilityTEXTVideo brand safety suitability3-Tier Brand Safety setting for the campaign.
video_channel_idTEXTVideo channel idThe owner channel id of the video.
video_channel_nameTEXTVideo channel nameVideo channel name
video_durationNUMERICVideo durationThe duration of the video in milliseconds.
video_idTEXTVideo idThe ID of the video.
video_quartile100_rateNUMERICVideo quartile100 ratePercentage of impressions where the viewer watched all of your video.
video_quartile25_rateNUMERICVideo quartile25 ratePercentage of impressions where the viewer watched 25% of your video.
video_quartile50_rateNUMERICVideo quartile50 ratePercentage of impressions where the viewer watched 50% of your video.
video_quartile75_rateNUMERICVideo quartile75 ratePercentage of impressions where the viewer watched 75% of your video.
video_quartile_p100_rateNUMERICVideo quartile p100 ratePercentage of impressions where the viewer watched all of your video.
video_quartile_p25_rateNUMERICVideo quartile p25 ratePercentage of impressions where the viewer watched 25% of your video.
video_quartile_p50_rateNUMERICVideo quartile p50 ratePercentage of impressions where the viewer watched 50% of your video.
video_quartile_p75_rateNUMERICVideo quartile p75 ratePercentage of impressions where the viewer watched 75% of your video.
video_resource_nameTEXTVideo resource nameThe resource name of the video. Video resource names have the form: customers/{customer_id}/videos/{video_id}
video_titleTEXTVideo titleThe title of the video.
video_view_rateNUMERICVideo view rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
video_viewsNUMERICVideo viewsThe number of times your video ads were viewed.
view_through_conversionsNUMERICView through conversionsThe 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.
view_through_conversions_from_location_asset_click_to_callNUMERICView through conversions from location asset click to callNumber of call button clicks on any location surface after an impression. This measure is coming from Asset based location.
view_through_conversions_from_location_asset_directionsNUMERICView through conversions from location asset directionsNumber of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location.
view_through_conversions_from_location_asset_menuNUMERICView through conversions from location asset menuNumber of menu link clicks on any location surface after an impression. This measure is coming from Asset based location.
view_through_conversions_from_location_asset_orderNUMERICView through conversions from location asset orderNumber of order clicks on any location surface after an impression. This measure is coming from Asset based location.
view_through_conversions_from_location_asset_other_engagementNUMERICView through conversions from location asset other engagementNumber of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location.
view_through_conversions_from_location_asset_store_visitsNUMERICView through conversions from location asset store visitsEstimated number of visits to the store after an impression. This measure is coming from Asset based location.
view_through_conversions_from_location_asset_websiteNUMERICView through conversions from location asset websiteNumber of website URL clicks on any location surface after an impression. This measure is coming from Asset based location.
webpage_conditionsTEXTWebpage conditionsConditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
webpage_coverage_percentageNUMERICWebpage coverage percentageWebsite criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
webpage_criterion_nameTEXTWebpage criterion nameThe name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
webpage_sample_sample_urlsTEXTWebpage sample sample urlsWebpage sample urls
weekTEXTWeekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear, formatted as yyyy.
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20
youtube_channel_channel_idTEXTYoutube channel channel idThe YouTube uploader channel id or the channel code of a YouTube channel.
youtube_video_asset_youtube_video_idTEXTYoutube video asset youtube video idYouTube video id. This is the 11 character string value used in the YouTube video URL.
youtube_video_asset_youtube_video_titleTEXTYoutube video asset youtube video titleYouTube video title.
youtube_video_video_idTEXTYoutube video video idYouTube video id as it appears on the YouTube watch page.