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 percentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.
accessible_bidding_strategyTEXTAccessible bidding strategyOutput only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
accessible_bidding_strategy_idNUMERICAccessible bidding strategy idOutput only. The 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_cpaNUMERICAccessible bidding strategy maximize conversions target cpaOutput only. The 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 nameOutput only. The name of the bidding strategy.
accessible_bidding_strategy_owner_customer_idNUMERICAccessible bidding strategy owner customer idOutput only. The ID of the Customer which owns the bidding strategy.
accessible_bidding_strategy_owner_descriptive_nameTEXTAccessible bidding strategy owner descriptive nameOutput only. descriptive_name of the Customer which owns the bidding strategy.
accessible_bidding_strategy_target_cpa_target_cpa_microsNUMERICAccessible bidding strategy target cpa target cpa microsOutput only. Average 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 desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
accessible_bidding_strategy_target_roas_target_roasNUMERICAccessible bidding strategy target roas target roasOutput only. The desired 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 typeOutput only. The type of the bidding strategy.
account_currency_codeTEXTAccount currency codeImmutable. The 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 zoneImmutable. The local timezone ID of the customer.
action_itemsTEXTAction itemsOutput only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.".
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 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).
ad_added_by_google_adsBOOLEANAd added by google adsOutput only. Indicates 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_codeTEXTAd 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, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
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_gmail_ad_header_imageTEXTAd gmail ad header imageThe MediaFile resource name of the header image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must be between 3:1 and 5:1 (+-1%).
ad_gmail_ad_marketing_imageTEXTAd gmail ad marketing imageThe MediaFile resource name of the marketing image. Valid image types are GIF, JPEG and PNG. The image must either be landscape with a minimum size of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
ad_gmail_ad_marketing_image_descriptionTEXTAd gmail ad marketing image descriptionDescription of the marketing image.
ad_gmail_ad_marketing_image_display_call_to_action_textTEXTAd gmail ad marketing image display call to action textText for the display-call-to-action.
ad_gmail_ad_marketing_image_display_call_to_action_text_colorTEXTAd gmail ad marketing image display call to action text colorText color for the display-call-to-action in hexadecimal, e.g. #ffffff for white.
ad_gmail_ad_marketing_image_display_call_to_action_url_collection_idTEXTAd gmail ad marketing image display call to action url collection idIdentifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url.
ad_gmail_ad_marketing_image_headlineTEXTAd gmail ad marketing image headlineHeadline of the marketing image.
ad_gmail_ad_product_imagesTEXTAd gmail ad product imagesProduct images. Up to 15 images are supported.
ad_gmail_ad_product_images_product_imageTEXTAd gmail ad product images product imageThe MediaFile resource name of the product image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio must be 1:1 (+-1%).
ad_gmail_ad_product_videosTEXTAd gmail ad product videosProduct videos. Up to 7 videos are supported. At least one product video or a marketing image must be specified.
ad_gmail_ad_product_videos_product_videoTEXTAd gmail ad product videos product videoThe MediaFile resource name of a video which must be hosted on YouTube.
ad_gmail_ad_teaser_business_nameTEXTAd gmail ad teaser business nameBusiness name of the advertiser.
ad_gmail_ad_teaser_descriptionTEXTAd gmail ad teaser descriptionDescription of the teaser.
ad_gmail_ad_teaser_headlineTEXTAd gmail ad teaser headlineHeadline of the teaser.
ad_gmail_ad_teaser_logo_imageTEXTAd gmail ad teaser logo imageThe MediaFile resource name of the logo image. Valid image types are GIF, JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must be 1:1 (+-1%).
ad_groupTEXTAd groupImmutable. The ad group to which the ad belongs.
ad_group_ad_action_itemsTEXTAd group ad action itemsOutput only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.".
ad_group_ad_ad_added_by_google_adsBOOLEANAd group ad ad added by google adsOutput only. Indicates 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_codeTEXTAd 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, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
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_gmail_ad_header_imageTEXTAd group ad ad gmail ad header imageThe MediaFile resource name of the header image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must be between 3:1 and 5:1 (+-1%).
ad_group_ad_ad_gmail_ad_marketing_imageTEXTAd group ad ad gmail ad marketing imageThe MediaFile resource name of the marketing image. Valid image types are GIF, JPEG and PNG. The image must either be landscape with a minimum size of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
ad_group_ad_ad_gmail_ad_marketing_image_descriptionTEXTAd group ad ad gmail ad marketing image descriptionDescription of the marketing image.
ad_group_ad_ad_gmail_ad_marketing_image_display_call_to_action_textTEXTAd group ad ad gmail ad marketing image display call to action textText for the display-call-to-action.
ad_group_ad_ad_gmail_ad_marketing_image_display_call_to_action_text_colorTEXTAd group ad ad gmail ad marketing image display call to action text colorText color for the display-call-to-action in hexadecimal, e.g. #ffffff for white.
ad_group_ad_ad_gmail_ad_marketing_image_display_call_to_action_url_collection_idTEXTAd group ad ad gmail ad marketing image display call to action url collection idIdentifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url.
ad_group_ad_ad_gmail_ad_marketing_image_headlineTEXTAd group ad ad gmail ad marketing image headlineHeadline of the marketing image.
ad_group_ad_ad_gmail_ad_product_imagesTEXTAd group ad ad gmail ad product imagesProduct images. Up to 15 images are supported.
ad_group_ad_ad_gmail_ad_product_images_product_imageTEXTAd group ad ad gmail ad product images product imageThe MediaFile resource name of the product image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio must be 1:1 (+-1%).
ad_group_ad_ad_gmail_ad_product_videosTEXTAd group ad ad gmail ad product videosProduct videos. Up to 7 videos are supported. At least one product video or a marketing image must be specified.
ad_group_ad_ad_gmail_ad_product_videos_product_videoTEXTAd group ad ad gmail ad product videos product videoThe MediaFile resource name of a video which must be hosted on YouTube.
ad_group_ad_ad_gmail_ad_teaser_business_nameTEXTAd group ad ad gmail ad teaser business nameBusiness name of the advertiser.
ad_group_ad_ad_gmail_ad_teaser_descriptionTEXTAd group ad ad gmail ad teaser descriptionDescription of the teaser.
ad_group_ad_ad_gmail_ad_teaser_headlineTEXTAd group ad ad gmail ad teaser headlineHeadline of the teaser.
ad_group_ad_ad_gmail_ad_teaser_logo_imageTEXTAd group ad ad gmail ad teaser logo imageThe MediaFile resource name of the logo image. Valid image types are GIF, JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must be 1:1 (+-1%).
ad_group_ad_ad_groupTEXTAd group ad ad groupImmutable. The 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 idOutput only. The ID of the ad.
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_media_fileTEXTAd group ad ad image ad media fileThe MediaFile resource to use for the 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 adImmutable. Details 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, e.g. #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, e.g. #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. E.g. '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. Call-to-actions are optional and at most 5 can 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. Videos are optional and at most 20 can 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 nameImmutable. The 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_responsive_display_ad_accent_colorTEXTAd group ad ad responsive display ad accent colorThe accent color of the ad in hexadecimal, e.g. #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, e.g. #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. E.g. '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 square_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 for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified.
ad_group_ad_ad_smart_campaign_ad_headlinesTEXTAd group ad ad smart campaign ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified.
ad_group_ad_ad_strengthTEXTAd group ad ad strengthOutput only. Overall ad strength for this ad group ad.
ad_group_ad_ad_system_managed_resource_sourceTEXTAd group ad ad system managed resource sourceOutput only. If 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_typeTEXTAd group ad ad typeOutput only. The 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, please use url custom parameter operations.
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_discovery_description1TEXTAd group ad ad video ad discovery description1First text line for a TrueView video discovery ad.
ad_group_ad_ad_video_ad_discovery_description2TEXTAd group ad ad video ad discovery description2Second text line for a TrueView video discovery ad.
ad_group_ad_ad_video_ad_discovery_headlineTEXTAd group ad ad video ad discovery headlineThe headline of the ad.
ad_group_ad_ad_video_ad_discovery_thumbnailTEXTAd group ad ad video ad discovery 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_call_to_actionsTEXTAd group ad ad video responsive ad call to actionsList of text assets used for the button, e.g. 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, e.g. the "Call To Action" banner. 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_labelsTEXTAd group ad labelsOutput only. The resource names of labels attached to this ad group ad.
ad_group_ad_policy_summary_approval_statusTEXTAd group ad policy summary approval statusOutput only. The 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 entriesOutput only. The list of policy findings for this ad.
ad_group_ad_policy_summary_review_statusTEXTAd group ad policy summary review statusOutput only. Where in the review process this ad is.
ad_group_ad_statusTEXTAd group ad statusThe status of the ad.
ad_group_campaignTEXTAd group campaignImmutable. The campaign to which the ad group belongs.
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_explorer_auto_optimizer_setting_opt_inBOOLEANAd group explorer auto optimizer setting opt inIndicates whether the optimizer is turned on.
ad_group_idNUMERICAd group idOutput only. The ID of the ad group.
ad_group_labelsTEXTAd group labelsOutput only. The 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_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_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_targeting_setting_target_restrictionsTEXTAd group targeting setting target restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
ad_group_typeTEXTAd group typeImmutable. The type of the ad group.
ad_hotel_adTEXTAd hotel adDetails pertaining to a hotel ad.
ad_idTEXTAd idOutput only. The ID of the ad.
ad_image_ad_image_urlTEXTAd image ad image urlURL of the full size image.
ad_image_ad_media_fileTEXTAd image ad media fileThe MediaFile resource to use for the 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 adImmutable. Details 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, e.g. #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, e.g. #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. E.g. '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. Call-to-actions are optional and at most 5 can 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. Videos are optional and at most 20 can be specified.
ad_local_ad_videos_assetTEXTAd local ad videos assetThe Asset resource name of this video.
ad_nameTEXTAd nameImmutable. The 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_type2TEXTAd network type2Ad network type.
ad_responsive_display_ad_accent_colorTEXTAd responsive display ad accent colorThe accent color of the ad in hexadecimal, e.g. #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, e.g. #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. E.g. '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 square_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_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 for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified.
ad_smart_campaign_ad_headlinesTEXTAd smart campaign ad headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified.
ad_strengthTEXTAd strengthOutput only. Overall ad strength for this ad group ad.
ad_system_managed_resource_sourceTEXTAd system managed resource sourceOutput only. If 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_typeTEXTAd typeOutput only. The 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, please use url custom parameter operations.
ad_video_ad_bumper_companion_banner_assetTEXTAd video ad bumper companion banner assetThe Asset resource name of this image.
ad_video_ad_discovery_description1TEXTAd video ad discovery description1First text line for a TrueView video discovery ad.
ad_video_ad_discovery_description2TEXTAd video ad discovery description2Second text line for a TrueView video discovery ad.
ad_video_ad_discovery_headlineTEXTAd video ad discovery headlineThe headline of the ad.
ad_video_ad_discovery_thumbnailTEXTAd video ad discovery 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_call_to_actionsTEXTAd video responsive ad call to actionsList of text assets used for the button, e.g. 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, e.g. the "Call To Action" banner. 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 typeImmutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
advertising_channel_typeTEXTAdvertising channel typeImmutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
aggregator_idNUMERICAggregator idAggregator ID of the product.
all_conversion_rateNUMERICAll 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_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).
amountNUMERICAmountThe 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. Monthly spend is capped at 30.4 times this amount.
amount_microsNUMERICAmount microsThe 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. Monthly spend is capped at 30.4 times this amount.
app_campaign_setting_app_idTEXTApp campaign setting app idImmutable. A string that uniquely identifies a mobile application.
app_campaign_setting_app_storeTEXTApp campaign setting app storeImmutable. The 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.
auto_tagging_enabledBOOLEANAuto tagging enabledWhether auto-tagging is enabled for the customer.
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_page_viewsNUMERICAverage page viewsAverage number of pages viewed per session.
average_pageviewsNUMERICAverage pageviewsAverage number of pages viewed per session.
average_time_on_siteNUMERICAverage time on siteTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
base_ad_groupTEXTBase ad groupOutput only. For 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 idOutput only. For 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 campaignOutput only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only.
base_campaign_idTEXTBase campaign idOutput only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only.
benchmark_average_max_cpcNUMERICBenchmark average max cpcAn indication of how other advertisers are bidding on similar products.
bidding_strategyTEXTBidding strategyPortfolio bidding strategy used by campaign.
bidding_strategy_campaign_countNUMERICBidding strategy campaign countOutput only. The number of campaigns attached to this bidding strategy. This field is read-only.
bidding_strategy_currency_codeTEXTBidding strategy currency codeImmutable. The 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 codeOutput only. The 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_cpaNUMERICBidding strategy maximize conversions target cpaOutput only. The 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 countOutput only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
bidding_strategy_sourceTEXTBidding strategy sourceOutput only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only.
bidding_strategy_statusTEXTBidding strategy statusOutput only. The status of the bidding strategy. This field is read-only.
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 microsOutput only. Average 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 desired fraction of ads to be shown in the targeted location in micros. E.g. 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 roasOutput only. The desired 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 typeOutput only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only.
bounce_rateNUMERICBounce ratePercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
brandTEXTBrandBrand of the product.
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_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 via Google System.
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 strategyOutput only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
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 idImmutable. A string that uniquely identifies a mobile application.
campaign_app_campaign_setting_app_storeTEXTCampaign app campaign setting app storeImmutable. The 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_budgetTEXTCampaign budgetThe budget of the campaign.
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_idNUMERICCampaign budget idOutput only. The 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).
campaign_budget_recommended_budget_estimated_change_weekly_clicksNUMERICCampaign budget recommended budget estimated change weekly clicksOutput only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
campaign_budget_recommended_budget_estimated_change_weekly_cost_microsNUMERICCampaign budget recommended budget estimated change weekly cost microsOutput only. The 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.
campaign_budget_recommended_budget_estimated_change_weekly_interactionsNUMERICCampaign budget recommended budget estimated change weekly interactionsOutput only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
campaign_budget_recommended_budget_estimated_change_weekly_viewsNUMERICCampaign budget recommended budget estimated change weekly viewsOutput only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
campaign_budget_reference_countNUMERICCampaign budget reference countOutput only. The number of campaigns actively using the budget. This field is read-only.
campaign_budget_statusTEXTCampaign budget statusOutput only. The status of this campaign budget. This field is read-only.
campaign_budget_typeTEXTCampaign budget typeImmutable. The type of the campaign budget.
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 countOutput only. The number of campaigns attached to this bidding strategy. This field is read-only.
campaign_dynamic_search_ads_setting_domain_nameTEXTCampaign dynamic search ads setting domain nameRequired. The Internet domain name that this setting represents, e.g., "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, e.g., "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_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_hotel_setting_hotel_center_idNUMERICCampaign hotel setting hotel center idImmutable. The linked Hotel Center account.
campaign_idTEXTCampaign idOutput only. The ID of the campaign.
campaign_labelsTEXTCampaign labelsOutput only. The resource names of labels attached to this campaign.
campaign_local_campaign_setting_location_source_typeTEXTCampaign local campaign setting location source typeThe location source type for this local campaign.
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 cpvOutput only. A bidding strategy that pays a configurable amount per video view.
campaign_maximize_conversions_target_cpaNUMERICCampaign maximize conversions target cpaOutput only. The 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.
campaign_network_settings_target_google_searchBOOLEANCampaign network settings target google searchWhether ads will be served with google.com search results.
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_optimization_goal_setting_optimization_goal_typesTEXTCampaign optimization goal setting optimization goal typesThe list of optimization goal types.
campaign_optimization_scoreNUMERICCampaign optimization scoreOutput only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
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_real_time_bidding_setting_opt_inBOOLEANCampaign real time bidding setting opt inWhether the campaign is opted in to real-time bidding.
campaign_selective_optimization_conversion_actionsTEXTCampaign selective optimization conversion actionsThe selected set of conversion actions for optimizing this 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_merchant_idNUMERICCampaign shopping setting merchant idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
campaign_shopping_setting_sales_countryTEXTCampaign shopping setting sales countryImmutable. Sales country of products to include in the campaign. This field is required for Shopping campaigns. This field is immutable. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
campaign_statusTEXTCampaign statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
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 microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
campaign_target_cpmTEXTCampaign target cpmA bidding strategy that automatically optimizes cost per thousand impressions.
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 desired fraction of ads to be shown in the targeted location in micros. E.g. 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 roasOutput only. The desired 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 urlOutput only. The url used for dynamic tracking.
campaign_trial_typeTEXTCampaign trial typeOutput only. The type of campaign: normal, draft, or experiment.
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 suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
category_l1TEXTCategory l1Bidding category (level 1) of the product.
category_l2TEXTCategory l2Bidding category (level 2) of the product.
category_l3TEXTCategory l3Bidding category (level 3) of the product.
category_l4TEXTCategory l4Bidding category (level 4) of the product.
category_l5TEXTCategory l5Bidding category (level 5) of the product.
channelTEXTChannelChannel of the product.
channel_exclusivityTEXTChannel exclusivityChannel exclusivity of the product.
click_typeTEXTClick typeClick type.
clicksNUMERICClicksThe number of clicks.
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_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 vs. 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 (e.g. 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_rateNUMERICConversion 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_conversion_tracking_idNUMERICConversion tracking setting conversion tracking idOutput only. The conversion tracking id used for this account. This id is automatically assigned after any conversion tracking feature is used. If the customer doesn't use conversion tracking, this is 0. This field is read-only.
conversion_tracking_setting_cross_account_conversion_tracking_idNUMERICConversion tracking setting cross account conversion tracking idOutput only. The 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_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_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.
country_criteria_idTEXTCountry criteria idResource name of the geo target constant for the country of sale of the product.
cpc_bidNUMERICCpc bidThe maximum CPC (cost-per-click) bid.
cpc_bid_microsNUMERICCpc bid microsThe maximum CPC (cost-per-click) 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.
cpv_bidNUMERICCpv bidOutput only. The CPV (cost-per-view) bid.
cpv_bid_microsNUMERICCpv bid microsOutput only. The CPV (cost-per-view) bid.
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.
ctrNUMERICCtrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
currencyTEXTCurrencyImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
currency_codeTEXTCurrency codeImmutable. The 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_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.
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 via Google System.
customer_conversion_tracking_setting_conversion_tracking_idNUMERICCustomer conversion tracking setting conversion tracking idOutput only. The conversion tracking id used for this account. This id is automatically assigned after any conversion tracking feature is used. If the customer doesn't use conversion tracking, this is 0. This field is read-only.
customer_conversion_tracking_setting_cross_account_conversion_tracking_idNUMERICCustomer conversion tracking setting cross account conversion tracking idOutput only. The 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_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
customer_has_partners_badgeBOOLEANCustomer has partners badgeOutput only. Whether 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_managerBOOLEANCustomer managerOutput only. Whether the customer is a manager.
customer_optimization_scoreNUMERICCustomer optimization scoreOutput only. Optimization 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 weightOutput only. Optimization 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 reasonsOutput only. Reasons 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 tagOutput only. The Google global site tag.
customer_test_accountBOOLEANCustomer test accountOutput only. Whether the customer is a test account.
customer_tracking_url_templateTEXTCustomer tracking url templateThe URL template for constructing a tracking URL out of parameters.
dateDATEDateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
day_of_weekTEXTDay of weekDay of the week, e.g., 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.
descriptive_nameTEXTDescriptive nameOptional, non-unique descriptive name of the customer.
deviceTEXTDeviceDevice to which metrics apply.
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.
dynamic_search_ads_setting_domain_nameTEXTDynamic search ads setting domain nameRequired. The Internet domain name that this setting represents, e.g., "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, e.g., "en".
dynamic_search_ads_setting_use_supplied_urls_onlyBOOLEANDynamic search ads setting use supplied urls onlyWhether the campaign uses advertiser supplied URLs exclusively.
effective_currency_codeTEXTEffective currency codeOutput only. The 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_target_cpa_microsNUMERICEffective target cpa microsOutput only. The effective target CPA (cost-per-acquisition). This field is read-only.
effective_target_cpa_sourceTEXTEffective target cpa sourceOutput only. Source of the effective target CPA. This field is read-only.
effective_target_roasNUMERICEffective target roasOutput only. The effective target ROAS (return-on-ad-spend). This field is read-only.
effective_target_roas_sourceTEXTEffective target roas sourceOutput only. Source of the effective target ROAS. This field is read-only.
end_dateDATEEnd dateThe last day of the campaign.
engagement_rateNUMERICEngagement 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.
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.
experiment_typeTEXTExperiment typeOutput only. The 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.
explorer_auto_optimizer_setting_opt_inBOOLEANExplorer auto optimizer setting opt inIndicates whether the optimizer is turned on.
external_conversion_sourceTEXTExternal conversion sourceExternal conversion source.
external_customer_idNUMERICExternal customer idOutput only. The ID of the customer.
final_urlTEXTFinal urlOutput only. The advertiser-specified final URL.
final_url_suffixTEXTFinal url suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
frequency_capsTEXTFrequency capsA list that limits how often each user will see this campaign's ads.
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_cityTEXTGeo target cityResource name of the geo target constant that represents a city.
geo_target_countryTEXTGeo target countryResource name of the geo target constant that represents a country.
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_regionTEXTGeo 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.
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.
has_partners_badgeBOOLEANHas partners badgeOutput only. Whether 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.
has_recommended_budgetBOOLEANHas recommended budgetOutput only. Indicates 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_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_cityTEXTHotel cityHotel city.
hotel_classNUMERICHotel classHotel class.
hotel_countryTEXTHotel 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_rate_rule_idTEXTHotel rate rule idHotel rate rule ID.
hotel_rate_typeTEXTHotel rate typeHotel rate type.
hotel_setting_hotel_center_idNUMERICHotel setting hotel center idImmutable. The 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.
idTEXTIdOutput only. The ID of the campaign.
impressionsNUMERICImpressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
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_rateNUMERICInvalid 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.
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.
keyword_ad_group_criterionTEXTKeyword ad group criterionThe AdGroupCriterion resource name.
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).
labelsTEXTLabelsOutput only. The resource names of labels attached to this campaign.
language_criteria_idTEXTLanguage criteria idResource name of the language constant for the language of the product.
local_campaign_setting_location_source_typeTEXTLocal campaign setting location source typeThe location source type for this local campaign.
managerBOOLEANManagerOutput only. Whether the customer is a manager.
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 cpvOutput only. A bidding strategy that pays a configurable amount per video view.
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_cpaNUMERICMaximize conversions target cpaOutput only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
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.
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, e.g., 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.
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.
network_settings_target_google_searchBOOLEANNetwork settings target google searchWhether ads will be served with google.com search results.
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).
non_removed_campaign_countNUMERICNon removed campaign countOutput only. The 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).
optimization_goal_setting_optimization_goal_typesTEXTOptimization goal setting optimization goal typesThe list of optimization goal types.
optimization_scoreNUMERICOptimization scoreOutput only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
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 weightOutput only. Optimization 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.
owner_customer_idNUMERICOwner customer idOutput only. The ID of the Customer which owns the bidding strategy.
owner_descriptive_nameTEXTOwner descriptive nameOutput only. descriptive_name of the Customer which owns the bidding strategy.
partner_hotel_idTEXTPartner hotel idPartner hotel ID.
pay_per_conversion_eligibility_failure_reasonsTEXTPay per conversion eligibility failure reasonsOutput only. Reasons 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.
periodTEXTPeriodImmutable. Period 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).
placeholder_typeTEXTPlaceholder typePlaceholder type. This is only used with feed item metrics.
policy_summary_approval_statusTEXTPolicy summary approval statusOutput only. The 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 entriesOutput only. The list of policy findings for this ad.
policy_summary_review_statusTEXTPolicy summary review statusOutput only. Where in the review process this ad is.
product_aggregator_idNUMERICProduct aggregator idAggregator ID of the product.
product_bidding_category_level1TEXTProduct bidding category level1Bidding category (level 1) of the product.
product_bidding_category_level2TEXTProduct bidding category level2Bidding category (level 2) of the product.
product_bidding_category_level3TEXTProduct bidding category level3Bidding category (level 3) of the product.
product_bidding_category_level4TEXTProduct bidding category level4Bidding category (level 4) of the product.
product_bidding_category_level5TEXTProduct bidding category level5Bidding category (level 5) of the product.
product_brandTEXTProduct brandBrand 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_countryTEXTProduct 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_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.
quarterTEXTQuarterQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
real_time_bidding_setting_opt_inBOOLEANReal time bidding setting opt inWhether the campaign is opted in to real-time bidding.
recommendation_typeTEXTRecommendation typeRecommendation type.
recommended_budget_amountNUMERICRecommended budget amountOutput only. The 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.
recommended_budget_amount_microsNUMERICRecommended budget amount microsOutput only. The 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.
recommended_budget_estimated_change_weekly_clicksNUMERICRecommended budget estimated change weekly clicksOutput only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
recommended_budget_estimated_change_weekly_cost_microsNUMERICRecommended budget estimated change weekly cost microsOutput only. The 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.
recommended_budget_estimated_change_weekly_interactionsNUMERICRecommended budget estimated change weekly interactionsOutput only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
recommended_budget_estimated_change_weekly_viewsNUMERICRecommended budget estimated change weekly viewsOutput only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
reference_countNUMERICReference countOutput only. The number of campaigns actively using the budget. This field is read-only.
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 tagOutput only. The Google global site tag.
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 above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
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 anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
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_rank_lost_absolute_top_impression_shareNUMERICSearch rank lost absolute top impression shareThe number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
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 anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
search_term_match_typeTEXTSearch term match typeMatch type of the keyword that triggered the ad, including variants.
search_top_impression_shareNUMERICSearch top impression shareThe impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
selective_optimization_conversion_actionsTEXTSelective optimization conversion actionsThe selected set of conversion actions for optimizing this campaign.
serving_statusTEXTServing statusOutput only. The ad serving status of 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_merchant_idNUMERICShopping setting merchant idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
shopping_setting_sales_countryTEXTShopping setting sales countryImmutable. Sales country of products to include in the campaign. This field is required for Shopping campaigns. This field is immutable. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
sk_ad_network_conversion_valueNUMERICSk ad network conversion valueiOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign.
sk_ad_network_conversionsNUMERICSk ad network conversionsThe number of iOS Store Kit Ad Network conversions.
slotTEXTSlotPosition of the ad.
sourceTEXTThe name of the connector ("google_ads")The 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.
statusTEXTStatusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
store_idTEXTStore idStore ID of the product.
target_cpaNUMERICTarget cpaOutput only. The effective target CPA (cost-per-acquisition). This field is read-only.
target_cpa_bid_sourceTEXTTarget cpa bid sourceOutput only. Source 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 microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
target_cpmTEXTTarget cpmA bidding strategy that automatically optimizes cost per thousand impressions.
target_cpm_microsNUMERICTarget cpm microsAverage amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
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 desired fraction of ads to be shown in the targeted location in micros. E.g. 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 roasOutput only. The desired 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.
targeting_setting_target_restrictionsTEXTTargeting setting target restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
test_accountBOOLEANTest accountOutput only. Whether the customer is a test account.
time_zoneTEXTTime zoneImmutable. The local timezone ID of the customer.
top_impression_percentageNUMERICTop impression percentageThe percent of your ad impressions that are shown anywhere above the organic search results.
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.
totalcostNUMERICTotalcostThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
tracking_setting_tracking_urlTEXTTracking setting tracking urlOutput only. The 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.
typeTEXTTypeImmutable. The type of the ad group.
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.
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.
video_brand_safety_suitabilityTEXTVideo brand safety suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
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_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 (e.g., clicking on) another ad.
weekTEXTWeekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
yearTEXTYearYear, formatted as yyyy.