Google Ads Field Reference
Sample
https://connectors.windsor.ai/google_ads?api_key=[your API key]&date_preset=last_7d&fields=source,campaign,spend,date&_renderer=csv
Google ads connector is unique in that keywords can be requested in stead of the fields to get search volume estimates.
https://connectors.windsor.ai/google_ads?keywords=sample,words&api_key=[your API key]
Fields
| ID | Type | Name | Description |
|---|---|---|---|
| absolute_top_impression_percentage | NUMERIC | Absolute top impression percentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. |
| access_reason | TEXT | Access reason | Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only. |
| accessible_bidding_strategy | TEXT | Accessible bidding strategy | 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_id | NUMERIC | Accessible bidding strategy id | The ID of the bidding strategy. |
| accessible_bidding_strategy_maximize_conversion_value_target_roas | NUMERIC | Accessible bidding strategy maximize conversion value target roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
| accessible_bidding_strategy_maximize_conversions_target_cpa_micros | NUMERIC | Accessible bidding strategy maximize conversions target cpa micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
| accessible_bidding_strategy_name | TEXT | Accessible bidding strategy name | The name of the bidding strategy. |
| accessible_bidding_strategy_owner_customer_id | NUMERIC | Accessible bidding strategy owner customer id | The ID of the Customer which owns the bidding strategy. |
| accessible_bidding_strategy_owner_descriptive_name | TEXT | Accessible bidding strategy owner descriptive name | descriptive_name of the Customer which owns the bidding strategy. |
| accessible_bidding_strategy_resource_name | TEXT | Accessible bidding strategy resource name | The resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id} |
| accessible_bidding_strategy_target_cpa_target_cpa_micros | NUMERIC | Accessible bidding strategy target cpa target cpa micros | 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_micros | NUMERIC | Accessible bidding strategy target impression share cpc bid ceiling micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
| accessible_bidding_strategy_target_impression_share_location | TEXT | Accessible bidding strategy target impression share location | The targeted location on the search results page. |
| accessible_bidding_strategy_target_impression_share_location_fraction_micros | NUMERIC | Accessible bidding strategy target impression share location fraction micros | The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. |
| accessible_bidding_strategy_target_roas_target_roas | NUMERIC | Accessible bidding strategy target roas target roas | Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
| accessible_bidding_strategy_target_spend_cpc_bid_ceiling_micros | NUMERIC | Accessible bidding strategy target spend cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Accessible bidding strategy target spend target spend micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
| accessible_bidding_strategy_type | TEXT | Accessible bidding strategy type | The type of the bidding strategy. |
| account_currency_code | TEXT | Account currency code | The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
| account_descriptive_name | TEXT | Account descriptive name | Optional, non-unique descriptive name of the customer. |
| account_id | TEXT | Account ID | The Google Ads account ID. |
| account_name | TEXT | Account Name | Optional, non-unique descriptive name of the customer. |
| account_time_zone | TEXT | Account time zone | The local timezone ID of the customer. |
| account_user_list_status | TEXT | Account user list status | Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED. |
| action_items | TEXT | Action items | 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_cpm | NUMERIC | Active view cpm | Average cost of viewable impressions (active_view_impressions). |
| active_view_ctr | NUMERIC | Active view ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
| active_view_impressions | NUMERIC | Active view impressions | A measurement of how often your ad has become viewable on a Display Network site. |
| active_view_measurability | NUMERIC | Active view measurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
| active_view_measurable_cost | NUMERIC | Active view measurable cost | The cost of the impressions you received that were measurable by Active View. |
| active_view_measurable_cost_micros | NUMERIC | Active view measurable cost micros | The cost of the impressions you received that were measurable by Active View. |
| active_view_measurable_impressions | NUMERIC | Active view measurable impressions | The number of times your ads are appearing on placements in positions where they can be seen. |
| active_view_viewability | NUMERIC | Active view viewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
| ad_added_by_google_ads | BOOLEAN | Ad added by google ads | 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_descriptions | TEXT | Ad app ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_app_ad_headlines | TEXT | Ad app ad headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| ad_app_ad_html5_media_bundles | TEXT | Ad app ad html5 media bundles | List of media bundle assets that may be used with the ad. |
| ad_app_ad_html5_media_bundles_asset | TEXT | Ad app ad html5 media bundles asset | The Asset resource name of this media bundle. |
| ad_app_ad_images | TEXT | Ad app ad images | List of image assets that may be displayed with the ad. |
| ad_app_ad_images_asset | TEXT | Ad app ad images asset | The Asset resource name of this image. |
| ad_app_ad_mandatory_ad_text | TEXT | Ad app ad mandatory ad text | Mandatory ad text. |
| ad_app_ad_youtube_videos | TEXT | Ad app ad youtube videos | List of YouTube video assets that may be displayed with the ad. |
| ad_app_ad_youtube_videos_asset | TEXT | Ad app ad youtube videos asset | The Asset resource name of this video. |
| ad_app_engagement_ad_descriptions | TEXT | Ad app engagement ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_app_engagement_ad_headlines | TEXT | Ad app engagement ad headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| ad_app_engagement_ad_images | TEXT | Ad app engagement ad images | List of image assets that may be displayed with the ad. |
| ad_app_engagement_ad_images_asset | TEXT | Ad app engagement ad images asset | The Asset resource name of this image. |
| ad_app_engagement_ad_videos | TEXT | Ad app engagement ad videos | List of video assets that may be displayed with the ad. |
| ad_app_engagement_ad_videos_asset | TEXT | Ad app engagement ad videos asset | The Asset resource name of this video. |
| ad_app_pre_registration_ad_descriptions | TEXT | Ad app pre registration ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_app_pre_registration_ad_headlines | TEXT | Ad app pre registration ad headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| ad_app_pre_registration_ad_images | TEXT | Ad app pre registration ad images | List of image asset IDs whose images may be displayed with the ad. |
| ad_app_pre_registration_ad_images_asset | TEXT | Ad app pre registration ad images asset | The Asset resource name of this image. |
| ad_app_pre_registration_ad_youtube_videos | TEXT | Ad app pre registration ad youtube videos | List of YouTube video asset IDs whose videos may be displayed with the ad. |
| ad_app_pre_registration_ad_youtube_videos_asset | TEXT | Ad app pre registration ad youtube videos asset | The Asset resource name of this video. |
| ad_call_ad_business_name | TEXT | Ad call ad business name | The business name in the ad. |
| ad_call_ad_call_tracked | BOOLEAN | Ad call ad call tracked | Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. |
| ad_call_ad_conversion_action | TEXT | Ad call ad conversion action | The 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_state | TEXT | Ad call ad conversion reporting state | The 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_code | TEXT | Ad call ad country code | The country code in the ad. |
| ad_call_ad_description1 | TEXT | Ad call ad description1 | The first line of the ad's description. |
| ad_call_ad_description2 | TEXT | Ad call ad description2 | The second line of the ad's description. |
| ad_call_ad_disable_call_conversion | BOOLEAN | Ad call ad disable call conversion | Whether 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_headline1 | TEXT | Ad call ad headline1 | First headline in the ad. |
| ad_call_ad_headline2 | TEXT | Ad call ad headline2 | Second headline in the ad. |
| ad_call_ad_path1 | TEXT | Ad call ad path1 | First part of text that can be appended to the URL in the ad. Optional. |
| ad_call_ad_path2 | TEXT | Ad call ad path2 | Second 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_number | TEXT | Ad call ad phone number | The phone number in the ad. |
| ad_call_ad_phone_number_verification_url | TEXT | Ad call ad phone number verification url | The URL to be used for phone number verification. |
| ad_destination_type | TEXT | Ad destination type | Ad Destination type. |
| ad_device_preference | TEXT | Ad device preference | The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. |
| ad_discovery_carousel_ad_business_name | TEXT | Ad discovery carousel ad business name | Required. The Advertiser/brand name. |
| ad_discovery_carousel_ad_call_to_action_text | TEXT | Ad discovery carousel ad call to action text | Call to action text. |
| ad_discovery_carousel_ad_carousel_cards | TEXT | Ad discovery carousel ad carousel cards | Required. Carousel cards that will display with the ad. Min 2 max 10. |
| ad_discovery_carousel_ad_carousel_cards_asset | TEXT | Ad discovery carousel ad carousel cards asset | The Asset resource name of this discovery carousel card. |
| ad_discovery_carousel_ad_description | TEXT | Ad discovery carousel ad description | Required. The descriptive text of the ad. |
| ad_discovery_carousel_ad_headline | TEXT | Ad discovery carousel ad headline | Required. Headline of the ad. |
| ad_discovery_carousel_ad_logo_image | TEXT | Ad discovery carousel ad logo image | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). |
| ad_discovery_carousel_ad_logo_image_asset | TEXT | Ad discovery carousel ad logo image asset | The Asset resource name of this image. |
| ad_discovery_multi_asset_ad_business_name | TEXT | Ad discovery multi asset ad business name | The Advertiser/brand name. Maximum display width is 25. Required. |
| ad_discovery_multi_asset_ad_call_to_action_text | TEXT | Ad discovery multi asset ad call to action text | Call to action text. |
| ad_discovery_multi_asset_ad_descriptions | TEXT | Ad discovery multi asset ad descriptions | The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. |
| ad_discovery_multi_asset_ad_headlines | TEXT | Ad discovery multi asset ad headlines | Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. |
| ad_discovery_multi_asset_ad_lead_form_only | BOOLEAN | Ad discovery multi asset ad lead form only | Boolean option that indicates if this ad must be served with lead form. |
| ad_discovery_multi_asset_ad_logo_images | TEXT | Ad discovery multi asset ad logo images | Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). At least 1 and max 5 logo images can be specified. |
| ad_discovery_multi_asset_ad_logo_images_asset | TEXT | Ad discovery multi asset ad logo images asset | The Asset resource name of this image. |
| ad_discovery_multi_asset_ad_marketing_images | TEXT | Ad discovery multi asset ad marketing images | Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. |
| ad_discovery_multi_asset_ad_marketing_images_asset | TEXT | Ad discovery multi asset ad marketing images asset | The Asset resource name of this image. |
| ad_discovery_multi_asset_ad_portrait_marketing_images | TEXT | Ad discovery multi asset ad portrait marketing images | Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. |
| ad_discovery_multi_asset_ad_portrait_marketing_images_asset | TEXT | Ad discovery multi asset ad portrait marketing images asset | The Asset resource name of this image. |
| ad_discovery_multi_asset_ad_square_marketing_images | TEXT | Ad discovery multi asset ad square marketing images | Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. |
| ad_discovery_multi_asset_ad_square_marketing_images_asset | TEXT | Ad discovery multi asset ad square marketing images asset | The Asset resource name of this image. |
| ad_display_upload_ad_display_upload_product_type | TEXT | Ad display upload ad display upload product type | The product type of this ad. See comments on the enum for details. |
| ad_display_upload_ad_media_bundle | TEXT | Ad display upload ad media bundle | A 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_asset | TEXT | Ad display upload ad media bundle asset | The Asset resource name of this media bundle. |
| ad_display_url | TEXT | Ad display url | The URL that appears in the ad description for some ad formats. |
| ad_expanded_dynamic_search_ad_description | TEXT | Ad expanded dynamic search ad description | The description of the ad. |
| ad_expanded_dynamic_search_ad_description2 | TEXT | Ad expanded dynamic search ad description2 | The second description of the ad. |
| ad_expanded_text_ad_description | TEXT | Ad expanded text ad description | The description of the ad. |
| ad_expanded_text_ad_description2 | TEXT | Ad expanded text ad description2 | The second description of the ad. |
| ad_expanded_text_ad_headline_part1 | TEXT | Ad expanded text ad headline part1 | The first part of the ad's headline. |
| ad_expanded_text_ad_headline_part2 | TEXT | Ad expanded text ad headline part2 | The second part of the ad's headline. |
| ad_expanded_text_ad_headline_part3 | TEXT | Ad expanded text ad headline part3 | The third part of the ad's headline. |
| ad_expanded_text_ad_path1 | TEXT | Ad expanded text ad path1 | The text that can appear alongside the ad's displayed URL. |
| ad_expanded_text_ad_path2 | TEXT | Ad expanded text ad path2 | Additional text that can appear alongside the ad's displayed URL. |
| ad_final_app_urls | TEXT | Ad final app urls | A list of final app URLs that will be used on mobile if the user has the specific app installed. |
| ad_final_mobile_urls | TEXT | Ad final mobile urls | The list of possible final mobile URLs after all cross-domain redirects for the ad. |
| ad_final_url_suffix | TEXT | Ad final url suffix | The suffix to use when constructing a final URL. |
| ad_final_urls | TEXT | Ad final urls | The list of possible final URLs after all cross-domain redirects for the ad. |
| ad_gmail_ad_header_image | TEXT | Ad gmail ad header image | The 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_image | TEXT | Ad gmail ad marketing image | The 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_description | TEXT | Ad gmail ad marketing image description | Description of the marketing image. |
| ad_gmail_ad_marketing_image_display_call_to_action_text | TEXT | Ad gmail ad marketing image display call to action text | Text for the display-call-to-action. |
| ad_gmail_ad_marketing_image_display_call_to_action_text_color | TEXT | Ad gmail ad marketing image display call to action text color | Text color for the display-call-to-action in hexadecimal, for example, # ffffff for white. |
| ad_gmail_ad_marketing_image_display_call_to_action_url_collection_id | TEXT | Ad gmail ad marketing image display call to action url collection id | Identifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url. |
| ad_gmail_ad_marketing_image_headline | TEXT | Ad gmail ad marketing image headline | Headline of the marketing image. |
| ad_gmail_ad_product_images | TEXT | Ad gmail ad product images | Product images. Up to 15 images are supported. |
| ad_gmail_ad_product_images_product_image | TEXT | Ad gmail ad product images product image | The 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_videos | TEXT | Ad gmail ad product videos | Product 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_video | TEXT | Ad gmail ad product videos product video | The MediaFile resource name of a video which must be hosted on YouTube. |
| ad_gmail_ad_teaser_business_name | TEXT | Ad gmail ad teaser business name | Business name of the advertiser. |
| ad_gmail_ad_teaser_description | TEXT | Ad gmail ad teaser description | Description of the teaser. |
| ad_gmail_ad_teaser_headline | TEXT | Ad gmail ad teaser headline | Headline of the teaser. |
| ad_gmail_ad_teaser_logo_image | TEXT | Ad gmail ad teaser logo image | The 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 | TEXT | Ad group path | The ad group to which the criterion belongs. |
| ad_group_ad_action_items | TEXT | Ad group ad action items | 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_ads | BOOLEAN | Ad group ad ad added by google ads | 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_descriptions | TEXT | Ad group ad ad app ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_group_ad_ad_app_ad_headlines | TEXT | Ad group ad ad app ad headlines | List 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_bundles | TEXT | Ad group ad ad app ad html5 media bundles | List of media bundle assets that may be used with the ad. |
| ad_group_ad_ad_app_ad_html5_media_bundles_asset | TEXT | Ad group ad ad app ad html5 media bundles asset | The Asset resource name of this media bundle. |
| ad_group_ad_ad_app_ad_images | TEXT | Ad group ad ad app ad images | List of image assets that may be displayed with the ad. |
| ad_group_ad_ad_app_ad_images_asset | TEXT | Ad group ad ad app ad images asset | The Asset resource name of this image. |
| ad_group_ad_ad_app_ad_mandatory_ad_text | TEXT | Ad group ad ad app ad mandatory ad text | Mandatory ad text. |
| ad_group_ad_ad_app_ad_youtube_videos | TEXT | Ad group ad ad app ad youtube videos | List of YouTube video assets that may be displayed with the ad. |
| ad_group_ad_ad_app_ad_youtube_videos_asset | TEXT | Ad group ad ad app ad youtube videos asset | The Asset resource name of this video. |
| ad_group_ad_ad_app_engagement_ad_descriptions | TEXT | Ad group ad ad app engagement ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_group_ad_ad_app_engagement_ad_headlines | TEXT | Ad group ad ad app engagement ad headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| ad_group_ad_ad_app_engagement_ad_images | TEXT | Ad group ad ad app engagement ad images | List of image assets that may be displayed with the ad. |
| ad_group_ad_ad_app_engagement_ad_images_asset | TEXT | Ad group ad ad app engagement ad images asset | The Asset resource name of this image. |
| ad_group_ad_ad_app_engagement_ad_videos | TEXT | Ad group ad ad app engagement ad videos | List of video assets that may be displayed with the ad. |
| ad_group_ad_ad_app_engagement_ad_videos_asset | TEXT | Ad group ad ad app engagement ad videos asset | The Asset resource name of this video. |
| ad_group_ad_ad_app_pre_registration_ad_descriptions | TEXT | Ad group ad ad app pre registration ad descriptions | List 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_headlines | TEXT | Ad group ad ad app pre registration ad headlines | List 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_images | TEXT | Ad group ad ad app pre registration ad images | List of image asset IDs whose images may be displayed with the ad. |
| ad_group_ad_ad_app_pre_registration_ad_images_asset | TEXT | Ad group ad ad app pre registration ad images asset | The Asset resource name of this image. |
| ad_group_ad_ad_app_pre_registration_ad_youtube_videos | TEXT | Ad group ad ad app pre registration ad youtube videos | List of YouTube video asset IDs whose videos may be displayed with the ad. |
| ad_group_ad_ad_app_pre_registration_ad_youtube_videos_asset | TEXT | Ad group ad ad app pre registration ad youtube videos asset | The Asset resource name of this video. |
| ad_group_ad_ad_call_ad_business_name | TEXT | Ad group ad ad call ad business name | The business name in the ad. |
| ad_group_ad_ad_call_ad_call_tracked | BOOLEAN | Ad group ad ad call ad call tracked | Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. |
| ad_group_ad_ad_call_ad_conversion_action | TEXT | Ad group ad ad call ad conversion action | The 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_state | TEXT | Ad group ad ad call ad conversion reporting state | The 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_code | TEXT | Ad group ad ad call ad country code | The country code in the ad. |
| ad_group_ad_ad_call_ad_description1 | TEXT | Ad group ad ad call ad description1 | The first line of the ad's description. |
| ad_group_ad_ad_call_ad_description2 | TEXT | Ad group ad ad call ad description2 | The second line of the ad's description. |
| ad_group_ad_ad_call_ad_disable_call_conversion | BOOLEAN | Ad group ad ad call ad disable call conversion | Whether 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_headline1 | TEXT | Ad group ad ad call ad headline1 | First headline in the ad. |
| ad_group_ad_ad_call_ad_headline2 | TEXT | Ad group ad ad call ad headline2 | Second headline in the ad. |
| ad_group_ad_ad_call_ad_path1 | TEXT | Ad group ad ad call ad path1 | First part of text that can be appended to the URL in the ad. Optional. |
| ad_group_ad_ad_call_ad_path2 | TEXT | Ad group ad ad call ad path2 | Second 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_number | TEXT | Ad group ad ad call ad phone number | The phone number in the ad. |
| ad_group_ad_ad_call_ad_phone_number_verification_url | TEXT | Ad group ad ad call ad phone number verification url | The URL to be used for phone number verification. |
| ad_group_ad_ad_device_preference | TEXT | Ad group ad ad device preference | The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. |
| ad_group_ad_ad_discovery_carousel_ad_business_name | TEXT | Ad group ad ad discovery carousel ad business name | Required. The Advertiser/brand name. |
| ad_group_ad_ad_discovery_carousel_ad_call_to_action_text | TEXT | Ad group ad ad discovery carousel ad call to action text | Call to action text. |
| ad_group_ad_ad_discovery_carousel_ad_carousel_cards | TEXT | Ad group ad ad discovery carousel ad carousel cards | Required. Carousel cards that will display with the ad. Min 2 max 10. |
| ad_group_ad_ad_discovery_carousel_ad_carousel_cards_asset | TEXT | Ad group ad ad discovery carousel ad carousel cards asset | The Asset resource name of this discovery carousel card. |
| ad_group_ad_ad_discovery_carousel_ad_description | TEXT | Ad group ad ad discovery carousel ad description | Required. The descriptive text of the ad. |
| ad_group_ad_ad_discovery_carousel_ad_headline | TEXT | Ad group ad ad discovery carousel ad headline | Required. Headline of the ad. |
| ad_group_ad_ad_discovery_carousel_ad_logo_image | TEXT | Ad group ad ad discovery carousel ad logo image | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). |
| ad_group_ad_ad_discovery_carousel_ad_logo_image_asset | TEXT | Ad group ad ad discovery carousel ad logo image asset | The Asset resource name of this image. |
| ad_group_ad_ad_discovery_multi_asset_ad_business_name | TEXT | Ad group ad ad discovery multi asset ad business name | The Advertiser/brand name. Maximum display width is 25. Required. |
| ad_group_ad_ad_discovery_multi_asset_ad_call_to_action_text | TEXT | Ad group ad ad discovery multi asset ad call to action text | Call to action text. |
| ad_group_ad_ad_discovery_multi_asset_ad_descriptions | TEXT | Ad group ad ad discovery multi asset ad descriptions | The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. |
| ad_group_ad_ad_discovery_multi_asset_ad_headlines | TEXT | Ad group ad ad discovery multi asset ad headlines | Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. |
| ad_group_ad_ad_discovery_multi_asset_ad_lead_form_only | BOOLEAN | Ad group ad ad discovery multi asset ad lead form only | Boolean option that indicates if this ad must be served with lead form. |
| ad_group_ad_ad_discovery_multi_asset_ad_logo_images | TEXT | Ad group ad ad discovery multi asset ad logo images | Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). At least 1 and max 5 logo images can be specified. |
| ad_group_ad_ad_discovery_multi_asset_ad_logo_images_asset | TEXT | Ad group ad ad discovery multi asset ad logo images asset | The Asset resource name of this image. |
| ad_group_ad_ad_discovery_multi_asset_ad_marketing_images | TEXT | Ad group ad ad discovery multi asset ad marketing images | Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. |
| ad_group_ad_ad_discovery_multi_asset_ad_marketing_images_asset | TEXT | Ad group ad ad discovery multi asset ad marketing images asset | The Asset resource name of this image. |
| ad_group_ad_ad_discovery_multi_asset_ad_portrait_marketing_images | TEXT | Ad group ad ad discovery multi asset ad portrait marketing images | Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. |
| ad_group_ad_ad_discovery_multi_asset_ad_portrait_marketing_images_asset | TEXT | Ad group ad ad discovery multi asset ad portrait marketing images asset | The Asset resource name of this image. |
| ad_group_ad_ad_discovery_multi_asset_ad_square_marketing_images | TEXT | Ad group ad ad discovery multi asset ad square marketing images | Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. |
| ad_group_ad_ad_discovery_multi_asset_ad_square_marketing_images_asset | TEXT | Ad group ad ad discovery multi asset ad square marketing images asset | The Asset resource name of this image. |
| ad_group_ad_ad_display_upload_ad_display_upload_product_type | TEXT | Ad group ad ad display upload ad display upload product type | The product type of this ad. See comments on the enum for details. |
| ad_group_ad_ad_display_upload_ad_media_bundle | TEXT | Ad group ad ad display upload ad media bundle | A 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_asset | TEXT | Ad group ad ad display upload ad media bundle asset | The Asset resource name of this media bundle. |
| ad_group_ad_ad_display_url | TEXT | Ad group ad ad display url | The URL that appears in the ad description for some ad formats. |
| ad_group_ad_ad_expanded_dynamic_search_ad_description | TEXT | Ad group ad ad expanded dynamic search ad description | The description of the ad. |
| ad_group_ad_ad_expanded_dynamic_search_ad_description2 | TEXT | Ad group ad ad expanded dynamic search ad description2 | The second description of the ad. |
| ad_group_ad_ad_expanded_text_ad_description | TEXT | Ad group ad ad expanded text ad description | The description of the ad. |
| ad_group_ad_ad_expanded_text_ad_description2 | TEXT | Ad group ad ad expanded text ad description2 | The second description of the ad. |
| ad_group_ad_ad_expanded_text_ad_headline_part1 | TEXT | Ad group ad ad expanded text ad headline part1 | The first part of the ad's headline. |
| ad_group_ad_ad_expanded_text_ad_headline_part2 | TEXT | Ad group ad ad expanded text ad headline part2 | The second part of the ad's headline. |
| ad_group_ad_ad_expanded_text_ad_headline_part3 | TEXT | Ad group ad ad expanded text ad headline part3 | The third part of the ad's headline. |
| ad_group_ad_ad_expanded_text_ad_path1 | TEXT | Ad group ad ad expanded text ad path1 | The text that can appear alongside the ad's displayed URL. |
| ad_group_ad_ad_expanded_text_ad_path2 | TEXT | Ad group ad ad expanded text ad path2 | Additional text that can appear alongside the ad's displayed URL. |
| ad_group_ad_ad_final_app_urls | TEXT | Ad group ad ad final app urls | A 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_urls | TEXT | Ad group ad ad final mobile urls | The list of possible final mobile URLs after all cross-domain redirects for the ad. |
| ad_group_ad_ad_final_url_suffix | TEXT | Ad group ad ad final url suffix | The suffix to use when constructing a final URL. |
| ad_group_ad_ad_final_urls | TEXT | Ad group ad ad final urls | The list of possible final URLs after all cross-domain redirects for the ad. |
| ad_group_ad_ad_gmail_ad_header_image | TEXT | Ad group ad ad gmail ad header image | The 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_image | TEXT | Ad group ad ad gmail ad marketing image | The 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_description | TEXT | Ad group ad ad gmail ad marketing image description | Description of the marketing image. |
| ad_group_ad_ad_gmail_ad_marketing_image_display_call_to_action_text | TEXT | Ad group ad ad gmail ad marketing image display call to action text | Text for the display-call-to-action. |
| ad_group_ad_ad_gmail_ad_marketing_image_display_call_to_action_text_color | TEXT | Ad group ad ad gmail ad marketing image display call to action text color | Text color for the display-call-to-action in hexadecimal, for example, # ffffff for white. |
| ad_group_ad_ad_gmail_ad_marketing_image_display_call_to_action_url_collection_id | TEXT | Ad group ad ad gmail ad marketing image display call to action url collection id | Identifies 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_headline | TEXT | Ad group ad ad gmail ad marketing image headline | Headline of the marketing image. |
| ad_group_ad_ad_gmail_ad_product_images | TEXT | Ad group ad ad gmail ad product images | Product images. Up to 15 images are supported. |
| ad_group_ad_ad_gmail_ad_product_images_product_image | TEXT | Ad group ad ad gmail ad product images product image | The 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_videos | TEXT | Ad group ad ad gmail ad product videos | Product 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_video | TEXT | Ad group ad ad gmail ad product videos product video | The MediaFile resource name of a video which must be hosted on YouTube. |
| ad_group_ad_ad_gmail_ad_teaser_business_name | TEXT | Ad group ad ad gmail ad teaser business name | Business name of the advertiser. |
| ad_group_ad_ad_gmail_ad_teaser_description | TEXT | Ad group ad ad gmail ad teaser description | Description of the teaser. |
| ad_group_ad_ad_gmail_ad_teaser_headline | TEXT | Ad group ad ad gmail ad teaser headline | Headline of the teaser. |
| ad_group_ad_ad_gmail_ad_teaser_logo_image | TEXT | Ad group ad ad gmail ad teaser logo image | The 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_group | TEXT | Ad group ad ad group | The ad group to which the ad belongs. |
| ad_group_ad_ad_hotel_ad | TEXT | Ad group ad ad hotel ad | Details pertaining to a hotel ad. |
| ad_group_ad_ad_id | NUMERIC | Ad group ad ad id | The ID of the ad. |
| ad_group_ad_ad_image_ad_image_url | TEXT | Ad group ad ad image ad image url | URL of the full size image. |
| ad_group_ad_ad_image_ad_media_file | TEXT | Ad group ad ad image ad media file | The MediaFile resource to use for the image. |
| ad_group_ad_ad_image_ad_mime_type | TEXT | Ad group ad ad image ad mime type | The mime type of the image. |
| ad_group_ad_ad_image_ad_name | TEXT | Ad group ad ad image ad name | The 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_height | NUMERIC | Ad group ad ad image ad pixel height | Height in pixels of the full size image. |
| ad_group_ad_ad_image_ad_pixel_width | NUMERIC | Ad group ad ad image ad pixel width | Width in pixels of the full size image. |
| ad_group_ad_ad_image_ad_preview_image_url | TEXT | Ad group ad ad image ad preview image url | URL of the preview size image. |
| ad_group_ad_ad_image_ad_preview_pixel_height | NUMERIC | Ad group ad ad image ad preview pixel height | Height in pixels of the preview size image. |
| ad_group_ad_ad_image_ad_preview_pixel_width | NUMERIC | Ad group ad ad image ad preview pixel width | Width in pixels of the preview size image. |
| ad_group_ad_ad_legacy_app_install_ad | TEXT | Ad group ad ad legacy app install ad | Details pertaining to a legacy app install ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_accent_color | TEXT | Ad group ad ad legacy responsive display ad accent color | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_group_ad_ad_legacy_responsive_display_ad_allow_flexible_color | BOOLEAN | Ad group ad ad legacy responsive display ad allow flexible color | Advertiser'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_name | TEXT | Ad group ad ad legacy responsive display ad business name | The business name in the ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_call_to_action_text | TEXT | Ad group ad ad legacy responsive display ad call to action text | The call-to-action text for the ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_description | TEXT | Ad group ad ad legacy responsive display ad description | The description of the ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_format_setting | TEXT | Ad group ad ad legacy responsive display ad format setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
| ad_group_ad_ad_legacy_responsive_display_ad_logo_image | TEXT | Ad group ad ad legacy responsive display ad logo image | The MediaFile resource name of the logo image used in the ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_long_headline | TEXT | Ad group ad ad legacy responsive display ad long headline | The long version of the ad's headline. |
| ad_group_ad_ad_legacy_responsive_display_ad_main_color | TEXT | Ad group ad ad legacy responsive display ad main color | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_group_ad_ad_legacy_responsive_display_ad_marketing_image | TEXT | Ad group ad ad legacy responsive display ad marketing image | The MediaFile resource name of the marketing image used in the ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_price_prefix | TEXT | Ad group ad ad legacy responsive display ad price prefix | Prefix before price. For example, 'as low as'. |
| ad_group_ad_ad_legacy_responsive_display_ad_promo_text | TEXT | Ad group ad ad legacy responsive display ad promo text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
| ad_group_ad_ad_legacy_responsive_display_ad_short_headline | TEXT | Ad group ad ad legacy responsive display ad short headline | The short version of the ad's headline. |
| ad_group_ad_ad_legacy_responsive_display_ad_square_logo_image | TEXT | Ad group ad ad legacy responsive display ad square logo image | The MediaFile resource name of the square logo image used in the ad. |
| ad_group_ad_ad_legacy_responsive_display_ad_square_marketing_image | TEXT | Ad group ad ad legacy responsive display ad square marketing image | The MediaFile resource name of the square marketing image used in the ad. |
| ad_group_ad_ad_local_ad_call_to_actions | TEXT | Ad group ad ad local ad call to actions | List 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_descriptions | TEXT | Ad group ad ad local ad descriptions | List 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_headlines | TEXT | Ad group ad ad local ad headlines | List 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_images | TEXT | Ad group ad ad local ad logo images | List 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_asset | TEXT | Ad group ad ad local ad logo images asset | The Asset resource name of this image. |
| ad_group_ad_ad_local_ad_marketing_images | TEXT | Ad group ad ad local ad marketing images | List 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_asset | TEXT | Ad group ad ad local ad marketing images asset | The Asset resource name of this image. |
| ad_group_ad_ad_local_ad_path1 | TEXT | Ad group ad ad local ad path1 | First part of optional text that can be appended to the URL in the ad. |
| ad_group_ad_ad_local_ad_path2 | TEXT | Ad group ad ad local ad path2 | Second 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_videos | TEXT | Ad group ad ad local ad videos | List 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_asset | TEXT | Ad group ad ad local ad videos asset | The Asset resource name of this video. |
| ad_group_ad_ad_name | TEXT | Ad group ad ad name | 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_resource_name | TEXT | Ad group ad ad resource name | The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id} |
| ad_group_ad_ad_responsive_display_ad_accent_color | TEXT | Ad group ad ad responsive display ad accent color | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_group_ad_ad_responsive_display_ad_allow_flexible_color | BOOLEAN | Ad group ad ad responsive display ad allow flexible color | Advertiser'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_name | TEXT | Ad group ad ad responsive display ad business name | The advertiser/brand name. Maximum display width is 25. |
| ad_group_ad_ad_responsive_display_ad_call_to_action_text | TEXT | Ad group ad ad responsive display ad call to action text | The call-to-action text for the ad. Maximum display width is 30. |
| ad_group_ad_ad_responsive_display_ad_control_spec_enable_asset_enhancements | BOOLEAN | Ad group ad ad responsive display ad control spec enable asset enhancements | Whether the advertiser has opted into the asset enhancements feature. |
| ad_group_ad_ad_responsive_display_ad_control_spec_enable_autogen_video | BOOLEAN | Ad group ad ad responsive display ad control spec enable autogen video | Whether the advertiser has opted into auto-gen video feature. |
| ad_group_ad_ad_responsive_display_ad_descriptions | TEXT | Ad group ad ad responsive display ad descriptions | Descriptive 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_setting | TEXT | Ad group ad ad responsive display ad format setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
| ad_group_ad_ad_responsive_display_ad_headlines | TEXT | Ad group ad ad responsive display ad headlines | Short 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_images | TEXT | Ad group ad ad responsive display ad logo images | Logo 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_asset | TEXT | Ad group ad ad responsive display ad logo images asset | The Asset resource name of this image. |
| ad_group_ad_ad_responsive_display_ad_long_headline | TEXT | Ad group ad ad responsive display ad long headline | A required long format headline. The maximum length is 90 characters. |
| ad_group_ad_ad_responsive_display_ad_main_color | TEXT | Ad group ad ad responsive display ad main color | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_group_ad_ad_responsive_display_ad_marketing_images | TEXT | Ad group ad ad responsive display ad marketing images | Marketing 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_asset | TEXT | Ad group ad ad responsive display ad marketing images asset | The Asset resource name of this image. |
| ad_group_ad_ad_responsive_display_ad_price_prefix | TEXT | Ad group ad ad responsive display ad price prefix | Prefix before price. For example, 'as low as'. |
| ad_group_ad_ad_responsive_display_ad_promo_text | TEXT | Ad group ad ad responsive display ad promo text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
| ad_group_ad_ad_responsive_display_ad_square_logo_images | TEXT | Ad group ad ad responsive display ad square logo images | Square 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_asset | TEXT | Ad group ad ad responsive display ad square logo images asset | The Asset resource name of this image. |
| ad_group_ad_ad_responsive_display_ad_square_marketing_images | TEXT | Ad group ad ad responsive display ad square marketing images | Square 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_asset | TEXT | Ad group ad ad responsive display ad square marketing images asset | The Asset resource name of this image. |
| ad_group_ad_ad_responsive_display_ad_youtube_videos | TEXT | Ad group ad ad responsive display ad youtube videos | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. |
| ad_group_ad_ad_responsive_display_ad_youtube_videos_asset | TEXT | Ad group ad ad responsive display ad youtube videos asset | The Asset resource name of this video. |
| ad_group_ad_ad_responsive_search_ad_descriptions | TEXT | Ad group ad ad responsive search ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_group_ad_ad_responsive_search_ad_headlines | TEXT | Ad group ad ad responsive search ad headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| ad_group_ad_ad_responsive_search_ad_path1 | TEXT | Ad group ad ad responsive search ad path1 | First part of text that can be appended to the URL in the ad. |
| ad_group_ad_ad_responsive_search_ad_path2 | TEXT | Ad group ad ad responsive search ad path2 | Second 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_headline | TEXT | Ad group ad ad shopping comparison listing ad headline | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. |
| ad_group_ad_ad_shopping_product_ad | TEXT | Ad group ad ad shopping product ad | Details pertaining to a Shopping product ad. |
| ad_group_ad_ad_shopping_smart_ad | TEXT | Ad group ad ad shopping smart ad | Details pertaining to a Smart Shopping ad. |
| ad_group_ad_ad_smart_campaign_ad_descriptions | TEXT | Ad group ad ad smart campaign ad descriptions | List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. |
| ad_group_ad_ad_smart_campaign_ad_headlines | TEXT | Ad group ad ad smart campaign ad headlines | List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. |
| ad_group_ad_ad_strength | TEXT | Ad group ad ad strength | Overall ad strength for this ad group ad. |
| ad_group_ad_ad_system_managed_resource_source | TEXT | Ad group ad ad system managed resource source | If this ad is system managed, then this field will indicate the source. This field is read-only. |
| ad_group_ad_ad_text_ad_description1 | TEXT | Ad group ad ad text ad description1 | The first line of the ad's description. |
| ad_group_ad_ad_text_ad_description2 | TEXT | Ad group ad ad text ad description2 | The second line of the ad's description. |
| ad_group_ad_ad_text_ad_headline | TEXT | Ad group ad ad text ad headline | The headline of the ad. |
| ad_group_ad_ad_tracking_url_template | TEXT | Ad group ad ad tracking url template | The URL template for constructing a tracking URL. |
| ad_group_ad_ad_type | TEXT | Ad group ad ad type | The type of ad. |
| ad_group_ad_ad_url_collections | TEXT | Ad group ad ad url collections | Additional 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_parameters | TEXT | Ad group ad ad url custom parameters | The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations. |
| ad_group_ad_ad_video_ad_bumper_companion_banner_asset | TEXT | Ad group ad ad video ad bumper companion banner asset | The Asset resource name of this image. |
| ad_group_ad_ad_video_ad_in_feed_description1 | TEXT | Ad group ad ad video ad in feed description1 | First text line for the ad. |
| ad_group_ad_ad_video_ad_in_feed_description2 | TEXT | Ad group ad ad video ad in feed description2 | Second text line for the ad. |
| ad_group_ad_ad_video_ad_in_feed_headline | TEXT | Ad group ad ad video ad in feed headline | The headline of the ad. |
| ad_group_ad_ad_video_ad_in_feed_thumbnail | TEXT | Ad group ad ad video ad in feed thumbnail | Video thumbnail image to use. |
| ad_group_ad_ad_video_ad_in_stream_action_button_label | TEXT | Ad group ad ad video ad in stream action button label | Label 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_headline | TEXT | Ad group ad ad video ad in stream action headline | Additional 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_asset | TEXT | Ad group ad ad video ad in stream companion banner asset | The Asset resource name of this image. |
| ad_group_ad_ad_video_ad_non_skippable_action_button_label | TEXT | Ad group ad ad video ad non skippable action button label | Label 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_headline | TEXT | Ad group ad ad video ad non skippable action headline | Additional 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_asset | TEXT | Ad group ad ad video ad non skippable companion banner asset | The Asset resource name of this image. |
| ad_group_ad_ad_video_ad_out_stream_description | TEXT | Ad group ad ad video ad out stream description | The description line. |
| ad_group_ad_ad_video_ad_out_stream_headline | TEXT | Ad group ad ad video ad out stream headline | The headline of the ad. |
| ad_group_ad_ad_video_ad_video_asset | TEXT | Ad group ad ad video ad video asset | The Asset resource name of this video. |
| ad_group_ad_ad_video_responsive_ad_breadcrumb1 | TEXT | Ad group ad ad video responsive ad breadcrumb1 | First part of text that appears in the ad with the displayed URL. |
| ad_group_ad_ad_video_responsive_ad_breadcrumb2 | TEXT | Ad group ad ad video responsive ad breadcrumb2 | Second part of text that appears in the ad with the displayed URL. |
| ad_group_ad_ad_video_responsive_ad_call_to_actions | TEXT | Ad group ad ad video responsive ad call to actions | List of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported. |
| ad_group_ad_ad_video_responsive_ad_companion_banners | TEXT | Ad group ad ad video responsive ad companion banners | List 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_asset | TEXT | Ad group ad ad video responsive ad companion banners asset | The Asset resource name of this image. |
| ad_group_ad_ad_video_responsive_ad_descriptions | TEXT | Ad group ad ad video responsive ad descriptions | List of text assets used for the description. Currently, only a single value for the description is supported. |
| ad_group_ad_ad_video_responsive_ad_headlines | TEXT | Ad group ad ad video responsive ad headlines | List of text assets used for the short headline, for example, the "Call To Action" banner. Currently, only a single value for the short headline is supported. |
| ad_group_ad_ad_video_responsive_ad_long_headlines | TEXT | Ad group ad ad video responsive ad long headlines | List 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_videos | TEXT | Ad group ad ad video responsive ad videos | List 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_asset | TEXT | Ad group ad ad video responsive ad videos asset | The Asset resource name of this video. |
| ad_group_ad_labels | TEXT | Ad group ad labels | The resource names of labels attached to this ad group ad. |
| ad_group_ad_policy_summary_approval_status | TEXT | Ad group ad policy summary approval status | 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_entries | TEXT | Ad group ad policy summary policy topic entries | The list of policy findings for this ad. |
| ad_group_ad_policy_summary_review_status | TEXT | Ad group ad policy summary review status | Where in the review process this ad is. |
| ad_group_ad_resource_name | TEXT | Ad group ad resource name | The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id} |
| ad_group_ad_status | TEXT | Ad group ad status | The status of the ad. |
| ad_group_audience_setting_use_audience_grouped | BOOLEAN | Ad group audience setting use audience grouped | If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
| ad_group_criterion_ad_group | TEXT | Ad group criterion ad group | The ad group to which the criterion belongs. |
| ad_group_criterion_app_payment_model_type | TEXT | Ad group criterion app payment model type | Type of the app payment model. |
| ad_group_criterion_audience_audience | TEXT | Ad group criterion audience audience | The Audience resource name. |
| ad_group_criterion_combined_audience_combined_audience | TEXT | Ad group criterion combined audience combined audience | The CombinedAudience resource name. |
| ad_group_criterion_cpc_bid_micros | NUMERIC | Ad group criterion cpc bid micros | The CPC (cost-per-click) bid. |
| ad_group_criterion_cpm_bid_micros | NUMERIC | Ad group criterion cpm bid micros | The CPM (cost-per-thousand viewable impressions) bid. |
| ad_group_criterion_cpv_bid_micros | NUMERIC | Ad group criterion cpv bid micros | The CPV (cost-per-view) bid. |
| ad_group_criterion_custom_affinity_custom_affinity | TEXT | Ad group criterion custom affinity custom affinity | The CustomInterest resource name. |
| ad_group_criterion_custom_audience_custom_audience | TEXT | Ad group criterion custom audience custom audience | The CustomAudience resource name. |
| ad_group_criterion_custom_intent_custom_intent | TEXT | Ad group criterion custom intent custom intent | The CustomInterest resource name. |
| ad_group_criterion_disapproval_reasons | TEXT | Ad group criterion disapproval reasons | List of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only. |
| ad_group_criterion_display_name | TEXT | Ad group criterion display name | The display name of the criterion. This field is ignored for mutates. |
| ad_group_criterion_effective_cpv_bid_micros | NUMERIC | Ad group criterion effective cpv bid micros | The effective CPV (cost-per-view) bid. |
| ad_group_criterion_effective_cpv_bid_source | TEXT | Ad group criterion effective cpv bid source | Source of the effective CPV bid. |
| ad_group_criterion_effective_percent_cpc_bid_micros | NUMERIC | Ad group criterion effective percent cpc bid micros | The effective Percent CPC bid amount. |
| ad_group_criterion_effective_percent_cpc_bid_source | TEXT | Ad group criterion effective percent cpc bid source | Source of the effective Percent CPC bid. |
| ad_group_criterion_income_range_type | TEXT | Ad group criterion income range type | Type of the income range. |
| ad_group_criterion_labels | TEXT | Ad group criterion labels | The resource names of labels attached to this ad group criterion. |
| ad_group_criterion_listing_group_case_value_hotel_city_city_criterion | TEXT | Ad group criterion listing group case value hotel city city criterion | The Geo Target Constant resource name. |
| ad_group_criterion_listing_group_case_value_hotel_class_value | NUMERIC | Ad group criterion listing group case value hotel class value | Long value of the hotel class. |
| ad_group_criterion_listing_group_case_value_hotel_country_region_country_region_criterion | TEXT | Ad group criterion listing group case value hotel country region country region criterion | The Geo Target Constant resource name. |
| ad_group_criterion_listing_group_case_value_hotel_id_value | TEXT | Ad group criterion listing group case value hotel id value | String value of the hotel ID. |
| ad_group_criterion_listing_group_case_value_hotel_state_state_criterion | TEXT | Ad group criterion listing group case value hotel state state criterion | The Geo Target Constant resource name. |
| ad_group_criterion_listing_group_case_value_product_bidding_category_country_code | TEXT | Ad group criterion listing group case value product bidding category country code | Two-letter upper-case country code of the product bidding category. It must match the campaign.shopping_setting.sales_country field. |
| ad_group_criterion_listing_group_case_value_product_bidding_category_id | NUMERIC | Ad group criterion listing group case value product bidding category id | ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 |
| ad_group_criterion_listing_group_case_value_product_bidding_category_level | TEXT | Ad group criterion listing group case value product bidding category level | Level of the product bidding category. |
| ad_group_criterion_listing_group_case_value_product_brand_value | TEXT | Ad group criterion listing group case value product brand value | String value of the product brand. |
| ad_group_criterion_listing_group_case_value_product_channel_channel | TEXT | Ad group criterion listing group case value product channel channel | Value of the locality. |
| ad_group_criterion_listing_group_case_value_product_channel_exclusivity_channel_exclusivity | TEXT | Ad group criterion listing group case value product channel exclusivity channel exclusivity | Value of the availability. |
| ad_group_criterion_listing_group_case_value_product_condition_condition | TEXT | Ad group criterion listing group case value product condition condition | Value of the condition. |
| ad_group_criterion_listing_group_case_value_product_custom_attribute_index | TEXT | Ad group criterion listing group case value product custom attribute index | Indicates the index of the custom attribute. |
| ad_group_criterion_listing_group_case_value_product_custom_attribute_value | TEXT | Ad group criterion listing group case value product custom attribute value | String value of the product custom attribute. |
| ad_group_criterion_listing_group_case_value_product_item_id_value | TEXT | Ad group criterion listing group case value product item id value | Value of the id. |
| ad_group_criterion_listing_group_case_value_product_type_level | TEXT | Ad group criterion listing group case value product type level | Level of the type. |
| ad_group_criterion_listing_group_case_value_product_type_value | TEXT | Ad group criterion listing group case value product type value | Value of the type. |
| ad_group_criterion_listing_group_parent_ad_group_criterion | TEXT | Ad group criterion listing group parent ad group criterion | Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group. |
| ad_group_criterion_listing_group_type | TEXT | Ad group criterion listing group type | Type of the listing group. |
| ad_group_criterion_mobile_app_category_mobile_app_category_constant | TEXT | Ad group criterion mobile app category mobile app category constant | The mobile app category constant resource name. |
| ad_group_criterion_mobile_application_app_id | TEXT | Ad group criterion mobile application app id | A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations. |
| ad_group_criterion_mobile_application_name | TEXT | Ad group criterion mobile application name | Name of this mobile application. |
| ad_group_criterion_parental_status_type | TEXT | Ad group criterion parental status type | Type of the parental status. |
| ad_group_criterion_percent_cpc_bid_micros | NUMERIC | Ad group criterion percent cpc bid micros | The CPC bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. |
| ad_group_criterion_placement_url | TEXT | Ad group criterion placement url | URL of the placement. For example, "http://www.domain.com". |
| ad_group_criterion_resource_name | TEXT | Ad group criterion resource name | The resource name of the ad group criterion. Ad group criterion resource names have the form: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id} |
| ad_group_criterion_topic_path | TEXT | Ad group criterion topic path | The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category. |
| ad_group_criterion_type | TEXT | Ad group criterion type | The type of the criterion. |
| ad_group_criterion_user_interest_user_interest_category | TEXT | Ad group criterion user interest user interest category | The UserInterest resource name. |
| ad_group_criterion_user_list_user_list | TEXT | Ad group criterion user list user list | The User List resource name. |
| ad_group_criterion_webpage_conditions | TEXT | Ad group criterion webpage conditions | Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_group_criterion_webpage_coverage_percentage | NUMERIC | Ad group criterion webpage coverage percentage | Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only. |
| ad_group_criterion_webpage_criterion_name | TEXT | Ad group criterion webpage criterion name | The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_group_criterion_webpage_sample_sample_urls | TEXT | Ad group criterion webpage sample sample urls | Webpage sample urls |
| ad_group_criterion_youtube_channel_channel_id | TEXT | Ad group criterion youtube channel channel id | The YouTube uploader channel id or the channel code of a YouTube channel. |
| ad_group_criterion_youtube_video_video_id | TEXT | Ad group criterion youtube video video id | YouTube video id as it appears on the YouTube watch page. |
| ad_group_effective_cpc_bid_micros | NUMERIC | Ad group effective cpc bid micros | Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. |
| ad_group_excluded_parent_asset_field_types | TEXT | Ad group excluded parent asset field types | The 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_in | BOOLEAN | Ad group explorer auto optimizer setting opt in | Indicates whether the optimizer is turned on. |
| ad_group_id | TEXT | Ad group id | The ID of the ad group. |
| ad_group_labels | TEXT | Ad group labels | The resource names of labels attached to this ad group. |
| ad_group_name | TEXT | Ad group name | The 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_micros | NUMERIC | Ad group percent cpc bid micros | The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. |
| ad_group_resource_name | TEXT | Ad group resource name | The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id} |
| ad_group_status | TEXT | Ad group status | The status of the ad group. |
| ad_group_target_cpa_micros | NUMERIC | Ad group target cpa micros | The 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_micros | NUMERIC | Ad group target cpm micros | Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. |
| ad_group_target_roas | NUMERIC | Ad group target roas | The 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_type | TEXT | Ad group type | The type of the ad group. |
| ad_hotel_ad | TEXT | Ad hotel ad | Details pertaining to a hotel ad. |
| ad_id | TEXT | Ad id | The ID of the ad. |
| ad_image_ad_image_url | TEXT | Ad image ad image url | URL of the full size image. |
| ad_image_ad_media_file | TEXT | Ad image ad media file | The MediaFile resource to use for the image. |
| ad_image_ad_mime_type | TEXT | Ad image ad mime type | The mime type of the image. |
| ad_image_ad_name | TEXT | Ad image ad name | The 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_height | NUMERIC | Ad image ad pixel height | Height in pixels of the full size image. |
| ad_image_ad_pixel_width | NUMERIC | Ad image ad pixel width | Width in pixels of the full size image. |
| ad_image_ad_preview_image_url | TEXT | Ad image ad preview image url | URL of the preview size image. |
| ad_image_ad_preview_pixel_height | NUMERIC | Ad image ad preview pixel height | Height in pixels of the preview size image. |
| ad_image_ad_preview_pixel_width | NUMERIC | Ad image ad preview pixel width | Width in pixels of the preview size image. |
| ad_legacy_app_install_ad | TEXT | Ad legacy app install ad | Details pertaining to a legacy app install ad. |
| ad_legacy_responsive_display_ad_accent_color | TEXT | Ad legacy responsive display ad accent color | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_legacy_responsive_display_ad_allow_flexible_color | BOOLEAN | Ad legacy responsive display ad allow flexible color | Advertiser'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_name | TEXT | Ad legacy responsive display ad business name | The business name in the ad. |
| ad_legacy_responsive_display_ad_call_to_action_text | TEXT | Ad legacy responsive display ad call to action text | The call-to-action text for the ad. |
| ad_legacy_responsive_display_ad_description | TEXT | Ad legacy responsive display ad description | The description of the ad. |
| ad_legacy_responsive_display_ad_format_setting | TEXT | Ad legacy responsive display ad format setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
| ad_legacy_responsive_display_ad_logo_image | TEXT | Ad legacy responsive display ad logo image | The MediaFile resource name of the logo image used in the ad. |
| ad_legacy_responsive_display_ad_long_headline | TEXT | Ad legacy responsive display ad long headline | The long version of the ad's headline. |
| ad_legacy_responsive_display_ad_main_color | TEXT | Ad legacy responsive display ad main color | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_legacy_responsive_display_ad_marketing_image | TEXT | Ad legacy responsive display ad marketing image | The MediaFile resource name of the marketing image used in the ad. |
| ad_legacy_responsive_display_ad_price_prefix | TEXT | Ad legacy responsive display ad price prefix | Prefix before price. For example, 'as low as'. |
| ad_legacy_responsive_display_ad_promo_text | TEXT | Ad legacy responsive display ad promo text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
| ad_legacy_responsive_display_ad_short_headline | TEXT | Ad legacy responsive display ad short headline | The short version of the ad's headline. |
| ad_legacy_responsive_display_ad_square_logo_image | TEXT | Ad legacy responsive display ad square logo image | The MediaFile resource name of the square logo image used in the ad. |
| ad_legacy_responsive_display_ad_square_marketing_image | TEXT | Ad legacy responsive display ad square marketing image | The MediaFile resource name of the square marketing image used in the ad. |
| ad_local_ad_call_to_actions | TEXT | Ad local ad call to actions | List 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_descriptions | TEXT | Ad local ad descriptions | List 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_headlines | TEXT | Ad local ad headlines | List 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_images | TEXT | Ad local ad logo images | List 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_asset | TEXT | Ad local ad logo images asset | The Asset resource name of this image. |
| ad_local_ad_marketing_images | TEXT | Ad local ad marketing images | List 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_asset | TEXT | Ad local ad marketing images asset | The Asset resource name of this image. |
| ad_local_ad_path1 | TEXT | Ad local ad path1 | First part of optional text that can be appended to the URL in the ad. |
| ad_local_ad_path2 | TEXT | Ad local ad path2 | Second 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_videos | TEXT | Ad local ad videos | List 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_asset | TEXT | Ad local ad videos asset | The Asset resource name of this video. |
| ad_name | TEXT | Ad name | 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_type | TEXT | Ad network type | Ad network type. |
| ad_network_type1 | TEXT | Ad network type1 | Ad network type. |
| ad_network_type2 | TEXT | Ad network type2 | Ad network type. |
| ad_resource_name | TEXT | Ad resource name | The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id} |
| ad_responsive_display_ad_accent_color | TEXT | Ad responsive display ad accent color | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_responsive_display_ad_allow_flexible_color | BOOLEAN | Ad responsive display ad allow flexible color | Advertiser'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_name | TEXT | Ad responsive display ad business name | The advertiser/brand name. Maximum display width is 25. |
| ad_responsive_display_ad_call_to_action_text | TEXT | Ad responsive display ad call to action text | The call-to-action text for the ad. Maximum display width is 30. |
| ad_responsive_display_ad_control_spec_enable_asset_enhancements | BOOLEAN | Ad responsive display ad control spec enable asset enhancements | Whether the advertiser has opted into the asset enhancements feature. |
| ad_responsive_display_ad_control_spec_enable_autogen_video | BOOLEAN | Ad responsive display ad control spec enable autogen video | Whether the advertiser has opted into auto-gen video feature. |
| ad_responsive_display_ad_descriptions | TEXT | Ad responsive display ad descriptions | Descriptive 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_setting | TEXT | Ad responsive display ad format setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
| ad_responsive_display_ad_headlines | TEXT | Ad responsive display ad headlines | Short 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_images | TEXT | Ad responsive display ad logo images | Logo 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_asset | TEXT | Ad responsive display ad logo images asset | The Asset resource name of this image. |
| ad_responsive_display_ad_long_headline | TEXT | Ad responsive display ad long headline | A required long format headline. The maximum length is 90 characters. |
| ad_responsive_display_ad_main_color | TEXT | Ad responsive display ad main color | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| ad_responsive_display_ad_marketing_images | TEXT | Ad responsive display ad marketing images | Marketing 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_asset | TEXT | Ad responsive display ad marketing images asset | The Asset resource name of this image. |
| ad_responsive_display_ad_price_prefix | TEXT | Ad responsive display ad price prefix | Prefix before price. For example, 'as low as'. |
| ad_responsive_display_ad_promo_text | TEXT | Ad responsive display ad promo text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
| ad_responsive_display_ad_square_logo_images | TEXT | Ad responsive display ad square logo images | Square 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_asset | TEXT | Ad responsive display ad square logo images asset | The Asset resource name of this image. |
| ad_responsive_display_ad_square_marketing_images | TEXT | Ad responsive display ad square marketing images | Square 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_asset | TEXT | Ad responsive display ad square marketing images asset | The Asset resource name of this image. |
| ad_responsive_display_ad_youtube_videos | TEXT | Ad responsive display ad youtube videos | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. |
| ad_responsive_display_ad_youtube_videos_asset | TEXT | Ad responsive display ad youtube videos asset | The Asset resource name of this video. |
| ad_responsive_search_ad_descriptions | TEXT | Ad responsive search ad descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| ad_responsive_search_ad_headlines | TEXT | Ad responsive search ad headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| ad_responsive_search_ad_path1 | TEXT | Ad responsive search ad path1 | First part of text that can be appended to the URL in the ad. |
| ad_responsive_search_ad_path2 | TEXT | Ad responsive search ad path2 | Second 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_mode | TEXT | Ad rotation mode | The ad rotation mode of the ad group. |
| ad_schedule_day_of_week | TEXT | Ad schedule day of week | Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_schedule_end_hour | NUMERIC | Ad schedule end hour | Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_schedule_end_minute | TEXT | Ad schedule end minute | Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_schedule_start_hour | NUMERIC | Ad schedule start hour | Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_schedule_start_minute | TEXT | Ad schedule start minute | Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| ad_serving_optimization_status | TEXT | Ad serving optimization status | The ad serving optimization status of the campaign. |
| ad_shopping_comparison_listing_ad_headline | TEXT | Ad shopping comparison listing ad headline | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. |
| ad_shopping_product_ad | TEXT | Ad shopping product ad | Details pertaining to a Shopping product ad. |
| ad_shopping_smart_ad | TEXT | Ad shopping smart ad | Details pertaining to a Smart Shopping ad. |
| ad_smart_campaign_ad_descriptions | TEXT | Ad smart campaign ad descriptions | List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. |
| ad_smart_campaign_ad_headlines | TEXT | Ad smart campaign ad headlines | List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. |
| ad_strength | TEXT | Ad strength | Overall ad strength for this ad group ad. |
| ad_system_managed_resource_source | TEXT | Ad system managed resource source | If this ad is system managed, then this field will indicate the source. This field is read-only. |
| ad_text_ad_description1 | TEXT | Ad text ad description1 | The first line of the ad's description. |
| ad_text_ad_description2 | TEXT | Ad text ad description2 | The second line of the ad's description. |
| ad_text_ad_headline | TEXT | Ad text ad headline | The headline of the ad. |
| ad_tracking_url_template | TEXT | Ad tracking url template | The URL template for constructing a tracking URL. |
| ad_type | TEXT | Ad type | The type of ad. |
| ad_url_collections | TEXT | Ad url collections | Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. |
| ad_url_custom_parameters | TEXT | Ad url custom parameters | The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations. |
| ad_video_ad_bumper_companion_banner_asset | TEXT | Ad video ad bumper companion banner asset | The Asset resource name of this image. |
| ad_video_ad_in_feed_description1 | TEXT | Ad video ad in feed description1 | First text line for the ad. |
| ad_video_ad_in_feed_description2 | TEXT | Ad video ad in feed description2 | Second text line for the ad. |
| ad_video_ad_in_feed_headline | TEXT | Ad video ad in feed headline | The headline of the ad. |
| ad_video_ad_in_feed_thumbnail | TEXT | Ad video ad in feed thumbnail | Video thumbnail image to use. |
| ad_video_ad_in_stream_action_button_label | TEXT | Ad video ad in stream action button label | Label 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_headline | TEXT | Ad video ad in stream action headline | Additional 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_asset | TEXT | Ad video ad in stream companion banner asset | The Asset resource name of this image. |
| ad_video_ad_non_skippable_action_button_label | TEXT | Ad video ad non skippable action button label | Label on the "Call To Action" button taking the user to the video ad's final URL. |
| ad_video_ad_non_skippable_action_headline | TEXT | Ad video ad non skippable action headline | Additional text displayed with the "Call To Action" button to give context and encourage clicking on the button. |
| ad_video_ad_non_skippable_companion_banner_asset | TEXT | Ad video ad non skippable companion banner asset | The Asset resource name of this image. |
| ad_video_ad_out_stream_description | TEXT | Ad video ad out stream description | The description line. |
| ad_video_ad_out_stream_headline | TEXT | Ad video ad out stream headline | The headline of the ad. |
| ad_video_ad_video_asset | TEXT | Ad video ad video asset | The Asset resource name of this video. |
| ad_video_responsive_ad_breadcrumb1 | TEXT | Ad video responsive ad breadcrumb1 | First part of text that appears in the ad with the displayed URL. |
| ad_video_responsive_ad_breadcrumb2 | TEXT | Ad video responsive ad breadcrumb2 | Second part of text that appears in the ad with the displayed URL. |
| ad_video_responsive_ad_call_to_actions | TEXT | Ad video responsive ad call to actions | List of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported. |
| ad_video_responsive_ad_companion_banners | TEXT | Ad video responsive ad companion banners | List 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_asset | TEXT | Ad video responsive ad companion banners asset | The Asset resource name of this image. |
| ad_video_responsive_ad_descriptions | TEXT | Ad video responsive ad descriptions | List of text assets used for the description. Currently, only a single value for the description is supported. |
| ad_video_responsive_ad_headlines | TEXT | Ad video responsive ad headlines | List of text assets used for the short headline, for example, the "Call To Action" banner. Currently, only a single value for the short headline is supported. |
| ad_video_responsive_ad_long_headlines | TEXT | Ad video responsive ad long headlines | List of text assets used for the long headline. Currently, only a single value for the long headline is supported. |
| ad_video_responsive_ad_videos | TEXT | Ad video responsive ad videos | List 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_asset | TEXT | Ad video responsive ad videos asset | The Asset resource name of this video. |
| adnetwork_conversions | NUMERIC | Adnetwork conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
| adnetwork_revenue | NUMERIC | Adnetwork revenue | The value of all conversions. |
| advertising_channel_sub_type | TEXT | Advertising channel sub type | 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_type | TEXT | Advertising channel type | 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. |
| age_range_type | TEXT | Age range type | Type of the age range. |
| age_range_view_resource_name | TEXT | Age range view resource name | The resource name of the age range view. Age range view resource names have the form: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id} |
| aggregator_id | NUMERIC | Aggregator id | Aggregator ID of the product. |
| all_conversion_rate | NUMERIC | All conversion rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
| all_conversion_value | NUMERIC | All conversion value | The value of all conversions. |
| all_conversions | NUMERIC | All conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
| all_conversions_by_conversion_date | NUMERIC | All conversions by conversion date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
| all_conversions_from_click_to_call | NUMERIC | All conversions from click to call | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
| all_conversions_from_directions | NUMERIC | All conversions from directions | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
| all_conversions_from_interactions_rate | NUMERIC | All conversions from interactions rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
| all_conversions_from_interactions_value_per_interaction | NUMERIC | All conversions from interactions value per interaction | The value of all conversions from interactions divided by the total number of interactions. |
| all_conversions_from_menu | NUMERIC | All conversions from menu | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
| all_conversions_from_order | NUMERIC | All conversions from order | The 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_engagement | NUMERIC | All conversions from other engagement | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
| all_conversions_from_store_visit | NUMERIC | All conversions from store visit | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
| all_conversions_from_store_website | NUMERIC | All conversions from store website | The 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_value | NUMERIC | All conversions value | The value of all conversions. |
| all_conversions_value_by_conversion_date | NUMERIC | All conversions value by conversion date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
| all_conversions_value_per_cost | NUMERIC | All conversions value per cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
| amount | NUMERIC | Amount | The amount of the budget for the selected date range, in the local currency for the account. |
| amount_micros | NUMERIC | Amount micros | The amount of the budget for the selected date range, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. |
| app_campaign_setting_app_id | TEXT | App campaign setting app id | A string that uniquely identifies a mobile application. |
| app_campaign_setting_app_store | TEXT | App campaign setting app store | The application store that distributes this specific app. |
| app_campaign_setting_bidding_strategy_goal_type | TEXT | App campaign setting bidding strategy goal type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
| app_payment_model_type | TEXT | App payment model type | Type of the app payment model. |
| approval_status | TEXT | Approval status | Approval status of the criterion. |
| asset_interaction_target_asset | TEXT | Asset interaction target asset | The asset resource name. |
| asset_interaction_target_interaction_on_this_asset | BOOLEAN | Asset interaction target interaction on this asset | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. |
| auction_insight_domain | TEXT | Auction insight domain | Domain (visible URL) of a participant in the Auction Insights report. |
| auction_insight_search_absolute_top_impression_percentage | NUMERIC | Auction insight search absolute top impression percentage | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed as the very first ad above the organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
| auction_insight_search_impression_share | NUMERIC | Auction insight search impression share | This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
| auction_insight_search_outranking_share | NUMERIC | Auction insight search outranking share | This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. |
| auction_insight_search_overlap_rate | NUMERIC | Auction insight search overlap rate | This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. |
| auction_insight_search_position_above_rate | NUMERIC | Auction insight search position above rate | This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. |
| auction_insight_search_top_impression_percentage | NUMERIC | Auction insight search top impression percentage | This metric is part of the Auction Insights report, and tells how often the ads of another participant showed above the organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
| audience_audience | TEXT | Audience audience | The Audience resource name. |
| audience_description | TEXT | Audience description | Description of this audience. |
| audience_dimensions | TEXT | Audience dimensions | Positive dimensions specifying the audience composition. |
| audience_dimensions_audience_segments_segments_custom_audience_custom_audience | TEXT | Audience dimensions audience segments segments custom audience custom audience | The custom audience resource. |
| audience_dimensions_audience_segments_segments_detailed_demographic_detailed_demographic | TEXT | Audience dimensions audience segments segments detailed demographic detailed demographic | The detailed demographic resource. |
| audience_dimensions_audience_segments_segments_life_event_life_event | TEXT | Audience dimensions audience segments segments life event life event | The life event resource. |
| audience_dimensions_audience_segments_segments_user_interest_user_interest_category | TEXT | Audience dimensions audience segments segments user interest user interest category | The user interest resource. |
| audience_dimensions_audience_segments_segments_user_list_user_list | TEXT | Audience dimensions audience segments segments user list user list | The user list resource. |
| audience_exclusion_dimension | TEXT | Audience exclusion dimension | Negative dimension specifying the audience composition. |
| audience_exclusion_dimension_exclusions_user_list_user_list | TEXT | Audience exclusion dimension exclusions user list user list | The user list resource. |
| audience_id | TEXT | Audience id | ID of the audience. |
| audience_name | TEXT | Audience name | Required. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255. |
| audience_resource_name | TEXT | Audience resource name | The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id} |
| audience_setting_use_audience_grouped | BOOLEAN | Audience setting use audience grouped | If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
| audience_status | TEXT | Audience status | Status of this audience. Indicates whether the audience is enabled or removed. |
| auto_tagging_enabled | BOOLEAN | Auto tagging enabled | Whether auto-tagging is enabled for the customer. |
| availabilities | TEXT | Availabilities | Availability information of the user interest. |
| average_cost | NUMERIC | Average cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
| average_cpc | NUMERIC | Average cpc | The total cost of all clicks divided by the total number of clicks received. |
| average_cpe | NUMERIC | Average cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
| average_cpm | NUMERIC | Average cpm | Average cost-per-thousand impressions (CPM). |
| average_cpv | NUMERIC | Average cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
| average_page_views | NUMERIC | Average page views | Average number of pages viewed per session. |
| average_pageviews | NUMERIC | Average pageviews | Average number of pages viewed per session. |
| average_time_on_site | NUMERIC | Average time on site | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
| base_ad_group | TEXT | Base ad group | 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_id | TEXT | Base ad group id | 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_campaign | TEXT | Base campaign | 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_id | TEXT | Base campaign id | 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. |
| basic_user_list_actions | TEXT | Basic user list actions | Actions associated with this user list. |
| benchmark_average_max_cpc | NUMERIC | Benchmark average max cpc | An indication of how other advertisers are bidding on similar products. |
| bid_modifier | NUMERIC | Bid modifier | The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. |
| biddable_app_install_conversions | NUMERIC | Biddable app install conversions | Number of app installs. |
| biddable_app_post_install_conversions | NUMERIC | Biddable app post install conversions | Number of in-app actions. |
| bidding_strategy | TEXT | Bidding strategy | Portfolio bidding strategy used by campaign. |
| bidding_strategy_campaign_count | NUMERIC | Bidding strategy campaign count | The number of campaigns attached to this bidding strategy. This field is read-only. |
| bidding_strategy_currency_code | TEXT | Bidding strategy currency code | 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_code | TEXT | Bidding strategy effective currency code | 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_cpc | TEXT | Bidding strategy enhanced cpc | A 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_id | TEXT | Bidding strategy id | Portfolio bidding strategy used by campaign. |
| bidding_strategy_maximize_conversion_value_cpc_bid_ceiling_micros | NUMERIC | Bidding strategy maximize conversion value cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Bidding strategy maximize conversion value cpc bid floor micros | Minimum 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_roas | NUMERIC | Bidding strategy maximize conversion value target roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
| bidding_strategy_maximize_conversions_cpc_bid_ceiling_micros | NUMERIC | Bidding strategy maximize conversions cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Bidding strategy maximize conversions cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
| bidding_strategy_maximize_conversions_target_cpa_micros | NUMERIC | Bidding strategy maximize conversions target cpa micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
| bidding_strategy_name | TEXT | Bidding strategy name | The 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_count | NUMERIC | Bidding strategy non removed campaign count | The number of non-removed campaigns attached to this bidding strategy. This field is read-only. |
| bidding_strategy_resource_name | TEXT | Bidding strategy resource name | The resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer_id}/biddingStrategies/{bidding_strategy_id} |
| bidding_strategy_source | TEXT | Bidding strategy source | 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_status | TEXT | Bidding strategy status | The status of the bidding strategy. This field is read-only. |
| bidding_strategy_system_status | TEXT | Bidding strategy system status | The system status of the campaign's bidding strategy. |
| bidding_strategy_target_cpa_cpc_bid_ceiling_micros | NUMERIC | Bidding strategy target cpa cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| bidding_strategy_target_cpa_cpc_bid_floor_micros | NUMERIC | Bidding strategy target cpa cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| bidding_strategy_target_cpa_target_cpa_micros | NUMERIC | Bidding strategy target cpa target cpa micros | 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_micros | NUMERIC | Bidding strategy target impression share cpc bid ceiling micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
| bidding_strategy_target_impression_share_location | TEXT | Bidding strategy target impression share location | The targeted location on the search results page. |
| bidding_strategy_target_impression_share_location_fraction_micros | NUMERIC | Bidding strategy target impression share location fraction micros | The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. |
| bidding_strategy_target_roas_cpc_bid_ceiling_micros | NUMERIC | Bidding strategy target roas cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| bidding_strategy_target_roas_cpc_bid_floor_micros | NUMERIC | Bidding strategy target roas cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| bidding_strategy_target_roas_target_roas | NUMERIC | Bidding strategy target roas target roas | Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
| bidding_strategy_target_spend_cpc_bid_ceiling_micros | NUMERIC | Bidding strategy target spend cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Bidding strategy target spend target spend micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
| bidding_strategy_type | TEXT | Bidding strategy type | 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_rate | NUMERIC | Bounce rate | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
| brand | TEXT | Brand | Brand of the product. |
| budget_amount | NUMERIC | Budget amount | The amount of the budget for the selected date range, in the local currency for the account. |
| budget_campaign_association_status_campaign | TEXT | Budget campaign association status campaign | The campaign resource name. |
| budget_campaign_association_status_status | TEXT | Budget campaign association status status | Budget campaign association status. |
| budget_id | TEXT | Budget id | The budget of the campaign. |
| call_reporting_setting_call_conversion_action | TEXT | Call reporting setting call conversion action | Customer-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_enabled | BOOLEAN | Call reporting setting call conversion reporting enabled | Whether to enable call conversion reporting. |
| call_reporting_setting_call_reporting_enabled | BOOLEAN | Call reporting setting call reporting enabled | Enable reporting of phone call events by redirecting them through Google System. |
| campaign | TEXT | Campaign | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
| campaign_accessible_bidding_strategy | TEXT | Campaign accessible bidding strategy | 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_status | TEXT | Campaign ad serving optimization status | The ad serving optimization status of the campaign. |
| campaign_app_campaign_setting_app_id | TEXT | Campaign app campaign setting app id | A string that uniquely identifies a mobile application. |
| campaign_app_campaign_setting_app_store | TEXT | Campaign app campaign setting app store | The application store that distributes this specific app. |
| campaign_app_campaign_setting_bidding_strategy_goal_type | TEXT | Campaign app campaign setting bidding strategy goal type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
| campaign_audience_setting_use_audience_grouped | BOOLEAN | Campaign audience setting use audience grouped | If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
| campaign_audience_view_resource_name | TEXT | Campaign audience view resource name | The resource name of the campaign audience view. Campaign audience view resource names have the form: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id} |
| campaign_bidding_strategy_system_status | TEXT | Campaign bidding strategy system status | The system status of the campaign's bidding strategy. |
| campaign_budget | NUMERIC | Campaign budget | The budget of the campaign. |
| campaign_budget_delivery_method | TEXT | Campaign budget delivery method | The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation. |
| campaign_budget_id | TEXT | Campaign budget id | 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_name | TEXT | Campaign budget name | The 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_clicks | NUMERIC | Campaign budget recommended budget estimated change weekly clicks | 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_micros | NUMERIC | Campaign budget recommended budget estimated change weekly cost micros | 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_interactions | NUMERIC | Campaign budget recommended budget estimated change weekly interactions | The estimated change in weekly interactions if the recommended budget is applied. This field is read-only. |
| campaign_budget_recommended_budget_estimated_change_weekly_views | NUMERIC | Campaign budget recommended budget estimated change weekly views | The estimated change in weekly views if the recommended budget is applied. This field is read-only. |
| campaign_budget_reference_count | NUMERIC | Campaign budget reference count | The number of campaigns actively using the budget. This field is read-only. |
| campaign_budget_resource_name | TEXT | Campaign budget resource name | The resource name of the campaign budget. Campaign budget resource names have the form: customers/{customer_id}/campaignBudgets/{campaign_budget_id} |
| campaign_budget_status | TEXT | Campaign budget status | The status of this campaign budget. This field is read-only. |
| campaign_budget_type | TEXT | Campaign budget type | The type of the campaign budget. |
| campaign_campaign_group | TEXT | Campaign campaign group | The campaign group this campaign belongs to. |
| campaign_commission_commission_rate_micros | NUMERIC | Campaign commission commission rate micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
| campaign_count | NUMERIC | Campaign count | The number of campaigns attached to this bidding strategy. This field is read-only. |
| campaign_criterion_ad_schedule_day_of_week | TEXT | Campaign criterion ad schedule day of week | Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_ad_schedule_end_hour | NUMERIC | Campaign criterion ad schedule end hour | Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_ad_schedule_end_minute | TEXT | Campaign criterion ad schedule end minute | Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_ad_schedule_start_hour | NUMERIC | Campaign criterion ad schedule start hour | Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_ad_schedule_start_minute | TEXT | Campaign criterion ad schedule start minute | Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_age_range_type | TEXT | Campaign criterion age range type | Type of the age range. |
| campaign_criterion_bid_modifier | NUMERIC | Campaign criterion bid modifier | The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type. |
| campaign_criterion_campaign | TEXT | Campaign criterion campaign | The campaign to which the criterion belongs. |
| campaign_criterion_carrier_carrier_constant | TEXT | Campaign criterion carrier carrier constant | The Carrier constant resource name. |
| campaign_criterion_combined_audience_combined_audience | TEXT | Campaign criterion combined audience combined audience | The CombinedAudience resource name. |
| campaign_criterion_content_label_type | TEXT | Campaign criterion content label type | Content label type, required for CREATE operations. |
| campaign_criterion_custom_affinity_custom_affinity | TEXT | Campaign criterion custom affinity custom affinity | The CustomInterest resource name. |
| campaign_criterion_custom_audience_custom_audience | TEXT | Campaign criterion custom audience custom audience | The CustomAudience resource name. |
| campaign_criterion_device_type | TEXT | Campaign criterion device type | Type of the device. |
| campaign_criterion_display_name | TEXT | Campaign criterion display name | The display name of the criterion. This field is ignored for mutates. |
| campaign_criterion_gender_type | TEXT | Campaign criterion gender type | Type of the gender. |
| campaign_criterion_income_range_type | TEXT | Campaign criterion income range type | Type of the income range. |
| campaign_criterion_ip_block_ip_address | TEXT | Campaign criterion ip block ip address | The IP address of this IP block. |
| campaign_criterion_keyword_match_type | TEXT | Campaign criterion keyword match type | The match type of the keyword. |
| campaign_criterion_keyword_theme_free_form_keyword_theme | TEXT | Campaign criterion keyword theme free form keyword theme | Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis. |
| campaign_criterion_keyword_theme_keyword_theme_constant | TEXT | Campaign criterion keyword theme keyword theme constant | The resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id} |
| campaign_criterion_language_language_constant | TEXT | Campaign criterion language language constant | The language constant resource name. |
| campaign_criterion_listing_scope_dimensions | TEXT | Campaign criterion listing scope dimensions | Scope of the campaign criterion. |
| campaign_criterion_listing_scope_dimensions_hotel_city_city_criterion | TEXT | Campaign criterion listing scope dimensions hotel city city criterion | The Geo Target Constant resource name. |
| campaign_criterion_listing_scope_dimensions_hotel_country_region_country_region_criterion | TEXT | Campaign criterion listing scope dimensions hotel country region country region criterion | The Geo Target Constant resource name. |
| campaign_criterion_listing_scope_dimensions_hotel_state_state_criterion | TEXT | Campaign criterion listing scope dimensions hotel state state criterion | The Geo Target Constant resource name. |
| campaign_criterion_location_geo_target_constant | TEXT | Campaign criterion location geo target constant | The geo target constant resource name. |
| campaign_criterion_location_group | TEXT | Campaign criterion location group | Location Group |
| campaign_criterion_location_group_feed | TEXT | Campaign criterion location group feed | Feed specifying locations for targeting. This is required and must be set in CREATE operations. |
| campaign_criterion_location_group_geo_target_constants | TEXT | Campaign criterion location group geo target constants | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
| campaign_criterion_mobile_app_category_mobile_app_category_constant | TEXT | Campaign criterion mobile app category mobile app category constant | The mobile app category constant resource name. |
| campaign_criterion_mobile_application_app_id | TEXT | Campaign criterion mobile application app id | A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations. |
| campaign_criterion_mobile_application_name | TEXT | Campaign criterion mobile application name | Name of this mobile application. |
| campaign_criterion_mobile_device_mobile_device_constant | TEXT | Campaign criterion mobile device mobile device constant | The mobile device constant resource name. |
| campaign_criterion_operating_system_version_operating_system_version_constant | TEXT | Campaign criterion operating system version operating system version constant | The operating system version constant resource name. |
| campaign_criterion_parental_status_type | TEXT | Campaign criterion parental status type | Type of the parental status. |
| campaign_criterion_placement_url | TEXT | Campaign criterion placement url | URL of the placement. For example, "http://www.domain.com". |
| campaign_criterion_proximity_address_city_name | TEXT | Campaign criterion proximity address city name | Name of the city. |
| campaign_criterion_proximity_address_country_code | TEXT | Campaign criterion proximity address country code | Country code. |
| campaign_criterion_proximity_address_postal_code | TEXT | Campaign criterion proximity address postal code | Postal code. |
| campaign_criterion_proximity_address_province_code | TEXT | Campaign criterion proximity address province code | Province or state code. |
| campaign_criterion_proximity_address_province_name | TEXT | Campaign criterion proximity address province name | Province or state name. |
| campaign_criterion_proximity_address_street_address | TEXT | Campaign criterion proximity address street address | Street address line 1. |
| campaign_criterion_proximity_geo_point_latitude_in_micro_degrees | NUMERIC | Campaign criterion proximity geo point latitude in micro degrees | Micro degrees for the latitude. |
| campaign_criterion_proximity_geo_point_longitude_in_micro_degrees | NUMERIC | Campaign criterion proximity geo point longitude in micro degrees | Micro degrees for the longitude. |
| campaign_criterion_proximity_radius | NUMERIC | Campaign criterion proximity radius | The radius of the proximity. |
| campaign_criterion_proximity_radius_units | TEXT | Campaign criterion proximity radius units | The unit of measurement of the radius. Default is KILOMETERS. |
| campaign_criterion_resource_name | TEXT | Campaign criterion resource name | The resource name of the campaign criterion. Campaign criterion resource names have the form: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id} |
| campaign_criterion_status | TEXT | Campaign criterion status | The status of the criterion. |
| campaign_criterion_topic_path | TEXT | Campaign criterion topic path | The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category. |
| campaign_criterion_topic_topic_constant | TEXT | Campaign criterion topic topic constant | The Topic Constant resource name. |
| campaign_criterion_user_interest_user_interest_category | TEXT | Campaign criterion user interest user interest category | The UserInterest resource name. |
| campaign_criterion_user_list_user_list | TEXT | Campaign criterion user list user list | The User List resource name. |
| campaign_criterion_webpage_conditions | TEXT | Campaign criterion webpage conditions | Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_webpage_coverage_percentage | NUMERIC | Campaign criterion webpage coverage percentage | Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only. |
| campaign_criterion_webpage_criterion_name | TEXT | Campaign criterion webpage criterion name | The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| campaign_criterion_webpage_sample_sample_urls | TEXT | Campaign criterion webpage sample sample urls | Webpage sample urls |
| campaign_criterion_youtube_channel_channel_id | TEXT | Campaign criterion youtube channel channel id | The YouTube uploader channel id or the channel code of a YouTube channel. |
| campaign_criterion_youtube_video_video_id | TEXT | Campaign criterion youtube video video id | YouTube video id as it appears on the YouTube watch page. |
| campaign_dynamic_search_ads_setting_domain_name | TEXT | Campaign dynamic search ads setting domain name | Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com". |
| campaign_dynamic_search_ads_setting_feeds | TEXT | Campaign dynamic search ads setting feeds | The list of page feeds associated with the campaign. |
| campaign_dynamic_search_ads_setting_language_code | TEXT | Campaign dynamic search ads setting language code | Required. The language code specifying the language of the domain, for example, "en". |
| campaign_dynamic_search_ads_setting_use_supplied_urls_only | BOOLEAN | Campaign dynamic search ads setting use supplied urls only | Whether the campaign uses advertiser supplied URLs exclusively. |
| campaign_excluded_parent_asset_field_types | TEXT | Campaign excluded parent asset field types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
| campaign_frequency_caps | TEXT | Campaign frequency caps | A list that limits how often each user will see this campaign's ads. |
| campaign_geo_target_type_setting_negative_geo_target_type | TEXT | Campaign geo target type setting negative geo target type | The setting used for negative geotargeting in this particular campaign. |
| campaign_geo_target_type_setting_positive_geo_target_type | TEXT | Campaign geo target type setting positive geo target type | The setting used for positive geotargeting in this particular campaign. |
| campaign_group | TEXT | Campaign group | The campaign group this campaign belongs to. |
| campaign_hotel_setting_hotel_center_id | NUMERIC | Campaign hotel setting hotel center id | The linked Hotel Center account. |
| campaign_id | TEXT | Campaign id | The ID of the campaign. |
| campaign_labels | TEXT | Campaign labels | The resource names of labels attached to this campaign. |
| campaign_local_campaign_setting_location_source_type | TEXT | Campaign local campaign setting location source type | The location source type for this local campaign. |
| campaign_local_services_campaign_settings_category_bids | TEXT | Campaign local services campaign settings category bids | Categorical level bids associated with MANUAL_CPA bidding strategy. |
| campaign_manual_cpa | TEXT | Campaign manual cpa | Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns. |
| campaign_manual_cpc_enhanced_cpc_enabled | BOOLEAN | Campaign manual cpc enhanced cpc enabled | Whether bids are to be enhanced based on conversion optimizer data. |
| campaign_manual_cpm | TEXT | Campaign manual cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
| campaign_manual_cpv | TEXT | Campaign manual cpv | A bidding strategy that pays a configurable amount per video view. |
| campaign_maximize_conversions_target_cpa_micros | NUMERIC | Campaign maximize conversions target cpa micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
| campaign_name | TEXT | Campaign name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
| campaign_network_settings_target_content_network | BOOLEAN | Campaign network settings target content network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
| campaign_network_settings_target_google_search | BOOLEAN | Campaign network settings target google search | Whether ads will be served with google.com search results. |
| campaign_network_settings_target_partner_search_network | BOOLEAN | Campaign network settings target partner search network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
| campaign_network_settings_target_search_network | BOOLEAN | Campaign network settings target search network | Whether 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_types | TEXT | Campaign optimization goal setting optimization goal types | The list of optimization goal types. |
| campaign_optimization_score | NUMERIC | Campaign optimization score | 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_mode | TEXT | Campaign payment mode | Payment mode for the campaign. |
| campaign_percent_cpc_cpc_bid_ceiling_micros | NUMERIC | Campaign percent cpc cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
| campaign_percent_cpc_enhanced_cpc_enabled | BOOLEAN | Campaign percent cpc enhanced cpc enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
| campaign_performance_max_upgrade_performance_max_campaign | TEXT | Campaign performance max upgrade performance max campaign | Indicates which Performance Max campaign the campaign is upgraded to. |
| campaign_performance_max_upgrade_pre_upgrade_campaign | TEXT | Campaign performance max upgrade pre upgrade campaign | Indicates legacy campaign upgraded to Performance Max. |
| campaign_performance_max_upgrade_status | TEXT | Campaign performance max upgrade status | The upgrade status of a campaign requested to be upgraded to Performance Max. |
| campaign_real_time_bidding_setting_opt_in | BOOLEAN | Campaign real time bidding setting opt in | Whether the campaign is opted in to real-time bidding. |
| campaign_resource_name | TEXT | Campaign resource name | The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
| campaign_selective_optimization_conversion_actions | TEXT | Campaign selective optimization conversion actions | The selected set of conversion actions for optimizing this campaign. |
| campaign_shopping_setting_campaign_priority | NUMERIC | Campaign shopping setting campaign priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
| campaign_shopping_setting_enable_local | BOOLEAN | Campaign shopping setting enable local | Whether to include local products. |
| campaign_shopping_setting_feed_label | TEXT | Campaign shopping setting feed label | Feed label of products to include in the campaign. Only one of feed_label or sales_country can be set. If used instead of sales_country, the feed_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center. |
| campaign_shopping_setting_merchant_id | NUMERIC | Campaign shopping setting merchant id | ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
| campaign_shopping_setting_sales_country | TEXT | Campaign shopping setting sales country | Sales country of products to include in the campaign. Only one of feed_label or sales_country can be set. Field is immutable except for clearing. Once this field is cleared, you must use feed_label if you want to set the sales country. |
| campaign_shopping_setting_use_vehicle_inventory | BOOLEAN | Campaign shopping setting use vehicle inventory | Whether to target Vehicle Listing inventory. |
| campaign_status | TEXT | Campaign status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
| campaign_target_cpa_cpc_bid_ceiling_micros | NUMERIC | Campaign target cpa cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| campaign_target_cpa_cpc_bid_floor_micros | NUMERIC | Campaign target cpa cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| campaign_target_cpa_target_cpa_micros | NUMERIC | Campaign target cpa target cpa micros | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
| campaign_target_cpm | TEXT | Campaign target cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
| campaign_target_impression_share_cpc_bid_ceiling_micros | NUMERIC | Campaign target impression share cpc bid ceiling micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
| campaign_target_impression_share_location | TEXT | Campaign target impression share location | The targeted location on the search results page. |
| campaign_target_impression_share_location_fraction_micros | NUMERIC | Campaign target impression share location fraction micros | The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. |
| campaign_target_roas_cpc_bid_ceiling_micros | NUMERIC | Campaign target roas cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| campaign_target_roas_cpc_bid_floor_micros | NUMERIC | Campaign target roas cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| campaign_target_roas_target_roas | NUMERIC | Campaign target roas target roas | Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
| campaign_target_spend_cpc_bid_ceiling_micros | NUMERIC | Campaign target spend cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Campaign target spend target spend micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
| campaign_targeting_setting_target_restrictions | TEXT | Campaign targeting setting target restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
| campaign_tracking_setting_tracking_url | TEXT | Campaign tracking setting tracking url | The url used for dynamic tracking. |
| campaign_trial_type | TEXT | Campaign trial type | The type of campaign: normal, draft, or experiment. |
| campaign_url_expansion_opt_out | BOOLEAN | Campaign url expansion opt out | Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false. |
| campaign_vanity_pharma_vanity_pharma_display_url_mode | TEXT | Campaign vanity pharma vanity pharma display url mode | The display mode for vanity pharma URLs. |
| campaign_vanity_pharma_vanity_pharma_text | TEXT | Campaign vanity pharma vanity pharma text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
| campaign_video_brand_safety_suitability | TEXT | Campaign video brand safety suitability | 3-Tier Brand Safety setting for the campaign. |
| carrier_carrier_constant | TEXT | Carrier carrier constant | The Carrier constant resource name. |
| category_l1 | TEXT | Category l1 | Bidding category (level 1) of the product. |
| category_l2 | TEXT | Category l2 | Bidding category (level 2) of the product. |
| category_l3 | TEXT | Category l3 | Bidding category (level 3) of the product. |
| category_l4 | TEXT | Category l4 | Bidding category (level 4) of the product. |
| category_l5 | TEXT | Category l5 | Bidding category (level 5) of the product. |
| channel | TEXT | Channel | Channel of the product. |
| channel_exclusivity | TEXT | Channel exclusivity | Channel exclusivity of the product. |
| city | TEXT | Geo target city | Geo target city name. |
| click_type | TEXT | Click type | Click type. |
| clicks | NUMERIC | Clicks | The number of clicks. |
| closing_reason | TEXT | Closing reason | Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open. |
| combined_audience_combined_audience | TEXT | Combined audience combined audience | The CombinedAudience resource name. |
| commission_commission_rate_micros | NUMERIC | Commission commission rate micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
| content_bid_criterion_type_group | TEXT | Content bid criterion type group | Allows 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_share | NUMERIC | Content budget lost impression share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| content_impression_share | NUMERIC | Content impression share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
| content_label_type | TEXT | Content label type | Content label type, required for CREATE operations. |
| content_rank_lost_impression_share | NUMERIC | Content rank lost impression share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| conversion_action | TEXT | Conversion action | Resource name of the conversion action. |
| conversion_action_category | TEXT | Conversion action category | Conversion action category. |
| conversion_action_name | TEXT | Conversion action name | Conversion action name. |
| conversion_adjustment | BOOLEAN | Conversion adjustment | This segments your conversion columns by the original conversion and conversion value versus the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data. |
| conversion_adjustment_lag_bucket | TEXT | Conversion adjustment lag bucket | An 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_type | TEXT | Conversion attribution event type | Conversion attribution event type. |
| conversion_category_name | TEXT | Conversion category name | Conversion action category. |
| conversion_lag_bucket | TEXT | Conversion lag bucket | An enum value representing the number of days between the impression and the conversion. |
| conversion_last_conversion_date | DATE | Conversion last conversion date | The date of the most recent conversion for this conversion action. The date is in the customer's time zone. |
| conversion_last_received_request_date_time | DATE | Conversion last received request date time | The last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (for example, because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone. |
| conversion_or_adjustment_lag_bucket | TEXT | Conversion or adjustment lag bucket | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
| conversion_rate | PERCENT | Conversion rate | 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. |
| conversion_tracker_id | TEXT | Conversion tracker id | Resource name of the conversion action. |
| conversion_tracking_setting_accepted_customer_data_terms | BOOLEAN | Conversion tracking setting accepted customer data terms | Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709. |
| conversion_tracking_setting_conversion_tracking_id | NUMERIC | Conversion tracking setting conversion tracking id | The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only. |
| conversion_tracking_setting_conversion_tracking_status | TEXT | Conversion tracking setting conversion tracking status | Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request. |
| conversion_tracking_setting_cross_account_conversion_tracking_id | NUMERIC | Conversion tracking setting cross account conversion tracking id | 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_tracking_setting_enhanced_conversions_for_leads_enabled | BOOLEAN | Conversion tracking setting enhanced conversions for leads enabled | Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. |
| conversion_tracking_setting_google_ads_conversion_customer | TEXT | Conversion tracking setting google ads conversion customer | The resource name of the customer where conversions are created and managed. This field is read-only. |
| conversion_type_name | TEXT | Conversion type name | Conversion action name. |
| conversion_value | NUMERIC | Conversion value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| conversion_value_rule_primary_dimension | TEXT | Conversion value rule primary dimension | Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. |
| conversions | NUMERIC | Conversions | 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. |
| conversions_by_conversion_date | NUMERIC | Conversions by conversion date | 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. |
| conversions_from_interactions_rate | NUMERIC | Conversions from interactions rate | 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. |
| conversions_from_interactions_value_per_interaction | NUMERIC | Conversions from interactions value per interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| conversions_value | NUMERIC | Conversions value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| conversions_value_by_conversion_date | NUMERIC | Conversions value by conversion date | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
| conversions_value_per_cost | NUMERIC | Conversions value per cost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| cost | NUMERIC | Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
| cost_micros | NUMERIC | Cost micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
| cost_per_all_conversion | NUMERIC | Cost per all conversion | The cost of ad interactions divided by all conversions. |
| cost_per_all_conversions | NUMERIC | Cost per all conversions | The cost of ad interactions divided by all conversions. |
| cost_per_conversion | NUMERIC | Cost per conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| cost_per_current_model_attributed_conversion | NUMERIC | Cost per current model attributed conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| country | COUNTRY | Geo target country code | Geo target country code. |
| country_criteria_id | TEXT | Country criteria id | Resource name of the geo target constant for the country of sale of the product. |
| country_criterion_id | NUMERIC | Country criterion id | Criterion Id for the country. |
| cpc_bid | NUMERIC | Cpc bid | The maximum CPC (cost-per-click) bid. |
| cpc_bid_micros | NUMERIC | Cpc bid micros | The maximum CPC (cost-per-click) bid. |
| cpc_bid_source | TEXT | Cpc bid source | Source of the effective CPC bid. |
| cpm_bid | NUMERIC | Cpm bid | The maximum CPM (cost-per-thousand viewable impressions) bid. |
| cpm_bid_micros | NUMERIC | Cpm bid micros | The maximum CPM (cost-per-thousand viewable impressions) bid. |
| cpm_bid_source | TEXT | Cpm bid source | Source of the effective CPM bid. |
| cpv_bid | NUMERIC | Cpv bid | The CPV (cost-per-view) bid. |
| cpv_bid_micros | NUMERIC | Cpv bid micros | The CPV (cost-per-view) bid. |
| creative_quality_score | TEXT | Creative quality score | The performance of the ad compared to other advertisers. |
| criteria | TEXT | Criteria | Type of the age range. |
| criteria_type | TEXT | Criteria type | The type of the criterion. |
| criterion_id | NUMERIC | Criterion id | The ID of the criterion. This field is ignored for mutates. |
| crm_based_user_list_app_id | TEXT | Crm based user list app id | A string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs. |
| crm_based_user_list_data_source_type | TEXT | Crm based user list data source type | Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists. |
| crm_based_user_list_upload_key_type | TEXT | Crm based user list upload key type | Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation. |
| cross_device_conversions | NUMERIC | Cross device conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
| ctr | PERCENT | Ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
| currency | TEXT | Currency | The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
| currency_code | TEXT | Currency code | The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
| current_model_attributed_conversion_value | NUMERIC | Current model attributed conversion value | The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| current_model_attributed_conversions | NUMERIC | Current model attributed conversions | Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| current_model_attributed_conversions_from_interactions_rate | NUMERIC | Current model attributed conversions from interactions rate | Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| current_model_attributed_conversions_from_interactions_value_per_interaction | NUMERIC | Current model attributed conversions from interactions value per interaction | The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| current_model_attributed_conversions_value | NUMERIC | Current model attributed conversions value | The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| current_model_attributed_conversions_value_per_cost | NUMERIC | Current model attributed conversions value per cost | The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| custom_affinity_custom_affinity | TEXT | Custom affinity custom affinity | The CustomInterest resource name. |
| custom_attribute0 | TEXT | Custom attribute0 | Custom attribute 0 of the product. |
| custom_attribute1 | TEXT | Custom attribute1 | Custom attribute 1 of the product. |
| custom_attribute2 | TEXT | Custom attribute2 | Custom attribute 2 of the product. |
| custom_attribute3 | TEXT | Custom attribute3 | Custom attribute 3 of the product. |
| custom_attribute4 | TEXT | Custom attribute4 | Custom attribute 4 of the product. |
| custom_audience_custom_audience | TEXT | Custom audience custom audience | The CustomAudience resource name. |
| custom_intent_custom_intent | TEXT | Custom intent custom intent | The CustomInterest resource name. |
| customer_auto_tagging_enabled | BOOLEAN | Customer auto tagging enabled | Whether auto-tagging is enabled for the customer. |
| customer_call_reporting_setting_call_conversion_action | TEXT | Customer call reporting setting call conversion action | Customer-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_enabled | BOOLEAN | Customer call reporting setting call conversion reporting enabled | Whether to enable call conversion reporting. |
| customer_call_reporting_setting_call_reporting_enabled | BOOLEAN | Customer call reporting setting call reporting enabled | Enable reporting of phone call events by redirecting them through Google System. |
| customer_conversion_tracking_setting_accepted_customer_data_terms | BOOLEAN | Customer conversion tracking setting accepted customer data terms | Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709. |
| customer_conversion_tracking_setting_conversion_tracking_id | NUMERIC | Customer conversion tracking setting conversion tracking id | The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only. |
| customer_conversion_tracking_setting_conversion_tracking_status | TEXT | Customer conversion tracking setting conversion tracking status | Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request. |
| customer_conversion_tracking_setting_cross_account_conversion_tracking_id | NUMERIC | Customer conversion tracking setting cross account conversion tracking id | 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_conversion_tracking_setting_enhanced_conversions_for_leads_enabled | BOOLEAN | Customer conversion tracking setting enhanced conversions for leads enabled | Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. |
| customer_conversion_tracking_setting_google_ads_conversion_customer | TEXT | Customer conversion tracking setting google ads conversion customer | The resource name of the customer where conversions are created and managed. This field is read-only. |
| customer_descriptive_name | TEXT | Customer descriptive name | Optional, non-unique descriptive name of the customer. |
| customer_final_url_suffix | TEXT | Customer final url suffix | The URL template for appending params to the final URL |
| customer_has_partners_badge | BOOLEAN | Customer has partners badge | 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_manager | BOOLEAN | Customer manager | Whether the customer is a manager. |
| customer_optimization_score | NUMERIC | Customer optimization score | 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_weight | NUMERIC | Customer optimization score weight | 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_reasons | TEXT | Customer pay per conversion eligibility failure reasons | 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_tag | TEXT | Customer remarketing setting google global site tag | The Google tag. |
| customer_resource_name | TEXT | Customer resource name | The resource name of the customer. Customer resource names have the form: customers/{customer_id} |
| customer_status | TEXT | Customer status | The status of the customer. |
| customer_test_account | BOOLEAN | Customer test account | Whether the customer is a test account. |
| customer_tracking_url_template | TEXT | Customer tracking url template | The URL template for constructing a tracking URL out of parameters. |
| date | DATE | Date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
| day_of_week | TEXT | Day of week | Day of the week, for example, MONDAY. |
| delivery_method | TEXT | Delivery method | The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation. |
| description | TEXT | Description | Description of this user list. |
| descriptive_name | TEXT | Descriptive name | Optional, non-unique descriptive name of the customer. |
| detail_placement_view_display_name | TEXT | Detail placement view display name | The display name is URL name for websites, YouTube video name for YouTube videos, and translated mobile app name for mobile apps. |
| detail_placement_view_group_placement_target_url | TEXT | Detail placement view group placement target url | URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL. |
| detail_placement_view_placement | TEXT | Detail placement view placement | The automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID. |
| detail_placement_view_placement_type | TEXT | Detail placement view placement type | Type of the placement, for example, Website, YouTube Video, and Mobile Application. |
| detail_placement_view_resource_name | TEXT | Detail placement view resource name | The resource name of the detail placement view. Detail placement view resource names have the form: customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement} |
| detail_placement_view_target_url | TEXT | Detail placement view target url | URL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL. |
| device | TEXT | Device | Device to which metrics apply. |
| device_type | TEXT | Device type | Type of the device. |
| dimensions | TEXT | Dimensions | Positive dimensions specifying the audience composition. |
| dimensions_audience_segments_segments_custom_audience_custom_audience | TEXT | Dimensions audience segments segments custom audience custom audience | The custom audience resource. |
| dimensions_audience_segments_segments_detailed_demographic_detailed_demographic | TEXT | Dimensions audience segments segments detailed demographic detailed demographic | The detailed demographic resource. |
| dimensions_audience_segments_segments_life_event_life_event | TEXT | Dimensions audience segments segments life event life event | The life event resource. |
| dimensions_audience_segments_segments_user_interest_user_interest_category | TEXT | Dimensions audience segments segments user interest user interest category | The user interest resource. |
| dimensions_audience_segments_segments_user_list_user_list | TEXT | Dimensions audience segments segments user list user list | The user list resource. |
| disapproval_reasons | TEXT | Disapproval reasons | List of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only. |
| display_custom_bid_dimension | TEXT | Display custom bid dimension | Allows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. |
| display_name | TEXT | Display name | The display name of the criterion. This field is ignored for mutates. |
| dynamic_search_ads_setting_domain_name | TEXT | Dynamic search ads setting domain name | Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com". |
| dynamic_search_ads_setting_feeds | TEXT | Dynamic search ads setting feeds | The list of page feeds associated with the campaign. |
| dynamic_search_ads_setting_language_code | TEXT | Dynamic search ads setting language code | Required. The language code specifying the language of the domain, for example, "en". |
| dynamic_search_ads_setting_use_supplied_urls_only | BOOLEAN | Dynamic search ads setting use supplied urls only | Whether the campaign uses advertiser supplied URLs exclusively. |
| effective_cpc_bid_micros | NUMERIC | Effective cpc bid micros | Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. |
| effective_cpc_bid_source | TEXT | Effective cpc bid source | Source of the effective CPC bid. |
| effective_cpm_bid_micros | NUMERIC | Effective cpm bid micros | The effective CPM (cost-per-thousand viewable impressions) bid. |
| effective_cpm_bid_source | TEXT | Effective cpm bid source | Source of the effective CPM bid. |
| effective_cpv_bid_micros | NUMERIC | Effective cpv bid micros | The effective CPV (cost-per-view) bid. |
| effective_cpv_bid_source | TEXT | Effective cpv bid source | Source of the effective CPV bid. |
| effective_currency_code | TEXT | Effective currency code | 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_percent_cpc_bid_micros | NUMERIC | Effective percent cpc bid micros | The effective Percent CPC bid amount. |
| effective_percent_cpc_bid_source | TEXT | Effective percent cpc bid source | Source of the effective Percent CPC bid. |
| effective_target_cpa_micros | NUMERIC | Effective target cpa micros | The effective target CPA (cost-per-acquisition). This field is read-only. |
| effective_target_cpa_source | TEXT | Effective target cpa source | Source of the effective target CPA. This field is read-only. |
| effective_target_roas | NUMERIC | Effective target roas | The effective target ROAS (return-on-ad-spend). This field is read-only. |
| effective_target_roas_source | TEXT | Effective target roas source | Source of the effective target ROAS. This field is read-only. |
| eligible_for_display | BOOLEAN | Eligible for display | Indicates this user list is eligible for Google Display Network. This field is read-only. |
| eligible_for_search | BOOLEAN | Eligible for search | Indicates if this user list is eligible for Google Search Network. |
| end_date | DATE | End date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
| engagement_rate | NUMERIC | Engagement rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
| engagements | NUMERIC | Engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
| enhanced_cpc | TEXT | Enhanced cpc | A bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely. |
| estimated_add_clicks_at_first_position_cpc | NUMERIC | Estimated add clicks at first position cpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros. |
| estimated_add_cost_at_first_position_cpc | NUMERIC | Estimated add cost at first position cpc | Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros. |
| excluded_parent_asset_field_types | TEXT | Excluded parent asset field types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
| exclusion_dimension | TEXT | Exclusion dimension | Negative dimension specifying the audience composition. |
| exclusion_dimension_exclusions_user_list_user_list | TEXT | Exclusion dimension exclusions user list user list | The user list resource. |
| experiment_type | TEXT | Experiment type | The type of campaign: normal, draft, or experiment. |
| explicitly_shared | BOOLEAN | Explicitly shared | Specifies 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_in | BOOLEAN | Explorer auto optimizer setting opt in | Indicates whether the optimizer is turned on. |
| external_conversion_source | TEXT | External conversion source | External conversion source. |
| external_customer_id | NUMERIC | External customer id | The ID of the customer. |
| final_mobile_urls | TEXT | Final mobile urls | The list of possible final mobile URLs after all cross-domain redirects. |
| final_url | TEXT | Final url | The advertiser-specified final URL. |
| final_url_suffix | TEXT | Final url suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
| final_urls | TEXT | Final urls | The list of possible final URLs after all cross-domain redirects for the ad. |
| first_page_cpc | NUMERIC | First page cpc | The estimate of the CPC bid required for ad to be shown on first page of search results. |
| first_position_cpc | NUMERIC | First position cpc | The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results. |
| frequency_caps | TEXT | Frequency caps | A list that limits how often each user will see this campaign's ads. |
| gender_type | TEXT | Gender type | Type of the gender. |
| gender_view_resource_name | TEXT | Gender view resource name | The resource name of the gender view. Gender view resource names have the form: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id} |
| geo_target_airport | TEXT | Geo target airport | Resource name of the geo target constant that represents an airport. |
| geo_target_canton | TEXT | Geo target canton | Resource name of the geo target constant that represents a canton. |
| geo_target_city | TEXT | Geo target city | Resource name of the geo target constant that represents a city. |
| geo_target_country | TEXT | Geo target country | Resource name of the geo target constant that represents a country. |
| geo_target_county | TEXT | Geo target county | Resource name of the geo target constant that represents a county. |
| geo_target_district | TEXT | Geo target district | Resource name of the geo target constant that represents a district. |
| geo_target_metro | TEXT | Geo target metro | Resource name of the geo target constant that represents a metro. |
| geo_target_most_specific_location | TEXT | Geo target most specific location | Resource name of the geo target constant that represents the most specific location. |
| geo_target_postal_code | TEXT | Geo target postal code | Resource name of the geo target constant that represents a postal code. |
| geo_target_province | TEXT | Geo target province | Resource name of the geo target constant that represents a province. |
| geo_target_region | TEXT | Geo target region | Resource name of the geo target constant that represents a region. |
| geo_target_state | TEXT | Geo target state | Resource name of the geo target constant that represents a state. |
| geo_target_type_setting_negative_geo_target_type | TEXT | Geo target type setting negative geo target type | The setting used for negative geotargeting in this particular campaign. |
| geo_target_type_setting_positive_geo_target_type | TEXT | Geo target type setting positive geo target type | The setting used for positive geotargeting in this particular campaign. |
| geographic_view_country_criterion_id | NUMERIC | Geographic view country criterion id | Criterion Id for the country. |
| geographic_view_location_type | TEXT | Geographic view location type | Type of the geo targeting of the campaign. |
| geographic_view_resource_name | TEXT | Geographic view resource name | The resource name of the geographic view. Geographic view resource names have the form: customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type} |
| gmail_forwards | NUMERIC | Gmail forwards | The number of times the ad was forwarded to someone else as a message. |
| gmail_saves | NUMERIC | Gmail saves | The number of times someone has saved your Gmail ad to their inbox as a message. |
| gmail_secondary_clicks | NUMERIC | Gmail secondary clicks | The number of clicks to the landing page on the expanded state of Gmail ads. |
| group_placement_target_url | TEXT | Group placement target url | URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL. |
| has_partners_badge | BOOLEAN | Has partners badge | 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_budget | BOOLEAN | Has recommended budget | Indicates whether there is a recommended budget for this campaign budget. This field is read-only. |
| historical_creative_quality_score | TEXT | Historical creative quality score | The creative historical quality score. |
| historical_landing_page_quality_score | TEXT | Historical landing page quality score | The quality of historical landing page experience. |
| historical_quality_score | NUMERIC | Historical quality score | The historical quality score. |
| historical_search_predicted_ctr | TEXT | Historical search predicted ctr | The historical search predicted click through rate (CTR). |
| hotel_average_lead_value_micros | NUMERIC | Hotel average lead value micros | Average lead value based on clicks. |
| hotel_booking_window_days | NUMERIC | Hotel booking window days | Hotel booking window in days. |
| hotel_center_id | NUMERIC | Hotel center id | Hotel center ID. |
| hotel_check_in_date | DATE | Hotel check in date | Hotel check-in date. Formatted as yyyy-MM-dd. |
| hotel_check_in_day_of_week | TEXT | Hotel check in day of week | Hotel check-in day of week. |
| hotel_city | TEXT | Hotel city | Hotel city. |
| hotel_class | NUMERIC | Hotel class | Hotel class. |
| hotel_country | TEXT | Hotel country | Hotel country. |
| hotel_date_selection_type | TEXT | Hotel date selection type | Hotel date selection type. |
| hotel_eligible_impressions | NUMERIC | Hotel eligible impressions | The number of impressions that hotel partners could have had given their feed performance. |
| hotel_length_of_stay | NUMERIC | Hotel length of stay | Hotel length of stay. |
| hotel_price_bucket | TEXT | Hotel price bucket | Hotel price bucket. |
| hotel_price_difference_percentage | NUMERIC | Hotel price difference percentage | The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. |
| hotel_rate_rule_id | TEXT | Hotel rate rule id | Hotel rate rule ID. |
| hotel_rate_type | TEXT | Hotel rate type | Hotel rate type. |
| hotel_setting_hotel_center_id | NUMERIC | Hotel setting hotel center id | The linked Hotel Center account. |
| hotel_state | TEXT | Hotel state | Hotel state. |
| hour | TEXT | Hour | Hour of day as a number between 0 and 23, inclusive. |
| hour_of_day | NUMERIC | Hour of day | Hour of day as a number between 0 and 23, inclusive. |
| id | TEXT | Id | The ID of the campaign. |
| impressions | NUMERIC | Impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
| income_range_type | TEXT | Income range type | Type of the income range. |
| integration_code | TEXT | Integration code | An ID from external system. It is used by user list sellers to correlate IDs on their systems. |
| interaction_event_types | TEXT | Interaction event types | The types of payable and free interactions. |
| interaction_on_this_extension | BOOLEAN | Interaction on this extension | Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. |
| interaction_rate | NUMERIC | Interaction rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
| interaction_types | TEXT | Interaction types | The types of payable and free interactions. |
| interactions | NUMERIC | Interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
| invalid_click_rate | NUMERIC | Invalid click rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
| invalid_clicks | NUMERIC | Invalid clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
| ip_block_ip_address | TEXT | Ip block ip address | The IP address of this IP block. |
| is_budget_explicitly_shared | BOOLEAN | Is budget explicitly shared | Specifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared. |
| is_negative | BOOLEAN | Is negative | Whether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it. |
| is_restrict | TEXT | Is restrict | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
| keyword_ad_group_criterion | TEXT | Keyword ad group criterion | The AdGroupCriterion resource name. |
| keyword_criterion_id | TEXT | Keyword Criterion ID | The Criterion ID for a keyword |
| keyword_info_match_type | TEXT | Keyword info match type | The match type of the keyword. |
| keyword_info_text | TEXT | Keyword info text | The text of the keyword (at most 80 characters and 10 words). |
| keyword_match_type | TEXT | Keyword match type | The match type of the keyword. |
| keyword_text | TEXT | Keyword text | The text of the keyword (at most 80 characters and 10 words). |
| keyword_theme_free_form_keyword_theme | TEXT | Keyword theme free form keyword theme | Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis. |
| keyword_theme_keyword_theme_constant | TEXT | Keyword theme keyword theme constant | The resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id} |
| keyword_view_resource_name | TEXT | Keyword view resource name | The resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id} |
| label_id | NUMERIC | Label id | ID of the label. Read only. |
| label_name | TEXT | Label name | The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive. |
| label_resource_name | TEXT | Label resource name | Name of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id} |
| label_status | TEXT | Label status | Status of the label. Read only. |
| label_text_label_background_color | TEXT | Label text label background color | Background color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. |
| label_text_label_description | TEXT | Label text label description | A short description of the label. The length must be no more than 200 characters. |
| labels | TEXT | Labels | The resource names of labels attached to this campaign. |
| landing_page_view_resource_name | TEXT | Landing page view resource name | The resource name of the landing page view. Landing page view resource names have the form: customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint} |
| language_criteria_id | TEXT | Language criteria id | Resource name of the language constant for the language of the product. |
| language_language_constant | TEXT | Language language constant | The language constant resource name. |
| launched_to_all | BOOLEAN | Launched to all | True if the user interest is launched to all channels and locales. |
| listing_group_case_value_hotel_city_city_criterion | TEXT | Listing group case value hotel city city criterion | The Geo Target Constant resource name. |
| listing_group_case_value_hotel_class_value | NUMERIC | Listing group case value hotel class value | Long value of the hotel class. |
| listing_group_case_value_hotel_country_region_country_region_criterion | TEXT | Listing group case value hotel country region country region criterion | The Geo Target Constant resource name. |
| listing_group_case_value_hotel_id_value | TEXT | Listing group case value hotel id value | String value of the hotel ID. |
| listing_group_case_value_hotel_state_state_criterion | TEXT | Listing group case value hotel state state criterion | The Geo Target Constant resource name. |
| listing_group_case_value_product_bidding_category_country_code | TEXT | Listing group case value product bidding category country code | Two-letter upper-case country code of the product bidding category. It must match the campaign.shopping_setting.sales_country field. |
| listing_group_case_value_product_bidding_category_id | NUMERIC | Listing group case value product bidding category id | ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 |
| listing_group_case_value_product_bidding_category_level | TEXT | Listing group case value product bidding category level | Level of the product bidding category. |
| listing_group_case_value_product_brand_value | TEXT | Listing group case value product brand value | String value of the product brand. |
| listing_group_case_value_product_channel_channel | TEXT | Listing group case value product channel channel | Value of the locality. |
| listing_group_case_value_product_channel_exclusivity_channel_exclusivity | TEXT | Listing group case value product channel exclusivity channel exclusivity | Value of the availability. |
| listing_group_case_value_product_condition_condition | TEXT | Listing group case value product condition condition | Value of the condition. |
| listing_group_case_value_product_custom_attribute_index | TEXT | Listing group case value product custom attribute index | Indicates the index of the custom attribute. |
| listing_group_case_value_product_custom_attribute_value | TEXT | Listing group case value product custom attribute value | String value of the product custom attribute. |
| listing_group_case_value_product_item_id_value | TEXT | Listing group case value product item id value | Value of the id. |
| listing_group_case_value_product_type_level | TEXT | Listing group case value product type level | Level of the type. |
| listing_group_case_value_product_type_value | TEXT | Listing group case value product type value | Value of the type. |
| listing_group_parent_ad_group_criterion | TEXT | Listing group parent ad group criterion | Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group. |
| listing_group_type | TEXT | Listing group type | Type of the listing group. |
| listing_scope_dimensions | TEXT | Listing scope dimensions | Scope of the campaign criterion. |
| listing_scope_dimensions_hotel_city_city_criterion | TEXT | Listing scope dimensions hotel city city criterion | The Geo Target Constant resource name. |
| listing_scope_dimensions_hotel_country_region_country_region_criterion | TEXT | Listing scope dimensions hotel country region country region criterion | The Geo Target Constant resource name. |
| listing_scope_dimensions_hotel_state_state_criterion | TEXT | Listing scope dimensions hotel state state criterion | The Geo Target Constant resource name. |
| local_campaign_setting_location_source_type | TEXT | Local campaign setting location source type | The location source type for this local campaign. |
| local_services_campaign_settings_category_bids | TEXT | Local services campaign settings category bids | Categorical level bids associated with MANUAL_CPA bidding strategy. |
| location_geo_target_constant | TEXT | Location geo target constant | The geo target constant resource name. |
| location_group | TEXT | Location group | Location Group |
| location_group_feed | TEXT | Location group feed | Feed specifying locations for targeting. This is required and must be set in CREATE operations. |
| location_group_geo_target_constants | TEXT | Location group geo target constants | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
| location_type | TEXT | Location type | Type of the geo targeting of the campaign. |
| logical_user_list_rules | TEXT | Logical user list rules | Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list. |
| manager | BOOLEAN | Manager | Whether the customer is a manager. |
| manual_cpa | TEXT | Manual cpa | Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns. |
| manual_cpc_enhanced_cpc_enabled | BOOLEAN | Manual cpc enhanced cpc enabled | Whether bids are to be enhanced based on conversion optimizer data. |
| manual_cpm | TEXT | Manual cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
| manual_cpv | TEXT | Manual cpv | A bidding strategy that pays a configurable amount per video view. |
| match_rate_percentage | NUMERIC | Match rate percentage | Indicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only. |
| maximize_conversion_value_cpc_bid_ceiling_micros | NUMERIC | Maximize conversion value cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Maximize conversion value cpc bid floor micros | Minimum 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_roas | NUMERIC | Maximize conversion value target roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
| maximize_conversions_cpc_bid_ceiling_micros | NUMERIC | Maximize conversions cpc bid ceiling micros | Maximum 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_micros | NUMERIC | Maximize conversions cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
| maximize_conversions_target_cpa_micros | NUMERIC | Maximize conversions target cpa micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
| membership_life_span | NUMERIC | Membership life span | Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list. |
| membership_status | TEXT | Membership status | Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to. |
| merchant_id | NUMERIC | Merchant id | Merchant ID of the product. |
| message_chat_rate | NUMERIC | Message chat rate | Number of message chats initiated (message_chats) divided by the number of message impressions (message_impressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression. |
| message_chats | NUMERIC | Message chats | Number of message chats initiated for Click To Message impressions that were message tracking eligible. |
| message_impressions | NUMERIC | Message impressions | Number of Click To Message impressions that were message tracking eligible. |
| metro | TEXT | Geo target metro area | Geo target metro area. |
| mobile_app_category_mobile_app_category_constant | TEXT | Mobile app category mobile app category constant | The mobile app category constant resource name. |
| mobile_application_app_id | TEXT | Mobile application app id | A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations. |
| mobile_application_name | TEXT | Mobile application name | Name of this mobile application. |
| mobile_device_mobile_device_constant | TEXT | Mobile device mobile device constant | The mobile device constant resource name. |
| mobile_friendly_clicks_percentage | NUMERIC | Mobile friendly clicks percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
| month | TEXT | Month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
| month_of_year | TEXT | Month of year | Month of the year, for example, January. |
| name | TEXT | Name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
| negative | BOOLEAN | Negative | Whether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it. |
| network_settings_target_content_network | BOOLEAN | Network settings target content network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
| network_settings_target_google_search | BOOLEAN | Network settings target google search | Whether ads will be served with google.com search results. |
| network_settings_target_partner_search_network | BOOLEAN | Network settings target partner search network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
| network_settings_target_search_network | BOOLEAN | Network settings target search network | Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true). |
| non_removed_campaign_count | NUMERIC | Non removed campaign count | The number of non-removed campaigns attached to this bidding strategy. This field is read-only. |
| num_offline_impressions | NUMERIC | Num offline impressions | Number of offline phone impressions. |
| num_offline_interactions | NUMERIC | Num offline interactions | Number of offline phone calls. |
| offer_id | TEXT | Offer id | Item ID of the product. |
| offline_interaction_rate | NUMERIC | Offline interaction rate | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
| operating_system_version_operating_system_version_constant | TEXT | Operating system version operating system version constant | The operating system version constant resource name. |
| optimization_goal_setting_optimization_goal_types | TEXT | Optimization goal setting optimization goal types | The list of optimization goal types. |
| optimization_score | NUMERIC | Optimization score | 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_uplift | NUMERIC | Optimization score uplift | Total optimization score uplift of all recommendations. |
| optimization_score_url | TEXT | Optimization score url | URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign, and can be segmented by segments.recommendation_type. For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendation_type) combination. |
| optimization_score_weight | NUMERIC | Optimization score weight | 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_id | NUMERIC | Owner customer id | The ID of the Customer which owns the bidding strategy. |
| owner_descriptive_name | TEXT | Owner descriptive name | descriptive_name of the Customer which owns the bidding strategy. |
| parental_status_type | TEXT | Parental status type | Type of the parental status. |
| partner_hotel_id | TEXT | Partner hotel id | Partner hotel ID. |
| pay_per_conversion_eligibility_failure_reasons | TEXT | Pay per conversion eligibility failure reasons | 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_mode | TEXT | Payment mode | Payment mode for the campaign. |
| percent_cpc_bid_micros | NUMERIC | Percent cpc bid micros | The 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_micros | NUMERIC | Percent cpc cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
| percent_cpc_enhanced_cpc_enabled | BOOLEAN | Percent cpc enhanced cpc enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
| percent_new_visitors | NUMERIC | Percent new visitors | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
| performance_max_upgrade_performance_max_campaign | TEXT | Performance max upgrade performance max campaign | Indicates which Performance Max campaign the campaign is upgraded to. |
| performance_max_upgrade_pre_upgrade_campaign | TEXT | Performance max upgrade pre upgrade campaign | Indicates legacy campaign upgraded to Performance Max. |
| performance_max_upgrade_status | TEXT | Performance max upgrade status | The upgrade status of a campaign requested to be upgraded to Performance Max. |
| period | TEXT | Period | Period over which to spend the budget. Defaults to DAILY if not specified. |
| phone_calls | NUMERIC | Phone calls | Number of offline phone calls. |
| phone_impressions | NUMERIC | Phone impressions | Number of offline phone impressions. |
| phone_through_rate | NUMERIC | Phone through rate | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
| placeholder_type | TEXT | Placeholder type | Placeholder type. This is only used with feed item metrics. |
| placement | TEXT | Placement | The automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID. |
| placement_type | TEXT | Placement type | Type of the placement, for example, Website, YouTube Video, and Mobile Application. |
| placement_url | TEXT | Placement url | URL of the placement. For example, "http://www.domain.com". |
| policy_summary_approval_status | TEXT | Policy summary approval status | The overall approval status of this ad, calculated based on the status of its individual policy topic entries. |
| policy_summary_policy_topic_entries | TEXT | Policy summary policy topic entries | The list of policy findings for this ad. |
| policy_summary_review_status | TEXT | Policy summary review status | Where in the review process this ad is. |
| position_estimates_estimated_add_clicks_at_first_position_cpc | NUMERIC | Position estimates estimated add clicks at first position cpc | Estimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros. |
| position_estimates_estimated_add_cost_at_first_position_cpc | NUMERIC | Position estimates estimated add cost at first position cpc | Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros. |
| position_estimates_first_page_cpc_micros | NUMERIC | Position estimates first page cpc micros | The estimate of the CPC bid required for ad to be shown on first page of search results. |
| position_estimates_first_position_cpc_micros | NUMERIC | Position estimates first position cpc micros | The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results. |
| position_estimates_top_of_page_cpc_micros | NUMERIC | Position estimates top of page cpc micros | The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results. |
| post_click_quality_score | TEXT | Post click quality score | The quality score of the landing page. |
| postal_code | TEXT | Geo target postal code numbers | Geo target postal code. |
| product_aggregator_id | NUMERIC | Product aggregator id | Aggregator ID of the product. |
| product_bidding_category_level1 | TEXT | Product bidding category level1 | Bidding category (level 1) of the product. |
| product_bidding_category_level2 | TEXT | Product bidding category level2 | Bidding category (level 2) of the product. |
| product_bidding_category_level3 | TEXT | Product bidding category level3 | Bidding category (level 3) of the product. |
| product_bidding_category_level4 | TEXT | Product bidding category level4 | Bidding category (level 4) of the product. |
| product_bidding_category_level5 | TEXT | Product bidding category level5 | Bidding category (level 5) of the product. |
| product_brand | TEXT | Product brand | Brand of the product. |
| product_channel | TEXT | Product channel | Channel of the product. |
| product_channel_exclusivity | TEXT | Product channel exclusivity | Channel exclusivity of the product. |
| product_condition | TEXT | Product condition | Condition of the product. |
| product_country | TEXT | Product country | Resource name of the geo target constant for the country of sale of the product. |
| product_custom_attribute0 | TEXT | Product custom attribute0 | Custom attribute 0 of the product. |
| product_custom_attribute1 | TEXT | Product custom attribute1 | Custom attribute 1 of the product. |
| product_custom_attribute2 | TEXT | Product custom attribute2 | Custom attribute 2 of the product. |
| product_custom_attribute3 | TEXT | Product custom attribute3 | Custom attribute 3 of the product. |
| product_custom_attribute4 | TEXT | Product custom attribute4 | Custom attribute 4 of the product. |
| product_item_id | TEXT | Product item id | Item ID of the product. |
| product_language | TEXT | Product language | Resource name of the language constant for the language of the product. |
| product_merchant_id | NUMERIC | Product merchant id | Merchant ID of the product. |
| product_store_id | TEXT | Product store id | Store ID of the product. |
| product_title | TEXT | Product title | Title of the product. |
| product_type_l1 | TEXT | Product type l1 | Type (level 1) of the product. |
| product_type_l2 | TEXT | Product type l2 | Type (level 2) of the product. |
| product_type_l3 | TEXT | Product type l3 | Type (level 3) of the product. |
| product_type_l4 | TEXT | Product type l4 | Type (level 4) of the product. |
| product_type_l5 | TEXT | Product type l5 | Type (level 5) of the product. |
| proximity_address_city_name | TEXT | Proximity address city name | Name of the city. |
| proximity_address_country_code | TEXT | Proximity address country code | Country code. |
| proximity_address_postal_code | TEXT | Proximity address postal code | Postal code. |
| proximity_address_province_code | TEXT | Proximity address province code | Province or state code. |
| proximity_address_province_name | TEXT | Proximity address province name | Province or state name. |
| proximity_address_street_address | TEXT | Proximity address street address | Street address line 1. |
| proximity_geo_point_latitude_in_micro_degrees | NUMERIC | Proximity geo point latitude in micro degrees | Micro degrees for the latitude. |
| proximity_geo_point_longitude_in_micro_degrees | NUMERIC | Proximity geo point longitude in micro degrees | Micro degrees for the longitude. |
| proximity_radius | NUMERIC | Proximity radius | The radius of the proximity. |
| proximity_radius_units | TEXT | Proximity radius units | The unit of measurement of the radius. Default is KILOMETERS. |
| quality_info_creative_quality_score | TEXT | Quality info creative quality score | The performance of the ad compared to other advertisers. |
| quality_info_post_click_quality_score | TEXT | Quality info post click quality score | The quality score of the landing page. |
| quality_info_quality_score | NUMERIC | Quality info quality score | The quality score. This field may not be populated if Google does not have enough information to determine a value. |
| quality_info_search_predicted_ctr | TEXT | Quality info search predicted ctr | The click-through rate compared to that of other advertisers. |
| quality_score | NUMERIC | Quality score | The quality score. This field may not be populated if Google does not have enough information to determine a value. |
| quarter | TEXT | Quarter | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
| read_only | BOOLEAN | Read only | An option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only. |
| real_time_bidding_setting_opt_in | BOOLEAN | Real time bidding setting opt in | Whether the campaign is opted in to real-time bidding. |
| recommendation_type | TEXT | Recommendation type | Recommendation type. |
| recommended_budget_amount | NUMERIC | Recommended budget amount | 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_micros | NUMERIC | Recommended budget amount micros | 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_clicks | NUMERIC | Recommended budget estimated change weekly clicks | The estimated change in weekly clicks if the recommended budget is applied. This field is read-only. |
| recommended_budget_estimated_change_weekly_cost_micros | NUMERIC | Recommended budget estimated change weekly cost micros | 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_interactions | NUMERIC | Recommended budget estimated change weekly interactions | The estimated change in weekly interactions if the recommended budget is applied. This field is read-only. |
| recommended_budget_estimated_change_weekly_views | NUMERIC | Recommended budget estimated change weekly views | The estimated change in weekly views if the recommended budget is applied. This field is read-only. |
| reference_count | NUMERIC | Reference count | The number of campaigns actively using the budget. This field is read-only. |
| region | TEXT | Geo target region | Geo target region name. |
| relative_ctr | NUMERIC | Relative ctr | Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
| remarketing_setting_google_global_site_tag | TEXT | Remarketing setting google global site tag | The Google tag. |
| resource_name | TEXT | Resource name | The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
| rule_based_user_list_combined_rule_user_list_left_operand_rule_item_groups | TEXT | Rule based user list combined rule user list left operand rule item groups | List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type. |
| rule_based_user_list_combined_rule_user_list_left_operand_rule_type | TEXT | Rule based user list combined rule user list left operand rule type | Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. |
| rule_based_user_list_combined_rule_user_list_right_operand_rule_item_groups | TEXT | Rule based user list combined rule user list right operand rule item groups | List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type. |
| rule_based_user_list_combined_rule_user_list_right_operand_rule_type | TEXT | Rule based user list combined rule user list right operand rule type | Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. |
| rule_based_user_list_combined_rule_user_list_rule_operator | TEXT | Rule based user list combined rule user list rule operator | Operator to connect the two operands. Required for creating a combined rule user list. |
| rule_based_user_list_expression_rule_user_list_rule_rule_item_groups | TEXT | Rule based user list expression rule user list rule rule item groups | List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type. |
| rule_based_user_list_expression_rule_user_list_rule_rule_type | TEXT | Rule based user list expression rule user list rule rule type | Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. |
| rule_based_user_list_flexible_rule_user_list_exclusive_operands | TEXT | Rule based user list flexible rule user list exclusive operands | Actions that are located on the exclusive side. These are joined together with OR. |
| rule_based_user_list_flexible_rule_user_list_inclusive_operands | TEXT | Rule based user list flexible rule user list inclusive operands | Actions that are located on the inclusive side. These are joined together by either AND/OR as specified by the inclusive_rule_operator. |
| rule_based_user_list_flexible_rule_user_list_inclusive_rule_operator | TEXT | Rule based user list flexible rule user list inclusive rule operator | Operator that defines how the inclusive operands are combined. |
| rule_based_user_list_prepopulation_status | TEXT | Rule based user list prepopulation status | The status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails. |
| search_absolute_top_impression_share | NUMERIC | Search absolute top impression share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999. |
| search_budget_lost_absolute_top_impression_share | NUMERIC | Search budget lost absolute top impression share | The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| search_budget_lost_impression_share | NUMERIC | Search budget lost impression share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| search_budget_lost_top_impression_share | NUMERIC | Search budget lost top impression share | The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| search_click_share | NUMERIC | Search click share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
| search_engine_results_page_type | TEXT | Search engine results page type | Type of the search engine results page. |
| search_exact_match_impression_share | NUMERIC | Search exact match impression share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
| search_impression_share | NUMERIC | Search impression share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
| search_predicted_ctr | TEXT | Search predicted ctr | The click-through rate compared to that of other advertisers. |
| search_rank_lost_absolute_top_impression_share | NUMERIC | Search rank lost absolute top impression share | The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| search_rank_lost_impression_share | NUMERIC | Search rank lost impression share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| search_rank_lost_top_impression_share | NUMERIC | Search rank lost top impression share | The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
| search_term | TEXT | Search term | The search term. |
| search_term_match_type | TEXT | Search term match type | Match type of the keyword that triggered the ad, including variants. |
| search_term_view_ad_group | TEXT | Search term view ad group | The ad group the search term served in. |
| search_term_view_ad_group_id | TEXT | Search Term View Ad Group ID | The Ad Group ID for a search term |
| search_term_view_campaign_id | TEXT | Search Term View Campaign ID | The Campaign ID for a search term |
| search_term_view_keyword_id | TEXT | Search Term View Keyword ID | The Keyword ID for a search term |
| search_term_view_resource_name | TEXT | Search term view resource name | The resource name of the search term view. Search term view resource names have the form: customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term} |
| search_term_view_search_term | TEXT | Search term view search term | The search term. |
| search_term_view_status | TEXT | Search term view status | Indicates whether the search term is currently one of your targeted or excluded keywords. |
| search_top_impression_share | NUMERIC | Search top impression share | The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
| selective_optimization_conversion_actions | TEXT | Selective optimization conversion actions | The selected set of conversion actions for optimizing this campaign. |
| serving_status | TEXT | Serving status | The ad serving status of the campaign. |
| shopping_performance_view_resource_name | TEXT | Shopping performance view resource name | The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView |
| shopping_setting_campaign_priority | NUMERIC | Shopping setting campaign priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
| shopping_setting_enable_local | BOOLEAN | Shopping setting enable local | Whether to include local products. |
| shopping_setting_feed_label | TEXT | Shopping setting feed label | Feed label of products to include in the campaign. Only one of feed_label or sales_country can be set. If used instead of sales_country, the feed_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center. |
| shopping_setting_merchant_id | NUMERIC | Shopping setting merchant id | ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
| shopping_setting_sales_country | TEXT | Shopping setting sales country | Sales country of products to include in the campaign. Only one of feed_label or sales_country can be set. Field is immutable except for clearing. Once this field is cleared, you must use feed_label if you want to set the sales country. |
| shopping_setting_use_vehicle_inventory | BOOLEAN | Shopping setting use vehicle inventory | Whether to target Vehicle Listing inventory. |
| similar_user_list_seed_user_list | TEXT | Similar user list seed user list | Seed UserList from which this list is derived. |
| size_for_display | NUMERIC | Size for display | Estimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only. |
| size_for_search | NUMERIC | Size for search | Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only. |
| size_range_for_display | TEXT | Size range for display | Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only. |
| size_range_for_search | TEXT | Size range for search | Size range in terms of number of users of the UserList, for Search ads. This field is read-only. |
| sk_ad_network_ad_event_type | TEXT | Sk ad network ad event type | iOS Store Kit Ad Network ad event type. |
| sk_ad_network_attribution_credit | TEXT | Sk ad network attribution credit | iOS Store Kit Ad Network attribution credit |
| sk_ad_network_conversion_value | NUMERIC | Sk ad network conversion value | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign. |
| sk_ad_network_conversions | NUMERIC | Sk ad network conversions | The number of iOS Store Kit Ad Network conversions. |
| sk_ad_network_source_app_sk_ad_network_source_app_id | TEXT | Sk ad network source app sk ad network source app id | App id where the ad that drove the iOS Store Kit Ad Network install was shown. |
| sk_ad_network_user_type | TEXT | Sk ad network user type | iOS Store Kit Ad Network user type. |
| slot | TEXT | Slot | Position of the ad. |
| source | TEXT | Source | The name of the connector ("google_ads") |
| speed_score | NUMERIC | Speed score | A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest. |
| spend | NUMERIC | Spend | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
| start_date | DATE | Start date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
| state | TEXT | Geo target state name. | Geo target state name. |
| status | TEXT | Status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
| store_id | TEXT | Store id | Store ID of the product. |
| system_serving_status | TEXT | System serving status | Serving status of the criterion. |
| target_cpa | NUMERIC | Target cpa | The effective target CPA (cost-per-acquisition). This field is read-only. |
| target_cpa_bid_source | TEXT | Target cpa bid source | Source of the effective target CPA. This field is read-only. |
| target_cpa_cpc_bid_ceiling_micros | NUMERIC | Target cpa cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| target_cpa_cpc_bid_floor_micros | NUMERIC | Target cpa cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| target_cpa_micros | NUMERIC | Target cpa micros | The 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_micros | NUMERIC | Target cpa target cpa micros | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
| target_cpm | TEXT | Target cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
| target_cpm_micros | NUMERIC | Target cpm micros | Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. |
| target_impression_share_cpc_bid_ceiling_micros | NUMERIC | Target impression share cpc bid ceiling micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
| target_impression_share_location | TEXT | Target impression share location | The targeted location on the search results page. |
| target_impression_share_location_fraction_micros | NUMERIC | Target impression share location fraction micros | The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. |
| target_roas | NUMERIC | Target roas | The 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_micros | NUMERIC | Target roas cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| target_roas_cpc_bid_floor_micros | NUMERIC | Target roas cpc bid floor micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
| target_roas_target_roas | NUMERIC | Target roas target roas | Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
| target_spend_cpc_bid_ceiling_micros | NUMERIC | Target spend cpc bid ceiling micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
| target_spend_target_spend_micros | NUMERIC | Target spend target spend micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
| target_url | TEXT | Target url | URL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL. |
| targeting_setting_target_restrictions | TEXT | Targeting setting target restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
| taxonomy_type | TEXT | Taxonomy type | Taxonomy type of the user interest. |
| test_account | BOOLEAN | Test account | Whether the customer is a test account. |
| text_label_background_color | TEXT | Text label background color | Background color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. |
| text_label_description | TEXT | Text label description | A short description of the label. The length must be no more than 200 characters. |
| time_zone | TEXT | Time zone | The local timezone ID of the customer. |
| top_impression_percentage | NUMERIC | Top impression percentage | The percent of your ad impressions that are shown anywhere above the organic search results. |
| top_of_page_cpc | NUMERIC | Top of page cpc | The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results. |
| topic_path | TEXT | Topic path | The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category. |
| topic_topic_constant | TEXT | Topic topic constant | The Topic Constant resource name. |
| total_amount | NUMERIC | Total amount | The 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_micros | NUMERIC | Total amount micros | The 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. |
| totalcost | NUMERIC | Total Cost | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
| tracking_setting_tracking_url | TEXT | Tracking setting tracking url | The url used for dynamic tracking. |
| tracking_url_template | TEXT | Tracking url template | The URL template for constructing a tracking URL. |
| transactionrevenue | NUMERIC | Transactionrevenue | The value of all conversions. |
| transactions | NUMERIC | Transactions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
| type | TEXT | Type | The type of the ad group. |
| url_custom_parameters | TEXT | Url custom parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
| url_expansion_opt_out | BOOLEAN | Url expansion opt out | Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false. |
| user_interest_availabilities | TEXT | User interest availabilities | Availability information of the user interest. |
| user_interest_id | NUMERIC | User interest id | The ID of the user interest. |
| user_interest_launched_to_all | BOOLEAN | User interest launched to all | True if the user interest is launched to all channels and locales. |
| user_interest_name | TEXT | User interest name | The name of the user interest. |
| user_interest_parent | TEXT | User interest parent | The parent of the user interest. |
| user_interest_resource_name | TEXT | User interest resource name | The resource name of the user interest. User interest resource names have the form: customers/{customer_id}/userInterests/{user_interest_id} |
| user_interest_taxonomy_type | TEXT | User interest taxonomy type | Taxonomy type of the user interest. |
| user_interest_user_interest_category | TEXT | User interest user interest category | The UserInterest resource name. |
| user_interest_user_interest_id | NUMERIC | User interest user interest id | The ID of the user interest. |
| user_interest_user_interest_parent | TEXT | User interest user interest parent | The parent of the user interest. |
| user_list_access_reason | TEXT | User list access reason | Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only. |
| user_list_account_user_list_status | TEXT | User list account user list status | Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED. |
| user_list_basic_user_list_actions | TEXT | User list basic user list actions | Actions associated with this user list. |
| user_list_closing_reason | TEXT | User list closing reason | Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open. |
| user_list_crm_based_user_list_app_id | TEXT | User list crm based user list app id | A string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs. |
| user_list_crm_based_user_list_data_source_type | TEXT | User list crm based user list data source type | Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists. |
| user_list_crm_based_user_list_upload_key_type | TEXT | User list crm based user list upload key type | Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation. |
| user_list_description | TEXT | User list description | Description of this user list. |
| user_list_eligible_for_display | BOOLEAN | User list eligible for display | Indicates this user list is eligible for Google Display Network. This field is read-only. |
| user_list_eligible_for_search | BOOLEAN | User list eligible for search | Indicates if this user list is eligible for Google Search Network. |
| user_list_id | NUMERIC | User list id | Id of the user list. |
| user_list_integration_code | TEXT | User list integration code | An ID from external system. It is used by user list sellers to correlate IDs on their systems. |
| user_list_logical_user_list_rules | TEXT | User list logical user list rules | Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list. |
| user_list_match_rate_percentage | NUMERIC | User list match rate percentage | Indicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only. |
| user_list_membership_life_span | NUMERIC | User list membership life span | Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list. |
| user_list_membership_status | TEXT | User list membership status | Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to. |
| user_list_name | TEXT | User list name | Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED) |
| user_list_read_only | BOOLEAN | User list read only | An option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only. |
| user_list_resource_name | TEXT | User list resource name | The resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id} |
| user_list_rule_based_user_list_combined_rule_user_list_left_operand_rule_item_groups | TEXT | User list rule based user list combined rule user list left operand rule item groups | List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type. |
| user_list_rule_based_user_list_combined_rule_user_list_left_operand_rule_type | TEXT | User list rule based user list combined rule user list left operand rule type | Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. |
| user_list_rule_based_user_list_combined_rule_user_list_right_operand_rule_item_groups | TEXT | User list rule based user list combined rule user list right operand rule item groups | List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type. |
| user_list_rule_based_user_list_combined_rule_user_list_right_operand_rule_type | TEXT | User list rule based user list combined rule user list right operand rule type | Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. |
| user_list_rule_based_user_list_combined_rule_user_list_rule_operator | TEXT | User list rule based user list combined rule user list rule operator | Operator to connect the two operands. Required for creating a combined rule user list. |
| user_list_rule_based_user_list_expression_rule_user_list_rule_rule_item_groups | TEXT | User list rule based user list expression rule user list rule rule item groups | List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type. |
| user_list_rule_based_user_list_expression_rule_user_list_rule_rule_type | TEXT | User list rule based user list expression rule user list rule rule type | Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. |
| user_list_rule_based_user_list_flexible_rule_user_list_exclusive_operands | TEXT | User list rule based user list flexible rule user list exclusive operands | Actions that are located on the exclusive side. These are joined together with OR. |
| user_list_rule_based_user_list_flexible_rule_user_list_inclusive_operands | TEXT | User list rule based user list flexible rule user list inclusive operands | Actions that are located on the inclusive side. These are joined together by either AND/OR as specified by the inclusive_rule_operator. |
| user_list_rule_based_user_list_flexible_rule_user_list_inclusive_rule_operator | TEXT | User list rule based user list flexible rule user list inclusive rule operator | Operator that defines how the inclusive operands are combined. |
| user_list_rule_based_user_list_prepopulation_status | TEXT | User list rule based user list prepopulation status | The status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails. |
| user_list_similar_user_list_seed_user_list | TEXT | User list similar user list seed user list | Seed UserList from which this list is derived. |
| user_list_size_for_display | NUMERIC | User list size for display | Estimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only. |
| user_list_size_for_search | NUMERIC | User list size for search | Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only. |
| user_list_size_range_for_display | TEXT | User list size range for display | Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only. |
| user_list_size_range_for_search | TEXT | User list size range for search | Size range in terms of number of users of the UserList, for Search ads. This field is read-only. |
| user_list_type | TEXT | User list type | Type of this list. This field is read-only. |
| user_list_user_list | TEXT | User list user list | The User List resource name. |
| valid_accelerated_mobile_pages_clicks_percentage | NUMERIC | Valid accelerated mobile pages clicks percentage | The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. |
| value_per_all_conversion | NUMERIC | Value per all conversion | The value of all conversions divided by the number of all conversions. |
| value_per_all_conversions | NUMERIC | Value per all conversions | The value of all conversions divided by the number of all conversions. |
| value_per_all_conversions_by_conversion_date | NUMERIC | Value per all conversions by conversion date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
| value_per_conversion | NUMERIC | Value per conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| value_per_conversions_by_conversion_date | NUMERIC | Value per conversions by conversion date | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
| value_per_current_model_attributed_conversion | NUMERIC | Value per current model attributed conversion | The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
| vanity_pharma_vanity_pharma_display_url_mode | TEXT | Vanity pharma vanity pharma display url mode | The display mode for vanity pharma URLs. |
| vanity_pharma_vanity_pharma_text | TEXT | Vanity pharma vanity pharma text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
| vertical_id | TEXT | Vertical id | The Topic Constant resource name. |
| video_brand_safety_suitability | TEXT | Video brand safety suitability | 3-Tier Brand Safety setting for the campaign. |
| video_quartile100_rate | NUMERIC | Video quartile100 rate | Percentage of impressions where the viewer watched all of your video. |
| video_quartile25_rate | NUMERIC | Video quartile25 rate | Percentage of impressions where the viewer watched 25% of your video. |
| video_quartile50_rate | NUMERIC | Video quartile50 rate | Percentage of impressions where the viewer watched 50% of your video. |
| video_quartile75_rate | NUMERIC | Video quartile75 rate | Percentage of impressions where the viewer watched 75% of your video. |
| video_quartile_p100_rate | NUMERIC | Video quartile p100 rate | Percentage of impressions where the viewer watched all of your video. |
| video_quartile_p25_rate | NUMERIC | Video quartile p25 rate | Percentage of impressions where the viewer watched 25% of your video. |
| video_quartile_p50_rate | NUMERIC | Video quartile p50 rate | Percentage of impressions where the viewer watched 50% of your video. |
| video_quartile_p75_rate | NUMERIC | Video quartile p75 rate | Percentage of impressions where the viewer watched 75% of your video. |
| video_view_rate | NUMERIC | Video view rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
| video_views | NUMERIC | Video views | The number of times your video ads were viewed. |
| view_through_conversions | NUMERIC | View through conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
| webpage_conditions | TEXT | Webpage conditions | Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| webpage_coverage_percentage | NUMERIC | Webpage coverage percentage | Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only. |
| webpage_criterion_name | TEXT | Webpage criterion name | The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations. |
| webpage_sample_sample_urls | TEXT | Webpage sample sample urls | Webpage sample urls |
| week | TEXT | Week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
| year | TEXT | Year | Year, formatted as yyyy. |
| youtube_channel_channel_id | TEXT | Youtube channel channel id | The YouTube uploader channel id or the channel code of a YouTube channel. |
| youtube_video_video_id | TEXT | Youtube video video id | YouTube video id as it appears on the YouTube watch page. |