Connect Google Ads to Looker Studio
Directly connect Google Ads to Looker Studio,in minutes, and in an easy-to-use format.

Analyze Your Marketing Metrics from Google Ads in GDS
About Google Ads
About Looker Studio
Why integrate Google Ads with Looker Studio?
- Looker Studio Studio is compatible with a wide range of data sources, including Google Ads and others. By connecting Google Ads with other data sources, you can track the performance of your marketing campaigns across different channels which enables you to compare Google Ads performance with others such as social media and email marketing, and make data-driven decisions about where to allocate your marketing budget.
- Using Looker Studio Studio, you can create customized reports that show the most important metrics of your business and schedule the reports to be sent to stakeholders on a regular basis.
- Looker Studio provides a variety of chart options to create visually appealing, interactive, and easy-to-understand dashboards and reports with Google Ads data. You can identify patterns and trends in your Google Ads data to optimize your campaigns and improve your ROI.
- Integrating Google Ads with Looker Studio enables you to automatically pull data from your Google Ads account without having to manually export and import it which can save you a significant amount of time, especially if you need to update your reports on a regular basis.
About the Google Ads Looker Studio Connector
The Google Ads Looker Studio Connector pulls metrics and dimensions for Snapchat Ads. The Insights are retrieved at the campaign and ad levels.
Once the user successfully logs into the connector he can then choose the metrics and dimensions he is interested to create a report on.
Prerequisites
To set up the connector, the user should have:
- A Google Ads advertiser account (Visit our privacy policy and terms of use)
- Google account for Google Ads to Looker Studio integration.
- A Windsor account. Start your free trial now.
How to connect Google Ads to Looker Studio?
Do you plan to connect and visualize your Google Ads in Looker Studio? Follow the Tutorial Below:
Select the fields on the right to later use in your data source. For example, you can include metrics such as Cost per Click, Cost per Action or Total Spend. Go to “Select Destination” and choose Looker Studio. Once done, select “connect” and authorize access to your data source.
Looker Studio Templates for Google Ads
These free and customizable Looker Studio Google Ads templates will assist you in visualizing your data for easy reporting and analysis.
Google Ads metrics & dimensions available for streaming into Looker Studio
name type description Absolute top impression percentage NUMERIC The percent of your ad impressions that are shown as the very first ad above the organic search results. Access reason TEXT 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 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 The ID of the bidding strategy. Accessible bidding strategy maximize conversion value target roas NUMERIC 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 The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. Accessible bidding strategy name TEXT The name of the bidding strategy. Accessible bidding strategy owner customer id NUMERIC The ID of the Customer which owns the bidding strategy. Accessible bidding strategy owner descriptive name TEXT descriptive_name of the Customer which owns the bidding strategy. Accessible bidding strategy resource name TEXT 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 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 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 The targeted location on the search results page. Accessible bidding strategy target impression share location fraction micros NUMERIC 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 The chosen revenue (based on conversion data) per unit of spend. Accessible bidding strategy target spend cpc bid ceiling micros NUMERIC 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 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 The type of the bidding strategy. Account currency code TEXT The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. Account descriptive name TEXT Optional, non-unique descriptive name of the customer. Account ID TEXT The Google Ads account ID. Account Name TEXT Optional, non-unique descriptive name of the customer. Account time zone TEXT The local timezone ID of the customer. Account user list status TEXT 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 A list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.". Active view cpm NUMERIC Average cost of viewable impressions (active_view_impressions). Active view ctr NUMERIC Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network. Active view impressions NUMERIC A measurement of how often your ad has become viewable on a Display Network site. Active view measurability NUMERIC The ratio of impressions that could be measured by Active View over the number of served impressions. Active view measurable cost NUMERIC The cost of the impressions you received that were measurable by Active View. Active view measurable cost micros NUMERIC The cost of the impressions you received that were measurable by Active View. Active view measurable impressions NUMERIC The number of times your ads are appearing on placements in positions where they can be seen. Active view viewability NUMERIC 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 rating NUMERIC Activity rating. Ad added by google ads BOOLEAN 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 List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. Ad app ad headlines TEXT 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 List of media bundle assets that may be used with the ad. Ad app ad html5 media bundles asset TEXT The Asset resource name of this media bundle. Ad app ad images TEXT List of image assets that may be displayed with the ad. Ad app ad images asset TEXT The Asset resource name of this image. Ad app ad mandatory ad text TEXT Mandatory ad text. Ad app ad youtube videos TEXT List of YouTube video assets that may be displayed with the ad. Ad app ad youtube videos asset TEXT The Asset resource name of this video. Ad app engagement ad descriptions TEXT List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. Ad app engagement ad headlines TEXT List of text assets for headlines. When the ad serves the headlines will be selected from this list. Ad app engagement ad images TEXT List of image assets that may be displayed with the ad. Ad app engagement ad images asset TEXT The Asset resource name of this image. Ad app engagement ad videos TEXT List of video assets that may be displayed with the ad. Ad app engagement ad videos asset TEXT The Asset resource name of this video. Ad app pre registration ad descriptions TEXT 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 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 List of image asset IDs whose images may be displayed with the ad. Ad app pre registration ad images asset TEXT The Asset resource name of this image. Ad app pre registration ad youtube videos TEXT List of YouTube video asset IDs whose videos may be displayed with the ad. Ad app pre registration ad youtube videos asset TEXT The Asset resource name of this video. Ad call ad business name TEXT The business name in the ad. Ad call ad call tracked BOOLEAN Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. Ad call ad conversion action TEXT 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 The call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled. Ad call ad country code TEXT The country code in the ad. Ad call ad description1 TEXT The first line of the ad's description. Ad call ad description2 TEXT The second line of the ad's description. Ad call ad disable call conversion BOOLEAN 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 First headline in the ad. Ad call ad headline2 TEXT Second headline in the ad. Ad call ad path1 TEXT First part of text that can be appended to the URL in the ad. Optional. Ad call ad path2 TEXT 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 The phone number in the ad. Ad call ad phone number verification url TEXT The URL to be used for phone number verification. Ad destination type TEXT Ad Destination type. Ad device preference TEXT The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. Ad discovery carousel ad business name TEXT Required. The Advertiser/brand name. Ad discovery carousel ad call to action text TEXT Call to action text. Ad discovery carousel ad carousel cards TEXT Required. Carousel cards that will display with the ad. Min 2 max 10. Ad discovery carousel ad carousel cards asset TEXT The Asset resource name of this discovery carousel card. Ad discovery carousel ad description TEXT Required. The descriptive text of the ad. Ad discovery carousel ad headline TEXT Required. Headline of the ad. Ad discovery carousel ad logo image TEXT Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). Ad discovery carousel ad logo image asset TEXT The Asset resource name of this image. Ad discovery multi asset ad business name TEXT The Advertiser/brand name. Maximum display width is 25. Required. Ad discovery multi asset ad call to action text TEXT Call to action text. Ad discovery multi asset ad descriptions TEXT The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. Ad discovery multi asset ad headlines TEXT Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. Ad discovery multi asset ad lead form only BOOLEAN Boolean option that indicates if this ad must be served with lead form. Ad discovery multi asset ad logo images TEXT Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). At least 1 and max 5 logo images can be specified. Ad discovery multi asset ad logo images asset TEXT The Asset resource name of this image. Ad discovery multi asset ad marketing images TEXT Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. Ad discovery multi asset ad marketing images asset TEXT The Asset resource name of this image. Ad discovery multi asset ad portrait marketing images TEXT Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. Ad discovery multi asset ad portrait marketing images asset TEXT The Asset resource name of this image. Ad discovery multi asset ad square marketing images TEXT Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. Ad discovery multi asset ad square marketing images asset TEXT The Asset resource name of this image. Ad display upload ad display upload product type TEXT The product type of this ad. See comments on the enum for details. Ad display upload ad media bundle TEXT 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 The Asset resource name of this media bundle. Ad display url TEXT The URL that appears in the ad description for some ad formats. Ad expanded dynamic search ad description TEXT The description of the ad. Ad expanded dynamic search ad description2 TEXT The second description of the ad. Ad expanded text ad description TEXT The description of the ad. Ad expanded text ad description2 TEXT The second description of the ad. Ad expanded text ad headline part1 TEXT The first part of the ad's headline. Ad expanded text ad headline part2 TEXT The second part of the ad's headline. Ad expanded text ad headline part3 TEXT The third part of the ad's headline. Ad expanded text ad path1 TEXT The text that can appear alongside the ad's displayed URL. Ad expanded text ad path2 TEXT Additional text that can appear alongside the ad's displayed URL. Ad final app urls TEXT 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 The list of possible final mobile URLs after all cross-domain redirects for the ad. Ad final url suffix TEXT The suffix to use when constructing a final URL. Ad final urls TEXT The list of possible final URLs after all cross-domain redirects for the ad. Ad group path TEXT The ad group to which the criterion belongs. Ad group ad action items TEXT A list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.". Ad group ad ad added by google ads BOOLEAN 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 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 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 List of media bundle assets that may be used with the ad. Ad group ad ad app ad html5 media bundles asset TEXT The Asset resource name of this media bundle. Ad group ad ad app ad images TEXT List of image assets that may be displayed with the ad. Ad group ad ad app ad images asset TEXT The Asset resource name of this image. Ad group ad ad app ad mandatory ad text TEXT Mandatory ad text. Ad group ad ad app ad youtube videos TEXT List of YouTube video assets that may be displayed with the ad. Ad group ad ad app ad youtube videos asset TEXT The Asset resource name of this video. Ad group ad ad app engagement ad descriptions TEXT 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 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 List of image assets that may be displayed with the ad. Ad group ad ad app engagement ad images asset TEXT The Asset resource name of this image. Ad group ad ad app engagement ad videos TEXT List of video assets that may be displayed with the ad. Ad group ad ad app engagement ad videos asset TEXT The Asset resource name of this video. Ad group ad ad app pre registration ad descriptions TEXT 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 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 List of image asset IDs whose images may be displayed with the ad. Ad group ad ad app pre registration ad images asset TEXT The Asset resource name of this image. Ad group ad ad app pre registration ad youtube videos TEXT 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 The Asset resource name of this video. Ad group ad ad call ad business name TEXT The business name in the ad. Ad group ad ad call ad call tracked BOOLEAN Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. Ad group ad ad call ad conversion action TEXT 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 The call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled. Ad group ad ad call ad country code TEXT The country code in the ad. Ad group ad ad call ad description1 TEXT The first line of the ad's description. Ad group ad ad call ad description2 TEXT The second line of the ad's description. Ad group ad ad call ad disable call conversion BOOLEAN 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 First headline in the ad. Ad group ad ad call ad headline2 TEXT Second headline in the ad. Ad group ad ad call ad path1 TEXT First part of text that can be appended to the URL in the ad. Optional. Ad group ad ad call ad path2 TEXT 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 The phone number in the ad. Ad group ad ad call ad phone number verification url TEXT The URL to be used for phone number verification. Ad group ad ad device preference TEXT The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. Ad group ad ad discovery carousel ad business name TEXT Required. The Advertiser/brand name. Ad group ad ad discovery carousel ad call to action text TEXT Call to action text. Ad group ad ad discovery carousel ad carousel cards TEXT Required. Carousel cards that will display with the ad. Min 2 max 10. Ad group ad ad discovery carousel ad carousel cards asset TEXT The Asset resource name of this discovery carousel card. Ad group ad ad discovery carousel ad description TEXT Required. The descriptive text of the ad. Ad group ad ad discovery carousel ad headline TEXT Required. Headline of the ad. Ad group ad ad discovery carousel ad logo image TEXT Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). Ad group ad ad discovery carousel ad logo image asset TEXT The Asset resource name of this image. Ad group ad ad discovery multi asset ad business name TEXT The Advertiser/brand name. Maximum display width is 25. Required. Ad group ad ad discovery multi asset ad call to action text TEXT Call to action text. Ad group ad ad discovery multi asset ad descriptions TEXT The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. Ad group ad ad discovery multi asset ad headlines TEXT Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. Ad group ad ad discovery multi asset ad lead form only BOOLEAN Boolean option that indicates if this ad must be served with lead form. Ad group ad ad discovery multi asset ad logo images TEXT Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). At least 1 and max 5 logo images can be specified. Ad group ad ad discovery multi asset ad logo images asset TEXT The Asset resource name of this image. Ad group ad ad discovery multi asset ad marketing images TEXT Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. Ad group ad ad discovery multi asset ad marketing images asset TEXT The Asset resource name of this image. Ad group ad ad discovery multi asset ad portrait marketing images TEXT Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. Ad group ad ad discovery multi asset ad portrait marketing images asset TEXT The Asset resource name of this image. Ad group ad ad discovery multi asset ad square marketing images TEXT Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. Ad group ad ad discovery multi asset ad square marketing images asset TEXT The Asset resource name of this image. Ad group ad ad display upload ad display upload product type TEXT The product type of this ad. See comments on the enum for details. Ad group ad ad display upload ad media bundle TEXT 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 The Asset resource name of this media bundle. Ad group ad ad display url TEXT The URL that appears in the ad description for some ad formats. Ad group ad ad expanded dynamic search ad description TEXT The description of the ad. Ad group ad ad expanded dynamic search ad description2 TEXT The second description of the ad. Ad group ad ad expanded text ad description TEXT The description of the ad. Ad group ad ad expanded text ad description2 TEXT The second description of the ad. Ad group ad ad expanded text ad headline part1 TEXT The first part of the ad's headline. Ad group ad ad expanded text ad headline part2 TEXT The second part of the ad's headline. Ad group ad ad expanded text ad headline part3 TEXT The third part of the ad's headline. Ad group ad ad expanded text ad path1 TEXT The text that can appear alongside the ad's displayed URL. Ad group ad ad expanded text ad path2 TEXT Additional text that can appear alongside the ad's displayed URL. Ad group ad ad final app urls TEXT 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 The list of possible final mobile URLs after all cross-domain redirects for the ad. Ad group ad ad final url suffix TEXT The suffix to use when constructing a final URL. Ad group ad ad final urls TEXT The list of possible final URLs after all cross-domain redirects for the ad. Ad group ad ad group TEXT The ad group to which the ad belongs. Ad group ad ad hotel ad TEXT Details pertaining to a hotel ad. Ad group ad ad id NUMERIC The ID of the ad. Ad group ad ad image ad image url TEXT URL of the full size image. Ad group ad ad image ad media file TEXT The MediaFile resource to use for the image. Ad group ad ad image ad mime type TEXT The mime type of the image. Ad group ad ad image ad name TEXT 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 Height in pixels of the full size image. Ad group ad ad image ad pixel width NUMERIC Width in pixels of the full size image. Ad group ad ad image ad preview image url TEXT URL of the preview size image. Ad group ad ad image ad preview pixel height NUMERIC Height in pixels of the preview size image. Ad group ad ad image ad preview pixel width NUMERIC Width in pixels of the preview size image. Ad group ad ad legacy app install ad TEXT Details pertaining to a legacy app install ad. Ad group ad ad legacy responsive display ad accent color TEXT 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 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 The business name in the ad. Ad group ad ad legacy responsive display ad call to action text TEXT The call-to-action text for the ad. Ad group ad ad legacy responsive display ad description TEXT The description of the ad. Ad group ad ad legacy responsive display ad format setting TEXT Specifies which format the ad will be served in. Default is ALL_FORMATS. Ad group ad ad legacy responsive display ad logo image TEXT The MediaFile resource name of the logo image used in the ad. Ad group ad ad legacy responsive display ad long headline TEXT The long version of the ad's headline. Ad group ad ad legacy responsive display ad main color TEXT 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 The MediaFile resource name of the marketing image used in the ad. Ad group ad ad legacy responsive display ad price prefix TEXT Prefix before price. For example, 'as low as'. Ad group ad ad legacy responsive display ad promo text 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 The short version of the ad's headline. Ad group ad ad legacy responsive display ad square logo image TEXT 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 The MediaFile resource name of the square marketing image used in the ad. Ad group ad ad local ad call to actions TEXT 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 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 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 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 The Asset resource name of this image. Ad group ad ad local ad marketing images TEXT 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 The Asset resource name of this image. Ad group ad ad local ad path1 TEXT First part of optional text that can be appended to the URL in the ad. Ad group ad ad local ad path2 TEXT 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 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 The Asset resource name of this video. Ad group ad ad name TEXT 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 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 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 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 The advertiser/brand name. Maximum display width is 25. Ad group ad ad responsive display ad call to action text 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 Whether the advertiser has opted into the asset enhancements feature. Ad group ad ad responsive display ad control spec enable autogen video BOOLEAN Whether the advertiser has opted into auto-gen video feature. Ad group ad ad responsive display ad descriptions TEXT 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 Specifies which format the ad will be served in. Default is ALL_FORMATS. Ad group ad ad responsive display ad headlines TEXT 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 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 The Asset resource name of this image. Ad group ad ad responsive display ad long headline TEXT A required long format headline. The maximum length is 90 characters. Ad group ad ad responsive display ad main color TEXT 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 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 The Asset resource name of this image. Ad group ad ad responsive display ad price prefix TEXT Prefix before price. For example, 'as low as'. Ad group ad ad responsive display ad promo text 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 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 The Asset resource name of this image. Ad group ad ad responsive display ad square marketing images TEXT 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 The Asset resource name of this image. Ad group ad ad responsive display ad youtube videos TEXT 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 The Asset resource name of this video. Ad group ad ad responsive search ad descriptions TEXT 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 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 First part of text that can be appended to the URL in the ad. Ad group ad ad responsive search ad path2 TEXT 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 Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. Ad group ad ad shopping product ad TEXT Details pertaining to a Shopping product ad. Ad group ad ad shopping smart ad TEXT Details pertaining to a Smart Shopping ad. Ad group ad ad smart campaign ad descriptions TEXT 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 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 Overall ad strength for this ad group ad. Ad group ad ad system managed resource source TEXT 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 The first line of the ad's description. Ad group ad ad text ad description2 TEXT The second line of the ad's description. Ad group ad ad text ad headline TEXT The headline of the ad. Ad group ad ad tracking url template TEXT The URL template for constructing a tracking URL. Ad group ad ad travel ad TEXT Details pertaining to a travel ad. Ad group ad ad type TEXT The type of ad. Ad group ad ad url collections TEXT 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 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 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 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 The Asset resource name of this image. Ad group ad ad video ad in feed description1 TEXT First text line for the ad. Ad group ad ad video ad in feed description2 TEXT Second text line for the ad. Ad group ad ad video ad in feed headline TEXT The headline of the ad. Ad group ad ad video ad in feed thumbnail TEXT Video thumbnail image to use. Ad group ad ad video ad in stream action button label TEXT 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 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 The Asset resource name of this image. Ad group ad ad video ad non skippable action button label TEXT 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 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 The Asset resource name of this image. Ad group ad ad video ad out stream description TEXT The description line. Ad group ad ad video ad out stream headline TEXT The headline of the ad. Ad group ad ad video ad video asset TEXT The Asset resource name of this video. Ad group ad ad video responsive ad breadcrumb1 TEXT First part of text that appears in the ad with the displayed URL. Ad group ad ad video responsive ad breadcrumb2 TEXT Second part of text that appears in the ad with the displayed URL. Ad group ad ad video responsive ad call to actions TEXT 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 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 The Asset resource name of this image. Ad group ad ad video responsive ad descriptions TEXT 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 List of text assets used for the short headline, for example, the "Call To Action" banner. Currently, only a single value for the short headline is supported. Ad group ad ad video responsive ad long headlines TEXT 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 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 The Asset resource name of this video. Ad group ad labels TEXT The resource names of labels attached to this ad group ad. Ad group ad policy summary approval status TEXT 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 The list of policy findings for this ad. Ad group ad policy summary review status TEXT Where in the review process this ad is. Ad group ad resource name TEXT 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 The status of the ad. Ad group audience setting use audience grouped BOOLEAN 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 The ad group to which the criterion belongs. Ad group criterion app payment model type TEXT Type of the app payment model. Ad group criterion audience audience TEXT The Audience resource name. Ad group criterion combined audience combined audience TEXT The CombinedAudience resource name. Ad group criterion cpc bid micros NUMERIC The CPC (cost-per-click) bid. Ad group criterion cpm bid micros NUMERIC The CPM (cost-per-thousand viewable impressions) bid. Ad group criterion cpv bid micros NUMERIC The CPV (cost-per-view) bid. Ad group criterion custom affinity custom affinity TEXT The CustomInterest resource name. Ad group criterion custom audience custom audience TEXT The CustomAudience resource name. Ad group criterion custom intent custom intent TEXT The CustomInterest resource name. Ad group criterion disapproval reasons TEXT 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 The display name of the criterion. This field is ignored for mutates. Ad group criterion effective cpv bid micros NUMERIC The effective CPV (cost-per-view) bid. Ad group criterion effective cpv bid source TEXT Source of the effective CPV bid. Ad group criterion effective percent cpc bid micros NUMERIC The effective Percent CPC bid amount. Ad group criterion effective percent cpc bid source TEXT Source of the effective Percent CPC bid. Ad group criterion income range type TEXT Type of the income range. Ad group criterion labels TEXT The resource names of labels attached to this ad group criterion. Ad group criterion listing group case value activity country value TEXT String value of the activity country. The Geo Target Constant resource name. Ad group criterion listing group case value activity id value TEXT String value of the activity ID. Ad group criterion listing group case value activity rating value NUMERIC Long value of the activity rating. Ad group criterion listing group case value hotel city city criterion CITY The Geo Target Constant resource name. Ad group criterion listing group case value hotel class value NUMERIC Long value of the hotel class. Ad group criterion listing group case value hotel country region country region criterion TEXT The Geo Target Constant resource name. Ad group criterion listing group case value hotel id value TEXT String value of the hotel ID. Ad group criterion listing group case value hotel state state criterion TEXT The Geo Target Constant resource name. Ad group criterion listing group case value product bidding category id NUMERIC ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 Ad group criterion listing group case value product bidding category level TEXT Level of the product bidding category. Ad group criterion listing group case value product brand value TEXT String value of the product brand. Ad group criterion listing group case value product channel channel TEXT Value of the locality. Ad group criterion listing group case value product channel exclusivity channel exclusivity TEXT Value of the availability. Ad group criterion listing group case value product condition condition TEXT Value of the condition. Ad group criterion listing group case value product custom attribute index TEXT Indicates the index of the custom attribute. Ad group criterion listing group case value product custom attribute value TEXT String value of the product custom attribute. Ad group criterion listing group case value product item id value TEXT Value of the id. Ad group criterion listing group case value product type level TEXT Level of the type. Ad group criterion listing group case value product type value TEXT Value of the type. Ad group criterion listing group parent ad group criterion TEXT Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group. Ad group criterion listing group type TEXT Type of the listing group. Ad group criterion mobile app category mobile app category constant TEXT The mobile app category constant resource name. Ad group criterion mobile application app id TEXT 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 Name of this mobile application. Ad group criterion parental status type TEXT Type of the parental status. Ad group criterion percent cpc bid micros NUMERIC 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 URL of the placement. For example, "http://www.domain.com". Ad group criterion resource name TEXT 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 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 The type of the criterion. Ad group criterion user interest user interest category TEXT The UserInterest resource name. Ad group criterion user list user list TEXT The User List resource name. Ad group criterion webpage conditions TEXT Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. Ad group criterion webpage coverage percentage NUMERIC 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 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 Webpage sample urls Ad group criterion youtube channel channel id TEXT The YouTube uploader channel id or the channel code of a YouTube channel. Ad group criterion youtube video video id TEXT YouTube video id as it appears on the YouTube watch page. Ad group effective cpc bid micros NUMERIC 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 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 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 id TEXT The ID of the ad group. Ad group labels TEXT The resource names of labels attached to this ad group. Ad group name TEXT 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 True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. Ad group percent cpc bid micros NUMERIC The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. Ad group resource name TEXT 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 The status of the ad group. Ad group target cpa micros NUMERIC 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 Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. Ad group target roas NUMERIC 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 The type of the ad group. Ad hotel ad TEXT Details pertaining to a hotel ad. Ad id TEXT The ID of the ad. Ad image ad image url TEXT URL of the full size image. Ad image ad media file TEXT The MediaFile resource to use for the image. Ad image ad mime type TEXT The mime type of the image. Ad image ad name TEXT 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 Height in pixels of the full size image. Ad image ad pixel width NUMERIC Width in pixels of the full size image. Ad image ad preview image url TEXT URL of the preview size image. Ad image ad preview pixel height NUMERIC Height in pixels of the preview size image. Ad image ad preview pixel width NUMERIC Width in pixels of the preview size image. Ad legacy app install ad TEXT Details pertaining to a legacy app install ad. Ad legacy responsive display ad accent color TEXT 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 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 The business name in the ad. Ad legacy responsive display ad call to action text TEXT The call-to-action text for the ad. Ad legacy responsive display ad description TEXT The description of the ad. Ad legacy responsive display ad format setting TEXT Specifies which format the ad will be served in. Default is ALL_FORMATS. Ad legacy responsive display ad logo image TEXT The MediaFile resource name of the logo image used in the ad. Ad legacy responsive display ad long headline TEXT The long version of the ad's headline. Ad legacy responsive display ad main color TEXT 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 The MediaFile resource name of the marketing image used in the ad. Ad legacy responsive display ad price prefix TEXT Prefix before price. For example, 'as low as'. Ad legacy responsive display ad promo text TEXT Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. Ad legacy responsive display ad short headline TEXT The short version of the ad's headline. Ad legacy responsive display ad square logo image TEXT The MediaFile resource name of the square logo image used in the ad. Ad legacy responsive display ad square marketing image TEXT The MediaFile resource name of the square marketing image used in the ad. Ad local ad call to actions TEXT 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 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 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 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 The Asset resource name of this image. Ad local ad marketing images TEXT 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 The Asset resource name of this image. Ad local ad path1 TEXT First part of optional text that can be appended to the URL in the ad. Ad local ad path2 TEXT 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 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 The Asset resource name of this video. Ad name TEXT 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 type1 TEXT Ad network type. Ad network type2 TEXT Ad network type. Ad resource name TEXT 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 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 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 The advertiser/brand name. Maximum display width is 25. Ad responsive display ad call to action text TEXT The call-to-action text for the ad. Maximum display width is 30. Ad responsive display ad control spec enable asset enhancements BOOLEAN Whether the advertiser has opted into the asset enhancements feature. Ad responsive display ad control spec enable autogen video BOOLEAN Whether the advertiser has opted into auto-gen video feature. Ad responsive display ad descriptions TEXT 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 Specifies which format the ad will be served in. Default is ALL_FORMATS. Ad responsive display ad headlines TEXT 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 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 The Asset resource name of this image. Ad responsive display ad long headline TEXT A required long format headline. The maximum length is 90 characters. Ad responsive display ad main color TEXT 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 Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15. Ad responsive display ad marketing images asset TEXT The Asset resource name of this image. Ad responsive display ad price prefix TEXT Prefix before price. For example, 'as low as'. Ad responsive display ad promo text TEXT Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. Ad responsive display ad square logo images TEXT 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 The Asset resource name of this image. Ad responsive display ad square marketing images TEXT 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 The Asset resource name of this image. Ad responsive display ad youtube videos TEXT Optional YouTube videos for the ad. A maximum of 5 videos can be specified. Ad responsive display ad youtube videos asset TEXT The Asset resource name of this video. Ad responsive search ad descriptions TEXT List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. Ad responsive search ad headlines TEXT List of text assets for headlines. When the ad serves the headlines will be selected from this list. Ad responsive search ad path1 TEXT First part of text that can be appended to the URL in the ad. Ad responsive search ad path2 TEXT 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 The ad rotation mode of the ad group. Ad schedule day of week TEXT 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 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 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 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 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 The ad serving optimization status of the campaign. Ad shopping comparison listing ad headline TEXT Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. Ad shopping product ad TEXT Details pertaining to a Shopping product ad. Ad shopping smart ad TEXT Details pertaining to a Smart Shopping ad. Ad smart campaign ad descriptions TEXT 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 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 Overall ad strength for this ad group ad. Ad system managed resource source TEXT If this ad is system managed, then this field will indicate the source. This field is read-only. Ad text ad description1 TEXT The first line of the ad's description. Ad text ad description2 TEXT The second line of the ad's description. Ad text ad headline TEXT The headline of the ad. Ad tracking url template TEXT The URL template for constructing a tracking URL. Ad travel ad TEXT Details pertaining to a travel ad. Ad type TEXT The type of ad. Ad url collections TEXT 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 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 Label on the "Call To Action" button taking the user to the video ad's final URL. Ad video ad bumper action headline TEXT 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 The Asset resource name of this image. Ad video ad in feed description1 TEXT First text line for the ad. Ad video ad in feed description2 TEXT Second text line for the ad. Ad video ad in feed headline TEXT The headline of the ad. Ad video ad in feed thumbnail TEXT Video thumbnail image to use. Ad video ad in stream action button label TEXT 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 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 The Asset resource name of this image. Ad video ad non skippable action button label TEXT 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 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 The Asset resource name of this image. Ad video ad out stream description TEXT The description line. Ad video ad out stream headline TEXT The headline of the ad. Ad video ad video asset TEXT The Asset resource name of this video. Ad video responsive ad breadcrumb1 TEXT First part of text that appears in the ad with the displayed URL. Ad video responsive ad breadcrumb2 TEXT Second part of text that appears in the ad with the displayed URL. Ad video responsive ad call to actions TEXT 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 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 The Asset resource name of this image. Ad video responsive ad descriptions TEXT List of text assets used for the description. Currently, only a single value for the description is supported. Ad video responsive ad headlines TEXT List of text assets used for the short headline, for example, the "Call To Action" banner. Currently, only a single value for the short headline is supported. Ad video responsive ad long headlines TEXT 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 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 The Asset resource name of this video. Adnetwork conversions NUMERIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. Adnetwork revenue NUMERIC The value of all conversions. Advertising channel sub type TEXT 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 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 Type of the age range. Age range view resource name TEXT 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 of the product. Aligned bidding strategy id NUMERIC 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 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 conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. All conversion value NUMERIC The value of all conversions. All conversions NUMERIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. All conversions by conversion date NUMERIC 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 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 The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. All conversions from interactions rate NUMERIC All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. All conversions from interactions value per interaction NUMERIC The value of all conversions from interactions divided by the total number of interactions. All conversions from location asset click to call NUMERIC 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 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 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 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 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 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 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 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 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 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 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 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 The value of all conversions. All conversions value by conversion date NUMERIC 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 The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). Amount NUMERIC The amount of the budget for the selected date range, in the local currency for the account. Amount micros NUMERIC 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 A string that uniquely identifies a mobile application. App campaign setting app store TEXT The application store that distributes this specific app. App campaign setting bidding strategy goal type TEXT Represents the goal which the bidding strategy of this app campaign should optimize towards. App payment model type TEXT Type of the app payment model. Approval status TEXT Approval status of the criterion. Asset interaction target asset TEXT The asset resource name. Asset interaction target interaction on this asset BOOLEAN Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Auction insight domain TEXT Domain (visible URL) of a participant in the Auction Insights report. Auction insight search absolute top impression percentage NUMERIC This metric is part of the Auction Insights report, and tells how often the ads of another participant showed as the very first ad above the organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. Auction insight search impression share NUMERIC 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 This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. Auction insight search overlap rate NUMERIC This metric is part of the Auction Insights report, and tells how often another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. Auction insight search position above rate NUMERIC This metric is part of the Auction Insights report, and tells how often another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. Auction insight search top impression percentage NUMERIC This metric is part of the Auction Insights report, and tells how often the ads of another participant showed above the organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. Audience audience TEXT The Audience resource name. Audience description TEXT Description of this audience. Audience dimensions TEXT Positive dimensions specifying the audience composition. Audience dimensions audience segments segments custom audience custom audience TEXT The custom audience resource. Audience dimensions audience segments segments detailed demographic detailed demographic TEXT The detailed demographic resource. Audience dimensions audience segments segments life event life event TEXT The life event resource. Audience dimensions audience segments segments user interest user interest category TEXT The user interest resource. Audience dimensions audience segments segments user list user list TEXT The user list resource. Audience exclusion dimension TEXT Negative dimension specifying the audience composition. Audience exclusion dimension exclusions user list user list TEXT The user list resource. Audience id TEXT ID of the audience. Audience name TEXT Required. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255. Audience resource name TEXT The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id} Audience setting use audience grouped BOOLEAN If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. Audience status TEXT Status of this audience. Indicates whether the audience is enabled or removed. Auto tagging enabled BOOLEAN Whether auto-tagging is enabled for the customer. Availabilities TEXT Availability information of the user interest. Average cost NUMERIC 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 The total cost of all clicks divided by the total number of clicks received. Average cpe NUMERIC 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 cost-per-thousand impressions (CPM). Average cpv NUMERIC The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. Average page views NUMERIC Average number of pages viewed per session. Average pageviews NUMERIC Average number of pages viewed per session. Average target cpa micros NUMERIC 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 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 Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. Base ad group TEXT 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 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 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 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 Actions associated with this user list. Benchmark average max cpc NUMERIC An indication of how other advertisers are bidding on similar products. Bid modifier NUMERIC 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 Number of app installs. Biddable app post install conversions NUMERIC Number of in-app actions. Bidding strategy TEXT Portfolio bidding strategy used by campaign. Bidding strategy aligned campaign budget id NUMERIC 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 The number of campaigns attached to this bidding strategy. This field is read-only. Bidding strategy currency code TEXT 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 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 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 Portfolio bidding strategy used by campaign. Bidding strategy maximize conversion value cpc bid ceiling micros NUMERIC 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 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 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 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 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 The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. Bidding strategy name TEXT 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 The number of non-removed campaigns attached to this bidding strategy. This field is read-only. Bidding strategy resource name TEXT 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 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 The status of the bidding strategy. This field is read-only. Bidding strategy system status TEXT The system status of the campaign's bidding strategy. Bidding strategy target cpa cpc bid ceiling micros NUMERIC 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 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 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 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 The targeted location on the search results page. Bidding strategy target impression share location fraction micros NUMERIC 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 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 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 The chosen revenue (based on conversion data) per unit of spend. Bidding strategy target spend cpc bid ceiling micros NUMERIC 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 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 The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. Bounce rate NUMERIC Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. Brand TEXT Brand of the product. Budget amount NUMERIC The amount of the budget for the selected date range, in the local currency for the account. Budget campaign association status campaign TEXT The campaign resource name. Budget campaign association status status TEXT Budget campaign association status. Budget id TEXT The budget of the campaign. Call reporting setting call conversion action TEXT 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 Whether to enable call conversion reporting. Call reporting setting call reporting enabled BOOLEAN Enable reporting of phone call events by redirecting them through Google System. Campaign TEXT 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 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 The ad serving optimization status of the campaign. Campaign app campaign setting app id TEXT A string that uniquely identifies a mobile application. Campaign app campaign setting app store TEXT The application store that distributes this specific app. Campaign app campaign setting bidding strategy goal type TEXT Represents the goal which the bidding strategy of this app campaign should optimize towards. Campaign audience setting use audience grouped BOOLEAN 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 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 The system status of the campaign's bidding strategy. Campaign budget NUMERIC The budget of the campaign. Campaign budget aligned bidding strategy id NUMERIC 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 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 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 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 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 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 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 The estimated change in weekly views if the recommended budget is applied. This field is read-only. Campaign budget reference count NUMERIC The number of campaigns actively using the budget. This field is read-only. Campaign budget resource name TEXT 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 The status of this campaign budget. This field is read-only. Campaign budget type TEXT The type of the campaign budget. Campaign campaign group TEXT The campaign group this campaign belongs to. Campaign commission commission rate micros NUMERIC 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 The number of campaigns attached to this bidding strategy. This field is read-only. Campaign criterion ad schedule day of week TEXT 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 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 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 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 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 Type of the age range. Campaign criterion bid modifier NUMERIC The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type. Campaign criterion campaign TEXT The campaign to which the criterion belongs. Campaign criterion carrier carrier constant TEXT The Carrier constant resource name. Campaign criterion combined audience combined audience TEXT The CombinedAudience resource name. Campaign criterion content label type TEXT Content label type, required for CREATE operations. Campaign criterion custom affinity custom affinity TEXT The CustomInterest resource name. Campaign criterion custom audience custom audience TEXT The CustomAudience resource name. Campaign criterion device type TEXT Type of the device. Campaign criterion display name TEXT The display name of the criterion. This field is ignored for mutates. Campaign criterion gender type TEXT Type of the gender. Campaign criterion income range type TEXT Type of the income range. Campaign criterion ip block ip address TEXT The IP address of this IP block. Campaign criterion keyword match type TEXT The match type of the keyword. Campaign criterion keyword theme free form keyword theme TEXT 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 The resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id} Campaign criterion language language constant TEXT The language constant resource name. Campaign criterion listing scope dimensions TEXT Scope of the campaign criterion. Campaign criterion listing scope dimensions activity country value TEXT String value of the activity country. The Geo Target Constant resource name. Campaign criterion listing scope dimensions hotel city city criterion CITY The Geo Target Constant resource name. Campaign criterion listing scope dimensions hotel country region country region criterion TEXT The Geo Target Constant resource name. Campaign criterion listing scope dimensions hotel state state criterion TEXT The Geo Target Constant resource name. Campaign criterion local service id service id TEXT The criterion resource name. Campaign criterion location geo target constant TEXT The geo target constant resource name. Campaign criterion location group TEXT Location Group Campaign criterion location group enable customer level location asset set BOOLEAN 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 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 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 The mobile app category constant resource name. Campaign criterion mobile application app id TEXT 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 Name of this mobile application. Campaign criterion mobile device mobile device constant TEXT The mobile device constant resource name. Campaign criterion operating system version operating system version constant TEXT The operating system version constant resource name. Campaign criterion parental status type TEXT Type of the parental status. Campaign criterion placement url TEXT URL of the placement. For example, "http://www.domain.com". Campaign criterion proximity address city name CITY Name of the city. Campaign criterion proximity address country code TEXT Country code. Campaign criterion proximity address postal code TEXT Postal code. Campaign criterion proximity address province code TEXT Province or state code. Campaign criterion proximity address province name TEXT Province or state name. Campaign criterion proximity address street address TEXT Street address line 1. Campaign criterion proximity geo point latitude in micro degrees NUMERIC Micro degrees for the latitude. Campaign criterion proximity geo point longitude in micro degrees NUMERIC Micro degrees for the longitude. Campaign criterion proximity radius NUMERIC The radius of the proximity. Campaign criterion proximity radius units TEXT The unit of measurement of the radius. Default is KILOMETERS. Campaign criterion resource name TEXT 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 The status of the criterion. Campaign criterion topic path TEXT 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 The Topic Constant resource name. Campaign criterion user interest user interest category TEXT The UserInterest resource name. Campaign criterion user list user list TEXT The User List resource name. Campaign criterion webpage conditions TEXT Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. Campaign criterion webpage coverage percentage NUMERIC 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 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 Webpage sample urls Campaign criterion youtube channel channel id TEXT The YouTube uploader channel id or the channel code of a YouTube channel. Campaign criterion youtube video video id TEXT YouTube video id as it appears on the YouTube watch page. Campaign dynamic search ads setting domain name TEXT Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com". Campaign dynamic search ads setting feeds TEXT The list of page feeds associated with the campaign. Campaign dynamic search ads setting language code TEXT Required. The language code specifying the language of the domain, for example, "en". Campaign dynamic search ads setting use supplied urls only BOOLEAN Whether the campaign uses advertiser supplied URLs exclusively. Campaign excluded parent asset field types TEXT 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 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 frequency caps TEXT A list that limits how often each user will see this campaign's ads. Campaign geo target type setting negative geo target type TEXT The setting used for negative geotargeting in this particular campaign. Campaign geo target type setting positive geo target type TEXT The setting used for positive geotargeting in this particular campaign. Campaign group TEXT The campaign group this campaign belongs to. Campaign hotel property asset set TEXT The set of hotel properties for Performance Max for travel goals campaigns. Campaign hotel setting hotel center id NUMERIC The linked Hotel Center account. Campaign id TEXT The ID of the campaign. Campaign labels TEXT The resource names of labels attached to this campaign. Campaign listing type TEXT 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 The location source type for this local campaign. Campaign local services campaign settings category bids TEXT Categorical level bids associated with MANUAL_CPA bidding strategy. Campaign manual cpa TEXT 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 Whether bids are to be enhanced based on conversion optimizer data. Campaign manual cpm TEXT Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. Campaign manual cpv TEXT A bidding strategy that pays a configurable amount per video view. Campaign maximize conversions target cpa micros NUMERIC The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. Campaign name TEXT 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 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 Whether ads will be served with google.com search results. Campaign network settings target partner search network BOOLEAN 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 Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true). Campaign optimization goal setting optimization goal types TEXT The list of optimization goal types. Campaign optimization score NUMERIC 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 Payment mode for the campaign. Campaign percent cpc cpc bid ceiling micros NUMERIC 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 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 Indicates which Performance Max campaign the campaign is upgraded to. Campaign performance max upgrade pre upgrade campaign TEXT Indicates legacy campaign upgraded to Performance Max. Campaign performance max upgrade status TEXT The upgrade status of a campaign requested to be upgraded to Performance Max. Campaign primary status TEXT 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 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 Whether the campaign is opted in to real-time bidding. Campaign resource name TEXT The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} Campaign selective optimization conversion actions TEXT The selected set of conversion actions for optimizing this campaign. Campaign shopping setting campaign priority NUMERIC Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. Campaign shopping setting enable local BOOLEAN Whether to include local products. Campaign shopping setting feed label TEXT 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 ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. Campaign shopping setting sales country TEXT Sales country of products to include in the campaign. Only one of feed_label or sales_country can be set. Field is immutable except for clearing. Once this field is cleared, you must use feed_label if you want to set the sales country. Campaign shopping setting use vehicle inventory BOOLEAN 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 The status of the campaign. When a new campaign is added, the status defaults to ENABLED. Campaign sub type TEXT Optional refinement to Campaign type. Alias for Advertising channel sub type. Campaign target cpa cpc bid ceiling micros NUMERIC 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 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 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 Target Frequency count representing how many times you want to reach a single user. Campaign target cpm target frequency goal time unit TEXT Time window expressing the period over which you want to reach the specified target_count. Campaign target impression share cpc bid ceiling micros NUMERIC 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 The targeted location on the search results page. Campaign target impression share location fraction micros NUMERIC 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 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 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 The chosen revenue (based on conversion data) per unit of spend. Campaign target spend cpc bid ceiling micros NUMERIC 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 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 The per-targeting-dimension setting to restrict the reach of your campaign or ad group. Campaign tracking setting tracking url TEXT The url used for dynamic tracking. Campaign travel campaign settings travel account id NUMERIC The Travel account ID associated with the Travel campaign. Campaign trial type TEXT The type of campaign: normal, draft, or experiment. Campaign type TEXT The primary serving target for ads within the campaign. Alias for Advertising channel type. Campaign url expansion opt out BOOLEAN 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 The display mode for vanity pharma URLs. Campaign vanity pharma vanity pharma text 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 3-Tier Brand Safety setting for the campaign. Carrier carrier constant TEXT The Carrier constant resource name. Category l1 TEXT Bidding category (level 1) of the product. Category l2 TEXT Bidding category (level 2) of the product. Category l3 TEXT Bidding category (level 3) of the product. Category l4 TEXT Bidding category (level 4) of the product. Category l5 TEXT Bidding category (level 5) of the product. Channel TEXT Channel of the product. Channel exclusivity TEXT Channel exclusivity of the product. Geo target city CITY Geo target city name. Click type TEXT Click type. Clicks NUMERIC The number of clicks. Closing reason TEXT 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 The CombinedAudience resource name. Commission commission rate micros NUMERIC 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 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 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 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, required for CREATE operations. Content rank lost impression share NUMERIC 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 Resource name of the conversion action. Conversion action category TEXT Conversion action category. Conversion action name TEXT Conversion action name. Conversion adjustment BOOLEAN 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 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 category name TEXT Conversion action category. Conversion lag bucket TEXT An enum value representing the number of days between the impression and the conversion. Conversion last conversion date 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 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 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 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 Resource name of the conversion action. Conversion tracking setting accepted customer data terms BOOLEAN 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 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 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 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 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 The resource name of the customer where conversions are created and managed. This field is read-only. Conversion type name TEXT Conversion action name. Conversion value NUMERIC 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 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 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 The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. Conversions from interactions rate NUMERIC Conversions from interactions 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 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 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 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 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 The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Cost micros NUMERIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Cost per all conversion NUMERIC The cost of ad interactions divided by all conversions. Cost per all conversions NUMERIC The cost of ad interactions divided by all conversions. Cost per conversion NUMERIC 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 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. Geo target country code COUNTRY Geo target country code. Country criteria id TEXT Resource name of the geo target constant for the country of sale of the product. Country criterion id NUMERIC Criterion Id for the country. Cpc bid NUMERIC The maximum CPC (cost-per-click) bid. Cpc bid micros NUMERIC The maximum CPC (cost-per-click) bid. Cpc bid source TEXT Source of the effective CPC bid. Cpm bid NUMERIC The maximum CPM (cost-per-thousand viewable impressions) bid. Cpm bid micros NUMERIC The maximum CPM (cost-per-thousand viewable impressions) bid. Cpm bid source TEXT Source of the effective CPM bid. Cpv bid NUMERIC The CPV (cost-per-view) bid. Cpv bid micros NUMERIC The CPV (cost-per-view) bid. Creative quality score TEXT The performance of the ad compared to other advertisers. Criteria TEXT Type of the age range. Criteria type TEXT The type of the criterion. Criterion id NUMERIC The ID of the criterion. This field is ignored for mutates. Crm based user list app id TEXT 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 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 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 Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. Ctr PERCENT The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Currency TEXT The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. Currency code TEXT 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 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 Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. Current model attributed conversions from interactions rate NUMERIC Current model attributed conversions from interactions 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 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 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 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 The CustomInterest resource name. Custom attribute0 TEXT Custom attribute 0 of the product. Custom attribute1 TEXT Custom attribute 1 of the product. Custom attribute2 TEXT Custom attribute 2 of the product. Custom attribute3 TEXT Custom attribute 3 of the product. Custom attribute4 TEXT Custom attribute 4 of the product. Custom audience custom audience TEXT The CustomAudience resource name. Custom intent custom intent TEXT The CustomInterest resource name. Customer auto tagging enabled BOOLEAN Whether auto-tagging is enabled for the customer. Customer call reporting setting call conversion action TEXT 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 Whether to enable call conversion reporting. Customer call reporting setting call reporting enabled BOOLEAN Enable reporting of phone call events by redirecting them through Google System. Customer conversion tracking setting accepted customer data terms BOOLEAN 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 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 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 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 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 The resource name of the customer where conversions are created and managed. This field is read-only. Customer descriptive name TEXT Optional, non-unique descriptive name of the customer. Customer final url suffix TEXT The URL template for appending params to the final URL. Only mutable in an update operation. Customer has partners badge BOOLEAN 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 True if feed based image has been migrated to asset based image. Customer image asset auto migration done date time DATE Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format. Customer location asset auto migration done BOOLEAN True if feed based location has been migrated to asset based location. Customer location asset auto migration done date time DATE Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format. Customer manager BOOLEAN Whether the customer is a manager. Customer optimization score NUMERIC 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 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 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 The Google tag. Customer resource name TEXT The resource name of the customer. Customer resource names have the form: customers/{customer_id} Customer status TEXT The status of the customer. Customer test account BOOLEAN Whether the customer is a test account. Customer tracking url template TEXT The URL template for constructing a tracking URL out of parameters. Only mutable in an update operation. Date DATE Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. Day of week TEXT Day of the week, for example, MONDAY. Delivery method TEXT The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation. Description TEXT Description of this user list. Descriptive name TEXT Optional, non-unique descriptive name of the customer. Detail placement view display name TEXT 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 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 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 Type of the placement, for example, Website, YouTube Video, and Mobile Application. Detail placement view resource name TEXT 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 URL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL. Device TEXT Device to which metrics apply. Device type TEXT Type of the device. Dimensions TEXT Positive dimensions specifying the audience composition. Dimensions audience segments segments custom audience custom audience TEXT The custom audience resource. Dimensions audience segments segments detailed demographic detailed demographic TEXT The detailed demographic resource. Dimensions audience segments segments life event life event TEXT The life event resource. Dimensions audience segments segments user interest user interest category TEXT The user interest resource. Dimensions audience segments segments user list user list TEXT The user list resource. Disapproval reasons TEXT 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 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 The display name of the criterion. This field is ignored for mutates. Dynamic search ads setting domain name TEXT Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com". Dynamic search ads setting feeds TEXT The list of page feeds associated with the campaign. Dynamic search ads setting language code TEXT Required. The language code specifying the language of the domain, for example, "en". Dynamic search ads setting use supplied urls only BOOLEAN Whether the campaign uses advertiser supplied URLs exclusively. Effective cpc bid micros NUMERIC 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 Source of the effective CPC bid. Effective cpm bid micros NUMERIC The effective CPM (cost-per-thousand viewable impressions) bid. Effective cpm bid source TEXT Source of the effective CPM bid. Effective cpv bid micros NUMERIC The effective CPV (cost-per-view) bid. Effective cpv bid source TEXT Source of the effective CPV bid. Effective currency code TEXT 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 The effective Percent CPC bid amount. Effective percent cpc bid source TEXT Source of the effective Percent CPC bid. Effective target cpa micros NUMERIC The effective target CPA (cost-per-acquisition). This field is read-only. Effective target cpa source TEXT Source of the effective target CPA. This field is read-only. Effective target roas NUMERIC The effective target ROAS (return-on-ad-spend). This field is read-only. Effective target roas source TEXT Source of the effective target ROAS. This field is read-only. Eligible for display BOOLEAN Indicates this user list is eligible for Google Display Network. This field is read-only. Eligible for search BOOLEAN Indicates if this user list is eligible for Google Search Network. Eligible impressions from location asset store reach NUMERIC 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. End date 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 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 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 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 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 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 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 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 Negative dimension specifying the audience composition. Exclusion dimension exclusions user list user list TEXT The user list resource. Experiment type TEXT The type of campaign: normal, draft, or experiment. Explicitly shared BOOLEAN 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 Advertiser supplied activity ID. External conversion source TEXT External conversion source. External customer id NUMERIC The ID of the customer. Final mobile urls TEXT The list of possible final mobile URLs after all cross-domain redirects. Final url TEXT The advertiser-specified final URL. Final url suffix TEXT Suffix used to append query parameters to landing pages that are served with parallel tracking. Final urls TEXT The list of possible final URLs after all cross-domain redirects for the ad. First page cpc NUMERIC The estimate of the CPC bid required for ad to be shown on first page of search results. First position cpc NUMERIC The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results. Frequency caps TEXT A list that limits how often each user will see this campaign's ads. Gender type TEXT Type of the gender. Gender view resource name TEXT 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 Resource name of the geo target constant that represents an airport. Geo target canton TEXT Resource name of the geo target constant that represents a canton. Geo target city CITY Resource name of the geo target constant that represents a city. Geo target country (Geographic View) COUNTRY The country of the user's actual physical location or an area of interest (Geographic View). Geo target county TEXT Resource name of the geo target constant that represents a county. Geo target district TEXT Resource name of the geo target constant that represents a district. Geo target metro TEXT Resource name of the geo target constant that represents a metro. Geo target most specific location TEXT Resource name of the geo target constant that represents the most specific location. Geo target postal code TEXT Resource name of the geo target constant that represents a postal code. Geo target province TEXT Resource name of the geo target constant that represents a province. Geo target region TEXT Resource name of the geo target constant that represents a region. Geo target state TEXT Resource name of the geo target constant that represents a state. Geo target type setting negative geo target type TEXT The setting used for negative geotargeting in this particular campaign. Geo target type setting positive geo target type TEXT The setting used for positive geotargeting in this particular campaign. Geographic view country criterion id NUMERIC Criterion Id for the country. Geographic view location type TEXT Type of the geo targeting of the campaign. Geographic view resource name TEXT 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 The number of times the ad was forwarded to someone else as a message. Gmail saves NUMERIC The number of times someone has saved your Gmail ad to their inbox as a message. Gmail secondary clicks NUMERIC The number of clicks to the landing page on the expanded state of Gmail ads. Group placement target url TEXT 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 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 Indicates whether there is a recommended budget for this campaign budget. This field is read-only. Historical creative quality score TEXT The creative historical quality score. Historical landing page quality score TEXT The quality of historical landing page experience. Historical quality score NUMERIC The historical quality score. Historical search predicted ctr TEXT The historical search predicted click through rate (CTR). Hotel average lead value micros NUMERIC Average lead value based on clicks. Hotel booking window days NUMERIC Hotel booking window in days. Hotel center id NUMERIC Hotel center ID. Hotel check in date DATE Hotel check-in date. Formatted as yyyy-MM-dd. Hotel check in day of week TEXT Hotel check-in day of week. Hotel city CITY Hotel city. Hotel class NUMERIC Hotel class. Hotel country TEXT Hotel country. Hotel date selection type TEXT Hotel date selection type. Hotel eligible impressions NUMERIC The number of impressions that hotel partners could have had given their feed performance. Hotel length of stay NUMERIC Hotel length of stay. Hotel price bucket TEXT Hotel price bucket. Hotel price difference percentage NUMERIC The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. Hotel property asset set TEXT The set of hotel properties for Performance Max for travel goals campaigns. Hotel rate rule id TEXT Hotel rate rule ID. Hotel rate type TEXT Hotel rate type. Hotel setting hotel center id NUMERIC The linked Hotel Center account. Hotel state TEXT Hotel state. Hour TEXT Hour of day as a number between 0 and 23, inclusive. Hour of day NUMERIC Hour of day as a number between 0 and 23, inclusive. Id TEXT The ID of the campaign. Image asset auto migration done BOOLEAN True if feed based image has been migrated to asset based image. Image asset auto migration done date time DATE Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format. Impressions NUMERIC Count of how often your ad has appeared on a search results page or website on the Google Network. Income range type TEXT Type of the income range. Integration code TEXT An ID from external system. It is used by user list sellers to correlate IDs on their systems. Interaction event types TEXT The types of payable and free interactions. Interaction on this extension BOOLEAN Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. Interaction rate NUMERIC 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 The types of payable and free interactions. Interactions NUMERIC 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 The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. Invalid clicks NUMERIC Number of clicks Google considers illegitimate and doesn't charge you for. Ip block ip address TEXT The IP address of this IP block. Is budget explicitly shared BOOLEAN 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 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 The per-targeting-dimension setting to restrict the reach of your campaign or ad group. Keyword ad group criterion TEXT The AdGroupCriterion resource name. Keyword Criterion ID TEXT The Criterion ID for a keyword Keyword info match type TEXT The match type of the keyword. Keyword info text TEXT The text of the keyword (at most 80 characters and 10 words). Keyword match type TEXT The match type of the keyword. Keyword text TEXT The text of the keyword (at most 80 characters and 10 words). Keyword theme free form keyword theme TEXT Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis. Keyword theme keyword theme constant TEXT The resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id} Keyword view resource name TEXT 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 ID of the label. Read only. Label name TEXT 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 Name of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id} Label status TEXT Status of the label. Read only. Label text label background color TEXT Background color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. Label text label description TEXT A short description of the label. The length must be no more than 200 characters. Labels TEXT The resource names of labels attached to this campaign. Landing page view resource name TEXT 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 Resource name of the language constant for the language of the product. Language language constant TEXT The language constant resource name. Launched to all BOOLEAN True if the user interest is launched to all channels and locales. Listing group case value activity country value TEXT String value of the activity country. The Geo Target Constant resource name. Listing group case value activity id value TEXT String value of the activity ID. Listing group case value activity rating value NUMERIC Long value of the activity rating. Listing group case value hotel city city criterion CITY The Geo Target Constant resource name. Listing group case value hotel class value NUMERIC Long value of the hotel class. Listing group case value hotel country region country region criterion TEXT The Geo Target Constant resource name. Listing group case value hotel id value TEXT String value of the hotel ID. Listing group case value hotel state state criterion TEXT The Geo Target Constant resource name. Listing group case value product bidding category id NUMERIC ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 Listing group case value product bidding category level TEXT Level of the product bidding category. Listing group case value product brand value TEXT String value of the product brand. Listing group case value product channel channel TEXT Value of the locality. Listing group case value product channel exclusivity channel exclusivity TEXT Value of the availability. Listing group case value product condition condition TEXT Value of the condition. Listing group case value product custom attribute index TEXT Indicates the index of the custom attribute. Listing group case value product custom attribute value TEXT String value of the product custom attribute. Listing group case value product item id value TEXT Value of the id. Listing group case value product type level TEXT Level of the type. Listing group case value product type value TEXT Value of the type. Listing group parent ad group criterion TEXT Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group. Listing group type TEXT Type of the listing group. Listing scope dimensions TEXT Scope of the campaign criterion. Listing scope dimensions activity country value TEXT String value of the activity country. The Geo Target Constant resource name. Listing scope dimensions hotel city city criterion CITY The Geo Target Constant resource name. Listing scope dimensions hotel country region country region criterion TEXT The Geo Target Constant resource name. Listing scope dimensions hotel state state criterion TEXT The Geo Target Constant resource name. Listing type TEXT Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns. Local campaign setting location source type TEXT The location source type for this local campaign. Local service id service id TEXT The criterion resource name. Local services campaign settings category bids TEXT Categorical level bids associated with MANUAL_CPA bidding strategy. Location asset auto migration done BOOLEAN True if feed based location has been migrated to asset based location. Location asset auto migration done date time DATE Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format. Location geo target constant TEXT The geo target constant resource name. Location group TEXT Location Group Location group enable customer level location asset set BOOLEAN 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 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 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 Type of the geo targeting of the campaign. Logical user list rules TEXT Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list. Manager BOOLEAN Whether the customer is a manager. Manual cpa TEXT 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 Whether bids are to be enhanced based on conversion optimizer data. Manual cpm TEXT Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. Manual cpv TEXT A bidding strategy that pays a configurable amount per video view. Match rate percentage NUMERIC 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 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 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 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 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 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 The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. Membership life span NUMERIC Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list. Membership status TEXT Membership status 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 of the product. Message chat rate NUMERIC 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 Number of message chats initiated for Click To Message impressions that were message tracking eligible. Message impressions NUMERIC Number of Click To Message impressions that were message tracking eligible. Geo target metro area TEXT Geo target metro area. Mobile app category mobile app category constant TEXT The mobile app category constant resource name. Mobile application app id TEXT 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 Name of this mobile application. Mobile device mobile device constant TEXT The mobile device constant resource name. Mobile friendly clicks percentage NUMERIC The percentage of mobile clicks that go to a mobile-friendly page. Month TEXT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. Month of year TEXT Month of the year, for example, January. Name TEXT 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 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 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 Whether ads will be served with google.com search results. Network settings target partner search network BOOLEAN 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 Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true). Non removed campaign count NUMERIC The number of non-removed campaigns attached to this bidding strategy. This field is read-only. Num offline impressions NUMERIC Number of offline phone impressions. Num offline interactions NUMERIC Number of offline phone calls. Offer id TEXT Item ID of the product. Offline interaction rate NUMERIC 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 The operating system version constant resource name. Optimization goal setting optimization goal types TEXT The list of optimization goal types. Optimization score NUMERIC 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 Total optimization score uplift of all recommendations. Optimization score url TEXT 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 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 True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. Owner customer id NUMERIC The ID of the Customer which owns the bidding strategy. Owner descriptive name TEXT descriptive_name of the Customer which owns the bidding strategy. Parental status type TEXT Type of the parental status. Partner hotel id TEXT Partner hotel ID. Pay per conversion eligibility failure reasons TEXT 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 for the campaign. Percent cpc bid micros NUMERIC 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 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 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 Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. Performance max upgrade performance max campaign TEXT Indicates which Performance Max campaign the campaign is upgraded to. Performance max upgrade pre upgrade campaign TEXT Indicates legacy campaign upgraded to Performance Max. Performance max upgrade status TEXT The upgrade status of a campaign requested to be upgraded to Performance Max. Period TEXT Period over which to spend the budget. Defaults to DAILY if not specified. Phone calls NUMERIC Number of offline phone calls. Phone impressions NUMERIC Number of offline phone impressions. Phone through rate NUMERIC Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). Placeholder type TEXT Placeholder type. This is only used with feed item metrics. Placement TEXT The automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID. Placement type TEXT Type of the placement, for example, Website, YouTube Video, and Mobile Application. Placement url TEXT URL of the placement. For example, "http://www.domain.com". Policy summary approval status TEXT The overall approval status of this ad, calculated based on the status of its individual policy topic entries. Policy summary policy topic entries TEXT The list of policy findings for this ad. Policy summary review status TEXT Where in the review process this ad is. Position estimates estimated add clicks at first position cpc NUMERIC 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 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 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 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 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 The quality score of the landing page. Geo target postal code numbers TEXT Geo target postal code. Primary status TEXT 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 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 Aggregator ID of the product. Product bidding category level1 TEXT Bidding category (level 1) of the product. Product bidding category level2 TEXT Bidding category (level 2) of the product. Product bidding category level3 TEXT Bidding category (level 3) of the product. Product bidding category level4 TEXT Bidding category (level 4) of the product. Product bidding category level5 TEXT Bidding category (level 5) of the product. Product brand TEXT Brand of the product. Product channel TEXT Channel of the product. Product channel exclusivity TEXT Channel exclusivity of the product. Product condition TEXT Condition of the product. Product country TEXT Resource name of the geo target constant for the country of sale of the product. Product custom attribute0 TEXT Custom attribute 0 of the product. Product custom attribute1 TEXT Custom attribute 1 of the product. Product custom attribute2 TEXT Custom attribute 2 of the product. Product custom attribute3 TEXT Custom attribute 3 of the product. Product custom attribute4 TEXT Custom attribute 4 of the product. Product feed label TEXT Feed label of the product. Product item id TEXT Item ID of the product. Product language TEXT Resource name of the language constant for the language of the product. Product merchant id NUMERIC Merchant ID of the product. Product store id TEXT Store ID of the product. Product title TEXT Title of the product. Product type l1 TEXT Type (level 1) of the product. Product type l2 TEXT Type (level 2) of the product. Product type l3 TEXT Type (level 3) of the product. Product type l4 TEXT Type (level 4) of the product. Product type l5 TEXT Type (level 5) of the product. Proximity address city name CITY Name of the city. Proximity address country code TEXT Country code. Proximity address postal code TEXT Postal code. Proximity address province code TEXT Province or state code. Proximity address province name TEXT Province or state name. Proximity address street address TEXT Street address line 1. Proximity geo point latitude in micro degrees NUMERIC Micro degrees for the latitude. Proximity geo point longitude in micro degrees NUMERIC Micro degrees for the longitude. Proximity radius NUMERIC The radius of the proximity. Proximity radius units TEXT The unit of measurement of the radius. Default is KILOMETERS. Publisher organic clicks NUMERIC Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity Publisher purchased clicks NUMERIC 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 Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" Quality info creative quality score TEXT The performance of the ad compared to other advertisers. Quality info post click quality score TEXT The quality score of the landing page. Quality info quality score NUMERIC 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 The click-through rate compared to that of other advertisers. Quality score NUMERIC The quality score. This field may not be populated if Google does not have enough information to determine a value. Quarter TEXT 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 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 Whether the campaign is opted in to real-time bidding. Recommendation type TEXT Recommendation type. Recommended budget amount NUMERIC 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 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 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 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 The estimated change in weekly interactions if the recommended budget is applied. This field is read-only. Recommended budget estimated change weekly views NUMERIC The estimated change in weekly views if the recommended budget is applied. This field is read-only. Reference count NUMERIC The number of campaigns actively using the budget. This field is read-only. Geo target region REGION Geo target region name. Relative ctr NUMERIC 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 The Google tag. Resource name TEXT The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} ROAS PERCENT Return on Spend Rule based user list flexible rule user list exclusive operands TEXT 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 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 Operator that defines how the inclusive operands are combined. Rule based user list prepopulation status TEXT The status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails. Search absolute top impression share NUMERIC 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 The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. Search budget lost impression share NUMERIC 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 The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. Search click share NUMERIC The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Search engine results page type TEXT Type of the search engine results page. Search exact match impression share NUMERIC 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 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 The click-through rate compared to that of other advertisers. Search rank lost absolute top impression share NUMERIC The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. Search rank lost impression share NUMERIC 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 The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. Search term TEXT The search term. Search term match type TEXT Match type of the keyword that triggered the ad, including variants. Search term view ad group TEXT The ad group the search term served in. Search Term View Ad Group ID TEXT The Ad Group ID for a search term Search Term View Campaign ID TEXT The Campaign ID for a search term Search Term View Keyword ID TEXT The Keyword ID for a search term Search term view resource name TEXT 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 The search term. Search term view status TEXT Indicates whether the search term is currently one of your targeted or excluded keywords. Search top impression share NUMERIC The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Selective optimization conversion actions TEXT The selected set of conversion actions for optimizing this campaign. Serving status TEXT The ad serving status of the campaign. Shopping performance view resource name TEXT The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView Shopping setting campaign priority NUMERIC Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. Shopping setting enable local BOOLEAN Whether to include local products. Shopping setting feed label TEXT 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 ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. Shopping setting sales country TEXT Sales country of products to include in the campaign. Only one of feed_label or sales_country can be set. Field is immutable except for clearing. Once this field is cleared, you must use feed_label if you want to set the sales country. Shopping setting use vehicle inventory BOOLEAN 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 Seed UserList from which this list is derived. Size for display NUMERIC 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 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 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 in terms of number of users of the UserList, for Search ads. This field is read-only. Sk ad network ad event type TEXT iOS Store Kit Ad Network ad event type. Sk ad network attribution credit TEXT iOS Store Kit Ad Network attribution credit Sk ad network conversion value NUMERIC iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign. Sk ad network conversions NUMERIC The number of iOS Store Kit Ad Network conversions. Sk ad network source app sk ad network source app id TEXT App id where the ad that drove the iOS Store Kit Ad Network install was shown. Sk ad network user type TEXT iOS Store Kit Ad Network user type. Slot TEXT Position of the ad. Source TEXT The name of the connector ("google_ads") Speed score NUMERIC 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 The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Start date DATE The date when campaign started in serving customer's timezone in YYYY-MM-DD format. Geo target state name. TEXT Geo target state name. Status TEXT The status of the campaign. When a new campaign is added, the status defaults to ENABLED. Store id TEXT Store ID of the product. System serving status TEXT Serving status of the criterion. Target cpa NUMERIC The effective target CPA (cost-per-acquisition). This field is read-only. Target cpa bid source TEXT Source of the effective target CPA. This field is read-only. Target cpa cpc bid ceiling micros NUMERIC 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 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 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 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 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 Frequency count representing how many times you want to reach a single user. Target cpm target frequency goal time unit TEXT Time window expressing the period over which you want to reach the specified target_count. Target impression share cpc bid ceiling micros NUMERIC 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 The targeted location on the search results page. Target impression share location fraction micros NUMERIC The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. Target roas NUMERIC 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 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 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 The chosen revenue (based on conversion data) per unit of spend. Target spend cpc bid ceiling micros NUMERIC 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 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 URL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL. Targeting location BOOLEAN Indicates whether location was targeted or not. Targeting setting target restrictions TEXT The per-targeting-dimension setting to restrict the reach of your campaign or ad group. Taxonomy type TEXT Taxonomy type of the user interest. Test account BOOLEAN Whether the customer is a test account. Text label background color TEXT Background color of the label in RGB format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. Text label description TEXT A short description of the label. The length must be no more than 200 characters. Time zone TEXT The local timezone ID of the customer. Top impression percentage NUMERIC The percent of your ad impressions that are shown anywhere above the organic search results. Top of page cpc NUMERIC 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 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 The Topic Constant resource name. Total amount NUMERIC 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 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 Cost NUMERIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Tracking setting tracking url TEXT The url used for dynamic tracking. Tracking url template TEXT The URL template for constructing a tracking URL. Transactionrevenue NUMERIC The value of all conversions. Transactions NUMERIC 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 The Travel account ID associated with the Travel campaign. Type TEXT The type of the ad group. Url custom parameters TEXT 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 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 Availability information of the user interest. User interest id NUMERIC The ID of the user interest. User interest launched to all BOOLEAN True if the user interest is launched to all channels and locales. User interest name TEXT The name of the user interest. User interest parent TEXT The parent of the user interest. User interest resource name TEXT 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 Taxonomy type of the user interest. User interest user interest category TEXT The UserInterest resource name. User interest user interest id NUMERIC The ID of the user interest. User interest user interest parent TEXT The parent of the user interest. User list access reason TEXT 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 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 Actions associated with this user list. User list closing reason TEXT 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 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 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 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 Description of this user list. User list eligible for display BOOLEAN Indicates this user list is eligible for Google Display Network. This field is read-only. User list eligible for search BOOLEAN Indicates if this user list is eligible for Google Search Network. User list id NUMERIC Id of the user list. User list integration code TEXT 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 Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list. User list match rate percentage NUMERIC 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 Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list. User list membership status TEXT 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 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 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 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 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 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 Operator that defines how the inclusive operands are combined. User list rule based user list prepopulation status TEXT 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 Seed UserList from which this list is derived. User list size for display NUMERIC 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 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 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 Size range in terms of number of users of the UserList, for Search ads. This field is read-only. User list type TEXT Type of this list. This field is read-only. User list user list TEXT The User List resource name. User location view country criterion id NUMERIC Criterion Id for the country. Geo target country (User Location View) COUNTRY The country of the user's actual physical location by targeted or not targeted location (User Location View). User location view targeting location BOOLEAN Indicates whether location was targeted or not. Valid accelerated mobile pages clicks percentage NUMERIC The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. Value per all conversion NUMERIC The value of all conversions divided by the number of all conversions. Value per all conversions NUMERIC The value of all conversions divided by the number of all conversions. Value per all conversions by conversion date NUMERIC 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 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 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 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 The display mode for vanity pharma URLs. Vanity pharma vanity pharma text 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 The Topic Constant resource name. Video brand safety suitability TEXT 3-Tier Brand Safety setting for the campaign. Video quartile100 rate NUMERIC Percentage of impressions where the viewer watched all of your video. Video quartile25 rate NUMERIC Percentage of impressions where the viewer watched 25% of your video. Video quartile50 rate NUMERIC Percentage of impressions where the viewer watched 50% of your video. Video quartile75 rate NUMERIC Percentage of impressions where the viewer watched 75% of your video. Video quartile p100 rate NUMERIC Percentage of impressions where the viewer watched all of your video. Video quartile p25 rate NUMERIC Percentage of impressions where the viewer watched 25% of your video. Video quartile p50 rate NUMERIC Percentage of impressions where the viewer watched 50% of your video. Video quartile p75 rate NUMERIC Percentage of impressions where the viewer watched 75% of your video. Video view rate NUMERIC 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 The number of times your video ads were viewed. View through conversions NUMERIC 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 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 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 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 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 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 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 Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. Webpage conditions TEXT Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. Webpage coverage percentage NUMERIC 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 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 urls Week TEXT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. Year TEXT Year, formatted as yyyy. Youtube channel channel id TEXT The YouTube uploader channel id or the channel code of a YouTube channel. Youtube video video id TEXT YouTube video id as it appears on the YouTube watch page. Today DATE Today's date
Easily connect Google Ads to Looker Studio
See the value and return on every marketing touchpoint

Providing 50+ marketing data streams, we make sure that all the data we integrate is fresh and accessible by marketers, whenever they want.

Spend less time on manual data loading and spreadsheets. Focus on delighting your customers.