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