> For the complete documentation index, see [llms.txt](https://docs.roivenue.com/roivenue-resources/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roivenue.com/roivenue-resources/roivenue-training/roivenue-app/data/connectors-overview/list-of-connectors/google-ads/google-ads-supported-columns.md). # Google Ads - Supported Columns Every column the Google Ads connector can download. These are the columns available to a Google Ads connector. The recommended template uses a small subset, listed on the [Google Ads](/roivenue-resources/roivenue-training/roivenue-app/data/connectors-overview/list-of-connectors/google-ads.md) page. The rest can be added to a connector through the Advanced Editor, which stops that connector receiving template updates. Column names follow the Google Ads API, so a name here matches what Google's own documentation calls it. ## Metrics | Column | Type | Description | | ------------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `absolute_top_impression_percentage` | | The percent of your ad impressions that are shown as the very first ad above the organic search results. | | `active_view_cpm` | Double | Average cost of viewable impressions (active\_view\_impressions). | | `active_view_ctr` | Double | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. | | `active_view_impressions` | Long | A measurement of how often your ad has become viewable on a Display Network site. | | `active_view_measurability` | Double | The ratio of impressions that could be measured by Active View over the number of served impressions. | | `active_view_measurable_cost_micros` | Long | The cost of the impressions you received that were measurable by Active View. | | `active_view_measurable_impressions` | Long | The number of times your ads are appearing on placements in positions where they can be seen. | | `active_view_viewability` | Double | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | | `all_conversions` | Double | The total number of conversions. This includes all conversions regardless of the value of include\_in\_conversions\_metric. | | `all_conversions_by_conversion_date` | Double | 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 . | | `all_conversions_from_click_to_call` | Double | 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` | Double | 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` | Double | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. | | `all_conversions_from_interactions_value_per_interaction` | Double | The value of all conversions from interactions divided by the total number of interactions. | | `all_conversions_from_location_asset_click_to_call` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. | | `all_conversions_from_store_website` | Double | 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` | Double | The value of all conversions. | | `all_conversions_value_by_conversion_date` | Double | 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 . | | `all_conversions_value_per_cost` | Double | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). | | `all_new_customer_lifetime_value` | Double | All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "all\_conversions\_value". See for more details. | | `auction_insight_search_absolute_top_impression_percentage` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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. | | `average_cart_size` | Double | Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. | | `average_cost` | Double | 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` | Double | The total cost of all clicks divided by the total number of clicks received. | | `average_cpe` | Double | 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` | Double | Average cost-per-thousand impressions (CPM). | | `trueview_average_cpv` | Double | 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 TrueView views. | | `average_impression_frequency_per_user` | Double | The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. | | `average_order_value_micros` | Long | Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. | | `average_page_views` | Double | Average number of pages viewed per session. | | `average_target_cpa_micros` | Long | 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` | Double | 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` | Double | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. | | `benchmark_average_max_cpc` | Double | An indication of how other advertisers are bidding on similar products. | | `benchmark_ctr` | Double | An indication on how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad click on it. | | `biddable_app_install_conversions` | Double | Number of app installs. | | `biddable_app_post_install_conversions` | Double | Number of in-app actions. | | `bounce_rate` | Double | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. | | `clicks` | Long | The number of clicks. | | `combined_clicks` | Long | The number of times your ad or your site's listing in the unpaid results was clicked. See the help page at for details. | | `combined_clicks_per_query` | Double | The number of times your ad or your site's listing in the unpaid results was clicked (combined\_clicks) divided by combined\_queries. See the help page at for details. | | `combined_queries` | Long | The number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See the help page at for details. | | `content_budget_lost_impression_share` | Double | 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` | Double | 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_rank_lost_impression_share` | Double | 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_last_conversion_date` | DateTime | 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` | DateTime | 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 (e.g. because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone. | | `conversions` | Double | 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` | Double | 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 . | | `conversions_from_interactions_rate` | Double | 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` | Double | 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` | Double | 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` | Double | 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 . | | `conversions_value_per_cost` | Double | 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_micros` | Long | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | | `cost_of_goods_sold_micros` | Long | Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. | | `cost_per_all_conversions` | Double | The cost of ad interactions divided by all conversions. | | `cost_per_conversion` | Double | 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` | Double | 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. | | `cross_device_conversions` | Double | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all\_conversions. | | `cross_device_conversions_value_micros` | Double | The sum of the value of cross-device conversions, in micros. | | `cross_sell_cost_of_goods_sold_micros` | Long | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. | | `cross_sell_gross_profit_micros` | Long | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. | | `cross_sell_revenue_micros` | Long | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. | | `cross_sell_units_sold` | Double | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. | | `ctr` | Double | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | | `current_model_attributed_conversions` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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. | | `eligible_impressions_from_location_asset_store_reach` | Long | 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. | | `engagement_rate` | Double | 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` | Long | 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. | | `gmail_forwards` | Long | The number of times the ad was forwarded to someone else as a message. | | `gmail_saves` | Long | The number of times someone has saved your Gmail ad to their inbox as a message. | | `gmail_secondary_clicks` | Long | The number of clicks to the landing page on the expanded state of Gmail ads. | | `gross_profit_margin` | Double | Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. | | `gross_profit_micros` | Double | Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. | | `historical_creative_quality_score` | String | The creative historical quality score. | | `historical_landing_page_quality_score` | String | The quality of historical landing page experience. | | `historical_quality_score` | Long | The historical quality score. | | `historical_search_predicted_ctr` | String | The historical search predicted click through rate (CTR). | | `hotel_average_lead_value_micros` | Double | Average lead value based on clicks. | | `hotel_commission_rate_micros` | Long | Commission bid rate in micros. A 20% commission is represented as 200,000. | | `hotel_eligible_impressions` | Long | The number of impressions that hotel partners could have had given their feed performance. | | `hotel_expected_commission_cost` | Double | Expected commission cost. The result of multiplying the commission value times the hotel\_commission\_rate in advertiser currency. | | `hotel_price_difference_percentage` | Double | The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. | | `impressions` | Long | Count of how often your ad has appeared on a search results page or website on the Google Network. | | `impressions_from_store_reach` | Long | The number of times a store's location-based ad was shown. This metric applies to feed items only. | | `interaction_event_types` | String | The types of payable and free interactions. | | `interaction_rate` | Double | 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. | | `interactions` | Long | 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` | Double | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. | | `invalid_clicks` | Long | Number of clicks Google considers illegitimate and doesn't charge you for. | | `lead_cost_of_goods_sold_micros` | Long | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. | | `lead_gross_profit_micros` | Long | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. | | `lead_revenue_micros` | Long | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. | | `lead_units_sold` | Double | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. | | `message_chat_rate` | Double | 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` | Long | Number of message chats initiated for Click To Message impressions that were message tracking eligible. | | `message_impressions` | Long | Number of Click To Message impressions that were message tracking eligible. | | `mobile_friendly_clicks_percentage` | Double | The percentage of mobile clicks that go to a mobile-friendly page. | | `new_customer_lifetime_value` | Double | New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversions\_value" for optimization. See for more details. | | `optimization_score_uplift` | Double | Total optimization score uplift of all recommendations. | | `optimization_score_url` | String | 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. | | `orders` | Double | Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. | | `organic_clicks` | Long | The number of times someone clicked your site's listing in the unpaid results for a particular query. See the help page at for details. | | `organic_clicks_per_query` | Double | The number of times someone clicked your site's listing in the unpaid results (organic\_clicks) divided by the total number of searches that returned pages from your site (organic\_queries). See the help page at for details. | | `organic_impressions` | Long | The number of listings for your site in the unpaid search results. See the help page at for details. | | `organic_impressions_per_query` | Double | The number of times a page from your site was listed in the unpaid search results (organic\_impressions) divided by the number of searches returning your site's listing in the unpaid results (organic\_queries). See the help page at for details. | | `organic_queries` | Long | The total number of searches that returned your site's listing in the unpaid results. See the help page at for details. | | `percent_new_visitors` | Double | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. | | `phone_calls` | Long | Number of offline phone calls. | | `phone_impressions` | Long | Number of offline phone impressions. | | `phone_through_rate` | Double | Number of phone calls received (phone\_calls) divided by the number of times your phone number is shown (phone\_impressions). | | `publisher_organic_clicks` | Long | Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity | | `publisher_purchased_clicks` | Long | 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` | Long | Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" | | `relative_ctr` | Double | 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. | | `revenue_micros` | Long | Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. | | `search_absolute_top_impression_share` | Double | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See for details. Any value below 0.1 is reported as 0.0999. | | `search_budget_lost_absolute_top_impression_share` | Double | 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` | Double | 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` | Double | 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` | Double | 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_exact_match_impression_share` | Double | 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` | Double | 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_rank_lost_absolute_top_impression_share` | Double | 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` | Double | 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` | Double | 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_top_impression_share` | Double | 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. | | `search_volume` | String | Search volume range for a search term insight category. | | `sk_ad_network_installs` | Long | The number of iOS Store Kit Ad Network conversions. | | `sk_ad_network_total_conversions` | Long | The total number of iOS Store Kit Ad Network conversions. | | `speed_score` | Long | 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. | | `top_impression_percentage` | Double | The percent of your ad impressions that are shown anywhere above the organic search results. | | `unique_users` | Long | The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. | | `units_sold` | Double | Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. | | `valid_accelerated_mobile_pages_clicks_percentage` | Double | The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. | | `value_per_all_conversions` | Double | The value of all conversions divided by the number of all conversions. | | `value_per_all_conversions_by_conversion_date` | Double | 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 . | | `value_per_conversion` | Double | 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` | Double | 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 . | | `value_per_current_model_attributed_conversion` | Double | 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. | | `video_quartile_p100_rate` | Double | Percentage of impressions where the viewer watched all of your video. | | `video_quartile_p25_rate` | Double | Percentage of impressions where the viewer watched 25% of your video. | | `video_quartile_p50_rate` | Double | Percentage of impressions where the viewer watched 50% of your video. | | `video_quartile_p75_rate` | Double | Percentage of impressions where the viewer watched 75% of your video. | | `video_trueview_view_rate` | Double | The number of TrueView views your video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | | `video_trueview_views` | Long | The number of TrueView views your video ads received. | | `view_through_conversions` | Long | 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 (e.g., clicking on) another ad. | | `view_through_conversions_from_location_asset_click_to_call` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | 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` | Double | Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. | ## Segments Segments split the figures by a dimension such as date, device or network. | Column | Type | Description | | ------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `activity_account_id` | Long | Activity account ID. | | `activity_city` | String | The city where the travel activity is available. | | `activity_country` | String | The country where the travel activity is available. | | `activity_rating` | Long | Activity rating. | | `activity_state` | String | The state where the travel activity is available. | | `ad_destination_type` | String | Ad Destination type. | | `ad_group` | String | Resource name of the ad group. | | `ad_network_type` | String | Ad network type. | | `asset_group` | String | Resource name of the asset group. | | `asset_interaction_target.asset` | String | 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` | String | Domain (visible URL) of a participant in the Auction Insights report. | | `budget_campaign_association_status.campaign` | String | The campaign resource name. | | `budget_campaign_association_status.status` | String | Budget campaign association status. | | `campaign` | String | Resource name of the campaign. | | `click_type` | String | Click type. | | `conversion_action` | String | Resource name of the conversion action. | | `conversion_action_category` | String | Conversion action category. | | `conversion_action_name` | String | Conversion action name. | | `conversion_adjustment` | Boolean | This segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data. | | `conversion_attribution_event_type` | String | Conversion attribution event type. | | `conversion_lag_bucket` | String | An enum value representing the number of days between the impression and the conversion. | | `conversion_or_adjustment_lag_bucket` | String | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. | | `conversion_value_rule_primary_dimension` | String | 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. | | `date` | DateTime | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. | | `day_of_week` | String | Day of the week, e.g., MONDAY. | | `device` | String | Device to which metrics apply. | | `external_activity_id` | String | Advertiser supplied activity ID. | | `external_conversion_source` | String | External conversion source. | | `geo_target_airport` | String | Resource name of the geo target constant that represents an airport. | | `geo_target_canton` | String | Resource name of the geo target constant that represents a canton. | | `geo_target_city` | String | Resource name of the geo target constant that represents a city. | | `geo_target_country` | String | Resource name of the geo target constant that represents a country. | | `geo_target_county` | String | Resource name of the geo target constant that represents a county. | | `geo_target_district` | String | Resource name of the geo target constant that represents a district. | | `geo_target_metro` | String | Resource name of the geo target constant that represents a metro. | | `geo_target_most_specific_location` | String | Resource name of the geo target constant that represents the most specific location. | | `geo_target_postal_code` | String | Resource name of the geo target constant that represents a postal code. | | `geo_target_province` | String | Resource name of the geo target constant that represents a province. | | `geo_target_region` | String | Resource name of the geo target constant that represents a region. | | `geo_target_state` | String | Resource name of the geo target constant that represents a state. | | `hotel_booking_window_days` | Long | Hotel booking window in days. | | `hotel_center_id` | Long | Hotel center ID. | | `hotel_check_in_date` | DateTime | Hotel check-in date. Formatted as yyyy-MM-dd. | | `hotel_check_in_day_of_week` | String | Hotel check-in day of week. | | `hotel_city` | String | Hotel city. | | `hotel_class` | Int | Hotel class. | | `hotel_country` | String | Hotel country. | | `hotel_date_selection_type` | String | Hotel date selection type. | | `hotel_length_of_stay` | Int | Hotel length of stay. | | `hotel_price_bucket` | String | Hotel price bucket. | | `hotel_rate_rule_id` | String | Hotel rate rule ID. | | `hotel_rate_type` | String | Hotel rate type. | | `hotel_state` | String | Hotel state. | | `hour` | Int | Hour of day as a number between 0 and 23, inclusive. | | `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. | | `keyword.ad_group_criterion` | String | The AdGroupCriterion resource name. | | `keyword.info.match_type` | String | The match type of the keyword. | | `keyword.info.text` | String | The text of the keyword (at most 80 characters and 10 words). | | `month` | DateTime | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. | | `month_of_year` | String | Month of the year, e.g., January. | | `new_versus_returning_customers` | String | This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. | | `partner_hotel_id` | String | Partner hotel ID. | | `placeholder_type` | String | Placeholder type. This is only used with feed item metrics. | | `product_aggregator_id` | Long | Aggregator ID of the product. | | `product_brand` | String | Brand of the product. | | `product_category_level1` | String | Category (level 1) of the product. | | `product_category_level2` | String | Category (level 2) of the product. | | `product_category_level3` | String | Category (level 3) of the product. | | `product_category_level4` | String | Category (level 4) of the product. | | `product_category_level5` | String | Category (level 5) of the product. | | `product_channel` | String | Channel of the product. | | `product_channel_exclusivity` | String | Channel exclusivity of the product. | | `product_condition` | String | Condition of the product. | | `product_country` | String | Resource name of the geo target constant for the country of sale of the product. | | `product_custom_attribute0` | String | Custom attribute 0 of the product. | | `product_custom_attribute1` | String | Custom attribute 1 of the product. | | `product_custom_attribute2` | String | Custom attribute 2 of the product. | | `product_custom_attribute3` | String | Custom attribute 3 of the product. | | `product_custom_attribute4` | String | Custom attribute 4 of the product. | | `product_feed_label` | String | Feed label of the product. | | `product_item_id` | String | Item ID of the product. | | `product_language` | String | Resource name of the language constant for the language of the product. | | `product_merchant_id` | Long | Merchant ID of the product. | | `product_store_id` | String | Store ID of the product. | | `product_title` | String | Title of the product. | | `product_type_l1` | String | Type (level 1) of the product. | | `product_type_l2` | String | Type (level 2) of the product. | | `product_type_l3` | String | Type (level 3) of the product. | | `product_type_l4` | String | Type (level 4) of the product. | | `product_type_l5` | String | Type (level 5) of the product. | | `quarter` | DateTime | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. | | `recommendation_type` | String | Recommendation type. | | `search_engine_results_page_type` | String | Type of the search engine results page. | | `search_subcategory` | String | A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory. | | `search_term` | String | A search term. | | `search_term_match_type` | String | Match type of the keyword that triggered the ad, including variants. | | `sk_ad_network_ad_event_type` | String | iOS Store Kit Ad Network ad event type. | | `sk_ad_network_attribution_credit` | String | iOS Store Kit Ad Network attribution credit | | `sk_ad_network_coarse_conversion_value` | String | iOS Store Kit Ad Network coarse conversion value. | | `sk_ad_network_fine_conversion_value` | Long | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign. | | `sk_ad_network_postback_sequence_index` | Long | iOS Store Kit Ad Network postback sequence index. | | `sk_ad_network_source_app.sk_ad_network_source_app_id` | String | App id where the ad that drove the iOS Store Kit Ad Network install was shown. | | `sk_ad_network_source_domain` | String | Website where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. | | `sk_ad_network_source_type` | String | The source type where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or neither source domain nor source app were present in any postbacks sent by Apple. | | `sk_ad_network_user_type` | String | iOS Store Kit Ad Network user type. | | `slot` | String | Position of the ad. | | `webpage` | String | Resource name of the ad group criterion that represents webpage criterion. | | `week` | DateTime | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. | | `year` | Int | Year, formatted as yyyy. | ## Resource fields Attributes of the campaign, ad group, ad and other objects. Which of these are available depends on the report type the connector reads. | Column | Type | Description | | ----------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ad_group.ad_rotation_mode` | String | The ad rotation mode of the ad group. | | `ad_group.audience_setting.use_audience_grouped` | Boolean | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. | | `ad_group.base_ad_group` | String | Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. | | `ad_group.campaign` | String | Immutable. The campaign to which the ad group belongs. | | `ad_group.cpc_bid_micros` | Long | The maximum CPC (cost-per-click) bid. | | `ad_group.cpm_bid_micros` | Long | The maximum CPM (cost-per-thousand viewable impressions) bid. | | `ad_group.cpv_bid_micros` | Long | Output only. The CPV (cost-per-view) bid. | | `ad_group.display_custom_bid_dimension` | String | 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. | | `ad_group.effective_cpc_bid_micros` | Long | Output only. 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.effective_target_cpa_micros` | Long | Output only. The effective target CPA (cost-per-acquisition). This field is read-only. | | `ad_group.effective_target_cpa_source` | String | Output only. Source of the effective target CPA. This field is read-only. | | `ad_group.effective_target_roas` | Double | Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. | | `ad_group.effective_target_roas_source` | String | Output only. Source of the effective target ROAS. This field is read-only. | | `ad_group.excluded_parent_asset_field_types` | Other | 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` | String | 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.final_url_suffix` | String | URL template for appending params to Final URL. | | `ad_group.id` | Long | Output only. The ID of the ad group. | | `ad_group.labels` | Other | Output only. The resource names of labels attached to this ad group. | | `ad_group.name` | String | 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` | Long | The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is \[0,1) and the value stored here is 1,000,000 \* \[fraction]. | | `ad_group.primary_status` | String | Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. | | `ad_group.primary_status_reasons` | String | Output only. Provides reasons for why an ad group is not serving or not serving optimally. | | `ad_group.resource_name` | String | Immutable. The resource name of the ad group. Ad group resource names have the form: customers/{customer\_id}/adGroups/{ad\_group\_id} | | `ad_group.status` | String | The status of the ad group. | | `ad_group.target_cpa_micros` | Long | 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` | Long | Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. | | `ad_group.target_roas` | Double | 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.targeting_setting.target_restrictions` | Other | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. | | `ad_group.tracking_url_template` | String | The URL template for constructing a tracking URL. | | `ad_group.type` | String | Immutable. The type of the ad group. | | `ad_group.url_custom_parameters` | Other | The list of mappings used to substitute custom parameter tags in a tracking\_url\_template, final\_urls, or mobile\_final\_urls. | | `ad_group_ad.action_items` | Other | Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.". | | `ad_group_ad.ad.added_by_google_ads` | Boolean | Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. | | `ad_group_ad.ad.app_ad.descriptions` | Other | 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` | Other | 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` | Other | List of media bundle assets that may be used with the ad. | | `ad_group_ad.ad.app_ad.html5_media_bundles.asset` | String | The Asset resource name of this media bundle. | | `ad_group_ad.ad.app_ad.images` | Other | List of image assets that may be displayed with the ad. | | `ad_group_ad.ad.app_ad.images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.app_ad.mandatory_ad_text` | String | Mandatory ad text. | | `ad_group_ad.ad.app_ad.youtube_videos` | Other | List of YouTube video assets that may be displayed with the ad. | | `ad_group_ad.ad.app_ad.youtube_videos.asset` | String | The Asset resource name of this video. | | `ad_group_ad.ad.app_engagement_ad.descriptions` | Other | 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` | Other | 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` | Other | List of image assets that may be displayed with the ad. | | `ad_group_ad.ad.app_engagement_ad.images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.app_engagement_ad.videos` | Other | List of video assets that may be displayed with the ad. | | `ad_group_ad.ad.app_engagement_ad.videos.asset` | String | The Asset resource name of this video. | | `ad_group_ad.ad.app_pre_registration_ad.descriptions` | Other | 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` | Other | 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` | Other | List of image asset IDs whose images may be displayed with the ad. | | `ad_group_ad.ad.app_pre_registration_ad.images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.app_pre_registration_ad.youtube_videos` | Other | 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` | String | The Asset resource name of this video. | | `ad_group_ad.ad.call_ad.business_name` | String | 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` | String | 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` | String | 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` | String | The country code in the ad. | | `ad_group_ad.ad.call_ad.description1` | String | The first line of the ad's description. | | `ad_group_ad.ad.call_ad.description2` | String | 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` | String | First headline in the ad. | | `ad_group_ad.ad.call_ad.headline2` | String | Second headline in the ad. | | `ad_group_ad.ad.call_ad.path1` | String | First part of text that can be appended to the URL in the ad. Optional. | | `ad_group_ad.ad.call_ad.path2` | String | 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` | String | The phone number in the ad. | | `ad_group_ad.ad.call_ad.phone_number_verification_url` | String | The URL to be used for phone number verification. | | `ad_group_ad.ad.demand_gen_product_ad.breadcrumb1` | String | First part of text that appears in the ad with the displayed URL. | | `ad_group_ad.ad.demand_gen_product_ad.breadcrumb2` | String | Second part of text that appears in the ad with the displayed URL. | | `ad_group_ad.ad.demand_gen_product_ad.business_name` | String | Required. The advertiser/brand name. | | `ad_group_ad.ad.demand_gen_product_ad.call_to_action` | String | Asset of type CallToActionAsset used for the "Call To Action" button. | | `ad_group_ad.ad.demand_gen_product_ad.call_to_action.asset` | String | The Asset resource name of this call to action asset. | | `ad_group_ad.ad.demand_gen_product_ad.description` | String | Required. Text asset used for the description. | | `ad_group_ad.ad.demand_gen_product_ad.headline` | String | Required. Text asset used for the short headline. | | `ad_group_ad.ad.demand_gen_product_ad.logo_image` | String | Required. Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). | | `ad_group_ad.ad.demand_gen_product_ad.logo_image.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.device_preference` | String | 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, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. | | `ad_group_ad.ad.demand_gen_carousel_ad.business_name` | String | Required. The Advertiser/brand name. | | `ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text` | String | Call to action text. | | `ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards` | String | Required. Carousel cards that will display with the ad. Min 2 max 10. | | `ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards.asset` | String | The Asset resource name of this discovery carousel card. | | `ad_group_ad.ad.demand_gen_carousel_ad.description` | String | Required. The descriptive text of the ad. | | `ad_group_ad.ad.demand_gen_carousel_ad.headline` | String | Required. Headline of the ad. | | `ad_group_ad.ad.demand_gen_carousel_ad.logo_image` | String | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). | | `ad_group_ad.ad.demand_gen_carousel_ad.logo_image.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.business_name` | String | The Advertiser/brand name. Maximum display width is 25. Required. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text` | String | Call to action text. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions` | String | The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.headlines` | String | Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.lead_form_only` | Boolean | Boolean option that indicates if this ad must be served with lead form. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images` | String | Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images` | String | Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square\_marketing\_images is not present. Combined with square\_marketing\_images and portrait\_marketing\_images the maximum is 20. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images` | String | Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing\_images and square\_marketing\_images the maximum is 20. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images` | String | Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing\_images is not present. Combined with marketing\_images and portrait\_marketing\_images the maximum is 20. | | `ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1` | String | First part of text that appears in the ad with the displayed URL. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2` | String | Second part of text that appears in the ad with the displayed URL. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.business_name` | String | Required. The advertiser/brand name. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions` | String | Assets of type CallToActionAsset used for the "Call To Action" button. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions.asset` | String | The Asset resource name of this call to action asset. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions` | String | List of text assets used for the description. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.headlines` | String | List of text assets used for the short headline. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images` | String | Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). | | `ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines` | String | List of text assets used for the long headline. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.videos` | String | List of YouTube video assets used for the ad. | | `ad_group_ad.ad.demand_gen_video_responsive_ad.videos.asset` | String | The Asset resource name of this video. | | `ad_group_ad.ad.display_upload_ad.display_upload_product_type` | String | The product type of this ad. See comments on the enum for details. | | `ad_group_ad.ad.display_upload_ad.media_bundle` | String | A media bundle asset to be used in the ad. For information about the media bundle for HTML5\_UPLOAD\_AD, see Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See for more information. | | `ad_group_ad.ad.display_upload_ad.media_bundle.asset` | String | The Asset resource name of this media bundle. | | `ad_group_ad.ad.display_url` | String | The URL that appears in the ad description for some ad formats. | | `ad_group_ad.ad.expanded_dynamic_search_ad.description` | String | The description of the ad. | | `ad_group_ad.ad.expanded_dynamic_search_ad.description2` | String | The second description of the ad. | | `ad_group_ad.ad.expanded_text_ad.description` | String | The description of the ad. | | `ad_group_ad.ad.expanded_text_ad.description2` | String | The second description of the ad. | | `ad_group_ad.ad.expanded_text_ad.headline_part1` | String | The first part of the ad's headline. | | `ad_group_ad.ad.expanded_text_ad.headline_part2` | String | The second part of the ad's headline. | | `ad_group_ad.ad.expanded_text_ad.headline_part3` | String | The third part of the ad's headline. | | `ad_group_ad.ad.expanded_text_ad.path1` | String | The text that can appear alongside the ad's displayed URL. | | `ad_group_ad.ad.expanded_text_ad.path2` | String | Additional text that can appear alongside the ad's displayed URL. | | `ad_group_ad.ad.final_app_urls` | Other | 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` | Other | The list of possible final mobile URLs after all cross-domain redirects for the ad. | | `ad_group_ad.ad.final_url_suffix` | String | The suffix to use when constructing a final URL. | | `ad_group_ad.ad.final_urls` | Other | The list of possible final URLs after all cross-domain redirects for the ad. | | `ad_group_ad.ad.hotel_ad` | String | Details pertaining to a hotel ad. | | `ad_group_ad.ad.id` | Long | Output only. The ID of the ad. | | `ad_group_ad.ad.image_ad.image_asset.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.image_ad.image_url` | String | URL of the full size image. | | `ad_group_ad.ad.image_ad.mime_type` | String | The mime type of the image. | | `ad_group_ad.ad.image_ad.name` | String | 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` | Long | Height in pixels of the full size image. | | `ad_group_ad.ad.image_ad.pixel_width` | Long | Width in pixels of the full size image. | | `ad_group_ad.ad.image_ad.preview_image_url` | String | URL of the preview size image. | | `ad_group_ad.ad.image_ad.preview_pixel_height` | Long | Height in pixels of the preview size image. | | `ad_group_ad.ad.image_ad.preview_pixel_width` | Long | Width in pixels of the preview size image. | | `ad_group_ad.ad.legacy_app_install_ad` | String | Immutable. Details pertaining to a legacy app install ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.accent_color` | String | The accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main\_color and accent\_color is set, the other is required as well. | | `ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_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` | String | The business name in the ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_text` | String | The call-to-action text for the ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.description` | String | The description of the ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.format_setting` | String | Specifies which format the ad will be served in. Default is ALL\_FORMATS. | | `ad_group_ad.ad.legacy_responsive_display_ad.logo_image` | String | The MediaFile resource name of the logo image used in the ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.long_headline` | String | The long version of the ad's headline. | | `ad_group_ad.ad.legacy_responsive_display_ad.main_color` | String | The main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main\_color and accent\_color is set, the other is required as well. | | `ad_group_ad.ad.legacy_responsive_display_ad.marketing_image` | String | The MediaFile resource name of the marketing image used in the ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.price_prefix` | String | Prefix before price. E.g. 'as low as'. | | `ad_group_ad.ad.legacy_responsive_display_ad.promo_text` | String | 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` | String | The short version of the ad's headline. | | `ad_group_ad.ad.legacy_responsive_display_ad.square_logo_image` | String | The MediaFile resource name of the square logo image used in the ad. | | `ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_image` | String | The MediaFile resource name of the square marketing image used in the ad. | | `ad_group_ad.ad.local_ad.call_to_actions` | Other | List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. Call-to-actions are optional and at most 5 can be specified. | | `ad_group_ad.ad.local_ad.descriptions` | Other | 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` | Other | 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` | Other | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.local_ad.marketing_images` | Other | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.local_ad.path1` | String | First part of optional text that can be appended to the URL in the ad. | | `ad_group_ad.ad.local_ad.path2` | String | 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` | Other | List of YouTube video assets that may be displayed with the ad. Videos are optional and at most 20 can be specified. | | `ad_group_ad.ad.local_ad.videos.asset` | String | The Asset resource name of this video. | | `ad_group_ad.ad.name` | String | Immutable. 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` | String | Immutable. 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` | String | The accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main\_color and accent\_color is set, the other is required as well. | | `ad_group_ad.ad.responsive_display_ad.allow_flexible_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` | String | The advertiser/brand name. Maximum display width is 25. | | `ad_group_ad.ad.responsive_display_ad.call_to_action_text` | String | 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` | Other | 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` | String | Specifies which format the ad will be served in. Default is ALL\_FORMATS. | | `ad_group_ad.ad.responsive_display_ad.headlines` | Other | 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` | Other | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.responsive_display_ad.long_headline` | String | A required long format headline. The maximum length is 90 characters. | | `ad_group_ad.ad.responsive_display_ad.main_color` | String | The main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main\_color and accent\_color is set, the other is required as well. | | `ad_group_ad.ad.responsive_display_ad.marketing_images` | Other | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.responsive_display_ad.price_prefix` | String | Prefix before price. E.g. 'as low as'. | | `ad_group_ad.ad.responsive_display_ad.promo_text` | String | 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` | Other | Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with square\_logo\_images, the maximum is 5. | | `ad_group_ad.ad.responsive_display_ad.square_logo_images.asset` | String | The Asset resource name of this image. | | `ad_group_ad.ad.responsive_display_ad.square_marketing_images` | Other | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.responsive_display_ad.youtube_videos` | Other | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. | | `ad_group_ad.ad.responsive_display_ad.youtube_videos.asset` | String | The Asset resource name of this video. | | `ad_group_ad.ad.responsive_search_ad.descriptions` | Other | 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` | Other | 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` | String | First part of text that can be appended to the URL in the ad. | | `ad_group_ad.ad.responsive_search_ad.path2` | String | 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` | String | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. | | `ad_group_ad.ad.shopping_product_ad` | String | Details pertaining to a Shopping product ad. | | `ad_group_ad.ad.shopping_smart_ad` | String | Details pertaining to a Smart Shopping ad. | | `ad_group_ad.ad.smart_campaign_ad.descriptions` | Other | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified. | | `ad_group_ad.ad.smart_campaign_ad.headlines` | Other | List of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified. | | `ad_group_ad.ad.system_managed_resource_source` | String | Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. | | `ad_group_ad.ad.text_ad.description1` | String | The first line of the ad's description. | | `ad_group_ad.ad.text_ad.description2` | String | The second line of the ad's description. | | `ad_group_ad.ad.text_ad.headline` | String | The headline of the ad. | | `ad_group_ad.ad.tracking_url_template` | String | The URL template for constructing a tracking URL. | | `ad_group_ad.ad.travel_ad` | String | Details pertaining to a travel ad. | | `ad_group_ad.ad.type` | String | Output only. The type of ad. | | `ad_group_ad.ad.url_collections` | Other | 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` | Other | 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, please use url custom parameter operations. | | `ad_group_ad.ad.video_ad.bumper.action_button_label` | String | 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` | String | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.video_ad.in_feed.description1` | String | First text line for the ad. | | `ad_group_ad.ad.video_ad.in_feed.description2` | String | Second text line for the ad. | | `ad_group_ad.ad.video_ad.in_feed.headline` | String | The headline of the ad. | | `ad_group_ad.ad.video_ad.in_feed.thumbnail` | String | Video thumbnail image to use. | | `ad_group_ad.ad.video_ad.in_stream.action_button_label` | String | 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` | String | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.video_ad.non_skippable.action_button_label` | String | 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` | String | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.video_ad.out_stream.description` | String | The description line. | | `ad_group_ad.ad.video_ad.out_stream.headline` | String | The headline of the ad. | | `ad_group_ad.ad.video_ad.video.asset` | String | The Asset resource name of this video. | | `ad_group_ad.ad.video_responsive_ad.breadcrumb1` | String | First part of text that appears in the ad with the displayed URL. | | `ad_group_ad.ad.video_responsive_ad.breadcrumb2` | String | Second part of text that appears in the ad with the displayed URL. | | `ad_group_ad.ad.video_responsive_ad.call_to_actions` | Other | List of text assets used for the button, e.g. the "Call To Action" button. Currently, only a single value for the button is supported. | | `ad_group_ad.ad.video_responsive_ad.companion_banners` | Other | 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` | String | The Asset resource name of this image. | | `ad_group_ad.ad.video_responsive_ad.descriptions` | Other | 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` | Other | List of text assets used for the short headline, e.g. the "Call To Action" banner. Currently, only a single value for the short headline is supported. | | `ad_group_ad.ad.video_responsive_ad.long_headlines` | Other | 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` | Other | 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` | String | The Asset resource name of this video. | | `ad_group_ad.ad_group` | String | Immutable. The ad group to which the ad belongs. | | `ad_group_ad.ad_strength` | String | Output only. Overall ad strength for this ad group ad. | | `ad_group_ad.labels` | Other | Output only. The resource names of labels attached to this ad group ad. | | `ad_group_ad.policy_summary.approval_status` | String | Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. | | `ad_group_ad.policy_summary.policy_topic_entries` | Other | Output only. The list of policy findings for this ad. | | `ad_group_ad.policy_summary.review_status` | String | Output only. Where in the review process this ad is. | | `ad_group_ad.primary_status` | String | Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally. | | `ad_group_ad.primary_status_reasons` | String | Output only. Provides reasons for why an ad group ad is not serving or not serving optimally. | | `ad_group_ad.resource_name` | String | Immutable. 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` | String | The status of the ad. | | `ad_group_ad_asset_combination_view.enabled` | Boolean | Output only. The status between the asset combination and the latest version of the ad. If true, the asset combination is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad. | | `ad_group_ad_asset_combination_view.resource_name` | String | Output only. The resource name of the ad group ad asset combination view. The combination ID is 128 bits long, where the upper 64 bits are stored in asset\_combination\_id\_high, and the lower 64 bits are stored in asset\_combination\_id\_low. AdGroupAd Asset Combination view resource names have the form: customers/{customer\_id}/adGroupAdAssetCombinationViews/{AdGroupAd.ad\_group\_id}~~{AdGroupAd.ad.ad\_id}~~{AssetCombination.asset\_combination\_id\_low}\~{AssetCombination.asset\_combination\_id\_high} | | `ad_group_ad_asset_combination_view.served_assets` | String | Output only. Served assets. | | `ad_group_ad_asset_view.ad_group_ad` | String | Output only. The ad group ad to which the asset is linked. | | `ad_group_ad_asset_view.asset` | String | Output only. The asset which is linked to the ad group ad. | | `ad_group_ad_asset_view.enabled` | Boolean | Output only. The status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad. | | `ad_group_ad_asset_view.field_type` | String | Output only. Role that the asset takes in the ad. | | `ad_group_ad_asset_view.performance_label` | String | Output only. Performance of an asset linkage. | | `ad_group_ad_asset_view.pinned_field` | String | Output only. Pinned field. | | `ad_group_ad_asset_view.policy_summary` | String | Output only. Policy information for the ad group ad asset. | | `ad_group_ad_asset_view.resource_name` | String | Output only. The resource name of the ad group ad asset view. Ad group ad asset view resource names have the form (Before V4): customers/{customer\_id}/adGroupAdAssets/{AdGroupAdAsset.ad\_group\_id}~~{AdGroupAdAsset.ad.ad\_id}~~{AdGroupAdAsset.asset\_id}~~{AdGroupAdAsset.field\_type} Ad group ad asset view resource names have the form (Beginning from V4): customers/{customer\_id}/adGroupAdAssetViews/{AdGroupAdAsset.ad\_group\_id}~~{AdGroupAdAsset.ad\_id}~~{AdGroupAdAsset.asset\_id}~~{AdGroupAdAsset.field\_type} | | `ad_group_ad_asset_view.source` | String | Output only. Source of the ad group ad asset. | | `ad_group_asset.ad_group` | String | Required. Immutable. The ad group to which the asset is linked. | | `ad_group_asset.asset` | String | Required. Immutable. The asset which is linked to the ad group. | | `ad_group_asset.field_type` | String | Required. Immutable. Role that the asset takes under the linked ad group. | | `ad_group_asset.primary_status` | String | Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state. | | `ad_group_asset.primary_status_details` | String | Output only. Provides the details of the primary status and its associated reasons. | | `ad_group_asset.primary_status_reasons` | String | Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity. | | `ad_group_asset.resource_name` | String | Immutable. The resource name of the ad group asset. AdGroupAsset resource names have the form: customers/{customer\_id}/adGroupAssets/{ad\_group\_id}~~{asset\_id}~~{field\_type} | | `ad_group_asset.source` | String | Output only. Source of the adgroup asset link. | | `ad_group_asset.status` | String | Status of the ad group asset. | | `ad_group_audience_view.resource_name` | String | Output only. The resource name of the ad group audience view. Ad group audience view resource names have the form: customers/{customer\_id}/adGroupAudienceViews/{ad\_group\_id}\~{criterion\_id} | | `ad_schedule_view.resource_name` | String | Output only. The resource name of the ad schedule view. AdSchedule view resource names have the form: customers/{customer\_id}/adScheduleViews/{campaign\_id}\~{criterion\_id} | | `age_range_view.resource_name` | String | Output only. 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} | | `asset_field_type_view.field_type` | String | Output only. The asset field type of the asset field type view. | | `asset_field_type_view.resource_name` | String | Output only. The resource name of the asset field type view. Asset field type view resource names have the form: customers/{customer\_id}/assetFieldTypeViews/{field\_type} | | `asset_group.ad_strength` | String | Output only. Overall ad strength of this asset group. | | `asset_group.campaign` | String | Immutable. The campaign with which this asset group is associated. The asset which is linked to the asset group. | | `asset_group.final_mobile_urls` | String | A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out. | | `asset_group.final_urls` | String | A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out. | | `asset_group.id` | Long | Output only. The ID of the asset group. | | `asset_group.name` | String | Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign. | | `asset_group.path1` | String | First part of text that may appear appended to the url displayed in the ad. | | `asset_group.path2` | String | Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set. | | `asset_group.primary_status` | String | Output only. The primary status of the asset group. Provides insights into why an asset group is not serving or not serving optimally. | | `asset_group.primary_status_reasons` | String | Output only. Provides reasons into why an asset group is not serving or not serving optimally. It will be empty when the asset group is serving without issues. | | `asset_group.resource_name` | String | Immutable. The resource name of the asset group. Asset group resource names have the form: customers/{customer\_id}/assetGroups/{asset\_group\_id} | | `asset_group.status` | String | The status of the asset group. | | `asset_group_product_group_view.asset_group` | String | Output only. The asset group associated with the listing group filter. | | `asset_group_product_group_view.asset_group_listing_group_filter` | String | Output only. The resource name of the asset group listing group filter. | | `asset_group_product_group_view.resource_name` | String | Output only. The resource name of the asset group product group view. Asset group product group view resource names have the form: customers/{customer\_id}/assetGroupProductGroupViews/{asset\_group\_id}\~{listing\_group\_filter\_id} | | `asset_set_asset.asset` | String | Immutable. The asset which this asset set asset is linking to. | | `asset_set_asset.asset_set` | String | Immutable. The asset set which this asset set asset is linking to. | | `asset_set_asset.resource_name` | String | Immutable. The resource name of the asset set asset. Asset set asset resource names have the form: customers/{customer\_id}/assetSetAssets/{asset\_set\_id}\~{asset\_id} | | `asset_set_asset.status` | String | Output only. The status of the asset set asset. Read-only. | | `asset_set_type_view.asset_set_type` | String | Output only. The asset set type of the asset set type view. | | `asset_set_type_view.resource_name` | String | Output only. The resource name of the asset set type view. Asset set type view resource names have the form: customers/{customer\_id}/assetSetTypeViews/{asset\_set\_type} | | `bidding_strategy.aligned_campaign_budget_id` | long | 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` | Long | Output only. The number of campaigns attached to this bidding strategy. This field is read-only. | | `bidding_strategy.currency_code` | String | Immutable. 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` | String | Output only. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency\_code. Bidding strategy metrics are reported in this currency. This field is read-only. | | `bidding_strategy.enhanced_cpc` | String | 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` | Long | Output only. The ID of the bidding strategy. | | `bidding_strategy.maximize_conversion_value.cpc_bid_ceiling_micros` | Long | 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` | Long | 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` | Double | 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` | Long | 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` | Long | 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` | Long | Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. | | `bidding_strategy.name` | String | 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` | Long | Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only. | | `bidding_strategy.resource_name` | String | Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer\_id}/biddingStrategies/{bidding\_strategy\_id} | | `bidding_strategy.status` | String | Output only. The status of the bidding strategy. This field is read-only. | | `bidding_strategy.target_cpa.cpc_bid_ceiling_micros` | Long | 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` | Long | 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` | Long | Output only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. | | `bidding_strategy.target_impression_share.cpc_bid_ceiling_micros` | Long | 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` | String | The targeted location on the search results page. | | `bidding_strategy.target_impression_share.location_fraction_micros` | Long | The desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000. | | `bidding_strategy.target_roas.cpc_bid_ceiling_micros` | Long | 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` | Long | 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` | Double | Output only. The desired revenue (based on conversion data) per unit of spend. | | `bidding_strategy.target_spend.cpc_bid_ceiling_micros` | Long | 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` | Long | 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 for details. | | `bidding_strategy.type` | String | Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. | | `campaign.accessible_bidding_strategy` | String | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding\_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. | | `campaign.ad_serving_optimization_status` | String | The ad serving optimization status of the campaign. | | `campaign.advertising_channel_sub_type` | String | Immutable. 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. | | `campaign.advertising_channel_type` | String | Immutable. 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. | | `campaign.app_campaign_setting.app_id` | String | Immutable. A string that uniquely identifies a mobile application. | | `campaign.app_campaign_setting.app_store` | String | Immutable. The application store that distributes this specific app. | | `campaign.app_campaign_setting.bidding_strategy_goal_type` | String | Represents the goal which the bidding strategy of this app campaign should optimize towards. | | `campaign.asset_automation_settings` | String | Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior. | | `campaign.audience_setting.use_audience_grouped` | Boolean | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. | | `campaign.base_campaign` | String | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource\_name. This field is read-only. | | `campaign.bidding_strategy` | String | Portfolio bidding strategy used by campaign. | | `campaign.bidding_strategy_system_status` | String | Output only. The system status of the campaign's bidding strategy. | | `campaign.bidding_strategy_type` | String | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding\_strategy field to create a portfolio bidding strategy. This field is read-only. | | `campaign.campaign_budget` | String | The budget of the campaign. | | `campaign.campaign_group` | String | The campaign group this campaign belongs to. | | `campaign.commission.commission_rate_micros` | Long | 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.discovery_campaign_settings.upgraded_targeting` | Boolean | Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to true, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to false, and can only be set when creating a campaign. | | `campaign.dynamic_search_ads_setting.domain_name` | String | Required. The Internet domain name that this setting represents, e.g., "google.com" or "[www.google.com](http://www.google.com)". | | `campaign.dynamic_search_ads_setting.feeds` | Other | The list of page feeds associated with the campaign. | | `campaign.dynamic_search_ads_setting.language_code` | String | Required. The language code specifying the language of the domain, e.g., "en". | | `campaign.dynamic_search_ads_setting.use_supplied_urls_only` | Boolean | Whether the campaign uses advertiser supplied URLs exclusively. | | `campaign.end_date` | DateTime | The last day of the campaign (in the context of campaign's account's time zone). | | `campaign.excluded_parent_asset_field_types` | Other | 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` | String | 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.experiment_type` | String | Output only. The type of campaign: normal, draft, or experiment. | | `campaign.final_url_suffix` | String | Suffix used to append query parameters to landing pages that are served with parallel tracking. | | `campaign.frequency_caps` | Other | A list that limits how often each user will see this campaign's ads. | | `campaign.geo_target_type_setting.negative_geo_target_type` | String | The setting used for negative geotargeting in this particular campaign. | | `campaign.geo_target_type_setting.positive_geo_target_type` | String | The setting used for positive geotargeting in this particular campaign. | | `campaign.hotel_property_asset_set` | String | Immutable. The set of hotel properties for Performance Max for travel goals campaigns. | | `campaign.hotel_setting.hotel_center_id` | Long | Immutable. The linked Hotel Center account. | | `campaign.id` | Long | Output only. The ID of the campaign. | | `campaign.labels` | Other | Output only. The resource names of labels attached to this campaign. | | `campaign.listing_type` | String | Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns. | | `campaign.local_campaign_setting.location_source_type` | String | The location source type for this local campaign. | | `campaign.local_services_campaign_settings.category_bids` | String | Categorical level bids associated with MANUAL\_CPA bidding strategy. | | `campaign.manual_cpa` | String | 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` | String | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. | | `campaign.manual_cpv` | String | Output only. A bidding strategy that pays a configurable amount per video view. | | `campaign.maximize_conversion_value.target_roas` | Double | 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. | | `campaign.maximize_conversions.target_cpa_micros` | Long | Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition. | | `campaign.name` | String | 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_google_tv_network` | Boolean | Whether ads will be served on the Google TV network. | | `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.network_settings.target_youtube` | Boolean | Whether ads will be served on YouTube. | | `campaign.optimization_goal_setting.optimization_goal_types` | Other | The list of optimization goal types. | | `campaign.optimization_score` | Double | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at . This field is read-only. | | `campaign.payment_mode` | String | Payment mode for the campaign. | | `campaign.percent_cpc.cpc_bid_ceiling_micros` | Long | 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` | String | Output only. Indicates which Performance Max campaign the campaign is upgraded to. | | `campaign.performance_max_upgrade.pre_upgrade_campaign` | String | Output only. Indicates legacy campaign upgraded to Performance Max. | | `campaign.performance_max_upgrade.status` | String | Output only. The upgrade status of a campaign requested to be upgraded to Performance Max. | | `campaign.primary_status` | String | Output only. 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` | String | Output only. 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` | String | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer\_id}/campaigns/{campaign\_id} | | `campaign.selective_optimization.conversion_actions` | Other | The selected set of conversion actions for optimizing this campaign. | | `campaign.serving_status` | String | Output only. The ad serving status of the campaign. | | `campaign.shopping_setting.advertising_partner_ids` | Long | Immutable. The ads account IDs of advertising partners cooperating within the campaign. | | `campaign.shopping_setting.campaign_priority` | Int | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. | | `campaign.shopping_setting.disable_product_feed` | Boolean | Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See to learn more about this feature. | | `campaign.shopping_setting.enable_local` | Boolean | Whether to include local products. | | `campaign.shopping_setting.feed_label` | String | 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` | Long | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. | | `campaign.shopping_setting.use_vehicle_inventory` | Boolean | Immutable. 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.start_date` | DateTime | The date when campaign started (in the context of campaign's account's time zone). | | `campaign.status` | String | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. | | `campaign.target_cpa.cpc_bid_ceiling_micros` | Long | 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` | Long | 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` | Long | Output only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. | | `campaign.target_cpm.target_frequency_goal.target_count` | Long | Target Frequency count representing how many times you want to reach a single user. | | `campaign.target_cpm.target_frequency_goal.time_unit` | String | Time window expressing the period over which you want to reach the specified target\_count. | | `campaign.target_cpm` | String | A bidding strategy that automatically optimizes cost per thousand impressions. | | `campaign.target_impression_share.cpc_bid_ceiling_micros` | Long | 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` | String | The targeted location on the search results page. | | `campaign.target_impression_share.location_fraction_micros` | Long | The desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000. | | `campaign.target_roas.cpc_bid_ceiling_micros` | Long | 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` | Long | 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` | Double | Output only. The desired revenue (based on conversion data) per unit of spend. | | `campaign.target_spend.cpc_bid_ceiling_micros` | Long | 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` | Long | 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 for details. | | `campaign.targeting_setting.target_restrictions` | Other | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. | | `campaign.tracking_setting.tracking_url` | String | Output only. The url used for dynamic tracking. | | `campaign.tracking_url_template` | String | The URL template for constructing a tracking URL. | | `campaign.travel_campaign_settings.travel_account_id` | Long | Immutable. The Travel account ID associated with the Travel campaign. | | `campaign.url_custom_parameters` | Other | The list of mappings used to substitute custom parameter tags in a tracking\_url\_template, final\_urls, or mobile\_final\_urls. | | `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` | String | The display mode for vanity pharma URLs. | | `campaign.vanity_pharma.vanity_pharma_text` | String | 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` | String | Output only. 3-Tier Brand Safety setting for the campaign. | | `campaign_asset.asset` | String | Immutable. The asset which is linked to the campaign. | | `campaign_asset.campaign` | String | Immutable. The campaign to which the asset is linked. | | `campaign_asset.field_type` | String | Immutable. Role that the asset takes under the linked campaign. Required. | | `campaign_asset.primary_status` | String | Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state. | | `campaign_asset.primary_status_details` | String | Output only. Provides the details of the primary status and its associated reasons. | | `campaign_asset.primary_status_reasons` | String | Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity. | | `campaign_asset.resource_name` | String | Immutable. The resource name of the campaign asset. CampaignAsset resource names have the form: customers/{customer\_id}/campaignAssets/{campaign\_id}~~{asset\_id}~~{field\_type} | | `campaign_asset.source` | String | Output only. Source of the campaign asset link. | | `campaign_asset.status` | String | Status of the campaign asset. | | `campaign_audience_view.resource_name` | String | Output only. 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_bid_modifier.bid_modifier` | Double | The modifier for the bid when the criterion matches. | | `campaign_bid_modifier.campaign` | String | Output only. The campaign to which this criterion belongs. | | `campaign_bid_modifier.criterion_id` | Long | Output only. The ID of the criterion to bid modify. This field is ignored for mutates. | | `campaign_bid_modifier.interaction_type.type` | String | The interaction type. | | `campaign_bid_modifier.resource_name` | String | Immutable. The resource name of the campaign bid modifier. Campaign bid modifier resource names have the form: customers/{customer\_id}/campaignBidModifiers/{campaign\_id}\~{criterion\_id} | | `campaign_budget.aligned_bidding_strategy_id` | Long | 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.amount_micros` | Long | The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount. | | `campaign_budget.delivery_method` | String | 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.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. | | `campaign_budget.has_recommended_budget` | Boolean | Output only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only. | | `campaign_budget.id` | Long | Output only. The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results. | | `campaign_budget.name` | String | 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.period` | String | Immutable. Period over which to spend the budget. Defaults to DAILY if not specified. | | `campaign_budget.recommended_budget_amount_micros` | Long | Output only. The recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only. | | `campaign_budget.recommended_budget_estimated_change_weekly_clicks` | Long | Output only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only. | | `campaign_budget.recommended_budget_estimated_change_weekly_cost_micros` | Long | Output only. The estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only. | | `campaign_budget.recommended_budget_estimated_change_weekly_interactions` | Long | Output only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only. | | `campaign_budget.recommended_budget_estimated_change_weekly_views` | Long | Output only. The estimated change in weekly views if the recommended budget is applied. This field is read-only. | | `campaign_budget.reference_count` | Long | Output only. The number of campaigns actively using the budget. This field is read-only. | | `campaign_budget.resource_name` | String | Immutable. The resource name of the campaign budget. Campaign budget resource names have the form: customers/{customer\_id}/campaignBudgets/{campaign\_budget\_id} | | `campaign_budget.status` | String | Output only. The status of this campaign budget. This field is read-only. | | `campaign_budget.total_amount_micros` | Long | 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. | | `campaign_budget.type` | String | Immutable. The type of the campaign budget. | | `campaign_group.id` | Long | Output only. The ID of the campaign group. | | `campaign_group.name` | String | The name of the campaign group. This field is required and should not be empty when creating new campaign groups. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. | | `campaign_group.resource_name` | String | Immutable. The resource name of the campaign group. Campaign group resource names have the form: customers/{customer\_id}/campaignGroups/{campaign\_group\_id} | | `campaign_group.status` | String | The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED. | | `campaign_search_term_insight.campaign_id` | Long | Output only. The ID of the campaign. | | `campaign_search_term_insight.category_label` | String | Output only. The label for the search category. An empty string denotes the catch-all category for search terms that didn't fit into another category. | | `campaign_search_term_insight.id` | Long | Output only. The ID of the insight. | | `campaign_search_term_insight.resource_name` | String | Output only. The resource name of the campaign level search term insight. Campaign level search term insight resource names have the form: customers/{customer\_id}/campaignSearchTermInsights/{campaign\_id}\~{category\_id} | | `click_view.ad_group_ad` | String | Output only. The associated ad. | | `click_view.area_of_interest.city` | String | The city location criterion associated with the impression. | | `click_view.area_of_interest.country` | String | The country location criterion associated with the impression. | | `click_view.area_of_interest.metro` | String | The metro location criterion associated with the impression. | | `click_view.area_of_interest.most_specific` | String | The most specific location criterion associated with the impression. | | `click_view.area_of_interest.region` | String | The region location criterion associated with the impression. | | `click_view.campaign_location_target` | String | Output only. The associated campaign location target, if one exists. | | `click_view.gclid` | String | Output only. The Google Click ID. | | `click_view.keyword` | String | Output only. The associated keyword, if one exists and the click corresponds to the SEARCH channel. | | `click_view.keyword_info.match_type` | String | The match type of the keyword. | | `click_view.keyword_info.text` | String | The text of the keyword (at most 80 characters and 10 words). | | `click_view.location_of_presence.city` | String | The city location criterion associated with the impression. | | `click_view.location_of_presence.country` | String | The country location criterion associated with the impression. | | `click_view.location_of_presence.metro` | String | The metro location criterion associated with the impression. | | `click_view.location_of_presence.most_specific` | String | The most specific location criterion associated with the impression. | | `click_view.location_of_presence.region` | String | The region location criterion associated with the impression. | | `click_view.page_number` | Long | Output only. Page number in search results where the ad was shown. | | `click_view.resource_name` | String | Output only. The resource name of the click view. Click view resource names have the form: customers/{customer\_id}/clickViews/{date (yyyy-MM-dd)}\~{gclid} | | `click_view.user_list` | String | Output only. The associated user list, if one exists. | | `conversion_action.app_id` | String | App ID for an app conversion action. | | `conversion_action.attribution_model_settings.attribution_model` | String | The attribution model type of this conversion action. | | `conversion_action.attribution_model_settings.data_driven_model_status` | String | Output only. The status of the data-driven attribution model for the conversion action. | | `conversion_action.category` | String | The category of conversions reported for this conversion action. | | `conversion_action.click_through_lookback_window_days` | Long | The maximum number of days that may elapse between an interaction (e.g., a click) and a conversion event. | | `conversion_action.counting_type` | String | How to count conversion events for the conversion action. | | `conversion_action.firebase_settings.event_name` | String | Output only. The event name of a Firebase conversion. | | `conversion_action.firebase_settings.project_id` | String | Output only. The Firebase project ID of the conversion. | | `conversion_action.firebase_settings.property_id` | Long | Output only. The GA property ID of the conversion. | | `conversion_action.firebase_settings.property_name` | String | Output only. The GA property name of the conversion. | | `conversion_action.google_analytics_4_settings.event_name` | String | Output only. The name of the GA 4 event. | | `conversion_action.google_analytics_4_settings.property_id` | Long | Output only. The ID of the GA 4 property. | | `conversion_action.google_analytics_4_settings.property_name` | String | Output only. The name of the GA 4 property. | | `conversion_action.id` | Long | Output only. The ID of the conversion action. | | `conversion_action.include_in_conversions_metric` | Boolean | Whether this conversion action should be included in the "conversions" metric. | | `conversion_action.mobile_app_vendor` | String | Output only. Mobile app vendor for an app conversion action. | | `conversion_action.name` | String | The name of the conversion action. This field is required and should not be empty when creating new conversion actions. | | `conversion_action.origin` | String | Output only. The conversion origin of this conversion action. | | `conversion_action.owner_customer` | String | Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action. | | `conversion_action.phone_call_duration_seconds` | Long | The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive. | | `conversion_action.primary_for_goal` | Boolean | If a conversion action's primary\_for\_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary\_for\_goal, so if a campaign has a custom conversion goal configured with a primary\_for\_goal = false conversion action, that conversion action is still biddable. | | `conversion_action.resource_name` | String | Immutable. The resource name of the conversion action. Conversion action resource names have the form: customers/{customer\_id}/conversionActions/{conversion\_action\_id} | | `conversion_action.status` | String | The status of this conversion action for conversion event accrual. | | `conversion_action.tag_snippets` | Other | Output only. The snippets used for tracking conversions. | | `conversion_action.third_party_app_analytics_settings.event_name` | String | Output only. The event name of a third-party app analytics conversion. | | `conversion_action.third_party_app_analytics_settings.provider_name` | String | Output only. Name of the third-party app analytics provider. | | `conversion_action.type` | String | Immutable. The type of this conversion action. | | `conversion_action.value_settings.always_use_default_value` | Boolean | Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action. | | `conversion_action.value_settings.default_currency_code` | String | The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value. | | `conversion_action.value_settings.default_value` | Double | The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value. | | `conversion_action.view_through_lookback_window_days` | Long | The maximum number of days which may elapse between an impression and a conversion without an interaction. | | `customer.auto_tagging_enabled` | Boolean | Whether auto-tagging is enabled for the customer. | | `customer.call_reporting_setting.call_conversion_action` | String | 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 via Google System. | | `customer.conversion_tracking_setting.accepted_customer_data_terms` | Boolean | Output only. 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 . | | `customer.conversion_tracking_setting.conversion_tracking_id` | Long | Output only. The conversion tracking id used for this account. This id is automatically assigned after any conversion tracking feature is used. If the customer doesn't use conversion tracking, this is 0. This field is read-only. | | `customer.conversion_tracking_setting.conversion_tracking_status` | String | Output only. 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` | Long | Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion\_tracking\_id. This field can only be managed through the Google Ads UI. This field is read-only. | | `customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled` | Boolean | Output only. 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` | String | Output only. The resource name of the customer where conversions are created and managed. This field is read-only. | | `customer.currency_code` | String | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. | | `customer.customer_agreement_setting.accepted_lead_form_terms` | Boolean | Output only. Whether the customer has accepted lead form term of service. | | `customer.descriptive_name` | String | Optional, non-unique descriptive name of the customer. | | `customer.final_url_suffix` | String | The URL template for appending params to the final URL | | `customer.has_partners_badge` | Boolean | Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see . | | `customer.id` | Long | Output only. The ID of the customer. | | `customer.image_asset_auto_migration_done` | Boolean | Output only. True if feed based image has been migrated to asset based image. | | `customer.image_asset_auto_migration_done_date_time` | DateTime | Output only. Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:flag\_mm:ss format. | | `customer.local_services_settings.granular_insurance_statuses` | String | Output only. A read-only list of geo vertical level insurance statuses. | | `customer.local_services_settings.granular_license_statuses` | String | Output only. A read-only list of geo vertical level license statuses. | | `customer.location_asset_auto_migration_done` | Boolean | Output only. True if feed based location has been migrated to asset based location. | | `customer.location_asset_auto_migration_done_date_time` | DateTime | Output only. Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:flag\_mm:ss format. | | `customer.manager` | Boolean | Output only. Whether the customer is a manager. | | `customer.optimization_score` | Double | Output only. Optimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See About optimization score at . This field is read-only. | | `customer.optimization_score_weight` | Double | Output only. Optimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization\_score \* Customer.optimization\_score\_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only. | | `customer.pay_per_conversion_eligibility_failure_reasons` | Other | Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only. | | `customer.remarketing_setting.google_global_site_tag` | String | Output only. The Google global site tag. | | `customer.resource_name` | String | Immutable. The resource name of the customer. Customer resource names have the form: customers/{customer\_id} | | `customer.status` | String | Output only. The status of the customer. | | `customer.test_account` | Boolean | Output only. Whether the customer is a test account. | | `customer.time_zone` | String | Immutable. The local timezone ID of the customer. | | `customer.tracking_url_template` | String | The URL template for constructing a tracking URL out of parameters. | | `customer_asset.asset` | String | Required. Immutable. The asset which is linked to the customer. | | `customer_asset.field_type` | String | Required. Immutable. Role that the asset takes for the customer link. | | `customer_asset.primary_status` | String | Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state. | | `customer_asset.primary_status_details` | String | Output only. Provides the details of the primary status and its associated reasons. | | `customer_asset.primary_status_reasons` | String | Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity. | | `customer_asset.resource_name` | String | Immutable. The resource name of the customer asset. CustomerAsset resource names have the form: customers/{customer\_id}/customerAssets/{asset\_id}\~{field\_type} | | `customer_asset.source` | String | Output only. Source of the customer asset link. | | `customer_asset.status` | String | Status of the customer asset. | | `customer_search_term_insight.category_label` | String | Output only. The label for the search category. An empty string denotes the catch-all category for search terms that didn't fit into another category. | | `customer_search_term_insight.id` | Long | Output only. The ID of the insight. | | `customer_search_term_insight.resource_name` | String | Output only. The resource name of the customer level search term insight. Customer level search term insight resource names have the form: customers/{customer\_id}/customerSearchTermInsights/{category\_id} | | `detail_placement_view.display_name` | String | Output only. 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` | String | Output only. URL of the group placement, e.g. domain, link to the mobile application in app store, or a YouTube channel URL. | | `detail_placement_view.placement` | String | Output only. The automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID. | | `detail_placement_view.placement_type` | String | Output only. Type of the placement, e.g. Website, YouTube Video, and Mobile Application. | | `detail_placement_view.resource_name` | String | Output only. 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` | String | Output only. URL of the placement, e.g. website, link to the mobile application in app store, or a YouTube video URL. | | `display_keyword_view.resource_name` | String | Output only. The resource name of the display keyword view. Display Keyword view resource names have the form: customers/{customer\_id}/displayKeywordViews/{ad\_group\_id}\~{criterion\_id} | | `distance_view.distance_bucket` | String | Output only. Grouping of user distance from location extensions. | | `distance_view.metric_system` | Boolean | Output only. True if the DistanceBucket is using the metric system, false otherwise. | | `distance_view.resource_name` | String | Output only. The resource name of the distance view. Distance view resource names have the form: customers/{customer\_id}/distanceViews/1\~{distance\_bucket} | | `dynamic_search_ads_search_term_view.has_matching_keyword` | Boolean | Output only. True if query is added to targeted keywords. This field is read-only. | | `dynamic_search_ads_search_term_view.has_negative_keyword` | Boolean | Output only. True if query matches a negative keyword. This field is read-only. | | `dynamic_search_ads_search_term_view.has_negative_url` | Boolean | Output only. True if query matches a negative url. This field is read-only. | | `dynamic_search_ads_search_term_view.headline` | String | Output only. The dynamically generated headline of the Dynamic Search Ad. This field is read-only. | | `dynamic_search_ads_search_term_view.landing_page` | String | Output only. The dynamically selected landing page URL of the impression. This field is read-only. | | `dynamic_search_ads_search_term_view.page_url` | String | Output only. The URL of page feed item served for the impression. This field is read-only. | | `dynamic_search_ads_search_term_view.resource_name` | String | Output only. The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form: customers/{customer\_id}/dynamicSearchAdsSearchTermViews/{ad\_group\_id}~~{search\_term\_fingerprint}~~{headline\_fingerprint}~~{landing\_page\_fingerprint}~~{page\_url\_fingerprint} | | `dynamic_search_ads_search_term_view.search_term` | String | Output only. Search term This field is read-only. | | `expanded_landing_page_view.expanded_final_url` | String | Output only. The final URL that clicks are directed to. | | `expanded_landing_page_view.resource_name` | String | Output only. The resource name of the expanded landing page view. Expanded landing page view resource names have the form: customers/{customer\_id}/expandedLandingPageViews/{expanded\_final\_url\_fingerprint} | | `extension_feed_item.ad_schedules` | Other | List of non-overlapping schedules specifying all time intervals for which the feed item may serve. There can be a maximum of 6 schedules per day. | | `extension_feed_item.affiliate_location_feed_item.address_line_1` | String | Line 1 of the business address. | | `extension_feed_item.affiliate_location_feed_item.address_line_2` | String | Line 2 of the business address. | | `extension_feed_item.affiliate_location_feed_item.business_name` | String | The name of the business. | | `extension_feed_item.affiliate_location_feed_item.chain_id` | Long | Id of the retail chain that is advertised as a seller of your product. | | `extension_feed_item.affiliate_location_feed_item.chain_name` | String | Name of chain. | | `extension_feed_item.affiliate_location_feed_item.city` | String | City of the business address. | | `extension_feed_item.affiliate_location_feed_item.country_code` | String | Country code of the business address. | | `extension_feed_item.affiliate_location_feed_item.phone_number` | String | Phone number of the business. | | `extension_feed_item.affiliate_location_feed_item.postal_code` | String | Postal code of the business address. | | `extension_feed_item.affiliate_location_feed_item.province` | String | Province of the business address. | | `extension_feed_item.app_feed_item.app_id` | String | The store-specific ID for the target application. This string must not be empty. | | `extension_feed_item.app_feed_item.app_store` | String | The application store that the target application belongs to. This field is required. | | `extension_feed_item.app_feed_item.final_mobile_urls` | Other | A list of possible final mobile URLs after all cross domain redirects. | | `extension_feed_item.app_feed_item.final_url_suffix` | String | URL template for appending params to landing page URLs served with parallel tracking. | | `extension_feed_item.app_feed_item.final_urls` | Other | A list of possible final URLs after all cross domain redirects. This list must not be empty. | | `extension_feed_item.app_feed_item.link_text` | String | The visible text displayed when the link is rendered in an ad. This string must not be empty, and the length of this string should be between 1 and 25, inclusive. | | `extension_feed_item.app_feed_item.tracking_url_template` | String | URL template for constructing a tracking URL. Default value is "{lpurl}". | | `extension_feed_item.call_feed_item.call_conversion_action` | String | 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\_tracking\_enabled is set to true. Otherwise this field is ignored. | | `extension_feed_item.call_feed_item.call_conversion_reporting_state` | String | Enum value that indicates whether this call extension uses its own call conversion setting (or just have call conversion disabled), or following the account level setting. | | `extension_feed_item.call_feed_item.call_conversion_tracking_disabled` | Boolean | If true, disable call conversion tracking. call\_conversion\_action should not be set if this is true. Optional. | | `extension_feed_item.call_feed_item.call_tracking_enabled` | Boolean | Indicates whether call tracking is enabled. By default, call tracking is not enabled. | | `extension_feed_item.call_feed_item.country_code` | String | Uppercase two-letter country code of the advertiser's phone number. This string must not be empty. | | `extension_feed_item.call_feed_item.phone_number` | String | The advertiser's phone number to append to the ad. This string must not be empty. | | `extension_feed_item.callout_feed_item.callout_text` | String | The callout text. The length of this string should be between 1 and 25, inclusive. | | `extension_feed_item.device` | String | The targeted device. | | `extension_feed_item.end_date_time` | DateTime | End time in which this feed item is no longer effective and will stop serving. The time is in the customer's time zone. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15: 00" or "2018-02-01 14:34:30" | | `extension_feed_item.extension_type` | String | Output only. The extension type of the extension feed item. This field is read-only. | | `extension_feed_item.hotel_callout_feed_item.language_code` | String | The language of the hotel callout text. IETF BCP 47 compliant language code. | | `extension_feed_item.hotel_callout_feed_item.text` | String | The callout text. The length of this string should be between 1 and 25, inclusive. | | `extension_feed_item.id` | Long | Output only. The ID of this feed item. Read-only. | | `extension_feed_item.image_feed_item.image_asset` | String | Required. Resource name of the image asset. | | `extension_feed_item.location_feed_item.address_line_1` | String | Line 1 of the business address. | | `extension_feed_item.location_feed_item.address_line_2` | String | Line 2 of the business address. | | `extension_feed_item.location_feed_item.business_name` | String | The name of the business. | | `extension_feed_item.location_feed_item.city` | String | City of the business address. | | `extension_feed_item.location_feed_item.country_code` | String | Country code of the business address. | | `extension_feed_item.location_feed_item.phone_number` | String | Phone number of the business. | | `extension_feed_item.location_feed_item.postal_code` | String | Postal code of the business address. | | `extension_feed_item.location_feed_item.province` | String | Province of the business address. | | `extension_feed_item.price_feed_item.final_url_suffix` | String | Tracking URL template for all offers of this price extension. | | `extension_feed_item.price_feed_item.language_code` | String | The code of the language used for this price extension. | | `extension_feed_item.price_feed_item.price_offerings` | Other | The price offerings in this price extension. | | `extension_feed_item.price_feed_item.price_qualifier` | String | Price qualifier for all offers of this price extension. | | `extension_feed_item.price_feed_item.tracking_url_template` | String | Tracking URL template for all offers of this price extension. | | `extension_feed_item.price_feed_item.type` | String | Price extension type of this extension. | | `extension_feed_item.promotion_feed_item.discount_modifier` | String | Enum that modifies the qualification of the discount. | | `extension_feed_item.promotion_feed_item.final_mobile_urls` | Other | A list of possible final mobile URLs after all cross domain redirects. | | `extension_feed_item.promotion_feed_item.final_url_suffix` | String | URL template for appending params to landing page URLs served with parallel tracking. | | `extension_feed_item.promotion_feed_item.final_urls` | Other | A list of possible final URLs after all cross domain redirects. This field is required. | | `extension_feed_item.promotion_feed_item.language_code` | String | The language of the promotion. Represented as BCP 47 language tag. | | `extension_feed_item.promotion_feed_item.money_amount_off.amount_micros` | Long | Amount in micros. One million is equivalent to one unit. | | `extension_feed_item.promotion_feed_item.money_amount_off.currency_code` | String | Three-character ISO 4217 currency code. | | `extension_feed_item.promotion_feed_item.occasion` | String | The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion. | | `extension_feed_item.promotion_feed_item.orders_over_amount.amount_micros` | Long | Amount in micros. One million is equivalent to one unit. | | `extension_feed_item.promotion_feed_item.orders_over_amount.currency_code` | String | Three-character ISO 4217 currency code. | | `extension_feed_item.promotion_feed_item.percent_off` | Long | Percentage off discount in the promotion in micros. One million is equivalent to one percent. Either this or money\_off\_amount is required. | | `extension_feed_item.promotion_feed_item.promotion_code` | String | A code the user should use in order to be eligible for the promotion. | | `extension_feed_item.promotion_feed_item.promotion_end_date` | DateTime | Last date when the promotion is eligible to be redeemed. | | `extension_feed_item.promotion_feed_item.promotion_start_date` | DateTime | Start date of when the promotion is eligible to be redeemed. | | `extension_feed_item.promotion_feed_item.promotion_target` | String | A freeform description of what the promotion is targeting. This field is required. | | `extension_feed_item.promotion_feed_item.tracking_url_template` | String | URL template for constructing a tracking URL. | | `extension_feed_item.resource_name` | String | Immutable. The resource name of the extension feed item. Extension feed item resource names have the form: customers/{customer\_id}/extensionFeedItems/{feed\_item\_id} | | `extension_feed_item.sitelink_feed_item.final_mobile_urls` | Other | A list of possible final mobile URLs after all cross domain redirects. | | `extension_feed_item.sitelink_feed_item.final_url_suffix` | String | Final URL suffix to be appended to landing page URLs served with parallel tracking. | | `extension_feed_item.sitelink_feed_item.final_urls` | Other | A list of possible final URLs after all cross domain redirects. | | `extension_feed_item.sitelink_feed_item.line1` | String | First line of the description for the sitelink. If this value is set, line2 must also be set. The length of this string should be between 0 and 35, inclusive. | | `extension_feed_item.sitelink_feed_item.line2` | String | Second line of the description for the sitelink. If this value is set, line1 must also be set. The length of this string should be between 0 and 35, inclusive. | | `extension_feed_item.sitelink_feed_item.link_text` | String | URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. | | `extension_feed_item.sitelink_feed_item.tracking_url_template` | String | URL template for constructing a tracking URL. | | `extension_feed_item.start_date_time` | DateTime | Start time in which this feed item is effective and can begin serving. The time is in the customer's time zone. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" | | `extension_feed_item.status` | String | Output only. Status of the feed item. This field is read-only. | | `extension_feed_item.structured_snippet_feed_item.header` | String | The header of the snippet. This string must not be empty. | | `extension_feed_item.structured_snippet_feed_item.values` | Other | The values in the snippet. The maximum size of this collection is 10. | | `extension_feed_item.targeted_ad_group` | String | The targeted ad group. | | `extension_feed_item.targeted_campaign` | String | The targeted campaign. | | `extension_feed_item.targeted_geo_target_constant` | String | The targeted geo target constant. | | `extension_feed_item.targeted_keyword.match_type` | String | The match type of the keyword. | | `extension_feed_item.targeted_keyword.text` | String | The text of the keyword (at most 80 characters and 10 words). | | `extension_feed_item.text_message_feed_item.business_name` | String | The business name to prepend to the message text. This field is required. | | `extension_feed_item.text_message_feed_item.country_code` | String | Uppercase two-letter country code of the advertiser's phone number. This field is required. | | `extension_feed_item.text_message_feed_item.extension_text` | String | The message extension\_text populated in the messaging app. | | `extension_feed_item.text_message_feed_item.phone_number` | String | The advertiser's phone number the message will be sent to. Required. | | `extension_feed_item.text_message_feed_item.text` | String | The text to show in the ad. This field is required. | | `feed_item.attribute_values` | Other | The feed item's attribute values. | | `feed_item.end_date_time` | DateTime | End time in which this feed item is no longer effective and will stop serving. The time is in the customer's time zone. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" | | `feed_item.feed` | String | Immutable. The feed to which this feed item belongs. | | `feed_item.geo_targeting_restriction` | String | Geo targeting restriction specifies the type of location that can be used for targeting. | | `feed_item.id` | Long | Output only. The ID of this feed item. | | `feed_item.policy_infos` | Other | Output only. List of info about a feed item's validation and approval state for active feed mappings. There will be an entry in the list for each type of feed mapping associated with the feed, e.g. a feed with a sitelink and a call feed mapping would cause every feed item associated with that feed to have an entry in this list for both sitelink and call. This field is read-only. | | `feed_item.resource_name` | String | Immutable. The resource name of the feed item. Feed item resource names have the form: customers/{customer\_id}/feedItems/{feed\_id}\~{feed\_item\_id} | | `feed_item.start_date_time` | DateTime | Start time in which this feed item is effective and can begin serving. The time is in the customer's time zone. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" | | `feed_item.status` | String | Output only. Status of the feed item. This field is read-only. | | `feed_item.url_custom_parameters` | Other | The list of mappings used to substitute custom parameter tags in a tracking\_url\_template, final\_urls, or mobile\_final\_urls. | | `feed_placeholder_view.placeholder_type` | String | Output only. The placeholder type of the feed placeholder view. | | `feed_placeholder_view.resource_name` | String | Output only. The resource name of the feed placeholder view. Feed placeholder view resource names have the form: customers/{customer\_id}/feedPlaceholderViews/{placeholder\_type} | | `gender_view.resource_name` | String | Output only. The resource name of the gender view. Gender view resource names have the form: customers/{customer\_id}/genderViews/{ad\_group\_id}\~{criterion\_id} | | `geographic_view.country_criterion_id` | Long | Output only. Criterion Id for the country. | | `geographic_view.location_type` | String | Output only. Type of the geo targeting of the campaign. | | `geographic_view.resource_name` | String | Output only. The resource name of the geographic view. Geographic view resource names have the form: customers/{customer\_id}/geographicViews/{country\_criterion\_id}\~{location\_type} | | `group_placement_view.display_name` | String | Output only. Domain name for websites and YouTube channel name for YouTube channels. | | `group_placement_view.placement` | String | Output only. The automatic placement string at group level, e. g. web domain, mobile app ID, or a YouTube channel ID. | | `group_placement_view.placement_type` | String | Output only. Type of the placement, e.g. Website, YouTube Channel, Mobile Application. | | `group_placement_view.resource_name` | String | Output only. The resource name of the group placement view. Group placement view resource names have the form: customers/{customer\_id}/groupPlacementViews/{ad\_group\_id}\~{base64\_placement} | | `group_placement_view.target_url` | String | Output only. URL of the group placement, e.g. domain, link to the mobile application in app store, or a YouTube channel URL. | | `hotel_group_view.resource_name` | String | Output only. The resource name of the hotel group view. Hotel Group view resource names have the form: customers/{customer\_id}/hotelGroupViews/{ad\_group\_id}\~{criterion\_id} | | `hotel_performance_view.resource_name` | String | Output only. The resource name of the hotel performance view. Hotel performance view resource names have the form: customers/{customer\_id}/hotelPerformanceView | | `hotel_reconciliation.billed` | Boolean | Output only. Whether a given booking has been billed. Once billed, a booking can't be modified. | | `hotel_reconciliation.campaign` | String | Output only. The resource name for the Campaign associated with the conversion. | | `hotel_reconciliation.check_in_date` | DateTime | Output only. Check-in date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD. | | `hotel_reconciliation.check_out_date` | DateTime | Output only. Check-out date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD. | | `hotel_reconciliation.commission_id` | String | Required. Output only. The commission ID is Google's ID for this booking. Every booking event is assigned a Commission ID to help you match it to a guest stay. | | `hotel_reconciliation.hotel_center_id` | Long | Output only. Identifier for the Hotel Center account which provides the rates for the Hotel campaign. | | `hotel_reconciliation.hotel_id` | String | Output only. Unique identifier for the booked property, as provided in the Hotel Center feed. The hotel ID comes from the 'ID' parameter of the conversion tracking tag. | | `hotel_reconciliation.order_id` | String | Output only. The order ID is the identifier for this booking as provided in the 'transaction\_id' parameter of the conversion tracking tag. | | `hotel_reconciliation.reconciled_value_micros` | Long | Required. Output only. Reconciled value is the final value of a booking as paid by the guest. If original booking value changes for any reason, such as itinerary changes or room upsells, the reconciled value should be the full final amount collected. If a booking is canceled, the reconciled value should include the value of any cancellation fees or non-refundable nights charged. Value is in millionths of the base unit currency. For example, $12.35 would be represented as 12350000. Currency unit is in the default customer currency. | | `hotel_reconciliation.resource_name` | String | Immutable. The resource name of the hotel reconciliation. Hotel reconciliation resource names have the form: customers/{customer\_id}/hotelReconciliations/{commission\_id} | | `hotel_reconciliation.status` | String | Required. Output only. Current status of a booking with regards to reconciliation and billing. Bookings should be reconciled within 45 days after the check-out date. Any booking not reconciled within 45 days will be billed at its original value. | | `income_range_view.resource_name` | String | Output only. The resource name of the income range view. Income range view resource names have the form: customers/{customer\_id}/incomeRangeViews/{ad\_group\_id}\~{criterion\_id} | | `keyword_view.resource_name` | String | Output only. The resource name of the keyword view. Keyword view resource names have the form: customers/{customer\_id}/keywordViews/{ad\_group\_id}\~{criterion\_id} | | `landing_page_view.resource_name` | String | Output only. The resource name of the landing page view. Landing page view resource names have the form: customers/{customer\_id}/landingPageViews/{unexpanded\_final\_url\_fingerprint} | | `landing_page_view.unexpanded_final_url` | String | Output only. The advertiser-specified final URL. | | `location_view.resource_name` | String | Output only. The resource name of the location view. Location view resource names have the form: customers/{customer\_id}/locationViews/{campaign\_id}\~{criterion\_id} | | `managed_placement_view.resource_name` | String | Output only. The resource name of the Managed Placement view. Managed placement view resource names have the form: customers/{customer\_id}/managedPlacementViews/{ad\_group\_id}\~{criterion\_id} | | `paid_organic_search_term_view.resource_name` | String | Output only. The resource name of the search term view. Search term view resource names have the form: customers/{customer\_id}/paidOrganicSearchTermViews/{campaign\_id}\~ {ad\_group\_id}\~{URL-base64 search term} | | `paid_organic_search_term_view.search_term` | String | Output only. The search term. | | `parental_status_view.resource_name` | String | Output only. The resource name of the parental status view. Parental Status view resource names have the form: customers/{customer\_id}/parentalStatusViews/{ad\_group\_id}\~{criterion\_id} | | `per_store_view.place_id` | String | Output only. The place ID of the per store view. | | `per_store_view.resource_name` | String | Output only. The resource name of the per store view. Per Store view resource names have the form: customers/{customer\_id}/perStoreViews/{place\_id} | | `product_group_view.resource_name` | String | Output only. The resource name of the product group view. Product group view resource names have the form: customers/{customer\_id}/productGroupViews/{ad\_group\_id}\~{criterion\_id} | | `search_term_view.ad_group` | String | Output only. The ad group the search term served in. | | `search_term_view.resource_name` | String | Output only. 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` | String | Output only. The search term. | | `search_term_view.status` | String | Output only. Indicates whether the search term is currently one of your targeted or excluded keywords. | | `shopping_performance_view.resource_name` | String | Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer\_id}/shoppingPerformanceView | | `smart_campaign_search_term_view.campaign` | String | Output only. The Smart campaign the search term served in. | | `smart_campaign_search_term_view.resource_name` | String | Output only. The resource name of the Smart campaign search term view. Smart campaign search term view resource names have the form: customers/{customer\_id}/smartCampaignSearchTermViews/{campaign\_id}\~{URL-base64\_search\_term} | | `smart_campaign_search_term_view.search_term` | String | Output only. The search term. | | `topic_view.resource_name` | String | Output only. The resource name of the topic view. Topic view resource names have the form: customers/{customer\_id}/topicViews/{ad\_group\_id}\~{criterion\_id} | | `travel_activity_group_view.resource_name` | String | Output only. The resource name of the travel activity group view. Travel Activity Group view resource names have the form: customers/{customer\_id}/travelActivityGroupViews/{ad\_group\_id}\~{criterion\_id} | | `travel_activity_performance_view.resource_name` | String | Output only. The resource name of the travel activity performance view. Travel Activity performance view resource names have the form: customers/{customer\_id}/travelActivityPerformanceView | | `user_location_view.country_criterion_id` | Long | Output only. Criterion Id for the country. | | `user_location_view.resource_name` | String | Output only. The resource name of the user location view. UserLocation view resource names have the form: customers/{customer\_id}/userLocationViews/{country\_criterion\_id}\~{targeting\_location} | | `user_location_view.targeting_location` | Boolean | Output only. Indicates whether location was targeted or not. | | `video.channel_id` | String | Output only. The owner channel id of the video. | | `video.duration_millis` | Long | Output only. The duration of the video in milliseconds. | | `video.id` | String | Output only. The ID of the video. | | `video.resource_name` | String | Output only. The resource name of the video. Video resource names have the form: customers/{customer\_id}/videos/{video\_id} | | `video.title` | String | Output only. The title of the video. | | `webpage_view.resource_name` | String | Output only. The resource name of the webpage view. Webpage view resource names have the form: customers/{customer\_id}/webpageViews/{ad\_group\_id}\~{criterion\_id} |