Windsor brings all your Google Ads data into Power BI, Looker Studio, Google Sheets, Excel, BigQuery, Snowflake, Tableau, Azure, PostgreSQL, MySQL, Python, Amazon S3, Azure, Azure MS SQL
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
Frequently asked support questions for the Google Ads connector can be found here.
Fields
ID | Type | Name | Description |
---|---|---|---|
absolute_top_impression_percentage | PERCENT | Absolute top impression percentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
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 acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. |
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 | The chosen revenue (based on conversion data) per unit of spend. |
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 "Try adding a few more unique headlines or unpinning some assets.". |
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 the 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). |
activity_account_id | NUMERIC | Activity account id | Activity account ID. |
activity_city | CITY | Activity city | The city where the travel activity is available. |
activity_country | COUNTRY | Activity country | The country where the travel activity is available. |
activity_rating | NUMERIC | Activity rating | Activity rating. |
activity_state | TEXT | Activity state | The state where the travel activity is available. |
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 | COUNTRY | 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_demand_gen_carousel_ad_business_name | TEXT | Ad demand gen carousel ad business name | Required. The Advertiser/brand name. |
ad_demand_gen_carousel_ad_call_to_action_text | TEXT | Ad demand gen carousel ad call to action text | Call to action text. |
ad_demand_gen_carousel_ad_carousel_cards | TEXT | Ad demand gen carousel ad carousel cards | Required. Carousel cards that will display with the ad. Min 2 max 10. |
ad_demand_gen_carousel_ad_carousel_cards_asset | TEXT | Ad demand gen carousel ad carousel cards asset | The Asset resource name of this discovery carousel card. |
ad_demand_gen_carousel_ad_description | TEXT | Ad demand gen carousel ad description | Required. The descriptive text of the ad. |
ad_demand_gen_carousel_ad_headline | TEXT | Ad demand gen carousel ad headline | Required. Headline of the ad. |
ad_demand_gen_carousel_ad_logo_image | TEXT | Ad demand gen 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_demand_gen_carousel_ad_logo_image_asset | TEXT | Ad demand gen carousel ad logo image asset | The Asset resource name of this image. |
ad_demand_gen_multi_asset_ad_business_name | TEXT | Ad demand gen multi asset ad business name | The Advertiser/brand name. Maximum display width is 25. Required. |
ad_demand_gen_multi_asset_ad_call_to_action_text | TEXT | Ad demand gen multi asset ad call to action text | Call to action text. |
ad_demand_gen_multi_asset_ad_descriptions | TEXT | Ad demand gen 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_demand_gen_multi_asset_ad_headlines | TEXT | Ad demand gen 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_demand_gen_multi_asset_ad_lead_form_only | BOOLEAN | Ad demand gen multi asset ad lead form only | Boolean option that indicates if this ad must be served with lead form. |
ad_demand_gen_multi_asset_ad_logo_images | TEXT | Ad demand gen 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_demand_gen_multi_asset_ad_logo_images_asset | TEXT | Ad demand gen multi asset ad logo images asset | The Asset resource name of this image. |
ad_demand_gen_multi_asset_ad_marketing_images | TEXT | Ad demand gen 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_demand_gen_multi_asset_ad_marketing_images_asset | TEXT | Ad demand gen multi asset ad marketing images asset | The Asset resource name of this image. |
ad_demand_gen_multi_asset_ad_portrait_marketing_images | TEXT | Ad demand gen 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_demand_gen_multi_asset_ad_portrait_marketing_images_asset | TEXT | Ad demand gen multi asset ad portrait marketing images asset | The Asset resource name of this image. |
ad_demand_gen_multi_asset_ad_square_marketing_images | TEXT | Ad demand gen 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_demand_gen_multi_asset_ad_square_marketing_images_asset | TEXT | Ad demand gen multi asset ad square marketing images asset | The Asset resource name of this image. |
ad_demand_gen_product_ad_breadcrumb1 | TEXT | Ad demand gen product ad breadcrumb1 | First part of text that appears in the ad with the displayed URL. |
ad_demand_gen_product_ad_breadcrumb2 | TEXT | Ad demand gen product ad breadcrumb2 | Second part of text that appears in the ad with the displayed URL. |
ad_demand_gen_product_ad_business_name | TEXT | Ad demand gen product ad business name | Required. The advertiser/brand name. |
ad_demand_gen_product_ad_call_to_action | TEXT | Ad demand gen product ad call to action | Asset of type CallToActionAsset used for the "Call To Action" button. |
ad_demand_gen_product_ad_call_to_action_asset | TEXT | Ad demand gen product ad call to action asset | The Asset resource name of this call to action asset. |
ad_demand_gen_product_ad_description | TEXT | Ad demand gen product ad description | Required. Text asset used for the description. |
ad_demand_gen_product_ad_headline | TEXT | Ad demand gen product ad headline | Required. Text asset used for the short headline. |
ad_demand_gen_product_ad_logo_image | TEXT | Ad demand gen product ad logo image | Required. Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
ad_demand_gen_product_ad_logo_image_asset | TEXT | Ad demand gen product ad logo image asset | The Asset resource name of this image. |
ad_demand_gen_video_responsive_ad_breadcrumb1 | TEXT | Ad demand gen video responsive ad breadcrumb1 | First part of text that appears in the ad with the displayed URL. |
ad_demand_gen_video_responsive_ad_breadcrumb2 | TEXT | Ad demand gen video responsive ad breadcrumb2 | Second part of text that appears in the ad with the displayed URL. |
ad_demand_gen_video_responsive_ad_business_name | TEXT | Ad demand gen video responsive ad business name | Required. The advertiser/brand name. |
ad_demand_gen_video_responsive_ad_call_to_actions | TEXT | Ad demand gen video responsive ad call to actions | Assets of type CallToActionAsset used for the "Call To Action" button. |
ad_demand_gen_video_responsive_ad_call_to_actions_asset | TEXT | Ad demand gen video responsive ad call to actions asset | The Asset resource name of this call to action asset. |
ad_demand_gen_video_responsive_ad_descriptions | TEXT | Ad demand gen video responsive ad descriptions | List of text assets used for the description. |
ad_demand_gen_video_responsive_ad_headlines | TEXT | Ad demand gen video responsive ad headlines | List of text assets used for the short headline. |
ad_demand_gen_video_responsive_ad_logo_images | TEXT | Ad demand gen video responsive ad logo images | Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
ad_demand_gen_video_responsive_ad_logo_images_asset | TEXT | Ad demand gen video responsive ad logo images asset | The Asset resource name of this image. |
ad_demand_gen_video_responsive_ad_long_headlines | TEXT | Ad demand gen video responsive ad long headlines | List of text assets used for the long headline. |
ad_demand_gen_video_responsive_ad_videos | TEXT | Ad demand gen video responsive ad videos | List of YouTube video assets used for the ad. |
ad_demand_gen_video_responsive_ad_videos_asset | TEXT | Ad demand gen video responsive ad videos asset | The Asset resource name of this video. |
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_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_format_type | TEXT | Ad format type | Ad Format type. |
ad_group | TEXT | Ad group path | The ad group to which the criterion belongs. |
ad_group_ad | TEXT | Ad group ad | The ad group ad to which the asset is linked. |
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 "Try adding a few more unique headlines or unpinning some assets.". |
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 | COUNTRY | 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_demand_gen_carousel_ad_business_name | TEXT | Ad group ad ad demand gen carousel ad business name | Required. The Advertiser/brand name. |
ad_group_ad_ad_demand_gen_carousel_ad_call_to_action_text | TEXT | Ad group ad ad demand gen carousel ad call to action text | Call to action text. |
ad_group_ad_ad_demand_gen_carousel_ad_carousel_cards | TEXT | Ad group ad ad demand gen carousel ad carousel cards | Required. Carousel cards that will display with the ad. Min 2 max 10. |
ad_group_ad_ad_demand_gen_carousel_ad_carousel_cards_asset | TEXT | Ad group ad ad demand gen carousel ad carousel cards asset | The Asset resource name of this discovery carousel card. |
ad_group_ad_ad_demand_gen_carousel_ad_description | TEXT | Ad group ad ad demand gen carousel ad description | Required. The descriptive text of the ad. |
ad_group_ad_ad_demand_gen_carousel_ad_headline | TEXT | Ad group ad ad demand gen carousel ad headline | Required. Headline of the ad. |
ad_group_ad_ad_demand_gen_carousel_ad_logo_image | TEXT | Ad group ad ad demand gen 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_demand_gen_carousel_ad_logo_image_asset | TEXT | Ad group ad ad demand gen carousel ad logo image asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_multi_asset_ad_business_name | TEXT | Ad group ad ad demand gen multi asset ad business name | The Advertiser/brand name. Maximum display width is 25. Required. |
ad_group_ad_ad_demand_gen_multi_asset_ad_call_to_action_text | TEXT | Ad group ad ad demand gen multi asset ad call to action text | Call to action text. |
ad_group_ad_ad_demand_gen_multi_asset_ad_descriptions | TEXT | Ad group ad ad demand gen 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_demand_gen_multi_asset_ad_headlines | TEXT | Ad group ad ad demand gen 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_demand_gen_multi_asset_ad_lead_form_only | BOOLEAN | Ad group ad ad demand gen multi asset ad lead form only | Boolean option that indicates if this ad must be served with lead form. |
ad_group_ad_ad_demand_gen_multi_asset_ad_logo_images | TEXT | Ad group ad ad demand gen 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_demand_gen_multi_asset_ad_logo_images_asset | TEXT | Ad group ad ad demand gen multi asset ad logo images asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_multi_asset_ad_marketing_images | TEXT | Ad group ad ad demand gen 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_demand_gen_multi_asset_ad_marketing_images_asset | TEXT | Ad group ad ad demand gen multi asset ad marketing images asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_multi_asset_ad_portrait_marketing_images | TEXT | Ad group ad ad demand gen 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_demand_gen_multi_asset_ad_portrait_marketing_images_asset | TEXT | Ad group ad ad demand gen multi asset ad portrait marketing images asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_multi_asset_ad_square_marketing_images | TEXT | Ad group ad ad demand gen 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_demand_gen_multi_asset_ad_square_marketing_images_asset | TEXT | Ad group ad ad demand gen multi asset ad square marketing images asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_product_ad_breadcrumb1 | TEXT | Ad group ad ad demand gen product ad breadcrumb1 | First part of text that appears in the ad with the displayed URL. |
ad_group_ad_ad_demand_gen_product_ad_breadcrumb2 | TEXT | Ad group ad ad demand gen product ad breadcrumb2 | Second part of text that appears in the ad with the displayed URL. |
ad_group_ad_ad_demand_gen_product_ad_business_name | TEXT | Ad group ad ad demand gen product ad business name | Required. The advertiser/brand name. |
ad_group_ad_ad_demand_gen_product_ad_call_to_action | TEXT | Ad group ad ad demand gen product ad call to action | Asset of type CallToActionAsset used for the "Call To Action" button. |
ad_group_ad_ad_demand_gen_product_ad_call_to_action_asset | TEXT | Ad group ad ad demand gen product ad call to action asset | The Asset resource name of this call to action asset. |
ad_group_ad_ad_demand_gen_product_ad_description | TEXT | Ad group ad ad demand gen product ad description | Required. Text asset used for the description. |
ad_group_ad_ad_demand_gen_product_ad_headline | TEXT | Ad group ad ad demand gen product ad headline | Required. Text asset used for the short headline. |
ad_group_ad_ad_demand_gen_product_ad_logo_image | TEXT | Ad group ad ad demand gen product ad logo image | Required. Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
ad_group_ad_ad_demand_gen_product_ad_logo_image_asset | TEXT | Ad group ad ad demand gen product ad logo image asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_video_responsive_ad_breadcrumb1 | TEXT | Ad group ad ad demand gen video responsive ad breadcrumb1 | First part of text that appears in the ad with the displayed URL. |
ad_group_ad_ad_demand_gen_video_responsive_ad_breadcrumb2 | TEXT | Ad group ad ad demand gen video responsive ad breadcrumb2 | Second part of text that appears in the ad with the displayed URL. |
ad_group_ad_ad_demand_gen_video_responsive_ad_business_name | TEXT | Ad group ad ad demand gen video responsive ad business name | Required. The advertiser/brand name. |
ad_group_ad_ad_demand_gen_video_responsive_ad_call_to_actions | TEXT | Ad group ad ad demand gen video responsive ad call to actions | Assets of type CallToActionAsset used for the "Call To Action" button. |
ad_group_ad_ad_demand_gen_video_responsive_ad_call_to_actions_asset | TEXT | Ad group ad ad demand gen video responsive ad call to actions asset | The Asset resource name of this call to action asset. |
ad_group_ad_ad_demand_gen_video_responsive_ad_descriptions | TEXT | Ad group ad ad demand gen video responsive ad descriptions | List of text assets used for the description. |
ad_group_ad_ad_demand_gen_video_responsive_ad_headlines | TEXT | Ad group ad ad demand gen video responsive ad headlines | List of text assets used for the short headline. |
ad_group_ad_ad_demand_gen_video_responsive_ad_logo_images | TEXT | Ad group ad ad demand gen video responsive ad logo images | Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
ad_group_ad_ad_demand_gen_video_responsive_ad_logo_images_asset | TEXT | Ad group ad ad demand gen video responsive ad logo images asset | The Asset resource name of this image. |
ad_group_ad_ad_demand_gen_video_responsive_ad_long_headlines | TEXT | Ad group ad ad demand gen video responsive ad long headlines | List of text assets used for the long headline. |
ad_group_ad_ad_demand_gen_video_responsive_ad_videos | TEXT | Ad group ad ad demand gen video responsive ad videos | List of YouTube video assets used for the ad. |
ad_group_ad_ad_demand_gen_video_responsive_ad_videos_asset | TEXT | Ad group ad ad demand gen video responsive ad videos asset | The Asset resource name of this video. |
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_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_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 | TEXT | Ad group ad ad id | The ID of the ad. |
ad_group_ad_ad_image_ad_image_asset_asset | TEXT | Ad group ad ad image ad image asset asset | The Asset resource name of this image. |
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_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. At least 1 and at most 5 call-to-actions must 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. At least 1 and at most 20 video assets must 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 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_travel_ad | TEXT | Ad group ad ad travel ad | Details pertaining to a travel ad. |
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_action_button_label | TEXT | Ad group ad ad video ad bumper 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_bumper_action_headline | TEXT | Ad group ad ad video ad bumper 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_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. 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_asset_view_ad_group_ad | TEXT | Ad group ad asset view ad group ad | The ad group ad to which the asset is linked. |
ad_group_ad_asset_view_asset | TEXT | Ad group ad asset view asset | The asset which is linked to the ad group ad. |
ad_group_ad_asset_view_enabled | BOOLEAN | Ad group ad asset view enabled | The status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad. |
ad_group_ad_asset_view_field_type | TEXT | Ad group ad asset view field type | Role that the asset takes in the ad. |
ad_group_ad_asset_view_performance_label | TEXT | Ad group ad asset view performance label | Performance of an asset linkage. |
ad_group_ad_asset_view_pinned_field | TEXT | Ad group ad asset view pinned field | Pinned field. |
ad_group_ad_asset_view_policy_summary | TEXT | Ad group ad asset view policy summary | Policy information for the ad group ad asset. |
ad_group_ad_asset_view_resource_name | TEXT | Ad group ad asset view resource name | The resource name of the ad group ad asset view. Ad group ad asset view resource names have the form (Before V4): customers/{customer_id}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type} Ad group ad asset view resource names have the form (Beginning from V4): customers/{customer_id}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type} |
ad_group_ad_asset_view_source | TEXT | Ad group ad asset view source | Source of the ad group ad asset. |
ad_group_ad_asset_view_source_asset | TEXT | Ad group ad asset view source asset | Source of the ad group ad asset. |
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_primary_status | TEXT | Ad group ad primary status | Provides aggregated view into why an ad group ad is not serving or not serving optimally. |
ad_group_ad_primary_status_reasons | TEXT | Ad group ad primary status reasons | Provides reasons for why an ad group ad is not serving or not serving optimally. |
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_language_language_constant | TEXT | Ad group criterion language language constant | The language constant resource name. |
ad_group_criterion_listing_group_case_value_activity_city_value | TEXT | Ad group criterion listing group case value activity city value | String value of the activity city. The Geo Target Constant resource name. |
ad_group_criterion_listing_group_case_value_activity_country_value | COUNTRY | Ad group criterion listing group case value activity country value | String value of the activity country. The Geo Target Constant resource name. |
ad_group_criterion_listing_group_case_value_activity_id_value | TEXT | Ad group criterion listing group case value activity id value | String value of the activity ID. |
ad_group_criterion_listing_group_case_value_activity_rating_value | NUMERIC | Ad group criterion listing group case value activity rating value | Long value of the activity rating. |
ad_group_criterion_listing_group_case_value_activity_state_value | TEXT | Ad group criterion listing group case value activity state value | String value of the activity state. The Geo Target Constant resource name. |
ad_group_criterion_listing_group_case_value_hotel_city_city_criterion | CITY | 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 | REGION | 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_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_category_category_id | NUMERIC | Ad group criterion listing group case value product category category id | ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 |
ad_group_criterion_listing_group_case_value_product_category_level | TEXT | Ad group criterion listing group case value product category level | Level of the product category. |
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_path | TEXT | Ad group criterion listing group path | The path of dimensions defining this listing group. |
ad_group_criterion_listing_group_type | TEXT | Ad group criterion listing group type | Type of the listing group. |
ad_group_criterion_location_geo_target_constant | TEXT | Ad group criterion location geo target constant | The geo target constant resource name. |
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_primary_status | TEXT | Ad group criterion primary status | The primary status for the ad group criterion. |
ad_group_criterion_primary_status_reasons | TEXT | Ad group criterion primary status reasons | The primary status reasons for the ad group criterion. |
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 | PERCENT | 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_excluded_parent_asset_set_types | TEXT | Ad group excluded parent asset set types | The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. |
ad_group_fixed_cpm_micros | NUMERIC | Ad group fixed cpm micros | The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. |
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_optimized_targeting_enabled | BOOLEAN | Ad group optimized targeting enabled | True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. |
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_primary_status | TEXT | Ad group primary status | Provides aggregated view into why an ad group is not serving or not serving optimally. |
ad_group_primary_status_reasons | TEXT | Ad group primary status reasons | Provides reasons for why an ad group is not serving or not serving optimally. |
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_cpv_micros | NUMERIC | Ad group target cpv micros | Average amount in micros that the advertiser is willing to pay for every ad view. |
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_asset_asset | TEXT | Ad image ad image asset asset | The Asset resource name of this image. |
ad_image_ad_image_url | TEXT | Ad image ad image url | URL of the full size 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. At least 1 and at most 5 call-to-actions must 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. At least 1 and at most 20 video assets must be specified. |
ad_local_ad_videos_asset | TEXT | Ad local ad videos asset | The Asset resource name of this video. |
ad_multi_asset_ad_marketing_images_1 | IMAGE_URL | Multi Asset Ad Marketing Image 1 | Image URL 1 (multi asset ad) |
ad_multi_asset_ad_marketing_images_10 | IMAGE_URL | Multi Asset Ad Marketing Image 10 | Image URL 10 (multi asset ad) |
ad_multi_asset_ad_marketing_images_11 | IMAGE_URL | Multi Asset Ad Marketing Image 11 | Image URL 11 (multi asset ad) |
ad_multi_asset_ad_marketing_images_12 | IMAGE_URL | Multi Asset Ad Marketing Image 12 | Image URL 12 (multi asset ad) |
ad_multi_asset_ad_marketing_images_13 | IMAGE_URL | Multi Asset Ad Marketing Image 13 | Image URL 13 (multi asset ad) |
ad_multi_asset_ad_marketing_images_14 | IMAGE_URL | Multi Asset Ad Marketing Image 14 | Image URL 14 (multi asset ad) |
ad_multi_asset_ad_marketing_images_15 | IMAGE_URL | Multi Asset Ad Marketing Image 15 | Image URL 15 (multi asset ad) |
ad_multi_asset_ad_marketing_images_2 | IMAGE_URL | Multi Asset Ad Marketing Image 2 | Image URL 2 (multi asset ad) |
ad_multi_asset_ad_marketing_images_3 | IMAGE_URL | Multi Asset Ad Marketing Image 3 | Image URL 3 (multi asset ad) |
ad_multi_asset_ad_marketing_images_4 | IMAGE_URL | Multi Asset Ad Marketing Image 4 | Image URL 4 (multi asset ad) |
ad_multi_asset_ad_marketing_images_5 | IMAGE_URL | Multi Asset Ad Marketing Image 5 | Image URL 5 (multi asset ad) |
ad_multi_asset_ad_marketing_images_6 | IMAGE_URL | Multi Asset Ad Marketing Image 6 | Image URL 6 (multi asset ad) |
ad_multi_asset_ad_marketing_images_7 | IMAGE_URL | Multi Asset Ad Marketing Image 7 | Image URL 7 (multi asset ad) |
ad_multi_asset_ad_marketing_images_8 | IMAGE_URL | Multi Asset Ad Marketing Image 8 | Image URL 8 (multi asset ad) |
ad_multi_asset_ad_marketing_images_9 | IMAGE_URL | Multi Asset Ad Marketing Image 9 | Image URL 9 (multi asset ad) |
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_1 | IMAGE_URL | Responsive Display Ad Marketing Image 1 | Image URL 1 (responsive display) |
ad_responsive_display_ad_marketing_images_10 | IMAGE_URL | Responsive Display Ad Marketing Image 10 | Image URL 10 (responsive display) |
ad_responsive_display_ad_marketing_images_11 | IMAGE_URL | Responsive Display Ad Marketing Image 11 | Image URL 11 (responsive display) |
ad_responsive_display_ad_marketing_images_12 | IMAGE_URL | Responsive Display Ad Marketing Image 12 | Image URL 12 (responsive display) |
ad_responsive_display_ad_marketing_images_13 | IMAGE_URL | Responsive Display Ad Marketing Image 13 | Image URL 13 (responsive display) |
ad_responsive_display_ad_marketing_images_14 | IMAGE_URL | Responsive Display Ad Marketing Image 14 | Image URL 14 (responsive display) |
ad_responsive_display_ad_marketing_images_15 | IMAGE_URL | Responsive Display Ad Marketing Image 15 | Image URL 15 (responsive display) |
ad_responsive_display_ad_marketing_images_2 | IMAGE_URL | Responsive Display Ad Marketing Image 2 | Image URL 2 (responsive display) |
ad_responsive_display_ad_marketing_images_3 | IMAGE_URL | Responsive Display Ad Marketing Image 3 | Image URL 3 (responsive display) |
ad_responsive_display_ad_marketing_images_4 | IMAGE_URL | Responsive Display Ad Marketing Image 4 | Image URL 4 (responsive display) |
ad_responsive_display_ad_marketing_images_5 | IMAGE_URL | Responsive Display Ad Marketing Image 5 | Image URL 5 (responsive display) |
ad_responsive_display_ad_marketing_images_6 | IMAGE_URL | Responsive Display Ad Marketing Image 6 | Image URL 6 (responsive display) |
ad_responsive_display_ad_marketing_images_7 | IMAGE_URL | Responsive Display Ad Marketing Image 7 | Image URL 7 (responsive display) |
ad_responsive_display_ad_marketing_images_8 | IMAGE_URL | Responsive Display Ad Marketing Image 8 | Image URL 8 (responsive display) |
ad_responsive_display_ad_marketing_images_9 | IMAGE_URL | Responsive Display Ad Marketing Image 9 | Image URL 9 (responsive display) |
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 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_descriptions_1_text | TEXT | Ad responsive search ad description 1 | Ad responsive search ad description 1 |
ad_responsive_search_ad_descriptions_2_text | TEXT | Ad responsive search ad description 2 | Ad responsive search ad description 2 |
ad_responsive_search_ad_descriptions_3_text | TEXT | Ad responsive search ad description 3 | Ad responsive search ad description 3 |
ad_responsive_search_ad_descriptions_4_text | TEXT | Ad responsive search ad description 4 | Ad responsive search ad description 4 |
ad_responsive_search_ad_descriptions_5_text | TEXT | Ad responsive search ad description 5 | Ad responsive search ad description 5 |
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_headlines_11_text | TEXT | Ad responsive search ad headline 11 | Ad responsive search ad headline 11 |
ad_responsive_search_ad_headlines_12_text | TEXT | Ad responsive search ad headline 12 | Ad responsive search ad headline 12 |
ad_responsive_search_ad_headlines_13_text | TEXT | Ad responsive search ad headline 13 | Ad responsive search ad headline 13 |
ad_responsive_search_ad_headlines_14_text | TEXT | Ad responsive search ad headline 14 | Ad responsive search ad headline 14 |
ad_responsive_search_ad_headlines_15_text | TEXT | Ad responsive search ad headline 15 | Ad responsive search ad headline 15 |
ad_responsive_search_ad_headlines_1_text | TEXT | Ad responsive search ad headline 1 | Ad responsive search ad headline 1 |
ad_responsive_search_ad_headlines_2_text | TEXT | Ad responsive search ad headline 2 | Ad responsive search ad headline 2 |
ad_responsive_search_ad_headlines_3_text | TEXT | Ad responsive search ad headline 3 | Ad responsive search ad headline 3 |
ad_responsive_search_ad_headlines_4_text | TEXT | Ad responsive search ad headline 4 | Ad responsive search ad headline 4 |
ad_responsive_search_ad_headlines_5_text | TEXT | Ad responsive search ad headline 5 | Ad responsive search ad headline 5 |
ad_responsive_search_ad_headlines_6_text | TEXT | Ad responsive search ad headline 6 | Ad responsive search ad headline 6 |
ad_responsive_search_ad_headlines_7_text | TEXT | Ad responsive search ad headline 7 | Ad responsive search ad headline 7 |
ad_responsive_search_ad_headlines_8_text | TEXT | Ad responsive search ad headline 8 | Ad responsive search ad headline 8 |
ad_responsive_search_ad_headlines_9_text | TEXT | Ad responsive search ad headline 9 | Ad responsive search ad headline 9 |
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_travel_ad | TEXT | Ad travel ad | Details pertaining to a travel ad. |
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_action_button_label | TEXT | Ad video ad bumper action button label | Label on the "Call To Action" button taking the user to the video ad's final URL. |
ad_video_ad_bumper_action_headline | TEXT | Ad video ad bumper action headline | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. |
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. 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. |
aligned_bidding_strategy_id | NUMERIC | Aligned bidding strategy id | ID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy. |
aligned_campaign_budget_id | NUMERIC | Aligned campaign budget id | ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget. |
all_conversion_rate | PERCENT | 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 | PERCENT | 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_location_asset_click_to_call | NUMERIC | All conversions from location asset click to call | Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
all_conversions_from_location_asset_directions | NUMERIC | All conversions from location asset directions | Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
all_conversions_from_location_asset_menu | NUMERIC | All conversions from location asset menu | Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
all_conversions_from_location_asset_order | NUMERIC | All conversions from location asset order | Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
all_conversions_from_location_asset_other_engagement | NUMERIC | All conversions from location asset other engagement | Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
all_conversions_from_location_asset_store_visits | NUMERIC | All conversions from location asset store visits | Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
all_conversions_from_location_asset_website | NUMERIC | All conversions from location asset website | Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. |
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). |
all_new_customer_lifetime_value | NUMERIC | All new customer lifetime value | All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "all_conversions_value". See https://support.google.com/google-ads/answer/12080169 for more details. |
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 | TEXT | Asset ID | The asset which is linked to the ad group ad. |
asset_automation_settings | TEXT | Asset automation settings | Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior. |
asset_book_on_google_asset | TEXT | Asset book on google asset | A book on google asset. |
asset_call_asset_ad_schedule_targets | TEXT | Asset call asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
asset_call_asset_call_conversion_action | TEXT | Asset call asset call conversion action | The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
asset_call_asset_call_conversion_reporting_state | TEXT | Asset call asset call conversion reporting state | Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. |
asset_call_asset_country_code | TEXT | Asset call asset country code | Required. Two-letter country code of the phone number. Examples: 'US', 'us'. |
asset_call_asset_phone_number | TEXT | Asset call asset phone number | Required. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890' |
asset_call_to_action_asset_call_to_action | TEXT | Asset call to action asset call to action | Call to action. |
asset_callout_asset_ad_schedule_targets | TEXT | Asset callout asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
asset_callout_asset_callout_text | TEXT | Asset callout asset callout text | Required. The callout text. The length of this string should be between 1 and 25, inclusive. |
asset_callout_asset_end_date | DATE | Asset callout asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
asset_callout_asset_start_date | DATE | Asset callout asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
asset_demand_gen_carousel_card_asset_call_to_action_text | TEXT | Asset demand gen carousel card asset call to action text | Call to action text. |
asset_demand_gen_carousel_card_asset_headline | TEXT | Asset demand gen carousel card asset headline | Required. Headline of the carousel card. |
asset_demand_gen_carousel_card_asset_marketing_image_asset | TEXT | Asset demand gen carousel card asset marketing image asset | Asset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required. |
asset_demand_gen_carousel_card_asset_portrait_marketing_image_asset | TEXT | Asset demand gen carousel card asset portrait marketing image asset | Asset resource name of the associated 4:5 portrait marketing image. |
asset_demand_gen_carousel_card_asset_square_marketing_image_asset | TEXT | Asset demand gen carousel card asset square marketing image asset | Asset resource name of the associated square marketing image. This and/or a marketing image asset is required. |
asset_dynamic_custom_asset_android_app_link | TEXT | Asset dynamic custom asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_custom_asset_contextual_keywords | TEXT | Asset dynamic custom asset contextual keywords | Contextual keywords, for example, Sedans, 4 door sedans. |
asset_dynamic_custom_asset_formatted_price | TEXT | Asset dynamic custom asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00. |
asset_dynamic_custom_asset_formatted_sale_price | TEXT | Asset dynamic custom asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00. |
asset_dynamic_custom_asset_id | TEXT | Asset dynamic custom asset id | Required. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required. |
asset_dynamic_custom_asset_id2 | TEXT | Asset dynamic custom asset id2 | ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique. |
asset_dynamic_custom_asset_image_url | TEXT | Asset dynamic custom asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_custom_asset_ios_app_link | TEXT | Asset dynamic custom asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_custom_asset_ios_app_store_id | NUMERIC | Asset dynamic custom asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_custom_asset_item_address | TEXT | Asset dynamic custom asset item address | Item address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
asset_dynamic_custom_asset_item_category | TEXT | Asset dynamic custom asset item category | Item category, for example, Sedans. |
asset_dynamic_custom_asset_item_description | TEXT | Asset dynamic custom asset item description | Item description, for example, Best selling mid-size car. |
asset_dynamic_custom_asset_item_subtitle | TEXT | Asset dynamic custom asset item subtitle | Item subtitle, for example, At your Mountain View dealership. |
asset_dynamic_custom_asset_item_title | TEXT | Asset dynamic custom asset item title | Required. Item title, for example, Mid-size sedan. Required. |
asset_dynamic_custom_asset_price | TEXT | Asset dynamic custom asset price | Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD. |
asset_dynamic_custom_asset_sale_price | TEXT | Asset dynamic custom asset sale price | Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field. |
asset_dynamic_custom_asset_similar_ids | TEXT | Asset dynamic custom asset similar ids | Similar IDs. |
asset_dynamic_education_asset_address | TEXT | Asset dynamic education asset address | School address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
asset_dynamic_education_asset_android_app_link | TEXT | Asset dynamic education asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_education_asset_contextual_keywords | TEXT | Asset dynamic education asset contextual keywords | Contextual keywords, for example, Nursing certification, Health, Mountain View. |
asset_dynamic_education_asset_image_url | TEXT | Asset dynamic education asset image url | Image url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_education_asset_ios_app_link | TEXT | Asset dynamic education asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_education_asset_ios_app_store_id | NUMERIC | Asset dynamic education asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_education_asset_location_id | TEXT | Asset dynamic education asset location id | Location ID which can be any sequence of letters and digits and must be unique. |
asset_dynamic_education_asset_program_description | TEXT | Asset dynamic education asset program description | Program description, for example, Nursing Certification. |
asset_dynamic_education_asset_program_id | TEXT | Asset dynamic education asset program id | Required. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_education_asset_program_name | TEXT | Asset dynamic education asset program name | Required. Program name, for example, Nursing. Required. |
asset_dynamic_education_asset_school_name | TEXT | Asset dynamic education asset school name | School name, for example, Mountain View School of Nursing. |
asset_dynamic_education_asset_similar_program_ids | TEXT | Asset dynamic education asset similar program ids | Similar program IDs. |
asset_dynamic_education_asset_subject | TEXT | Asset dynamic education asset subject | Subject of study, for example, Health. |
asset_dynamic_education_asset_thumbnail_image_url | TEXT | Asset dynamic education asset thumbnail image url | Thumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset. |
asset_dynamic_flights_asset_android_app_link | TEXT | Asset dynamic flights asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_flights_asset_custom_mapping | TEXT | Asset dynamic flights asset custom mapping | A custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32". |
asset_dynamic_flights_asset_destination_id | TEXT | Asset dynamic flights asset destination id | Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_flights_asset_destination_name | TEXT | Asset dynamic flights asset destination name | Destination name, for example, Paris. |
asset_dynamic_flights_asset_flight_description | TEXT | Asset dynamic flights asset flight description | Required. Flight description, for example, Book your ticket. Required. |
asset_dynamic_flights_asset_flight_price | TEXT | Asset dynamic flights asset flight price | Flight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
asset_dynamic_flights_asset_flight_sale_price | TEXT | Asset dynamic flights asset flight sale price | Flight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field. |
asset_dynamic_flights_asset_formatted_price | TEXT | Asset dynamic flights asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
asset_dynamic_flights_asset_formatted_sale_price | TEXT | Asset dynamic flights asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
asset_dynamic_flights_asset_image_url | TEXT | Asset dynamic flights asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_flights_asset_ios_app_link | TEXT | Asset dynamic flights asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_flights_asset_ios_app_store_id | NUMERIC | Asset dynamic flights asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_flights_asset_origin_id | TEXT | Asset dynamic flights asset origin id | Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique. |
asset_dynamic_flights_asset_origin_name | TEXT | Asset dynamic flights asset origin name | Origin name, for example, London. |
asset_dynamic_flights_asset_similar_destination_ids | TEXT | Asset dynamic flights asset similar destination ids | Similar destination IDs, for example, PAR,LON. |
asset_dynamic_hotels_and_rentals_asset_address | TEXT | Asset dynamic hotels and rentals asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
asset_dynamic_hotels_and_rentals_asset_android_app_link | TEXT | Asset dynamic hotels and rentals asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_hotels_and_rentals_asset_category | TEXT | Asset dynamic hotels and rentals asset category | Category, for example, Hotel suite. |
asset_dynamic_hotels_and_rentals_asset_contextual_keywords | TEXT | Asset dynamic hotels and rentals asset contextual keywords | Contextual keywords, for example, Mountain View "Hotels", South Bay hotels. |
asset_dynamic_hotels_and_rentals_asset_description | TEXT | Asset dynamic hotels and rentals asset description | Description, for example, Close to SJC Airport. |
asset_dynamic_hotels_and_rentals_asset_destination_name | TEXT | Asset dynamic hotels and rentals asset destination name | Destination name, for example, Downtown Mountain View. |
asset_dynamic_hotels_and_rentals_asset_formatted_price | TEXT | Asset dynamic hotels and rentals asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
asset_dynamic_hotels_and_rentals_asset_formatted_sale_price | TEXT | Asset dynamic hotels and rentals asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
asset_dynamic_hotels_and_rentals_asset_image_url | TEXT | Asset dynamic hotels and rentals asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_hotels_and_rentals_asset_ios_app_link | TEXT | Asset dynamic hotels and rentals asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_hotels_and_rentals_asset_ios_app_store_id | NUMERIC | Asset dynamic hotels and rentals asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_hotels_and_rentals_asset_price | TEXT | Asset dynamic hotels and rentals asset price | Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
asset_dynamic_hotels_and_rentals_asset_property_id | TEXT | Asset dynamic hotels and rentals asset property id | Required. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_hotels_and_rentals_asset_property_name | TEXT | Asset dynamic hotels and rentals asset property name | Required. Property name, for example, Mountain View Hotel. Required. |
asset_dynamic_hotels_and_rentals_asset_sale_price | TEXT | Asset dynamic hotels and rentals asset sale price | ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field. |
asset_dynamic_hotels_and_rentals_asset_similar_property_ids | TEXT | Asset dynamic hotels and rentals asset similar property ids | Similar property IDs. |
asset_dynamic_hotels_and_rentals_asset_star_rating | NUMERIC | Asset dynamic hotels and rentals asset star rating | Star rating. Must be a number between 1 to 5, inclusive. |
asset_dynamic_jobs_asset_address | TEXT | Asset dynamic jobs asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403. |
asset_dynamic_jobs_asset_android_app_link | TEXT | Asset dynamic jobs asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_jobs_asset_contextual_keywords | TEXT | Asset dynamic jobs asset contextual keywords | Contextual keywords, for example, Software engineering job. |
asset_dynamic_jobs_asset_description | TEXT | Asset dynamic jobs asset description | Description, for example, Apply your technical skills. |
asset_dynamic_jobs_asset_image_url | TEXT | Asset dynamic jobs asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_jobs_asset_ios_app_link | TEXT | Asset dynamic jobs asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_jobs_asset_ios_app_store_id | NUMERIC | Asset dynamic jobs asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_jobs_asset_job_category | TEXT | Asset dynamic jobs asset job category | Job category, for example, Technical. |
asset_dynamic_jobs_asset_job_id | TEXT | Asset dynamic jobs asset job id | Required. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_jobs_asset_job_subtitle | TEXT | Asset dynamic jobs asset job subtitle | Job subtitle, for example, Level II. |
asset_dynamic_jobs_asset_job_title | TEXT | Asset dynamic jobs asset job title | Required. Job title, for example, Software engineer. Required. |
asset_dynamic_jobs_asset_location_id | TEXT | Asset dynamic jobs asset location id | Location ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique. |
asset_dynamic_jobs_asset_salary | TEXT | Asset dynamic jobs asset salary | Salary, for example, $100,000. |
asset_dynamic_jobs_asset_similar_job_ids | TEXT | Asset dynamic jobs asset similar job ids | Similar job IDs, for example, 1275. |
asset_dynamic_local_asset_address | TEXT | Asset dynamic local asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403. |
asset_dynamic_local_asset_android_app_link | TEXT | Asset dynamic local asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_local_asset_category | TEXT | Asset dynamic local asset category | Category, for example, Food. |
asset_dynamic_local_asset_contextual_keywords | TEXT | Asset dynamic local asset contextual keywords | Contextual keywords, for example, Save groceries coupons. |
asset_dynamic_local_asset_deal_id | TEXT | Asset dynamic local asset deal id | Required. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_local_asset_deal_name | TEXT | Asset dynamic local asset deal name | Required. Deal name, for example, 50% off at Mountain View Grocers. Required. |
asset_dynamic_local_asset_description | TEXT | Asset dynamic local asset description | Description, for example, Save on your weekly bill. |
asset_dynamic_local_asset_formatted_price | TEXT | Asset dynamic local asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
asset_dynamic_local_asset_formatted_sale_price | TEXT | Asset dynamic local asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
asset_dynamic_local_asset_image_url | TEXT | Asset dynamic local asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_local_asset_ios_app_link | TEXT | Asset dynamic local asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_local_asset_ios_app_store_id | NUMERIC | Asset dynamic local asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_local_asset_price | TEXT | Asset dynamic local asset price | Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
asset_dynamic_local_asset_sale_price | TEXT | Asset dynamic local asset sale price | Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field. |
asset_dynamic_local_asset_similar_deal_ids | TEXT | Asset dynamic local asset similar deal ids | Similar deal IDs, for example, 1275. |
asset_dynamic_local_asset_subtitle | TEXT | Asset dynamic local asset subtitle | Subtitle, for example, Groceries. |
asset_dynamic_real_estate_asset_address | TEXT | Asset dynamic real estate asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
asset_dynamic_real_estate_asset_android_app_link | TEXT | Asset dynamic real estate asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_real_estate_asset_city_name | CITY | Asset dynamic real estate asset city name | City name, for example, Mountain View, California. |
asset_dynamic_real_estate_asset_contextual_keywords | TEXT | Asset dynamic real estate asset contextual keywords | Contextual keywords, for example, For sale; Houses for sale. |
asset_dynamic_real_estate_asset_description | TEXT | Asset dynamic real estate asset description | Description, for example, 3 beds, 2 baths, 1568 sq. ft. |
asset_dynamic_real_estate_asset_formatted_price | TEXT | Asset dynamic real estate asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00. |
asset_dynamic_real_estate_asset_image_url | TEXT | Asset dynamic real estate asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_real_estate_asset_ios_app_link | TEXT | Asset dynamic real estate asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_real_estate_asset_ios_app_store_id | NUMERIC | Asset dynamic real estate asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_real_estate_asset_listing_id | TEXT | Asset dynamic real estate asset listing id | Required. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_real_estate_asset_listing_name | TEXT | Asset dynamic real estate asset listing name | Required. Listing name, for example, Boulevard Bungalow. Required. |
asset_dynamic_real_estate_asset_listing_type | TEXT | Asset dynamic real estate asset listing type | Listing type, for example, For sale. |
asset_dynamic_real_estate_asset_price | TEXT | Asset dynamic real estate asset price | Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD. |
asset_dynamic_real_estate_asset_property_type | TEXT | Asset dynamic real estate asset property type | Property type, for example, House. |
asset_dynamic_real_estate_asset_similar_listing_ids | TEXT | Asset dynamic real estate asset similar listing ids | Similar listing IDs. |
asset_dynamic_travel_asset_android_app_link | TEXT | Asset dynamic travel asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
asset_dynamic_travel_asset_category | TEXT | Asset dynamic travel asset category | Category, for example, Express. |
asset_dynamic_travel_asset_contextual_keywords | TEXT | Asset dynamic travel asset contextual keywords | Contextual keywords, for example, Paris trains. |
asset_dynamic_travel_asset_destination_address | TEXT | Asset dynamic travel asset destination address | Destination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403. |
asset_dynamic_travel_asset_destination_id | TEXT | Asset dynamic travel asset destination id | Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
asset_dynamic_travel_asset_destination_name | TEXT | Asset dynamic travel asset destination name | Destination name, for example, Paris. |
asset_dynamic_travel_asset_formatted_price | TEXT | Asset dynamic travel asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
asset_dynamic_travel_asset_formatted_sale_price | TEXT | Asset dynamic travel asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
asset_dynamic_travel_asset_image_url | TEXT | Asset dynamic travel asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
asset_dynamic_travel_asset_ios_app_link | TEXT | Asset dynamic travel asset ios app link | iOS deep link, for example, exampleApp://content/page. |
asset_dynamic_travel_asset_ios_app_store_id | NUMERIC | Asset dynamic travel asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
asset_dynamic_travel_asset_origin_id | TEXT | Asset dynamic travel asset origin id | Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique. |
asset_dynamic_travel_asset_origin_name | TEXT | Asset dynamic travel asset origin name | Origin name, for example, London. |
asset_dynamic_travel_asset_price | TEXT | Asset dynamic travel asset price | Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
asset_dynamic_travel_asset_sale_price | TEXT | Asset dynamic travel asset sale price | Sale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field. |
asset_dynamic_travel_asset_similar_destination_ids | TEXT | Asset dynamic travel asset similar destination ids | Similar destination IDs, for example, NYC. |
asset_dynamic_travel_asset_title | TEXT | Asset dynamic travel asset title | Required. Title, for example, Book your train ticket. Required. |
asset_field_type_policy_summaries | TEXT | Asset field type policy summaries | Policy information for the asset for each FieldType. |
asset_final_mobile_urls | TEXT | Asset final mobile urls | A list of possible final mobile URLs after all cross domain redirects. |
asset_final_url_suffix | TEXT | Asset final url suffix | URL template for appending params to landing page URLs served with parallel tracking. |
asset_final_urls | TEXT | Asset final urls | A list of possible final URLs after all cross domain redirects. |
asset_group | TEXT | Asset group | The asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared. |
asset_group_ad_strength | TEXT | Asset group ad strength | Overall ad strength of this asset group. |
asset_group_campaign | TEXT | Asset group campaign | The campaign with which this asset group is associated. The asset which is linked to the asset group. |
asset_group_final_mobile_urls | TEXT | Asset group final mobile urls | A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out. |
asset_group_final_urls | TEXT | Asset group final urls | A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out. |
asset_group_id | TEXT | Asset group id | The ID of the asset group. |
asset_group_name | TEXT | Asset group name | Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign. |
asset_group_path1 | TEXT | Asset group path1 | First part of text that may appear appended to the url displayed in the ad. |
asset_group_path2 | TEXT | Asset group path2 | Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set. |
asset_group_primary_status | TEXT | Asset group primary status | The primary status of the asset group. Provides insights into why an asset group is not serving or not serving optimally. |
asset_group_primary_status_reasons | TEXT | Asset group primary status reasons | Provides reasons into why an asset group is not serving or not serving optimally. It will be empty when the asset group is serving without issues. |
asset_group_resource_name | TEXT | Asset group resource name | The resource name of the asset group. Asset group resource names have the form: customers/{customer_id}/assetGroups/{asset_group_id} |
asset_group_status | TEXT | Asset group status | The status of the asset group. |
asset_hotel_callout_asset_language_code | TEXT | Asset hotel callout asset language code | Required. The language of the hotel callout. Represented as BCP 47 language tag. |
asset_hotel_callout_asset_text | TEXT | Asset hotel callout asset text | Required. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive. |
asset_hotel_property_asset_hotel_address | TEXT | Asset hotel property asset hotel address | Address of the hotel. Read-only. |
asset_hotel_property_asset_hotel_name | TEXT | Asset hotel property asset hotel name | Name of the hotel. Read-only. |
asset_hotel_property_asset_place_id | TEXT | Asset hotel property asset place id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more. |
asset_id | TEXT | Asset id | The ID of the asset. |
asset_image_asset_file_size | NUMERIC | Asset image asset file size | File size of the image asset in bytes. |
asset_image_asset_full_size_height_pixels | NUMERIC | Asset image asset full size height pixels | Height of the image. |
asset_image_asset_full_size_url | IMAGE_URL | Asset image asset full size url | A URL that returns the image with this height and width. |
asset_image_asset_full_size_width_pixels | NUMERIC | Asset image asset full size width pixels | Width of the image. |
asset_image_asset_mime_type | TEXT | Asset image asset mime type | MIME type of the image asset. |
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. |
asset_lead_form_asset_background_image_asset | TEXT | Asset lead form asset background image asset | Asset resource name of the background image. The image dimensions must be exactly 1200x628. |
asset_lead_form_asset_business_name | TEXT | Asset lead form asset business name | Required. The name of the business being advertised. |
asset_lead_form_asset_call_to_action_description | TEXT | Asset lead form asset call to action description | Required. Text giving a clear value proposition of what users expect once they expand the form. |
asset_lead_form_asset_call_to_action_type | TEXT | Asset lead form asset call to action type | Required. Pre-defined display text that encourages user to expand the form. |
asset_lead_form_asset_custom_disclosure | TEXT | Asset lead form asset custom disclosure | Custom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only. |
asset_lead_form_asset_custom_question_fields | TEXT | Asset lead form asset custom question fields | Ordered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form. |
asset_lead_form_asset_delivery_methods | TEXT | Asset lead form asset delivery methods | Configured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured. |
asset_lead_form_asset_description | TEXT | Asset lead form asset description | Required. Detailed description of the expanded form to describe what the form is asking for or facilitating. |
asset_lead_form_asset_desired_intent | TEXT | Asset lead form asset desired intent | Chosen intent for the lead form, for example, more volume or more qualified. |
asset_lead_form_asset_fields | TEXT | Asset lead form asset fields | Ordered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions. |
asset_lead_form_asset_headline | TEXT | Asset lead form asset headline | Required. Headline of the expanded form to describe what the form is asking for or facilitating. |
asset_lead_form_asset_post_submit_call_to_action_type | TEXT | Asset lead form asset post submit call to action type | Pre-defined display text that encourages user action after the form is submitted. |
asset_lead_form_asset_post_submit_description | TEXT | Asset lead form asset post submit description | Detailed description shown after form submission that describes how the advertiser will follow up with the user. |
asset_lead_form_asset_post_submit_headline | TEXT | Asset lead form asset post submit headline | Headline of text shown after form submission that describes how the advertiser will follow up with the user. |
asset_lead_form_asset_privacy_policy_url | TEXT | Asset lead form asset privacy policy url | Required. Link to a page describing the policy on how the collected data is handled by the advertiser/business. |
asset_location_asset_business_profile_locations | TEXT | Asset location asset business profile locations | The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID. |
asset_location_asset_location_ownership_type | TEXT | Asset location asset location ownership type | The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location. |
asset_location_asset_place_id | TEXT | Asset location asset place id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID. |
asset_mobile_app_asset_app_id | TEXT | Asset mobile app asset app id | Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS. |
asset_mobile_app_asset_app_store | TEXT | Asset mobile app asset app store | Required. The application store that distributes this specific app. |
asset_mobile_app_asset_end_date | DATE | Asset mobile app asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
asset_mobile_app_asset_link_text | TEXT | Asset mobile app asset link text | Required. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive. |
asset_mobile_app_asset_start_date | DATE | Asset mobile app asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
asset_name | TEXT | Asset name | Optional name of the asset. |
asset_page_feed_asset_labels | TEXT | Asset page feed asset labels | Labels used to group the page urls. |
asset_page_feed_asset_page_url | TEXT | Asset page feed asset page url | Required. The webpage that advertisers want to target. |
asset_policy_summary_approval_status | TEXT | Asset policy summary approval status | The overall approval status of this asset, calculated based on the status of its individual policy topic entries. |
asset_policy_summary_policy_topic_entries | TEXT | Asset policy summary policy topic entries | The list of policy findings for this asset. |
asset_policy_summary_review_status | TEXT | Asset policy summary review status | Where in the review process this asset is. |
asset_price_asset_language_code | TEXT | Asset price asset language code | Required. The language of the price asset. Represented as BCP 47 language tag. |
asset_price_asset_price_offerings | TEXT | Asset price asset price offerings | The price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive. |
asset_price_asset_price_qualifier | TEXT | Asset price asset price qualifier | The price qualifier of the price asset. |
asset_price_asset_type | TEXT | Asset price asset type | Required. The type of the price asset. |
asset_promotion_asset_ad_schedule_targets | TEXT | Asset promotion asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
asset_promotion_asset_discount_modifier | TEXT | Asset promotion asset discount modifier | A modifier for qualification of the discount. |
asset_promotion_asset_end_date | DATE | Asset promotion asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
asset_promotion_asset_language_code | TEXT | Asset promotion asset language code | The language of the promotion. Represented as BCP 47 language tag. |
asset_promotion_asset_money_amount_off_amount_micros | NUMERIC | Asset promotion asset money amount off amount micros | Amount in micros. One million is equivalent to one unit. |
asset_promotion_asset_money_amount_off_currency_code | TEXT | Asset promotion asset money amount off currency code | Three-character ISO 4217 currency code. |
asset_promotion_asset_occasion | TEXT | Asset promotion asset occasion | The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion. |
asset_promotion_asset_orders_over_amount_amount_micros | NUMERIC | Asset promotion asset orders over amount amount micros | Amount in micros. One million is equivalent to one unit. |
asset_promotion_asset_orders_over_amount_currency_code | TEXT | Asset promotion asset orders over amount currency code | Three-character ISO 4217 currency code. |
asset_promotion_asset_percent_off | NUMERIC | Asset promotion asset percent off | Percentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required. |
asset_promotion_asset_promotion_code | TEXT | Asset promotion asset promotion code | A code the user should use in order to be eligible for the promotion. |
asset_promotion_asset_promotion_target | TEXT | Asset promotion asset promotion target | Required. A freeform description of what the promotion is targeting. |
asset_promotion_asset_redemption_end_date | DATE | Asset promotion asset redemption end date | Last date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format. |
asset_promotion_asset_redemption_start_date | DATE | Asset promotion asset redemption start date | Start date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format. |
asset_promotion_asset_start_date | DATE | Asset promotion asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
asset_resource_name | TEXT | Asset resource name | The resource name of the asset. Asset resource names have the form: customers/{customer_id}/assets/{asset_id} |
asset_sitelink_asset_ad_schedule_targets | TEXT | Asset sitelink asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
asset_sitelink_asset_description1 | TEXT | Asset sitelink asset description1 | First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set. |
asset_sitelink_asset_description2 | TEXT | Asset sitelink asset description2 | Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set. |
asset_sitelink_asset_end_date | DATE | Asset sitelink asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
asset_sitelink_asset_link_text | TEXT | Asset sitelink asset link text | Required. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. |
asset_sitelink_asset_start_date | DATE | Asset sitelink asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
asset_source | TEXT | Asset source | Source of the asset. |
asset_structured_snippet_asset_header | TEXT | Asset structured snippet asset header | Required. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers |
asset_structured_snippet_asset_values | TEXT | Asset structured snippet asset values | Required. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive. |
asset_text_asset_text | TEXT | Asset text asset text | Text content of the text asset. |
asset_tracking_url_template | TEXT | Asset tracking url template | URL template for constructing a tracking URL. |
asset_type | TEXT | Asset type | Type of the asset. |
asset_url_custom_parameters | TEXT | Asset url custom parameters | A list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls. |
asset_youtube_video_asset_youtube_video_id | TEXT | Asset youtube video asset youtube video id | YouTube video id. This is the 11 character string value used in the YouTube video URL. |
asset_youtube_video_asset_youtube_video_title | TEXT | Asset youtube video asset youtube video title | YouTube video title. |
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 | PERCENT | 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 in the most prominent position on the search results page. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
auction_insight_search_impression_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 | PERCENT | 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 | PERCENT | 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 | PERCENT | 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 adjacent to the top organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. |
audience_asset_group | TEXT | Audience asset group | The asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared. |
audience_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 | Name of the audience. It should be unique across all audiences within the account. It must have a minimum length of 1 and maximum length of 255. Required when scope is not set or is set to CUSTOMER. Cannot be set or updated when scope is ASSET_GROUP. |
audience_resource_name | TEXT | Audience resource name | The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id} |
audience_scope | TEXT | Audience scope | Defines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP. |
audience_setting_use_audience_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_cart_size | NUMERIC | Average cart size | Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. |
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_impression_frequency_per_user | NUMERIC | Average impression frequency per user | The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. |
average_order_value_micros | NUMERIC | Average order value micros | Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. |
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_target_cpa_micros | NUMERIC | Average target cpa micros | The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA). |
average_target_roas | NUMERIC | Average target roas | The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS). |
average_time_on_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_aligned_campaign_budget_id | NUMERIC | Bidding strategy aligned campaign budget id | ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget. |
bidding_strategy_campaign_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 acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. |
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 | The chosen revenue (based on conversion data) per unit of spend. |
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. |
book_on_google_asset | TEXT | Book on google asset | A book on google asset. |
bounce_rate | PERCENT | 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. |
brand_list_shared_set | TEXT | Brand list shared set | Shared set resource name of the brand list. |
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_asset_ad_schedule_targets | TEXT | Call asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
call_asset_call_conversion_action | TEXT | Call asset call conversion action | The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
call_asset_call_conversion_reporting_state | TEXT | Call asset call conversion reporting state | Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. |
call_asset_country_code | TEXT | Call asset country code | Required. Two-letter country code of the phone number. Examples: 'US', 'us'. |
call_asset_phone_number | TEXT | Call asset phone number | Required. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890' |
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. |
call_to_action_asset_call_to_action | TEXT | Call to action asset call to action | Call to action. |
callout_asset_ad_schedule_targets | TEXT | Callout asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
callout_asset_callout_text | TEXT | Callout asset callout text | Required. The callout text. The length of this string should be between 1 and 25, inclusive. |
callout_asset_end_date | DATE | Callout asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
callout_asset_start_date | DATE | Callout asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
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_asset_automation_settings | TEXT | Campaign asset automation settings | Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior. |
campaign_audience_setting_use_audience_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_aligned_bidding_strategy_id | NUMERIC | Campaign budget aligned bidding strategy id | ID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy. |
campaign_budget_delivery_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_brand_list_shared_set | TEXT | Campaign criterion brand list shared set | Shared set resource name of the brand list. |
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_activity_city_value | TEXT | Campaign criterion listing scope dimensions activity city value | String value of the activity city. The Geo Target Constant resource name. |
campaign_criterion_listing_scope_dimensions_activity_country_value | COUNTRY | Campaign criterion listing scope dimensions activity country value | String value of the activity country. The Geo Target Constant resource name. |
campaign_criterion_listing_scope_dimensions_activity_state_value | TEXT | Campaign criterion listing scope dimensions activity state value | String value of the activity state. The Geo Target Constant resource name. |
campaign_criterion_listing_scope_dimensions_hotel_city_city_criterion | CITY | 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 | REGION | 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_local_service_id_service_id | TEXT | Campaign criterion local service id service id | The criterion 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_enable_customer_level_location_asset_set | BOOLEAN | Campaign criterion location group enable customer level location asset set | Denotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations. |
campaign_criterion_location_group_feed | TEXT | Campaign criterion location group feed | Feed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations. |
campaign_criterion_location_group_geo_target_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. Cannot be set with AssetSet fields. |
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 | CITY | Campaign criterion proximity address city name | Name of the city. |
campaign_criterion_proximity_address_country_code | COUNTRY | 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 | PERCENT | 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_demand_gen_campaign_settings_upgraded_targeting | BOOLEAN | Campaign demand gen campaign settings upgraded targeting | Specifies whether this campaign uses upgraded targeting options. When this field is set to true, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to false, and can only be set when creating a campaign. |
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_excluded_parent_asset_set_types | TEXT | Campaign excluded parent asset set types | The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported. |
campaign_fixed_cpm_goal | TEXT | Campaign fixed cpm goal | Fixed CPM bidding goal. Determines the exact bidding optimization parameters. |
campaign_fixed_cpm_target_frequency_info_target_count | NUMERIC | Campaign fixed cpm target frequency info target count | Target frequency count represents the number of times an advertiser wants to show the ad to target a single user. |
campaign_fixed_cpm_target_frequency_info_time_unit | TEXT | Campaign fixed cpm target frequency info time unit | Time window expressing the period over which you want to reach the specified target_count. |
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_property_asset_set | TEXT | Campaign hotel property asset set | The set of hotel properties for Performance Max for travel goals campaigns. |
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_keyword_match_type | TEXT | Campaign keyword match type | Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign. |
campaign_labels | TEXT | Campaign labels | The resource names of labels attached to this campaign. |
campaign_listing_type | TEXT | Campaign listing type | Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns. |
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 acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. |
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_google_tv_network | BOOLEAN | Campaign network settings target google tv network | Whether ads will be served on the Google TV network. |
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_network_settings_target_youtube | BOOLEAN | Campaign network settings target youtube | Whether ads will be served on YouTube. |
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_primary_status | TEXT | Campaign primary status | The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status. |
campaign_primary_status_reasons | TEXT | Campaign primary status reasons | The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus. |
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_advertising_partner_ids | NUMERIC | Campaign shopping setting advertising partner ids | The ads account IDs of advertising partners cooperating within the 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_disable_product_feed | BOOLEAN | Campaign shopping setting disable product feed | Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature. |
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_use_vehicle_inventory | BOOLEAN | Campaign shopping setting use vehicle inventory | Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns. For setting Vehicle Listing inventory in Performance Max campaigns, use listing_type instead. |
campaign_status | TEXT | Campaign status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
campaign_sub_type | TEXT | Campaign sub type | Optional refinement to Campaign type. Alias for Advertising channel sub type. |
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_target_frequency_goal_target_count | NUMERIC | Campaign target cpm target frequency goal target count | Target Frequency count representing how many times you want to reach a single user. |
campaign_target_cpm_target_frequency_goal_time_unit | TEXT | Campaign target cpm target frequency goal time unit | Time window expressing the period over which you want to reach the specified target_count. |
campaign_target_cpv | TEXT | Campaign target cpv | An automated bidding strategy that sets bids to optimize performance given the target CPV you set. |
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 | The chosen revenue (based on conversion data) per unit of spend. |
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_travel_campaign_settings_travel_account_id | NUMERIC | Campaign travel campaign settings travel account id | The Travel account ID associated with the Travel campaign. |
campaign_trial_type | TEXT | Campaign trial type | The type of campaign: normal, draft, or experiment. |
campaign_type | TEXT | Campaign type | The primary serving target for ads within the campaign. Alias for Advertising channel type. |
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 | Brand Safety setting at the individual campaign level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513. |
campaign_video_campaign_settings_video_ad_inventory_control_allow_in_feed | BOOLEAN | Campaign video campaign settings video ad inventory control allow in feed | Determine if VideoResponsiveAds can be used for in-feed video ads. |
campaign_video_campaign_settings_video_ad_inventory_control_allow_in_stream | BOOLEAN | Campaign video campaign settings video ad inventory control allow in stream | Determine if VideoResponsiveAds can be used for in-stream video ads. |
campaign_video_campaign_settings_video_ad_inventory_control_allow_shorts | BOOLEAN | Campaign video campaign settings video ad inventory control allow shorts | Determine if VideoResponsiveAds can be used as shorts format. |
carrier_carrier_constant | TEXT | Carrier carrier constant | The Carrier constant resource name. |
channel | TEXT | Channel | Channel of the product. |
channel_exclusivity | TEXT | Channel exclusivity | Channel exclusivity of the product. |
channel_id | TEXT | Channel id | The owner channel id of the video. |
city | CITY | 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 | PERCENT | 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_of_goods_sold_micros | NUMERIC | Cost of goods sold micros | Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. |
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 | COUNTRY | Country criteria id | Resource name of the geo target constant for the country of sale of the product. |
country_criterion_id | COUNTRY | 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_id | TEXT | Creative id | The ID of the ad. |
creative_quality_score | TEXT | Creative quality score | The performance of the ad compared to other advertisers. |
creative_status | TEXT | Creative status | The status of the ad. |
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. |
cross_device_conversions_value_micros | NUMERIC | Cross device conversions value micros | The sum of the value of cross-device conversions, in micros. |
cross_sell_cost_of_goods_sold_micros | NUMERIC | Cross sell cost of goods sold micros | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. |
cross_sell_gross_profit_micros | NUMERIC | Cross sell gross profit micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. |
cross_sell_revenue_micros | NUMERIC | Cross sell revenue micros | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. |
cross_sell_units_sold | NUMERIC | Cross sell units sold | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
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 | PERCENT | 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_agreement_setting_accepted_lead_form_terms | BOOLEAN | Customer agreement setting accepted lead form terms | Whether the customer has accepted lead form term of service. |
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_customer_agreement_setting_accepted_lead_form_terms | BOOLEAN | Customer customer agreement setting accepted lead form terms | Whether the customer has accepted lead form term of service. |
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. Only mutable in an update operation. |
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_image_asset_auto_migration_done | BOOLEAN | Customer image asset auto migration done | True if feed based image has been migrated to asset based image. |
customer_image_asset_auto_migration_done_date_time | DATE | Customer image asset auto migration done date time | Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format. |
customer_local_services_settings_granular_insurance_statuses | TEXT | Customer local services settings granular insurance statuses | A read-only list of geo vertical level insurance statuses. |
customer_local_services_settings_granular_license_statuses | TEXT | Customer local services settings granular license statuses | A read-only list of geo vertical level license statuses. |
customer_location_asset_auto_migration_done | BOOLEAN | Customer location asset auto migration done | True if feed based location has been migrated to asset based location. |
customer_location_asset_auto_migration_done_date_time | DATE | Customer location asset auto migration done date time | Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format. |
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. Only mutable in an update operation. |
customer_video_brand_safety_suitability | TEXT | Customer video brand safety suitability | Brand Safety setting at the account level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513. |
datasource | TEXT | Data Source | The name of the Windsor connector returning the row |
date | DATE | Date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
day_of_month | TEXT | Day of month | Day of the month |
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. |
demand_gen_campaign_settings_upgraded_targeting | BOOLEAN | Demand gen campaign settings upgraded targeting | Specifies whether this campaign uses upgraded targeting options. When this field is set to true, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to false, and can only be set when creating a campaign. |
demand_gen_carousel_card_asset_call_to_action_text | TEXT | Demand gen carousel card asset call to action text | Call to action text. |
demand_gen_carousel_card_asset_headline | TEXT | Demand gen carousel card asset headline | Required. Headline of the carousel card. |
demand_gen_carousel_card_asset_marketing_image_asset | TEXT | Demand gen carousel card asset marketing image asset | Asset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required. |
demand_gen_carousel_card_asset_portrait_marketing_image_asset | TEXT | Demand gen carousel card asset portrait marketing image asset | Asset resource name of the associated 4:5 portrait marketing image. |
demand_gen_carousel_card_asset_square_marketing_image_asset | TEXT | Demand gen carousel card asset square marketing image asset | Asset resource name of the associated square marketing image. This and/or a marketing image asset is required. |
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. |
duration_millis | NUMERIC | Video duration millis | The duration of the video in milliseconds. |
dynamic_custom_asset_android_app_link | TEXT | Dynamic custom asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_custom_asset_contextual_keywords | TEXT | Dynamic custom asset contextual keywords | Contextual keywords, for example, Sedans, 4 door sedans. |
dynamic_custom_asset_formatted_price | TEXT | Dynamic custom asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00. |
dynamic_custom_asset_formatted_sale_price | TEXT | Dynamic custom asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00. |
dynamic_custom_asset_id | TEXT | Dynamic custom asset id | Required. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required. |
dynamic_custom_asset_id2 | TEXT | Dynamic custom asset id2 | ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique. |
dynamic_custom_asset_image_url | TEXT | Dynamic custom asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_custom_asset_ios_app_link | TEXT | Dynamic custom asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_custom_asset_ios_app_store_id | NUMERIC | Dynamic custom asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_custom_asset_item_address | TEXT | Dynamic custom asset item address | Item address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
dynamic_custom_asset_item_category | TEXT | Dynamic custom asset item category | Item category, for example, Sedans. |
dynamic_custom_asset_item_description | TEXT | Dynamic custom asset item description | Item description, for example, Best selling mid-size car. |
dynamic_custom_asset_item_subtitle | TEXT | Dynamic custom asset item subtitle | Item subtitle, for example, At your Mountain View dealership. |
dynamic_custom_asset_item_title | TEXT | Dynamic custom asset item title | Required. Item title, for example, Mid-size sedan. Required. |
dynamic_custom_asset_price | TEXT | Dynamic custom asset price | Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD. |
dynamic_custom_asset_sale_price | TEXT | Dynamic custom asset sale price | Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field. |
dynamic_custom_asset_similar_ids | TEXT | Dynamic custom asset similar ids | Similar IDs. |
dynamic_education_asset_address | TEXT | Dynamic education asset address | School address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
dynamic_education_asset_android_app_link | TEXT | Dynamic education asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_education_asset_contextual_keywords | TEXT | Dynamic education asset contextual keywords | Contextual keywords, for example, Nursing certification, Health, Mountain View. |
dynamic_education_asset_image_url | TEXT | Dynamic education asset image url | Image url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_education_asset_ios_app_link | TEXT | Dynamic education asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_education_asset_ios_app_store_id | NUMERIC | Dynamic education asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_education_asset_location_id | TEXT | Dynamic education asset location id | Location ID which can be any sequence of letters and digits and must be unique. |
dynamic_education_asset_program_description | TEXT | Dynamic education asset program description | Program description, for example, Nursing Certification. |
dynamic_education_asset_program_id | TEXT | Dynamic education asset program id | Required. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_education_asset_program_name | TEXT | Dynamic education asset program name | Required. Program name, for example, Nursing. Required. |
dynamic_education_asset_school_name | TEXT | Dynamic education asset school name | School name, for example, Mountain View School of Nursing. |
dynamic_education_asset_similar_program_ids | TEXT | Dynamic education asset similar program ids | Similar program IDs. |
dynamic_education_asset_subject | TEXT | Dynamic education asset subject | Subject of study, for example, Health. |
dynamic_education_asset_thumbnail_image_url | TEXT | Dynamic education asset thumbnail image url | Thumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset. |
dynamic_flights_asset_android_app_link | TEXT | Dynamic flights asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_flights_asset_custom_mapping | TEXT | Dynamic flights asset custom mapping | A custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32". |
dynamic_flights_asset_destination_id | TEXT | Dynamic flights asset destination id | Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_flights_asset_destination_name | TEXT | Dynamic flights asset destination name | Destination name, for example, Paris. |
dynamic_flights_asset_flight_description | TEXT | Dynamic flights asset flight description | Required. Flight description, for example, Book your ticket. Required. |
dynamic_flights_asset_flight_price | TEXT | Dynamic flights asset flight price | Flight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
dynamic_flights_asset_flight_sale_price | TEXT | Dynamic flights asset flight sale price | Flight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field. |
dynamic_flights_asset_formatted_price | TEXT | Dynamic flights asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
dynamic_flights_asset_formatted_sale_price | TEXT | Dynamic flights asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
dynamic_flights_asset_image_url | TEXT | Dynamic flights asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_flights_asset_ios_app_link | TEXT | Dynamic flights asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_flights_asset_ios_app_store_id | NUMERIC | Dynamic flights asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_flights_asset_origin_id | TEXT | Dynamic flights asset origin id | Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique. |
dynamic_flights_asset_origin_name | TEXT | Dynamic flights asset origin name | Origin name, for example, London. |
dynamic_flights_asset_similar_destination_ids | TEXT | Dynamic flights asset similar destination ids | Similar destination IDs, for example, PAR,LON. |
dynamic_hotels_and_rentals_asset_address | TEXT | Dynamic hotels and rentals asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
dynamic_hotels_and_rentals_asset_android_app_link | TEXT | Dynamic hotels and rentals asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_hotels_and_rentals_asset_category | TEXT | Dynamic hotels and rentals asset category | Category, for example, Hotel suite. |
dynamic_hotels_and_rentals_asset_contextual_keywords | TEXT | Dynamic hotels and rentals asset contextual keywords | Contextual keywords, for example, Mountain View "Hotels", South Bay hotels. |
dynamic_hotels_and_rentals_asset_description | TEXT | Dynamic hotels and rentals asset description | Description, for example, Close to SJC Airport. |
dynamic_hotels_and_rentals_asset_destination_name | TEXT | Dynamic hotels and rentals asset destination name | Destination name, for example, Downtown Mountain View. |
dynamic_hotels_and_rentals_asset_formatted_price | TEXT | Dynamic hotels and rentals asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
dynamic_hotels_and_rentals_asset_formatted_sale_price | TEXT | Dynamic hotels and rentals asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
dynamic_hotels_and_rentals_asset_image_url | TEXT | Dynamic hotels and rentals asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_hotels_and_rentals_asset_ios_app_link | TEXT | Dynamic hotels and rentals asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_hotels_and_rentals_asset_ios_app_store_id | NUMERIC | Dynamic hotels and rentals asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_hotels_and_rentals_asset_price | TEXT | Dynamic hotels and rentals asset price | Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
dynamic_hotels_and_rentals_asset_property_id | TEXT | Dynamic hotels and rentals asset property id | Required. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_hotels_and_rentals_asset_property_name | TEXT | Dynamic hotels and rentals asset property name | Required. Property name, for example, Mountain View Hotel. Required. |
dynamic_hotels_and_rentals_asset_sale_price | TEXT | Dynamic hotels and rentals asset sale price | ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field. |
dynamic_hotels_and_rentals_asset_similar_property_ids | TEXT | Dynamic hotels and rentals asset similar property ids | Similar property IDs. |
dynamic_hotels_and_rentals_asset_star_rating | NUMERIC | Dynamic hotels and rentals asset star rating | Star rating. Must be a number between 1 to 5, inclusive. |
dynamic_jobs_asset_address | TEXT | Dynamic jobs asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403. |
dynamic_jobs_asset_android_app_link | TEXT | Dynamic jobs asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_jobs_asset_contextual_keywords | TEXT | Dynamic jobs asset contextual keywords | Contextual keywords, for example, Software engineering job. |
dynamic_jobs_asset_description | TEXT | Dynamic jobs asset description | Description, for example, Apply your technical skills. |
dynamic_jobs_asset_image_url | TEXT | Dynamic jobs asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_jobs_asset_ios_app_link | TEXT | Dynamic jobs asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_jobs_asset_ios_app_store_id | NUMERIC | Dynamic jobs asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_jobs_asset_job_category | TEXT | Dynamic jobs asset job category | Job category, for example, Technical. |
dynamic_jobs_asset_job_id | TEXT | Dynamic jobs asset job id | Required. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_jobs_asset_job_subtitle | TEXT | Dynamic jobs asset job subtitle | Job subtitle, for example, Level II. |
dynamic_jobs_asset_job_title | TEXT | Dynamic jobs asset job title | Required. Job title, for example, Software engineer. Required. |
dynamic_jobs_asset_location_id | TEXT | Dynamic jobs asset location id | Location ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique. |
dynamic_jobs_asset_salary | TEXT | Dynamic jobs asset salary | Salary, for example, $100,000. |
dynamic_jobs_asset_similar_job_ids | TEXT | Dynamic jobs asset similar job ids | Similar job IDs, for example, 1275. |
dynamic_local_asset_address | TEXT | Dynamic local asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403. |
dynamic_local_asset_android_app_link | TEXT | Dynamic local asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_local_asset_category | TEXT | Dynamic local asset category | Category, for example, Food. |
dynamic_local_asset_contextual_keywords | TEXT | Dynamic local asset contextual keywords | Contextual keywords, for example, Save groceries coupons. |
dynamic_local_asset_deal_id | TEXT | Dynamic local asset deal id | Required. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_local_asset_deal_name | TEXT | Dynamic local asset deal name | Required. Deal name, for example, 50% off at Mountain View Grocers. Required. |
dynamic_local_asset_description | TEXT | Dynamic local asset description | Description, for example, Save on your weekly bill. |
dynamic_local_asset_formatted_price | TEXT | Dynamic local asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
dynamic_local_asset_formatted_sale_price | TEXT | Dynamic local asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
dynamic_local_asset_image_url | TEXT | Dynamic local asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_local_asset_ios_app_link | TEXT | Dynamic local asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_local_asset_ios_app_store_id | NUMERIC | Dynamic local asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_local_asset_price | TEXT | Dynamic local asset price | Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
dynamic_local_asset_sale_price | TEXT | Dynamic local asset sale price | Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field. |
dynamic_local_asset_similar_deal_ids | TEXT | Dynamic local asset similar deal ids | Similar deal IDs, for example, 1275. |
dynamic_local_asset_subtitle | TEXT | Dynamic local asset subtitle | Subtitle, for example, Groceries. |
dynamic_real_estate_asset_address | TEXT | Dynamic real estate asset address | Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403 |
dynamic_real_estate_asset_android_app_link | TEXT | Dynamic real estate asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_real_estate_asset_city_name | CITY | Dynamic real estate asset city name | City name, for example, Mountain View, California. |
dynamic_real_estate_asset_contextual_keywords | TEXT | Dynamic real estate asset contextual keywords | Contextual keywords, for example, For sale; Houses for sale. |
dynamic_real_estate_asset_description | TEXT | Dynamic real estate asset description | Description, for example, 3 beds, 2 baths, 1568 sq. ft. |
dynamic_real_estate_asset_formatted_price | TEXT | Dynamic real estate asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00. |
dynamic_real_estate_asset_image_url | TEXT | Dynamic real estate asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_real_estate_asset_ios_app_link | TEXT | Dynamic real estate asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_real_estate_asset_ios_app_store_id | NUMERIC | Dynamic real estate asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_real_estate_asset_listing_id | TEXT | Dynamic real estate asset listing id | Required. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_real_estate_asset_listing_name | TEXT | Dynamic real estate asset listing name | Required. Listing name, for example, Boulevard Bungalow. Required. |
dynamic_real_estate_asset_listing_type | TEXT | Dynamic real estate asset listing type | Listing type, for example, For sale. |
dynamic_real_estate_asset_price | TEXT | Dynamic real estate asset price | Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD. |
dynamic_real_estate_asset_property_type | TEXT | Dynamic real estate asset property type | Property type, for example, House. |
dynamic_real_estate_asset_similar_listing_ids | TEXT | Dynamic real estate asset similar listing ids | Similar listing IDs. |
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. |
dynamic_travel_asset_android_app_link | TEXT | Dynamic travel asset android app link | Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234. |
dynamic_travel_asset_category | TEXT | Dynamic travel asset category | Category, for example, Express. |
dynamic_travel_asset_contextual_keywords | TEXT | Dynamic travel asset contextual keywords | Contextual keywords, for example, Paris trains. |
dynamic_travel_asset_destination_address | TEXT | Dynamic travel asset destination address | Destination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403. |
dynamic_travel_asset_destination_id | TEXT | Dynamic travel asset destination id | Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required. |
dynamic_travel_asset_destination_name | TEXT | Dynamic travel asset destination name | Destination name, for example, Paris. |
dynamic_travel_asset_formatted_price | TEXT | Dynamic travel asset formatted price | Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00. |
dynamic_travel_asset_formatted_sale_price | TEXT | Dynamic travel asset formatted sale price | Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00. |
dynamic_travel_asset_image_url | TEXT | Dynamic travel asset image url | Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset. |
dynamic_travel_asset_ios_app_link | TEXT | Dynamic travel asset ios app link | iOS deep link, for example, exampleApp://content/page. |
dynamic_travel_asset_ios_app_store_id | NUMERIC | Dynamic travel asset ios app store id | iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present. |
dynamic_travel_asset_origin_id | TEXT | Dynamic travel asset origin id | Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique. |
dynamic_travel_asset_origin_name | TEXT | Dynamic travel asset origin name | Origin name, for example, London. |
dynamic_travel_asset_price | TEXT | Dynamic travel asset price | Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD. |
dynamic_travel_asset_sale_price | TEXT | Dynamic travel asset sale price | Sale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field. |
dynamic_travel_asset_similar_destination_ids | TEXT | Dynamic travel asset similar destination ids | Similar destination IDs, for example, NYC. |
dynamic_travel_asset_title | TEXT | Dynamic travel asset title | Required. Title, for example, Book your train ticket. Required. |
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. |
eligible_impressions_from_location_asset_store_reach | NUMERIC | Eligible impressions from location asset store reach | Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location. |
enabled | BOOLEAN | Enabled | The status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad. |
end_date | DATE | End date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30. |
engagement_rate | PERCENT | 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. |
excluded_parent_asset_set_types | TEXT | Excluded parent asset set types | The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported. |
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. |
external_activity_id | TEXT | External activity id | Advertiser supplied activity ID. |
external_conversion_source | TEXT | External conversion source | External conversion source. |
external_customer_id | NUMERIC | External customer id | The ID of the customer. |
field_type | TEXT | Field type | Role that the asset takes in the ad. |
field_type_policy_summaries | TEXT | Field type policy summaries | Policy information for the asset for each FieldType. |
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. |
fixed_cpm_goal | TEXT | Fixed cpm goal | Fixed CPM bidding goal. Determines the exact bidding optimization parameters. |
fixed_cpm_micros | NUMERIC | Fixed cpm micros | The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. |
fixed_cpm_target_frequency_info_target_count | NUMERIC | Fixed cpm target frequency info target count | Target frequency count represents the number of times an advertiser wants to show the ad to target a single user. |
fixed_cpm_target_frequency_info_time_unit | TEXT | Fixed cpm target frequency info time unit | Time window expressing the period over which you want to reach the specified target_count. |
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 | CITY | Geo target city (Alias) | Resource name of the geo target constant that represents a city. |
geo_target_country | COUNTRY | Geo target country (Geographic View) | The country of the user's actual physical location or an area of interest (Geographic View). |
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 | REGION | 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 | COUNTRY | 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. |
gross_profit_margin | NUMERIC | Gross profit margin | Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. |
gross_profit_micros | NUMERIC | Gross profit micros | Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
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. |
group_placement_view_display_name | TEXT | Group placement view display name | Domain name for websites and YouTube channel name for YouTube channels. |
group_placement_view_placement | TEXT | Group placement view placement | The automatic placement string at group level, e. g. web domain, mobile app ID, or a YouTube channel ID. |
group_placement_view_placement_type | TEXT | Group placement view placement type | Type of the placement, for example, Website, YouTube Channel, Mobile Application. |
group_placement_view_resource_name | TEXT | Group placement view resource name | The resource name of the group placement view. Group placement view resource names have the form: customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement} |
group_placement_view_target_url | TEXT | Group placement view 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_callout_asset_language_code | TEXT | Hotel callout asset language code | Required. The language of the hotel callout. Represented as BCP 47 language tag. |
hotel_callout_asset_text | TEXT | Hotel callout asset text | Required. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive. |
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 | CITY | Hotel city | Hotel city. |
hotel_class | NUMERIC | Hotel class | Hotel class. |
hotel_country | COUNTRY | 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 | PERCENT | 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_property_asset_hotel_address | TEXT | Hotel property asset hotel address | Address of the hotel. Read-only. |
hotel_property_asset_hotel_name | TEXT | Hotel property asset hotel name | Name of the hotel. Read-only. |
hotel_property_asset_place_id | TEXT | Hotel property asset place id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more. |
hotel_property_asset_set | TEXT | Hotel property asset set | The set of hotel properties for Performance Max for travel goals campaigns. |
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. |
image_asset_auto_migration_done | BOOLEAN | Image asset auto migration done | True if feed based image has been migrated to asset based image. |
image_asset_auto_migration_done_date_time | DATE | Image asset auto migration done date time | Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format. |
image_asset_file_size | NUMERIC | Image asset file size | File size of the image asset in bytes. |
image_asset_full_size_height_pixels | NUMERIC | Image asset full size height pixels | Height of the image. |
image_asset_full_size_url | TEXT | Image asset full size url | A URL that returns the image with this height and width. |
image_asset_full_size_width_pixels | NUMERIC | Image asset full size width pixels | Width of the image. |
image_asset_mime_type | TEXT | Image asset mime type | MIME type of the image asset. |
image_url | IMAGE_URL | Ad Image URL | Image URL from Multi asset ad or Responsive Display Ad, first non-null match. |
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 | PERCENT | 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 | PERCENT | 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 | Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign. |
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 HEX 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. |
lead_cost_of_goods_sold_micros | NUMERIC | Lead cost of goods sold micros | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. |
lead_form_asset_background_image_asset | TEXT | Lead form asset background image asset | Asset resource name of the background image. The image dimensions must be exactly 1200x628. |
lead_form_asset_business_name | TEXT | Lead form asset business name | Required. The name of the business being advertised. |
lead_form_asset_call_to_action_description | TEXT | Lead form asset call to action description | Required. Text giving a clear value proposition of what users expect once they expand the form. |
lead_form_asset_call_to_action_type | TEXT | Lead form asset call to action type | Required. Pre-defined display text that encourages user to expand the form. |
lead_form_asset_custom_disclosure | TEXT | Lead form asset custom disclosure | Custom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only. |
lead_form_asset_custom_question_fields | TEXT | Lead form asset custom question fields | Ordered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form. |
lead_form_asset_delivery_methods | TEXT | Lead form asset delivery methods | Configured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured. |
lead_form_asset_description | TEXT | Lead form asset description | Required. Detailed description of the expanded form to describe what the form is asking for or facilitating. |
lead_form_asset_desired_intent | TEXT | Lead form asset desired intent | Chosen intent for the lead form, for example, more volume or more qualified. |
lead_form_asset_fields | TEXT | Lead form asset fields | Ordered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions. |
lead_form_asset_headline | TEXT | Lead form asset headline | Required. Headline of the expanded form to describe what the form is asking for or facilitating. |
lead_form_asset_post_submit_call_to_action_type | TEXT | Lead form asset post submit call to action type | Pre-defined display text that encourages user action after the form is submitted. |
lead_form_asset_post_submit_description | TEXT | Lead form asset post submit description | Detailed description shown after form submission that describes how the advertiser will follow up with the user. |
lead_form_asset_post_submit_headline | TEXT | Lead form asset post submit headline | Headline of text shown after form submission that describes how the advertiser will follow up with the user. |
lead_form_asset_privacy_policy_url | TEXT | Lead form asset privacy policy url | Required. Link to a page describing the policy on how the collected data is handled by the advertiser/business. |
lead_gross_profit_micros | NUMERIC | Lead gross profit micros | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. |
lead_revenue_micros | NUMERIC | Lead revenue micros | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. |
lead_units_sold | NUMERIC | Lead units sold | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
listing_group_case_value_activity_city_value | TEXT | Listing group case value activity city value | String value of the activity city. The Geo Target Constant resource name. |
listing_group_case_value_activity_country_value | COUNTRY | Listing group case value activity country value | String value of the activity country. The Geo Target Constant resource name. |
listing_group_case_value_activity_id_value | TEXT | Listing group case value activity id value | String value of the activity ID. |
listing_group_case_value_activity_rating_value | NUMERIC | Listing group case value activity rating value | Long value of the activity rating. |
listing_group_case_value_activity_state_value | TEXT | Listing group case value activity state value | String value of the activity state. The Geo Target Constant resource name. |
listing_group_case_value_hotel_city_city_criterion | CITY | 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 | REGION | 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_brand_value | TEXT | Listing group case value product brand value | String value of the product brand. |
listing_group_case_value_product_category_category_id | NUMERIC | Listing group case value product category category id | ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 |
listing_group_case_value_product_category_level | TEXT | Listing group case value product category level | Level of the product category. |
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_path | TEXT | Listing group path | The path of dimensions defining this listing 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_activity_city_value | TEXT | Listing scope dimensions activity city value | String value of the activity city. The Geo Target Constant resource name. |
listing_scope_dimensions_activity_country_value | COUNTRY | Listing scope dimensions activity country value | String value of the activity country. The Geo Target Constant resource name. |
listing_scope_dimensions_activity_state_value | TEXT | Listing scope dimensions activity state value | String value of the activity state. The Geo Target Constant resource name. |
listing_scope_dimensions_hotel_city_city_criterion | CITY | Listing scope dimensions hotel city city criterion | The Geo Target Constant resource name. |
listing_scope_dimensions_hotel_country_region_country_region_criterion | REGION | 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. |
listing_type | TEXT | Listing type | Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns. |
local_campaign_setting_location_source_type | TEXT | Local campaign setting location source type | The location source type for this local campaign. |
local_service_id_service_id | TEXT | Local service id service id | The criterion resource name. |
local_services_campaign_settings_category_bids | TEXT | Local services campaign settings category bids | Categorical level bids associated with MANUAL_CPA bidding strategy. |
local_services_settings_granular_insurance_statuses | TEXT | Local services settings granular insurance statuses | A read-only list of geo vertical level insurance statuses. |
local_services_settings_granular_license_statuses | TEXT | Local services settings granular license statuses | A read-only list of geo vertical level license statuses. |
location_asset_auto_migration_done | BOOLEAN | Location asset auto migration done | True if feed based location has been migrated to asset based location. |
location_asset_auto_migration_done_date_time | DATE | Location asset auto migration done date time | Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format. |
location_asset_business_profile_locations | TEXT | Location asset business profile locations | The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID. |
location_asset_location_ownership_type | TEXT | Location asset location ownership type | The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location. |
location_asset_place_id | TEXT | Location asset place id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID. |
location_geo_target_constant | TEXT | Location geo target constant | The geo target constant resource name. |
location_group | TEXT | Location group | Location Group |
location_group_enable_customer_level_location_asset_set | BOOLEAN | Location group enable customer level location asset set | Denotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations. |
location_group_feed | TEXT | Location group feed | Feed specifying locations for targeting. Cannot be set with AssetSet fields. 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. Cannot be set with AssetSet fields. |
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. |
lookalike_user_list_country_codes | TEXT | Lookalike user list country codes | Countries targeted by the Lookalike. Two-letter country code as defined by ISO-3166 |
lookalike_user_list_expansion_level | TEXT | Lookalike user list expansion level | Expansion level, reflecting the size of the lookalike audience |
lookalike_user_list_seed_user_list_ids | NUMERIC | Lookalike user list seed user list ids | Seed UserList ID from which this list is derived, provided by user. |
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 acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. |
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. This field is ignored for logical_user_list and rule_based_user_list types. Membership to lists of these types depends on the rules defined by the lists. |
membership_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 | PERCENT | 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_asset_app_id | TEXT | Mobile app asset app id | Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS. |
mobile_app_asset_app_store | TEXT | Mobile app asset app store | Required. The application store that distributes this specific app. |
mobile_app_asset_end_date | DATE | Mobile app asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
mobile_app_asset_link_text | TEXT | Mobile app asset link text | Required. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive. |
mobile_app_asset_start_date | DATE | Mobile app asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
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 | PERCENT | Mobile friendly clicks percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
month | TEXT | Month | Number of the month |
month_first_day | DATE | Month first day | 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_google_tv_network | BOOLEAN | Network settings target google tv network | Whether ads will be served on the Google TV network. |
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). |
network_settings_target_youtube | BOOLEAN | Network settings target youtube | Whether ads will be served on YouTube. |
new_customer_lifetime_value | NUMERIC | New customer lifetime value | New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversions_value" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. |
new_versus_returning_customers | TEXT | New versus returning customers | This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. |
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 | PERCENT | 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. |
optimized_targeting_enabled | BOOLEAN | Optimized targeting enabled | True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. |
orders | NUMERIC | Orders | Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. |
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. |
page_feed_asset_labels | TEXT | Page feed asset labels | Labels used to group the page urls. |
page_feed_asset_page_url | TEXT | Page feed asset page url | Required. The webpage that advertisers want to target. |
parental_status_type | TEXT | Parental status type | Type of the parental status. |
partner_hotel_id | TEXT | Partner hotel id | Partner hotel ID. |
path1 | TEXT | Path1 | First part of text that may appear appended to the url displayed in the ad. |
path2 | TEXT | Path2 | Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set. |
pay_per_conversion_eligibility_failure_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_label | TEXT | Performance label | Performance of an asset linkage. |
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 | PERCENT | Phone through rate | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
pinned_field | TEXT | Pinned field | Pinned field. |
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 | TEXT | Policy summary | Policy information for the ad group ad asset. |
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. |
price_asset_language_code | TEXT | Price asset language code | Required. The language of the price asset. Represented as BCP 47 language tag. |
price_asset_price_offerings | TEXT | Price asset price offerings | The price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive. |
price_asset_price_qualifier | TEXT | Price asset price qualifier | The price qualifier of the price asset. |
price_asset_type | TEXT | Price asset type | Required. The type of the price asset. |
primary_status | TEXT | Primary status | The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status. |
primary_status_reasons | TEXT | Primary status reasons | The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus. |
product_aggregator_id | NUMERIC | Product aggregator id | Aggregator ID of the product. |
product_brand | TEXT | Product brand | Brand of the product. |
product_category_level1 | TEXT | Product category level1 | Category (level 1) of the product. |
product_category_level2 | TEXT | Product category level2 | Category (level 2) of the product. |
product_category_level3 | TEXT | Product category level3 | Category (level 3) of the product. |
product_category_level4 | TEXT | Product category level4 | Category (level 4) of the product. |
product_category_level5 | TEXT | Product category level5 | Category (level 5) 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 | COUNTRY | 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_feed_label | TEXT | Product feed label | Feed label 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. |
promotion_asset_ad_schedule_targets | TEXT | Promotion asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
promotion_asset_discount_modifier | TEXT | Promotion asset discount modifier | A modifier for qualification of the discount. |
promotion_asset_end_date | DATE | Promotion asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
promotion_asset_language_code | TEXT | Promotion asset language code | The language of the promotion. Represented as BCP 47 language tag. |
promotion_asset_money_amount_off_amount_micros | NUMERIC | Promotion asset money amount off amount micros | Amount in micros. One million is equivalent to one unit. |
promotion_asset_money_amount_off_currency_code | TEXT | Promotion asset money amount off currency code | Three-character ISO 4217 currency code. |
promotion_asset_occasion | TEXT | Promotion asset occasion | The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion. |
promotion_asset_orders_over_amount_amount_micros | NUMERIC | Promotion asset orders over amount amount micros | Amount in micros. One million is equivalent to one unit. |
promotion_asset_orders_over_amount_currency_code | TEXT | Promotion asset orders over amount currency code | Three-character ISO 4217 currency code. |
promotion_asset_percent_off | NUMERIC | Promotion asset percent off | Percentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required. |
promotion_asset_promotion_code | TEXT | Promotion asset promotion code | A code the user should use in order to be eligible for the promotion. |
promotion_asset_promotion_target | TEXT | Promotion asset promotion target | Required. A freeform description of what the promotion is targeting. |
promotion_asset_redemption_end_date | DATE | Promotion asset redemption end date | Last date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format. |
promotion_asset_redemption_start_date | DATE | Promotion asset redemption start date | Start date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format. |
promotion_asset_start_date | DATE | Promotion asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
proximity_address_city_name | CITY | Proximity address city name | Name of the city. |
proximity_address_country_code | COUNTRY | 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. |
publisher_organic_clicks | NUMERIC | Publisher organic clicks | Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity |
publisher_purchased_clicks | NUMERIC | Publisher purchased clicks | Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity |
publisher_unknown_clicks | NUMERIC | Publisher unknown clicks | Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" |
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 | REGION | 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} |
revenue_micros | NUMERIC | Revenue micros | Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. |
roas | PERCENT | ROAS | Return on Spend |
rule_based_user_list_flexible_rule_user_list_exclusive_operands | TEXT | Rule based user list flexible rule user list exclusive operands | Rules representing users that should be excluded from the user list. These are located on the right side of the AND_NOT operator, and joined together by OR. |
rule_based_user_list_flexible_rule_user_list_inclusive_operands | TEXT | Rule based user list flexible rule user list inclusive operands | Rules representing users that should be included in the user list. These are located on the left side of the AND_NOT operator, and joined together by either AND/OR as specified by the inclusive_rule_operator. |
rule_based_user_list_flexible_rule_user_list_inclusive_rule_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. |
scope | TEXT | Scope | Defines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP. |
search_absolute_top_impression_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 among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_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 adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_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_eligible_clicks | NUMERIC | Eligible Clicks on Search Network | Estimated number of clicks you are eligible to receive on the Search Network, calculated based on the reported value of Search Click Share metric. |
search_eligible_impressions | NUMERIC | Eligible Impressions on Search Network | Estimated number of impressions you are eligible to receive on the Search Network, calculated based on the reported value of Search Impression Share metric. |
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 among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_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 adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_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 among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
selective_optimization_conversion_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_advertising_partner_ids | NUMERIC | Shopping setting advertising partner ids | The ads account IDs of advertising partners cooperating within the campaign. |
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_disable_product_feed | BOOLEAN | Shopping setting disable product feed | Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature. |
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_use_vehicle_inventory | BOOLEAN | Shopping setting use vehicle inventory | Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns. For setting Vehicle Listing inventory in Performance Max campaigns, use listing_type instead. |
similar_user_list_seed_user_list | TEXT | Similar user list seed user list | Seed UserList from which this list is derived. |
sitelink_asset_ad_schedule_targets | TEXT | Sitelink asset ad schedule targets | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
sitelink_asset_description1 | TEXT | Sitelink asset description1 | First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set. |
sitelink_asset_description2 | TEXT | Sitelink asset description2 | Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set. |
sitelink_asset_end_date | DATE | Sitelink asset end date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
sitelink_asset_link_text | TEXT | Sitelink asset link text | Required. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. |
sitelink_asset_start_date | DATE | Sitelink asset start date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
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_coarse_conversion_value | TEXT | Sk ad network coarse conversion value | iOS Store Kit Ad Network coarse conversion value. |
sk_ad_network_fine_conversion_value | NUMERIC | Sk ad network fine 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_installs | NUMERIC | Sk ad network installs | The number of iOS Store Kit Ad Network conversions. |
sk_ad_network_postback_sequence_index | NUMERIC | Sk ad network postback sequence index | iOS Store Kit Ad Network postback sequence index. |
sk_ad_network_redistributed_fine_conversion_value | NUMERIC | Sk ad network redistributed fine conversion value | iOS Store Kit Ad Network redistributed fine conversion value. Google uses modeling on observed conversion values(obtained from Apple) to calculate conversions from SKAN postbacks where NULLs are returned. This column represents the sum of the modeled conversion values and the observed conversion values. See https://support.google.com/google-ads/answer/14892597 to lean more. |
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_source_domain | TEXT | Sk ad network source domain | Website where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. |
sk_ad_network_source_type | TEXT | Sk ad network source type | The source type where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or neither source domain nor source app were present in any postbacks sent by Apple. |
sk_ad_network_total_conversions | NUMERIC | Sk ad network total conversions | The total number of iOS Store Kit Ad Network conversions. |
sk_ad_network_user_type | TEXT | Sk ad network user type | iOS Store Kit Ad Network user type. |
sk_ad_network_version | TEXT | Sk ad network version | The version of the SKAdNetwork API used. |
slot | TEXT | Slot | Position of the ad. |
source | TEXT | Source | The text "google" |
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. |
structured_snippet_asset_header | TEXT | Structured snippet asset header | Required. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers |
structured_snippet_asset_values | TEXT | Structured snippet asset values | Required. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive. |
system_serving_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_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_cpm_target_frequency_goal_target_count | NUMERIC | Target cpm target frequency goal target count | Target Frequency count representing how many times you want to reach a single user. |
target_cpm_target_frequency_goal_time_unit | TEXT | Target cpm target frequency goal time unit | Time window expressing the period over which you want to reach the specified target_count. |
target_cpv | TEXT | Target cpv | An automated bidding strategy that sets bids to optimize performance given the target CPV you set. |
target_cpv_micros | NUMERIC | Target cpv micros | Average amount in micros that the advertiser is willing to pay for every ad view. |
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 | The chosen revenue (based on conversion data) per unit of spend. |
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_location | BOOLEAN | Targeting location | Indicates whether location was targeted or not. |
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_asset_text | TEXT | Text asset text | Text content of the text asset. |
text_label_background_color | TEXT | Text label background color | Background color of the label in HEX 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. |
title | TEXT | Title | The title of the video. |
today | DATE | Today | Today's date |
top_impression_percentage | PERCENT | Top impression percentage | The percent of your ad impressions that are shown adjacent to the top 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. |
travel_campaign_settings_travel_account_id | NUMERIC | Travel campaign settings travel account id | The Travel account ID associated with the Travel campaign. |
type | TEXT | Type | The type of the ad group. |
unique_users | NUMERIC | Unique users | The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. |
units_sold | NUMERIC | Units sold | Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. |
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_lookalike_user_list_country_codes | TEXT | User list lookalike user list country codes | Countries targeted by the Lookalike. Two-letter country code as defined by ISO-3166 |
user_list_lookalike_user_list_expansion_level | TEXT | User list lookalike user list expansion level | Expansion level, reflecting the size of the lookalike audience |
user_list_lookalike_user_list_seed_user_list_ids | NUMERIC | User list lookalike user list seed user list ids | Seed UserList ID from which this list is derived, provided by user. |
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. This field is ignored for logical_user_list and rule_based_user_list types. Membership to lists of these types depends on the rules defined by the lists. |
user_list_membership_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_flexible_rule_user_list_exclusive_operands | TEXT | User list rule based user list flexible rule user list exclusive operands | Rules representing users that should be excluded from the user list. These are located on the right side of the AND_NOT operator, and joined together by OR. |
user_list_rule_based_user_list_flexible_rule_user_list_inclusive_operands | TEXT | User list rule based user list flexible rule user list inclusive operands | Rules representing users that should be included in the user list. These are located on the left side of the AND_NOT operator, and joined together by either AND/OR as specified by the inclusive_rule_operator. |
user_list_rule_based_user_list_flexible_rule_user_list_inclusive_rule_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. |
user_location_view_country_criterion_id | COUNTRY | User location view country criterion id | Criterion Id for the country. |
user_location_view_geo_target_country | COUNTRY | Geo target country (User Location View) | The country of the user's actual physical location by targeted or not targeted location (User Location View). |
user_location_view_targeting_location | BOOLEAN | User location view targeting location | Indicates whether location was targeted or not. |
valid_accelerated_mobile_pages_clicks_percentage | PERCENT | 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 | Brand Safety setting at the individual campaign level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513. |
video_campaign_settings_video_ad_inventory_control_allow_in_feed | BOOLEAN | Video campaign settings video ad inventory control allow in feed | Determine if VideoResponsiveAds can be used for in-feed video ads. |
video_campaign_settings_video_ad_inventory_control_allow_in_stream | BOOLEAN | Video campaign settings video ad inventory control allow in stream | Determine if VideoResponsiveAds can be used for in-stream video ads. |
video_campaign_settings_video_ad_inventory_control_allow_shorts | BOOLEAN | Video campaign settings video ad inventory control allow shorts | Determine if VideoResponsiveAds can be used as shorts format. |
video_channel_id | TEXT | Video channel id | The owner channel id of the video. |
video_channel_name | TEXT | Video channel name | Video channel name |
video_duration | NUMERIC | Video duration | The duration of the video in milliseconds. |
video_id | TEXT | Video id | The ID of the video. |
video_quartile100_rate | PERCENT | Video quartile100 rate | Percentage of impressions where the viewer watched all of your video. |
video_quartile25_rate | PERCENT | Video quartile25 rate | Percentage of impressions where the viewer watched 25% of your video. |
video_quartile50_rate | PERCENT | Video quartile50 rate | Percentage of impressions where the viewer watched 50% of your video. |
video_quartile75_rate | PERCENT | Video quartile75 rate | Percentage of impressions where the viewer watched 75% of your video. |
video_quartile_p100_rate | PERCENT | Video quartile p100 rate | Percentage of impressions where the viewer watched all of your video. |
video_quartile_p25_rate | PERCENT | Video quartile p25 rate | Percentage of impressions where the viewer watched 25% of your video. |
video_quartile_p50_rate | PERCENT | Video quartile p50 rate | Percentage of impressions where the viewer watched 50% of your video. |
video_quartile_p75_rate | PERCENT | Video quartile p75 rate | Percentage of impressions where the viewer watched 75% of your video. |
video_resource_name | TEXT | Video resource name | The resource name of the video. Video resource names have the form: customers/{customer_id}/videos/{video_id} |
video_title | TEXT | Video title | The title of the video. |
video_view_rate | PERCENT | 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. |
view_through_conversions_from_location_asset_click_to_call | NUMERIC | View through conversions from location asset click to call | Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location. |
view_through_conversions_from_location_asset_directions | NUMERIC | View through conversions from location asset directions | Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location. |
view_through_conversions_from_location_asset_menu | NUMERIC | View through conversions from location asset menu | Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location. |
view_through_conversions_from_location_asset_order | NUMERIC | View through conversions from location asset order | Number of order clicks on any location surface after an impression. This measure is coming from Asset based location. |
view_through_conversions_from_location_asset_other_engagement | NUMERIC | View through conversions from location asset other engagement | Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location. |
view_through_conversions_from_location_asset_store_visits | NUMERIC | View through conversions from location asset store visits | Estimated number of visits to the store after an impression. This measure is coming from Asset based location. |
view_through_conversions_from_location_asset_website | NUMERIC | View through conversions from location asset website | Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. |
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 | PERCENT | 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. |
week_day | TEXT | Day of week and day number | Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday. |
week_day_iso | TEXT | Day of week and day number, ISO | Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7 |
week_iso | TEXT | Week ISO | Week, ISO format (Mon-Sun). |
year | TEXT | Year | Year, formatted as yyyy. |
year_month | TEXT | Yearmonth | Year and month, e.g. 2024|3 |
year_of_week | TEXT | Year of week | The year that contains first day of the week (Sun-Sat). |
year_of_week_iso | TEXT | Year of week, ISO | The year that contains first day of the ISO week (Mon-Sun). |
year_week | TEXT | Year week | Year and week for US weeks (Sun-Sat), e.g. 2024|15 |
year_week_iso | TEXT | Year week ISO | Year and week for ISO weeks (Mon-Sun), e.g. 2024|20 |
youtube_channel_channel_id | TEXT | Youtube channel channel id | The YouTube uploader channel id or the channel code of a YouTube channel. |
youtube_video_asset_youtube_video_id | TEXT | Youtube video asset youtube video id | YouTube video id. This is the 11 character string value used in the YouTube video URL. |
youtube_video_asset_youtube_video_title | TEXT | Youtube video asset youtube video title | YouTube video title. |
youtube_video_video_id | TEXT | Youtube video video id | YouTube video id as it appears on the YouTube watch page. |