xref: /aosp_15_r20/external/googleapis/google/ads/googleads/v14/common/metrics.proto (revision d5c09012810ac0c9f33fe448fb6da8260d444cc9)
1// Copyright 2023 Google LLC
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15syntax = "proto3";
16
17package google.ads.googleads.v14.common;
18
19import "google/ads/googleads/v14/enums/interaction_event_type.proto";
20import "google/ads/googleads/v14/enums/quality_score_bucket.proto";
21
22option csharp_namespace = "Google.Ads.GoogleAds.V14.Common";
23option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v14/common;common";
24option java_multiple_files = true;
25option java_outer_classname = "MetricsProto";
26option java_package = "com.google.ads.googleads.v14.common";
27option objc_class_prefix = "GAA";
28option php_namespace = "Google\\Ads\\GoogleAds\\V14\\Common";
29option ruby_package = "Google::Ads::GoogleAds::V14::Common";
30
31// Proto file describing metrics.
32
33// Metrics data.
34message Metrics {
35  // The percent of your ad impressions that are shown as the very first ad
36  // above the organic search results.
37  optional double absolute_top_impression_percentage = 183;
38
39  // Average cost of viewable impressions (`active_view_impressions`).
40  optional double active_view_cpm = 184;
41
42  // Active view measurable clicks divided by active view viewable impressions.
43  //
44  // This metric is reported only for the Display Network.
45  optional double active_view_ctr = 185;
46
47  // A measurement of how often your ad has become viewable on a Display
48  // Network site.
49  optional int64 active_view_impressions = 186;
50
51  // The ratio of impressions that could be measured by Active View over the
52  // number of served impressions.
53  optional double active_view_measurability = 187;
54
55  // The cost of the impressions you received that were measurable by Active
56  // View.
57  optional int64 active_view_measurable_cost_micros = 188;
58
59  // The number of times your ads are appearing on placements in positions
60  // where they can be seen.
61  optional int64 active_view_measurable_impressions = 189;
62
63  // The percentage of time when your ad appeared on an Active View enabled site
64  // (measurable impressions) and was viewable (viewable impressions).
65  optional double active_view_viewability = 190;
66
67  // All conversions from interactions (as oppose to view through conversions)
68  // divided by the number of ad interactions.
69  optional double all_conversions_from_interactions_rate = 191;
70
71  // The value of all conversions.
72  optional double all_conversions_value = 192;
73
74  // The value of all conversions. When this column is selected with date, the
75  // values in date column means the conversion date. Details for the
76  // by_conversion_date columns are available at
77  // https://support.google.com/google-ads/answer/9549009.
78  double all_conversions_value_by_conversion_date = 240;
79
80  // All of new customers' lifetime conversion value. If you have set up
81  // customer acquisition goal at either account level or campaign level, this
82  // will include the additional conversion value from new customers for both
83  // biddable and non-biddable conversions. If your campaign has adopted the
84  // customer acquisition goal and selected "bid higher for new customers",
85  // these values will be included in "all_conversions_value". See
86  // https://support.google.com/google-ads/answer/12080169 for more details.
87  optional double all_new_customer_lifetime_value = 294;
88
89  // The total number of conversions. This includes all conversions regardless
90  // of the value of include_in_conversions_metric.
91  optional double all_conversions = 193;
92
93  // The total number of conversions. This includes all conversions regardless
94  // of the value of include_in_conversions_metric. When this column is selected
95  // with date, the values in date column means the conversion date. Details for
96  // the by_conversion_date columns are available at
97  // https://support.google.com/google-ads/answer/9549009.
98  double all_conversions_by_conversion_date = 241;
99
100  // The value of all conversions divided by the total cost of ad interactions
101  // (such as clicks for text ads or views for video ads).
102  optional double all_conversions_value_per_cost = 194;
103
104  // The number of times people clicked the "Call" button to call a store during
105  // or after clicking an ad. This number doesn't include whether or not calls
106  // were connected, or the duration of any calls.
107  //
108  // This metric applies to feed items only.
109  optional double all_conversions_from_click_to_call = 195;
110
111  // The number of times people clicked a "Get directions" button to navigate to
112  // a store after clicking an ad.
113  //
114  // This metric applies to feed items only.
115  optional double all_conversions_from_directions = 196;
116
117  // The value of all conversions from interactions divided by the total number
118  // of interactions.
119  optional double all_conversions_from_interactions_value_per_interaction = 197;
120
121  // The number of times people clicked a link to view a store's menu after
122  // clicking an ad.
123  //
124  // This metric applies to feed items only.
125  optional double all_conversions_from_menu = 198;
126
127  // The number of times people placed an order at a store after clicking an ad.
128  //
129  // This metric applies to feed items only.
130  optional double all_conversions_from_order = 199;
131
132  // The number of other conversions (for example, posting a review or saving a
133  // location for a store) that occurred after people clicked an ad.
134  //
135  // This metric applies to feed items only.
136  optional double all_conversions_from_other_engagement = 200;
137
138  // Estimated number of times people visited a store after clicking an ad.
139  //
140  // This metric applies to feed items only.
141  optional double all_conversions_from_store_visit = 201;
142
143  // The number of times that people were taken to a store's URL after clicking
144  // an ad.
145  //
146  // This metric applies to feed items only.
147  optional double all_conversions_from_store_website = 202;
148
149  // This metric is part of the Auction Insights report, and tells how often
150  // the ads of another participant showed as the very first ad above the
151  // organic search results.
152  // This percentage is computed only over the auctions that you appeared in
153  // the page.
154  //
155  // This metric is not publicly available.
156  optional double auction_insight_search_absolute_top_impression_percentage =
157      258;
158
159  // This metric is part of the Auction Insights report, and tells the
160  // percentage of impressions that another participant obtained, over the total
161  // number of impressions that your ads were eligible for.
162  // Any value below 0.1 is reported as 0.0999.
163  //
164  // This metric is not publicly available.
165  optional double auction_insight_search_impression_share = 259;
166
167  // This metric is part of the Auction Insights report, and tells the
168  // percentage of impressions that your ads outranked (showed above)
169  // another participant in the auction, compared to the total number of
170  // impressions that your ads were eligible for.
171  // Any value below 0.1 is reported as 0.0999.
172  //
173  // This metric is not publicly available.
174  optional double auction_insight_search_outranking_share = 260;
175
176  // This metric is part of the Auction Insights report, and tells how often
177  // another participant's ad received an impression when your ad also received
178  // an impression.
179  //
180  // This metric is not publicly available.
181  optional double auction_insight_search_overlap_rate = 261;
182
183  // This metric is part of the Auction Insights report, and tells how often
184  // another participant's ad was shown in a higher position than yours, when
185  // both of your ads were shown at the same page.
186  //
187  // This metric is not publicly available.
188  optional double auction_insight_search_position_above_rate = 262;
189
190  // This metric is part of the Auction Insights report, and tells how often
191  // the ads of another participant showed above the organic search results.
192  // This percentage is computed only over the auctions that you appeared in
193  // the page.
194  //
195  // This metric is not publicly available.
196  optional double auction_insight_search_top_impression_percentage = 263;
197
198  // The average amount you pay per interaction. This amount is the total cost
199  // of your ads divided by the total number of interactions.
200  optional double average_cost = 203;
201
202  // The total cost of all clicks divided by the total number of clicks
203  // received.
204  optional double average_cpc = 204;
205
206  // The average amount that you've been charged for an ad engagement. This
207  // amount is the total cost of all ad engagements divided by the total number
208  // of ad engagements.
209  optional double average_cpe = 205;
210
211  // Average cost-per-thousand impressions (CPM).
212  optional double average_cpm = 206;
213
214  // The average amount you pay each time someone views your ad.
215  // The average CPV is defined by the total cost of all ad views divided by
216  // the number of views.
217  optional double average_cpv = 207;
218
219  // Average number of pages viewed per session.
220  optional double average_page_views = 208;
221
222  // Total duration of all sessions (in seconds) / number of sessions. Imported
223  // from Google Analytics.
224  optional double average_time_on_site = 209;
225
226  // An indication of how other advertisers are bidding on similar products.
227  optional double benchmark_average_max_cpc = 210;
228
229  // Number of app installs.
230  optional double biddable_app_install_conversions = 254;
231
232  // Number of in-app actions.
233  optional double biddable_app_post_install_conversions = 255;
234
235  // An indication on how other advertisers' Shopping ads for similar products
236  // are performing based on how often people who see their ad click on it.
237  optional double benchmark_ctr = 211;
238
239  // Percentage of clicks where the user only visited a single page on your
240  // site. Imported from Google Analytics.
241  optional double bounce_rate = 212;
242
243  // The number of clicks.
244  optional int64 clicks = 131;
245
246  // The number of times your ad or your site's listing in the unpaid
247  // results was clicked. See the help page at
248  // https://support.google.com/google-ads/answer/3097241 for details.
249  optional int64 combined_clicks = 156;
250
251  // The number of times your ad or your site's listing in the unpaid
252  // results was clicked (combined_clicks) divided by combined_queries. See the
253  // help page at https://support.google.com/google-ads/answer/3097241 for
254  // details.
255  optional double combined_clicks_per_query = 157;
256
257  // The number of searches that returned pages from your site in the unpaid
258  // results or showed one of your text ads. See the help page at
259  // https://support.google.com/google-ads/answer/3097241 for details.
260  optional int64 combined_queries = 158;
261
262  // The estimated percent of times that your ad was eligible to show
263  // on the Display Network but didn't because your budget was too low.
264  // Note: Content budget lost impression share is reported in the range of 0
265  // to 0.9. Any value above 0.9 is reported as 0.9001.
266  optional double content_budget_lost_impression_share = 159;
267
268  // The impressions you've received on the Display Network divided
269  // by the estimated number of impressions you were eligible to receive.
270  // Note: Content impression share is reported in the range of 0.1 to 1. Any
271  // value below 0.1 is reported as 0.0999.
272  optional double content_impression_share = 160;
273
274  // The last date/time a conversion tag for this conversion action successfully
275  // fired and was seen by Google Ads. This firing event may not have been the
276  // result of an attributable conversion (for example, because the tag was
277  // fired from a browser that did not previously click an ad from an
278  // appropriate advertiser). The date/time is in the customer's time zone.
279  optional string conversion_last_received_request_date_time = 161;
280
281  // The date of the most recent conversion for this conversion action. The date
282  // is in the customer's time zone.
283  optional string conversion_last_conversion_date = 162;
284
285  // The estimated percentage of impressions on the Display Network
286  // that your ads didn't receive due to poor Ad Rank.
287  // Note: Content rank lost impression share is reported in the range of 0
288  // to 0.9. Any value above 0.9 is reported as 0.9001.
289  optional double content_rank_lost_impression_share = 163;
290
291  // Conversions from interactions divided by the number of ad interactions
292  // (such as clicks for text ads or views for video ads). This only includes
293  // conversion actions which include_in_conversions_metric attribute is set to
294  // true. If you use conversion-based bidding, your bid strategies will
295  // optimize for these conversions.
296  optional double conversions_from_interactions_rate = 164;
297
298  // The value of conversions. This only includes conversion actions which
299  // include_in_conversions_metric attribute is set to true. If you use
300  // conversion-based bidding, your bid strategies will optimize for these
301  // conversions.
302  optional double conversions_value = 165;
303
304  // The value of conversions. This only includes conversion actions which
305  // include_in_conversions_metric attribute is set to true. If you use
306  // conversion-based bidding, your bid strategies will optimize for these
307  // conversions. When this column is selected with date, the values in date
308  // column means the conversion date. Details for the by_conversion_date
309  // columns are available at
310  // https://support.google.com/google-ads/answer/9549009.
311  double conversions_value_by_conversion_date = 242;
312
313  // New customers' lifetime conversion value. If you have set up
314  // customer acquisition goal at either account level or campaign level, this
315  // will include the additional conversion value from new customers for
316  // biddable conversions. If your campaign has adopted the customer
317  // acquisition goal and selected "bid higher for new customers", these values
318  // will be included in "conversions_value" for optimization. See
319  // https://support.google.com/google-ads/answer/12080169 for more details.
320  optional double new_customer_lifetime_value = 293;
321
322  // The value of conversions divided by the cost of ad interactions. This only
323  // includes conversion actions which include_in_conversions_metric attribute
324  // is set to true. If you use conversion-based bidding, your bid strategies
325  // will optimize for these conversions.
326  optional double conversions_value_per_cost = 166;
327
328  // The value of conversions from interactions divided by the number of ad
329  // interactions. This only includes conversion actions which
330  // include_in_conversions_metric attribute is set to true. If you use
331  // conversion-based bidding, your bid strategies will optimize for these
332  // conversions.
333  optional double conversions_from_interactions_value_per_interaction = 167;
334
335  // The number of conversions. This only includes conversion actions which
336  // include_in_conversions_metric attribute is set to true. If you use
337  // conversion-based bidding, your bid strategies will optimize for these
338  // conversions.
339  optional double conversions = 168;
340
341  // The number of conversions. This only includes conversion actions which
342  // include_in_conversions_metric attribute is set to true. If you use
343  // conversion-based bidding, your bid strategies will optimize for these
344  // conversions. When this column is selected with date, the values in date
345  // column means the conversion date. Details for the by_conversion_date
346  // columns are available at
347  // https://support.google.com/google-ads/answer/9549009.
348  double conversions_by_conversion_date = 243;
349
350  // The sum of your cost-per-click (CPC) and cost-per-thousand impressions
351  // (CPM) costs during this period.
352  optional int64 cost_micros = 169;
353
354  // The cost of ad interactions divided by all conversions.
355  optional double cost_per_all_conversions = 170;
356
357  // The cost of ad interactions divided by conversions. This only includes
358  // conversion actions which include_in_conversions_metric attribute is set to
359  // true. If you use conversion-based bidding, your bid strategies will
360  // optimize for these conversions.
361  optional double cost_per_conversion = 171;
362
363  // The cost of ad interactions divided by current model attributed
364  // conversions. This only includes conversion actions which
365  // include_in_conversions_metric attribute is set to true. If you use
366  // conversion-based bidding, your bid strategies will optimize for these
367  // conversions.
368  optional double cost_per_current_model_attributed_conversion = 172;
369
370  // Conversions from when a customer clicks on a Google Ads ad on one device,
371  // then converts on a different device or browser.
372  // Cross-device conversions are already included in all_conversions.
373  optional double cross_device_conversions = 173;
374
375  // The number of clicks your ad receives (Clicks) divided by the number
376  // of times your ad is shown (Impressions).
377  optional double ctr = 174;
378
379  // Shows how your historic conversions data would look under the attribution
380  // model you've currently selected. This only includes conversion actions
381  // which include_in_conversions_metric attribute is set to true. If you use
382  // conversion-based bidding, your bid strategies will optimize for these
383  // conversions.
384  optional double current_model_attributed_conversions = 175;
385
386  // Current model attributed conversions from interactions divided by the
387  // number of ad interactions (such as clicks for text ads or views for video
388  // ads). This only includes conversion actions which
389  // include_in_conversions_metric attribute is set to true. If you use
390  // conversion-based bidding, your bid strategies will optimize for these
391  // conversions.
392  optional double current_model_attributed_conversions_from_interactions_rate =
393      176;
394
395  // The value of current model attributed conversions from interactions divided
396  // by the number of ad interactions. This only includes conversion actions
397  // which include_in_conversions_metric attribute is set to true. If you use
398  // conversion-based bidding, your bid strategies will optimize for these
399  // conversions.
400  optional double
401      current_model_attributed_conversions_from_interactions_value_per_interaction =
402          177;
403
404  // The value of current model attributed conversions. This only includes
405  // conversion actions which include_in_conversions_metric attribute is set to
406  // true. If you use conversion-based bidding, your bid strategies will
407  // optimize for these conversions.
408  optional double current_model_attributed_conversions_value = 178;
409
410  // The value of current model attributed conversions divided by the cost of ad
411  // interactions. This only includes conversion actions which
412  // include_in_conversions_metric attribute is set to true. If you use
413  // conversion-based bidding, your bid strategies will optimize for these
414  // conversions.
415  optional double current_model_attributed_conversions_value_per_cost = 179;
416
417  // How often people engage with your ad after it's shown to them. This is the
418  // number of ad expansions divided by the number of times your ad is shown.
419  optional double engagement_rate = 180;
420
421  // The number of engagements.
422  // An engagement occurs when a viewer expands your Lightbox ad. Also, in the
423  // future, other ad types may support engagement metrics.
424  optional int64 engagements = 181;
425
426  // Average lead value based on clicks.
427  optional double hotel_average_lead_value_micros = 213;
428
429  // Commission bid rate in micros. A 20% commission is represented as
430  // 200,000.
431  optional int64 hotel_commission_rate_micros = 256;
432
433  // Expected commission cost. The result of multiplying the commission value
434  // times the hotel_commission_rate in advertiser currency.
435  optional double hotel_expected_commission_cost = 257;
436
437  // The average price difference between the price offered by reporting hotel
438  // advertiser and the cheapest price offered by the competing advertiser.
439  optional double hotel_price_difference_percentage = 214;
440
441  // The number of impressions that hotel partners could have had given their
442  // feed performance.
443  optional int64 hotel_eligible_impressions = 215;
444
445  // The creative historical quality score.
446  google.ads.googleads.v14.enums.QualityScoreBucketEnum.QualityScoreBucket
447      historical_creative_quality_score = 80;
448
449  // The quality of historical landing page experience.
450  google.ads.googleads.v14.enums.QualityScoreBucketEnum.QualityScoreBucket
451      historical_landing_page_quality_score = 81;
452
453  // The historical quality score.
454  optional int64 historical_quality_score = 216;
455
456  // The historical search predicted click through rate (CTR).
457  google.ads.googleads.v14.enums.QualityScoreBucketEnum.QualityScoreBucket
458      historical_search_predicted_ctr = 83;
459
460  // The number of times the ad was forwarded to someone else as a message.
461  optional int64 gmail_forwards = 217;
462
463  // The number of times someone has saved your Gmail ad to their inbox as a
464  // message.
465  optional int64 gmail_saves = 218;
466
467  // The number of clicks to the landing page on the expanded state of Gmail
468  // ads.
469  optional int64 gmail_secondary_clicks = 219;
470
471  // The number of times a store's location-based ad was shown.
472  //
473  // This metric applies to feed items only.
474  optional int64 impressions_from_store_reach = 220;
475
476  // Count of how often your ad has appeared on a search results page or
477  // website on the Google Network.
478  optional int64 impressions = 221;
479
480  // How often people interact with your ad after it is shown to them.
481  // This is the number of interactions divided by the number of times your ad
482  // is shown.
483  optional double interaction_rate = 222;
484
485  // The number of interactions.
486  // An interaction is the main user action associated with an ad format-clicks
487  // for text and shopping ads, views for video ads, and so on.
488  optional int64 interactions = 223;
489
490  // The types of payable and free interactions.
491  repeated google.ads.googleads.v14.enums.InteractionEventTypeEnum
492      .InteractionEventType interaction_event_types = 100;
493
494  // The percentage of clicks filtered out of your total number of clicks
495  // (filtered + non-filtered clicks) during the reporting period.
496  optional double invalid_click_rate = 224;
497
498  // Number of clicks Google considers illegitimate and doesn't charge you for.
499  optional int64 invalid_clicks = 225;
500
501  // Number of message chats initiated for Click To Message impressions that
502  // were message tracking eligible.
503  optional int64 message_chats = 226;
504
505  // Number of Click To Message impressions that were message tracking eligible.
506  optional int64 message_impressions = 227;
507
508  // Number of message chats initiated (message_chats) divided by the number
509  // of message impressions (message_impressions).
510  // Rate at which a user initiates a message chat from an ad impression with
511  // a messaging option and message tracking enabled.
512  // Note that this rate can be more than 1.0 for a given message impression.
513  optional double message_chat_rate = 228;
514
515  // The percentage of mobile clicks that go to a mobile-friendly page.
516  optional double mobile_friendly_clicks_percentage = 229;
517
518  // Total optimization score uplift of all recommendations.
519  optional double optimization_score_uplift = 247;
520
521  // URL for the optimization score page in the Google Ads web interface.
522  // This metric can be selected from `customer` or `campaign`, and can be
523  // segmented by `segments.recommendation_type`. For example, `SELECT
524  // metrics.optimization_score_url, segments.recommendation_type FROM
525  // customer` will return a URL for each unique (customer, recommendation_type)
526  // combination.
527  optional string optimization_score_url = 248;
528
529  // The number of times someone clicked your site's listing in the unpaid
530  // results for a particular query. See the help page at
531  // https://support.google.com/google-ads/answer/3097241 for details.
532  optional int64 organic_clicks = 230;
533
534  // The number of times someone clicked your site's listing in the unpaid
535  // results (organic_clicks) divided by the total number of searches that
536  // returned pages from your site (organic_queries). See the help page at
537  // https://support.google.com/google-ads/answer/3097241 for details.
538  optional double organic_clicks_per_query = 231;
539
540  // The number of listings for your site in the unpaid search results. See the
541  // help page at https://support.google.com/google-ads/answer/3097241 for
542  // details.
543  optional int64 organic_impressions = 232;
544
545  // The number of times a page from your site was listed in the unpaid search
546  // results (organic_impressions) divided by the number of searches returning
547  // your site's listing in the unpaid results (organic_queries). See the help
548  // page at https://support.google.com/google-ads/answer/3097241 for details.
549  optional double organic_impressions_per_query = 233;
550
551  // The total number of searches that returned your site's listing in the
552  // unpaid results. See the help page at
553  // https://support.google.com/google-ads/answer/3097241 for details.
554  optional int64 organic_queries = 234;
555
556  // Percentage of first-time sessions (from people who had never visited your
557  // site before). Imported from Google Analytics.
558  optional double percent_new_visitors = 235;
559
560  // Number of offline phone calls.
561  optional int64 phone_calls = 236;
562
563  // Number of offline phone impressions.
564  optional int64 phone_impressions = 237;
565
566  // Number of phone calls received (phone_calls) divided by the number of
567  // times your phone number is shown (phone_impressions).
568  optional double phone_through_rate = 238;
569
570  // Your clickthrough rate (Ctr) divided by the average clickthrough rate of
571  // all advertisers on the websites that show your ads. Measures how your ads
572  // perform on Display Network sites compared to other ads on the same sites.
573  optional double relative_ctr = 239;
574
575  // The percentage of the customer's Shopping or Search ad impressions that are
576  // shown in the most prominent Shopping position. See
577  // https://support.google.com/google-ads/answer/7501826
578  // for details. Any value below 0.1 is reported as 0.0999.
579  optional double search_absolute_top_impression_share = 136;
580
581  // The number estimating how often your ad wasn't the very first ad above the
582  // organic search results due to a low budget. Note: Search
583  // budget lost absolute top impression share is reported in the range of 0 to
584  // 0.9. Any value above 0.9 is reported as 0.9001.
585  optional double search_budget_lost_absolute_top_impression_share = 137;
586
587  // The estimated percent of times that your ad was eligible to show on the
588  // Search Network but didn't because your budget was too low. Note: Search
589  // budget lost impression share is reported in the range of 0 to 0.9. Any
590  // value above 0.9 is reported as 0.9001.
591  optional double search_budget_lost_impression_share = 138;
592
593  // The number estimating how often your ad didn't show anywhere above the
594  // organic search results due to a low budget. Note: Search
595  // budget lost top impression share is reported in the range of 0 to 0.9. Any
596  // value above 0.9 is reported as 0.9001.
597  optional double search_budget_lost_top_impression_share = 139;
598
599  // The number of clicks you've received on the Search Network
600  // divided by the estimated number of clicks you were eligible to receive.
601  // Note: Search click share is reported in the range of 0.1 to 1. Any value
602  // below 0.1 is reported as 0.0999.
603  optional double search_click_share = 140;
604
605  // The impressions you've received divided by the estimated number of
606  // impressions you were eligible to receive on the Search Network for search
607  // terms that matched your keywords exactly (or were close variants of your
608  // keyword), regardless of your keyword match types. Note: Search exact match
609  // impression share is reported in the range of 0.1 to 1. Any value below 0.1
610  // is reported as 0.0999.
611  optional double search_exact_match_impression_share = 141;
612
613  // The impressions you've received on the Search Network divided
614  // by the estimated number of impressions you were eligible to receive.
615  // Note: Search impression share is reported in the range of 0.1 to 1. Any
616  // value below 0.1 is reported as 0.0999.
617  optional double search_impression_share = 142;
618
619  // The number estimating how often your ad wasn't the very first ad above the
620  // organic search results due to poor Ad Rank.
621  // Note: Search rank lost absolute top impression share is reported in the
622  // range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
623  optional double search_rank_lost_absolute_top_impression_share = 143;
624
625  // The estimated percentage of impressions on the Search Network
626  // that your ads didn't receive due to poor Ad Rank.
627  // Note: Search rank lost impression share is reported in the range of 0 to
628  // 0.9. Any value above 0.9 is reported as 0.9001.
629  optional double search_rank_lost_impression_share = 144;
630
631  // The number estimating how often your ad didn't show anywhere above the
632  // organic search results due to poor Ad Rank.
633  // Note: Search rank lost top impression share is reported in the range of 0
634  // to 0.9. Any value above 0.9 is reported as 0.9001.
635  optional double search_rank_lost_top_impression_share = 145;
636
637  // The impressions you've received in the top location (anywhere above the
638  // organic search results) compared to the estimated number of impressions you
639  // were eligible to receive in the top location.
640  // Note: Search top impression share is reported in the range of 0.1 to 1. Any
641  // value below 0.1 is reported as 0.0999.
642  optional double search_top_impression_share = 146;
643
644  // Search volume range for a search term insight category.
645  optional SearchVolumeRange search_volume = 295;
646
647  // A measure of how quickly your page loads after clicks on your mobile ads.
648  // The score is a range from 1 to 10, 10 being the fastest.
649  optional int64 speed_score = 147;
650
651  // The average Target CPA, or unset if not available (for example, for
652  // campaigns that had traffic from portfolio bidding strategies or non-tCPA).
653  optional int64 average_target_cpa_micros = 290;
654
655  // The average Target ROAS, or unset if not available (for example, for
656  // campaigns that had traffic from portfolio bidding strategies or non-tROAS).
657  optional double average_target_roas = 250;
658
659  // The percent of your ad impressions that are shown anywhere above the
660  // organic search results.
661  optional double top_impression_percentage = 148;
662
663  // The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages
664  // that reach a valid AMP page.
665  optional double valid_accelerated_mobile_pages_clicks_percentage = 149;
666
667  // The value of all conversions divided by the number of all conversions.
668  optional double value_per_all_conversions = 150;
669
670  // The value of all conversions divided by the number of all conversions. When
671  // this column is selected with date, the values in date column means the
672  // conversion date. Details for the by_conversion_date columns are available
673  // at https://support.google.com/google-ads/answer/9549009.
674  optional double value_per_all_conversions_by_conversion_date = 244;
675
676  // The value of conversions divided by the number of conversions. This only
677  // includes conversion actions which include_in_conversions_metric attribute
678  // is set to true. If you use conversion-based bidding, your bid strategies
679  // will optimize for these conversions.
680  optional double value_per_conversion = 151;
681
682  // The value of conversions divided by the number of conversions. This only
683  // includes conversion actions which include_in_conversions_metric attribute
684  // is set to true. If you use conversion-based bidding, your bid strategies
685  // will optimize for these conversions. When this column is selected with
686  // date, the values in date column means the conversion date. Details for the
687  // by_conversion_date columns are available at
688  // https://support.google.com/google-ads/answer/9549009.
689  optional double value_per_conversions_by_conversion_date = 245;
690
691  // The value of current model attributed conversions divided by the number of
692  // the conversions. This only includes conversion actions which
693  // include_in_conversions_metric attribute is set to true. If you use
694  // conversion-based bidding, your bid strategies will optimize for these
695  // conversions.
696  optional double value_per_current_model_attributed_conversion = 152;
697
698  // Percentage of impressions where the viewer watched all of your video.
699  optional double video_quartile_p100_rate = 132;
700
701  // Percentage of impressions where the viewer watched 25% of your video.
702  optional double video_quartile_p25_rate = 133;
703
704  // Percentage of impressions where the viewer watched 50% of your video.
705  optional double video_quartile_p50_rate = 134;
706
707  // Percentage of impressions where the viewer watched 75% of your video.
708  optional double video_quartile_p75_rate = 135;
709
710  // The number of views your TrueView video ad receives divided by its number
711  // of impressions, including thumbnail impressions for TrueView in-display
712  // ads.
713  optional double video_view_rate = 153;
714
715  // The number of times your video ads were viewed.
716  optional int64 video_views = 154;
717
718  // The total number of view-through conversions.
719  // These happen when a customer sees an image or rich media ad, then later
720  // completes a conversion on your site without interacting with (for example,
721  // clicking on) another ad.
722  optional int64 view_through_conversions = 155;
723
724  // The number of iOS Store Kit Ad Network conversions.
725  int64 sk_ad_network_conversions = 246;
726
727  // Clicks from properties not owned by the publisher for which the traffic
728  // the publisher has paid for or acquired through incentivized activity
729  int64 publisher_purchased_clicks = 264;
730
731  // Clicks from properties for which the traffic the publisher has not paid
732  // for or acquired through incentivized activity
733  int64 publisher_organic_clicks = 265;
734
735  // Clicks from traffic which is not identified as "Publisher Purchased" or
736  // "Publisher Organic"
737  int64 publisher_unknown_clicks = 266;
738
739  // Number of call button clicks on any location surface after a chargeable ad
740  // event (click or impression). This measure is coming from Asset based
741  // location.
742  optional double all_conversions_from_location_asset_click_to_call = 267;
743
744  // Number of driving directions clicks on any location surface after a
745  // chargeable ad event (click or impression). This measure is coming
746  // from Asset based location.
747  optional double all_conversions_from_location_asset_directions = 268;
748
749  // Number of menu link clicks on any location surface after a chargeable ad
750  // event (click or impression). This measure is coming from Asset based
751  // location.
752  optional double all_conversions_from_location_asset_menu = 269;
753
754  // Number of order clicks on any location surface after a chargeable ad event
755  // (click or impression). This measure is coming from Asset based
756  // location.
757  optional double all_conversions_from_location_asset_order = 270;
758
759  // Number of other types of local action clicks on any location surface after
760  // a chargeable ad event (click or impression). This measure is coming
761  // from Asset based location.
762  optional double all_conversions_from_location_asset_other_engagement = 271;
763
764  // Estimated number of visits to the store after a chargeable
765  // ad event (click or impression). This measure is coming from Asset
766  // based location.
767  optional double all_conversions_from_location_asset_store_visits = 272;
768
769  // Number of website URL clicks on any location surface after a chargeable ad
770  // event (click or impression). This measure is coming from Asset based
771  // location.
772  optional double all_conversions_from_location_asset_website = 273;
773
774  // Number of impressions in which the store location was shown or the location
775  // was used for targeting. This measure is coming from Asset based
776  // location.
777  optional int64 eligible_impressions_from_location_asset_store_reach = 274;
778
779  // Number of call button clicks on any location surface after an impression.
780  // This measure is coming from Asset based location.
781  optional double view_through_conversions_from_location_asset_click_to_call =
782      275;
783
784  // Number of driving directions clicks on any location surface after an
785  // impression. This measure is coming from Asset based location.
786  optional double view_through_conversions_from_location_asset_directions = 276;
787
788  // Number of menu link clicks on any location surface after an impression.
789  // This measure is coming from Asset based location.
790  optional double view_through_conversions_from_location_asset_menu = 277;
791
792  // Number of order clicks on any location surface after an impression. This
793  // measure is coming from Asset based location.
794  optional double view_through_conversions_from_location_asset_order = 278;
795
796  // Number of other types of local action clicks on any location surface after
797  // an impression. This measure is coming from Asset based location.
798  optional double
799      view_through_conversions_from_location_asset_other_engagement = 279;
800
801  // Estimated number of visits to the store after an impression.
802  // This measure is coming from Asset based location.
803  optional double view_through_conversions_from_location_asset_store_visits =
804      280;
805
806  // Number of website URL clicks on any location surface after an impression.
807  // This measure is coming from Asset based location.
808  optional double view_through_conversions_from_location_asset_website = 281;
809}
810
811// Search volume range.
812// Actual search volume falls within this range.
813message SearchVolumeRange {
814  // Lower bound of search volume.
815  optional int64 min = 1;
816
817  // Upper bound of search volume.
818  optional int64 max = 2;
819}
820