xref: /aosp_15_r20/external/googleapis/google/ads/searchads360/v0/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.searchads360.v0.common;
18
19import "google/ads/searchads360/v0/common/value.proto";
20import "google/ads/searchads360/v0/enums/interaction_event_type.proto";
21import "google/ads/searchads360/v0/enums/quality_score_bucket.proto";
22
23option csharp_namespace = "Google.Ads.SearchAds360.V0.Common";
24option go_package = "google.golang.org/genproto/googleapis/ads/searchads360/v0/common;common";
25option java_multiple_files = true;
26option java_outer_classname = "MetricsProto";
27option java_package = "com.google.ads.searchads360.v0.common";
28option objc_class_prefix = "GASA360";
29option php_namespace = "Google\\Ads\\SearchAds360\\V0\\Common";
30option ruby_package = "Google::Ads::SearchAds360::V0::Common";
31
32// Proto file describing metrics.
33
34// Metrics data.
35message Metrics {
36  // Search absolute top impression share is the percentage of your Search ad
37  // impressions that are shown in the most prominent Search position.
38  optional double absolute_top_impression_percentage = 183;
39
40  // All conversions from interactions (as oppose to view through conversions)
41  // divided by the number of ad interactions.
42  optional double all_conversions_from_interactions_rate = 191;
43
44  // The value of all conversions.
45  optional double all_conversions_value = 192;
46
47  // The value of all conversions. When this column is selected with date, the
48  // values in date column means the conversion date. Details for the
49  // by_conversion_date columns are available at
50  // https://support.google.com/sa360/answer/9250611.
51  double all_conversions_value_by_conversion_date = 240;
52
53  // The total number of conversions. This includes all conversions regardless
54  // of the value of include_in_conversions_metric.
55  optional double all_conversions = 193;
56
57  // The total number of conversions. This includes all conversions regardless
58  // of the value of include_in_conversions_metric. When this column is selected
59  // with date, the values in date column means the conversion date. Details for
60  // the by_conversion_date columns are available at
61  // https://support.google.com/sa360/answer/9250611.
62  double all_conversions_by_conversion_date = 241;
63
64  // The value of all conversions divided by the total cost of ad interactions
65  // (such as clicks for text ads or views for video ads).
66  optional double all_conversions_value_per_cost = 194;
67
68  // The number of times people clicked the "Call" button to call a store during
69  // or after clicking an ad. This number doesn't include whether or not calls
70  // were connected, or the duration of any calls.
71  //
72  // This metric applies to feed items only.
73  optional double all_conversions_from_click_to_call = 195;
74
75  // The number of times people clicked a "Get directions" button to navigate to
76  // a store after clicking an ad.
77  //
78  // This metric applies to feed items only.
79  optional double all_conversions_from_directions = 196;
80
81  // The value of all conversions from interactions divided by the total number
82  // of interactions.
83  optional double all_conversions_from_interactions_value_per_interaction = 197;
84
85  // The number of times people clicked a link to view a store's menu after
86  // clicking an ad.
87  //
88  // This metric applies to feed items only.
89  optional double all_conversions_from_menu = 198;
90
91  // The number of times people placed an order at a store after clicking an ad.
92  //
93  // This metric applies to feed items only.
94  optional double all_conversions_from_order = 199;
95
96  // The number of other conversions (for example, posting a review or saving a
97  // location for a store) that occurred after people clicked an ad.
98  //
99  // This metric applies to feed items only.
100  optional double all_conversions_from_other_engagement = 200;
101
102  // Estimated number of times people visited a store after clicking an ad.
103  //
104  // This metric applies to feed items only.
105  optional double all_conversions_from_store_visit = 201;
106
107  // Clicks that Search Ads 360 has successfully recorded and forwarded to an
108  // advertiser's landing page.
109  optional double visits = 289;
110
111  // The number of times that people were taken to a store's URL after clicking
112  // an ad.
113  //
114  // This metric applies to feed items only.
115  optional double all_conversions_from_store_website = 202;
116
117  // The average amount you pay per interaction. This amount is the total cost
118  // of your ads divided by the total number of interactions.
119  optional double average_cost = 203;
120
121  // The total cost of all clicks divided by the total number of clicks
122  // received.
123  // This metric is a monetary value and returned in the customer's currency by
124  // default. See the metrics_currency parameter at
125  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
126  optional double average_cpc = 317;
127
128  // Average cost-per-thousand impressions (CPM).
129  // This metric is a monetary value and returned in the customer's currency by
130  // default. See the metrics_currency parameter at
131  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
132  optional double average_cpm = 318;
133
134  // The number of clicks.
135  optional int64 clicks = 131;
136
137  // The estimated percent of times that your ad was eligible to show
138  // on the Display Network but didn't because your budget was too low.
139  // Note: Content budget lost impression share is reported in the range of 0
140  // to 0.9. Any value above 0.9 is reported as 0.9001.
141  optional double content_budget_lost_impression_share = 159;
142
143  // The impressions you've received on the Display Network divided
144  // by the estimated number of impressions you were eligible to receive.
145  // Note: Content impression share is reported in the range of 0.1 to 1. Any
146  // value below 0.1 is reported as 0.0999.
147  optional double content_impression_share = 160;
148
149  // The conversion custom metrics.
150  repeated Value conversion_custom_metrics = 336;
151
152  // The estimated percentage of impressions on the Display Network
153  // that your ads didn't receive due to poor Ad Rank.
154  // Note: Content rank lost impression share is reported in the range of 0
155  // to 0.9. Any value above 0.9 is reported as 0.9001.
156  optional double content_rank_lost_impression_share = 163;
157
158  // Average biddable conversions (from interaction) per conversion eligible
159  // interaction. Shows how often, on average, an ad interaction leads to a
160  // biddable conversion.
161  optional double conversions_from_interactions_rate = 284;
162
163  // The value of client account conversions. This only
164  // includes conversion actions which
165  // include_in_client_account_conversions_metric attribute is set to true. If
166  // you use conversion-based bidding, your bid strategies will optimize for
167  // these conversions.
168  optional double client_account_conversions_value = 165;
169
170  // The sum of biddable conversions value by conversion date. When this
171  // column is selected with date, the values in date column means the
172  // conversion date.
173  double conversions_value_by_conversion_date = 283;
174
175  // The value of biddable conversion divided by the total cost of conversion
176  // eligible interactions.
177  optional double conversions_value_per_cost = 288;
178
179  // The value of conversions from interactions divided by the number of ad
180  // interactions. This only includes conversion actions which
181  // include_in_conversions_metric attribute is set to true. If you use
182  // conversion-based bidding, your bid strategies will optimize for these
183  // conversions.
184  optional double conversions_from_interactions_value_per_interaction = 167;
185
186  // The number of client account conversions. This only
187  // includes conversion actions which
188  // include_in_client_account_conversions_metric attribute is set to true. If
189  // you use conversion-based bidding, your bid strategies will optimize for
190  // these conversions.
191  optional double client_account_conversions = 168;
192
193  // The sum of conversions by conversion date for biddable conversion types.
194  // Can be fractional due to attribution modeling. When this column is selected
195  // with date, the values in date column means the conversion date.
196  double conversions_by_conversion_date = 282;
197
198  // The sum of your cost-per-click (CPC) and cost-per-thousand impressions
199  // (CPM) costs during this period.
200  // This metric is a monetary value and returned in the customer's currency by
201  // default. See the metrics_currency parameter at
202  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
203  optional int64 cost_micros = 316;
204
205  // The cost of ad interactions divided by all conversions.
206  optional double cost_per_all_conversions = 170;
207
208  // Average conversion eligible cost per biddable conversion.
209  optional double cost_per_conversion = 286;
210
211  // The cost of ad interactions divided by current model attributed
212  // conversions. This only includes conversion actions which
213  // include_in_conversions_metric attribute is set to true. If you use
214  // conversion-based bidding, your bid strategies will optimize for these
215  // conversions.
216  optional double cost_per_current_model_attributed_conversion = 172;
217
218  // Conversions from when a customer clicks on an ad on one device,
219  // then converts on a different device or browser.
220  // Cross-device conversions are already included in all_conversions.
221  optional double cross_device_conversions = 173;
222
223  // The sum of the value of cross-device conversions.
224  optional double cross_device_conversions_value = 253;
225
226  // The number of clicks your ad receives (Clicks) divided by the number
227  // of times your ad is shown (Impressions).
228  optional double ctr = 174;
229
230  // The number of conversions. This only includes conversion actions which
231  // include_in_conversions_metric attribute is set to true. If you use
232  // conversion-based bidding, your bid strategies will optimize for these
233  // conversions.
234  optional double conversions = 251;
235
236  // The sum of conversion values for the conversions included in the
237  // "conversions" field. This metric is useful only if you entered a value for
238  // your conversion actions.
239  optional double conversions_value = 252;
240
241  // The creative historical quality score.
242  google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
243      historical_creative_quality_score = 80;
244
245  // The quality of historical landing page experience.
246  google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
247      historical_landing_page_quality_score = 81;
248
249  // The historical quality score.
250  optional int64 historical_quality_score = 216;
251
252  // The historical search predicted click through rate (CTR).
253  google.ads.searchads360.v0.enums.QualityScoreBucketEnum.QualityScoreBucket
254      historical_search_predicted_ctr = 83;
255
256  // Count of how often your ad has appeared on a search results page or
257  // website on the Google Network.
258  optional int64 impressions = 221;
259
260  // How often people interact with your ad after it is shown to them.
261  // This is the number of interactions divided by the number of times your ad
262  // is shown.
263  optional double interaction_rate = 222;
264
265  // The number of interactions.
266  // An interaction is the main user action associated with an ad format-clicks
267  // for text and shopping ads, views for video ads, and so on.
268  optional int64 interactions = 223;
269
270  // The types of payable and free interactions.
271  repeated google.ads.searchads360.v0.enums.InteractionEventTypeEnum
272      .InteractionEventType interaction_event_types = 100;
273
274  // The percentage of clicks filtered out of your total number of clicks
275  // (filtered + non-filtered clicks) during the reporting period.
276  optional double invalid_click_rate = 224;
277
278  // Number of clicks Google considers illegitimate and doesn't charge you for.
279  optional int64 invalid_clicks = 225;
280
281  // The percentage of mobile clicks that go to a mobile-friendly page.
282  optional double mobile_friendly_clicks_percentage = 229;
283
284  // The raw event conversion metrics.
285  repeated Value raw_event_conversion_metrics = 337;
286
287  // The percentage of the customer's Shopping or Search ad impressions that are
288  // shown in the most prominent Shopping position. See
289  // https://support.google.com/sa360/answer/9566729
290  // for details. Any value below 0.1 is reported as 0.0999.
291  optional double search_absolute_top_impression_share = 136;
292
293  // The number estimating how often your ad wasn't the very first ad among the
294  // top ads in the search results due to a low budget. Note: Search
295  // budget lost absolute top impression share is reported in the range of 0 to
296  // 0.9. Any value above 0.9 is reported as 0.9001.
297  optional double search_budget_lost_absolute_top_impression_share = 137;
298
299  // The estimated percent of times that your ad was eligible to show on the
300  // Search Network but didn't because your budget was too low. Note: Search
301  // budget lost impression share is reported in the range of 0 to 0.9. Any
302  // value above 0.9 is reported as 0.9001.
303  optional double search_budget_lost_impression_share = 138;
304
305  // The number estimating how often your ad didn't show adjacent to the top
306  // organic search results due to a low budget. Note: Search
307  // budget lost top impression share is reported in the range of 0 to 0.9. Any
308  // value above 0.9 is reported as 0.9001.
309  optional double search_budget_lost_top_impression_share = 139;
310
311  // The number of clicks you've received on the Search Network
312  // divided by the estimated number of clicks you were eligible to receive.
313  // Note: Search click share is reported in the range of 0.1 to 1. Any value
314  // below 0.1 is reported as 0.0999.
315  optional double search_click_share = 140;
316
317  // The impressions you've received divided by the estimated number of
318  // impressions you were eligible to receive on the Search Network for search
319  // terms that matched your keywords exactly (or were close variants of your
320  // keyword), regardless of your keyword match types. Note: Search exact match
321  // impression share is reported in the range of 0.1 to 1. Any value below 0.1
322  // is reported as 0.0999.
323  optional double search_exact_match_impression_share = 141;
324
325  // The impressions you've received on the Search Network divided
326  // by the estimated number of impressions you were eligible to receive.
327  // Note: Search impression share is reported in the range of 0.1 to 1. Any
328  // value below 0.1 is reported as 0.0999.
329  optional double search_impression_share = 142;
330
331  // The number estimating how often your ad wasn't the very first ad among the
332  // top ads in the search results due to poor Ad Rank.
333  // Note: Search rank lost absolute top impression share is reported in the
334  // range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
335  optional double search_rank_lost_absolute_top_impression_share = 143;
336
337  // The estimated percentage of impressions on the Search Network
338  // that your ads didn't receive due to poor Ad Rank.
339  // Note: Search rank lost impression share is reported in the range of 0 to
340  // 0.9. Any value above 0.9 is reported as 0.9001.
341  optional double search_rank_lost_impression_share = 144;
342
343  // The number estimating how often your ad didn't show adjacent to the top
344  // organic search results due to poor Ad Rank.
345  // Note: Search rank lost top impression share is reported in the range of 0
346  // to 0.9. Any value above 0.9 is reported as 0.9001.
347  optional double search_rank_lost_top_impression_share = 145;
348
349  // The impressions you've received among the top ads compared to the estimated
350  // number of impressions you were eligible to receive among the top ads.
351  // Note: Search top impression share is reported in the range of 0.1 to 1. Any
352  // value below 0.1 is reported as 0.0999.
353  //
354  // Top ads are generally above the top organic results, although they may show
355  // below the top organic results on certain queries.
356  optional double search_top_impression_share = 146;
357
358  // The percent of your ad impressions that are shown adjacent to the top
359  // organic search results.
360  optional double top_impression_percentage = 148;
361
362  // The value of all conversions divided by the number of all conversions.
363  optional double value_per_all_conversions = 150;
364
365  // The value of all conversions divided by the number of all conversions. When
366  // this column is selected with date, the values in date column means the
367  // conversion date. Details for the by_conversion_date columns are available
368  // at https://support.google.com/sa360/answer/9250611.
369  optional double value_per_all_conversions_by_conversion_date = 244;
370
371  // The value of biddable conversion divided by the number of biddable
372  // conversions. Shows how much, on average, each of the biddable conversions
373  // is worth.
374  optional double value_per_conversion = 287;
375
376  // Biddable conversions value by conversion date divided by biddable
377  // conversions by conversion date. Shows how much, on average, each of the
378  // biddable conversions is worth (by conversion date). When this column is
379  // selected with date, the values in date column means the conversion date.
380  optional double value_per_conversions_by_conversion_date = 285;
381
382  // The total number of view-through conversions.
383  // These happen when a customer sees an image or rich media ad, then later
384  // completes a conversion on your site without interacting with (for example,
385  // clicking on) another ad.
386  optional int64 client_account_view_through_conversions = 155;
387
388  // Client account cross-sell cost of goods sold (COGS) is the total cost
389  // of products sold as a result of advertising a different product.
390  // How it works: You report conversions with cart data for
391  // completed purchases on your website. If the ad that was interacted with
392  // before the purchase has an associated product (see Shopping Ads) then this
393  // product is considered the advertised product. Any product included in the
394  // order the customer places is a sold product. If these products don't match
395  // then this is considered cross-sell. Cross-sell cost of goods sold is the
396  // total cost of the products sold that weren't advertised. Example: Someone
397  // clicked on a Shopping ad for a hat then bought the same hat and a shirt.
398  // The hat has a cost of goods sold value of $3, the shirt has a cost of goods
399  // sold value of $5. The cross-sell cost of goods sold for this order is $5.
400  // This metric is only available if you report conversions with cart data.
401  // This metric is a monetary value and returned in the customer's currency by
402  // default. See the metrics_currency parameter at
403  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
404  optional int64 client_account_cross_sell_cost_of_goods_sold_micros = 321;
405
406  // Cross-sell cost of goods sold (COGS) is the total cost of products sold as
407  // a result of advertising a different product.
408  // How it works: You report conversions with cart data for
409  // completed purchases on your website. If the ad that was interacted with
410  // before the purchase has an associated product (see Shopping Ads) then this
411  // product is considered the advertised product. Any product included in the
412  // order the customer places is a sold product. If these products don't match
413  // then this is considered cross-sell. Cross-sell cost of goods sold is the
414  // total cost of the products sold that weren't advertised. Example: Someone
415  // clicked on a Shopping ad for a hat then bought the same hat and a shirt.
416  // The hat has a cost of goods sold value of $3, the shirt has a cost of goods
417  // sold value of $5. The cross-sell cost of goods sold for this order is $5.
418  // This metric is only available if you report conversions with cart data.
419  // This metric is a monetary value and returned in the customer's currency by
420  // default. See the metrics_currency parameter at
421  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
422  optional int64 cross_sell_cost_of_goods_sold_micros = 327;
423
424  // Client account cross-sell gross profit is the profit you made from
425  // products sold as a result of advertising a different product, minus cost of
426  // goods sold (COGS).
427  // How it works: You report conversions with cart data for completed purchases
428  // on your website. If the ad that was interacted with before the purchase has
429  // an associated product (see Shopping Ads) then this product is considered
430  // the advertised product. Any product included in the purchase is a sold
431  // product. If these products don't match then this is considered cross-sell.
432  // Cross-sell gross profit is the revenue you made from cross-sell attributed
433  // to your ads minus the cost of the goods sold. Example: Someone clicked on a
434  // Shopping ad for a hat then bought the same hat and a shirt. The shirt is
435  // priced $20 and has a cost of goods sold value of $5. The cross-sell gross
436  // profit of this order is $15 = $20 - $5. This metric is only available if
437  // you report conversions with cart data. This metric is a monetary value and
438  // returned in the customer's currency by default. See the metrics_currency
439  // parameter at
440  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
441  optional int64 client_account_cross_sell_gross_profit_micros = 322;
442
443  // Cross-sell gross profit is the profit you made from products sold as a
444  // result of advertising a different product, minus cost of goods sold (COGS).
445  // How it works: You report conversions with cart data for completed purchases
446  // on your website. If the ad that was interacted with before the purchase has
447  // an associated product (see Shopping Ads) then this product is considered
448  // the advertised product. Any product included in the purchase is a sold
449  // product. If these products don't match then this is considered cross-sell.
450  // Cross-sell gross profit is the revenue you made from cross-sell attributed
451  // to your ads minus the cost of the goods sold.
452  // Example: Someone clicked on a Shopping ad for a hat then bought the same
453  // hat and a shirt. The shirt is priced $20 and has a cost of goods sold value
454  // of $5. The cross-sell gross profit of this order is $15 = $20 - $5.
455  // This metric is only available if you report conversions with cart data.
456  // This metric is a monetary value and returned in the customer's currency by
457  // default. See the metrics_currency parameter at
458  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
459  optional int64 cross_sell_gross_profit_micros = 328;
460
461  // Client account cross-sell revenue is the total amount you made from
462  // products sold as a result of advertising a different product.
463  // How it works: You report conversions with cart data for completed purchases
464  // on your website. If the ad that was interacted with before the purchase has
465  // an associated product (see Shopping Ads) then this product is considered
466  // the advertised product. Any product included in the order the customer
467  // places is a sold product. If these products don't match then this is
468  // considered cross-sell. Cross-sell revenue is the total value you made from
469  // cross-sell attributed to your ads. Example: Someone clicked on a Shopping
470  // ad for a hat then bought the same hat and a shirt. The hat is priced $10
471  // and the shirt is priced $20. The cross-sell revenue of this order is $20.
472  // This metric is only available if you report conversions with cart data.
473  // This metric is a monetary value and returned in the customer's currency by
474  // default. See the metrics_currency parameter at
475  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
476  optional int64 client_account_cross_sell_revenue_micros = 323;
477
478  // Cross-sell revenue is the total amount you made from products sold as a
479  // result of advertising a different product.
480  // How it works: You report conversions with cart data for completed purchases
481  // on your website. If the ad that was interacted with before the purchase has
482  // an associated product (see Shopping Ads) then this product is considered
483  // the advertised product. Any product included in the order the customer
484  // places is a sold product. If these products don't match then this is
485  // considered cross-sell. Cross-sell revenue is the total value you made from
486  // cross-sell attributed to your ads. Example: Someone clicked on a Shopping
487  // ad for a hat then bought the same hat and a shirt. The hat is priced $10
488  // and the shirt is priced $20. The cross-sell revenue of this order is $20.
489  // This metric is only available if you report conversions with cart data.
490  // This metric is a monetary value and returned in the customer's currency by
491  // default. See the metrics_currency parameter at
492  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
493  optional int64 cross_sell_revenue_micros = 329;
494
495  // Client account cross-sell units sold is
496  // the total number of products sold as a result of advertising a different
497  // product.
498  // How it works: You report conversions with cart data for completed purchases
499  // on your website. If the ad that was interacted with before the purchase has
500  // an associated product (see Shopping Ads) then this product is considered
501  // the advertised product. Any product included in the order the customer
502  // places is a sold product. If these products don't match then this is
503  // considered cross-sell. Cross-sell units sold is the total number of
504  // cross-sold products from all orders attributed to your ads.
505  // Example: Someone clicked on a Shopping ad for a hat then bought the same
506  // hat, a shirt and a jacket. The cross-sell units sold in this order is 2.
507  // This metric is only available if you report conversions with cart data.
508  optional double client_account_cross_sell_units_sold = 307;
509
510  // Cross-sell units sold is the total number of products sold as a result of
511  // advertising a different product.
512  // How it works: You report conversions with cart data for completed purchases
513  // on your website. If the ad that was interacted with before the purchase has
514  // an associated product (see Shopping Ads) then this product is considered
515  // the advertised product. Any product included in the order the customer
516  // places is a sold product. If these products don't match then this is
517  // considered cross-sell. Cross-sell units sold is the total number of
518  // cross-sold products from all orders attributed to your ads.
519  // Example: Someone clicked on a Shopping ad for a hat then bought the same
520  // hat, a shirt and a jacket. The cross-sell units sold in this order is 2.
521  // This metric is only available if you report conversions with cart data.
522  optional double cross_sell_units_sold = 330;
523
524  // Client account lead cost of goods sold (COGS) is the total cost of
525  // products sold as a result of advertising the same product.
526  // How it works: You report conversions with cart data for completed purchases
527  // on your website. If the ad that was interacted with has an associated
528  // product (see Shopping Ads) then this product is considered the advertised
529  // product. Any product included in the order the customer places is a sold
530  // product. If the advertised and sold products match, then the cost of these
531  // goods is counted under lead cost of goods sold. Example: Someone clicked on
532  // a Shopping ad for a hat then bought the same hat and a shirt. The hat has a
533  // cost of goods sold value of $3, the shirt has a cost of goods sold value of
534  // $5. The lead cost of goods sold for this order is $3. This metric is only
535  // available if you report conversions with cart data. This metric is a
536  // monetary value and returned in the customer's currency by default. See the
537  // metrics_currency parameter at
538  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
539  optional int64 client_account_lead_cost_of_goods_sold_micros = 324;
540
541  // Lead cost of goods sold (COGS) is the total cost of products sold as a
542  // result of advertising the same product.
543  // How it works: You report conversions with cart data for completed purchases
544  // on your website. If the ad that was interacted with has an associated
545  // product (see Shopping Ads) then this product is considered the advertised
546  // product. Any product included in the order the customer places is a sold
547  // product. If the advertised and sold products match, then the cost of these
548  // goods is counted under lead cost of goods sold. Example: Someone clicked on
549  // a Shopping ad for a hat then bought the same hat and a shirt. The hat has a
550  // cost of goods sold value of $3, the shirt has a cost of goods sold value of
551  // $5. The lead cost of goods sold for this order is $3. This metric is only
552  // available if you report conversions with cart data. This metric is a
553  // monetary value and returned in the customer's currency by default. See the
554  // metrics_currency parameter at
555  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
556  optional int64 lead_cost_of_goods_sold_micros = 332;
557
558  // Client account lead gross profit is the profit you made from products
559  // sold as a result of advertising the same product, minus cost of goods sold
560  // (COGS).
561  // How it works: You report conversions with cart data for completed purchases
562  // on your website. If the ad that was interacted with before the purchase has
563  // an associated product (see Shopping Ads) then this product is considered
564  // the advertised product. Any product included in the order the customer
565  // places is a sold product. If the advertised and sold products match, then
566  // the revenue you made from these sales minus the cost of goods sold is your
567  // lead gross profit. Example: Someone clicked on a Shopping ad for a hat then
568  // bought the same hat and a shirt. The hat is priced $10 and has a cost of
569  // goods sold value of $3. The lead gross profit of this order is $7 = $10 -
570  // $3. This metric is only available if you report conversions with cart data.
571  // This metric is a monetary value and returned in the customer's currency by
572  // default. See the metrics_currency parameter at
573  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
574  optional int64 client_account_lead_gross_profit_micros = 325;
575
576  // Lead gross profit is the profit you made from products sold as a result of
577  // advertising the same product, minus cost of goods sold (COGS).
578  // How it works: You report conversions with cart data for completed purchases
579  // on your website. If the ad that was interacted with before the purchase has
580  // an associated product (see Shopping Ads) then this product is considered
581  // the advertised product. Any product included in the order the customer
582  // places is a sold product. If the advertised and sold products match, then
583  // the revenue you made from these sales minus the cost of goods sold is your
584  // lead gross profit. Example: Someone clicked on a Shopping ad for a hat then
585  // bought the same hat and a shirt. The hat is priced $10 and has a cost of
586  // goods sold value of $3. The lead gross profit of this order is $7 = $10 -
587  // $3. This metric is only available if you report conversions with cart data.
588  // This metric is a monetary value and returned in the customer's currency by
589  // default. See the metrics_currency parameter at
590  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
591  optional int64 lead_gross_profit_micros = 333;
592
593  // Client account lead revenue is the total amount you made from
594  // products sold as a result of advertising the same product.
595  // How it works: You report conversions with cart data for completed purchases
596  // on your website. If the ad that was interacted with before the purchase has
597  // an associated product (see Shopping Ads) then this product is considered
598  // the advertised product. Any product included in the order the customer
599  // places is a sold product. If the advertised and sold products match, then
600  // the total value you made from the sales of these products is shown under
601  // lead revenue. Example: Someone clicked on a Shopping ad for a hat then
602  // bought the same hat and a shirt. The hat is priced $10 and the shirt is
603  // priced $20. The lead revenue of this order is $10. This metric is only
604  // available if you report conversions with cart data. This metric is a
605  // monetary value and returned in the customer's currency by default. See the
606  // metrics_currency parameter at
607  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
608  optional int64 client_account_lead_revenue_micros = 326;
609
610  // Lead revenue is the total amount you made from products sold as a result of
611  // advertising the same product.
612  // How it works: You report conversions with cart data for completed purchases
613  // on your website. If the ad that was interacted with before the purchase has
614  // an associated product (see Shopping Ads) then this product is considered
615  // the advertised product. Any product included in the order the customer
616  // places is a sold product. If the advertised and sold products match, then
617  // the total value you made from the sales of these products is shown under
618  // lead revenue.
619  // Example: Someone clicked on a Shopping ad for a hat then bought the same
620  // hat and a shirt. The hat is priced $10 and the shirt is priced $20. The
621  // lead revenue of this order is $10.
622  // This metric is only available if you report conversions with cart data.
623  // This metric is a monetary value and returned in the customer's currency by
624  // default. See the metrics_currency parameter at
625  // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
626  optional int64 lead_revenue_micros = 334;
627
628  // Client account lead units sold is the total number of
629  // products sold as a result of advertising the same product.
630  // How it works: You report conversions with cart data for completed purchases
631  // on your website. If the ad that was interacted with before the purchase has
632  // an associated product (see Shopping Ads) then this product is considered
633  // the advertised product. Any product included in the order the customer
634  // places is a sold product. If the advertised and sold products match, then
635  // the total number of these products sold is shown under lead units sold.
636  // Example: Someone clicked on a Shopping ad for a hat then bought the same
637  // hat, a shirt and a jacket. The lead units sold in this order is 1.
638  // This metric is only available if you report conversions with cart data.
639  optional double client_account_lead_units_sold = 311;
640
641  // Lead units sold is the total number of products sold as a result of
642  // advertising the same product.
643  // How it works: You report conversions with cart data for completed purchases
644  // on your website. If the ad that was interacted with before the purchase has
645  // an associated product (see Shopping Ads) then this product is considered
646  // the advertised product. Any product included in the order the customer
647  // places is a sold product. If the advertised and sold products match, then
648  // the total number of these products sold is shown under lead units sold.
649  // Example: Someone clicked on a Shopping ad for a hat then bought the same
650  // hat, a shirt and a jacket. The lead units sold in this order is 1.
651  // This metric is only available if you report conversions with cart data.
652  optional double lead_units_sold = 335;
653}
654