/common/metrics.proto

--- v14/common/metrics.proto    2023-10-19 02:11:02.000000000 +0000
+++ v15/common/metrics.proto    2023-10-19 02:11:10.000000000 +0000
@@ -372,6 +372,9 @@
   // Cross-device conversions are already included in all_conversions.
   optional double cross_device_conversions = 173;

+  // The sum of the value of cross-device conversions, in micros.
+  optional int64 cross_device_conversions_value_micros = 312;
+
   // The number of clicks your ad receives (Clicks) divided by the number
   // of times your ad is shown (Impressions).
   optional double ctr = 174;
@@ -722,7 +725,10 @@
   optional int64 view_through_conversions = 155;

   // The number of iOS Store Kit Ad Network conversions.
-  int64 sk_ad_network_conversions = 246;
+  int64 sk_ad_network_installs = 246;
+
+  // The total number of iOS Store Kit Ad Network conversions.
+  int64 sk_ad_network_total_conversions = 292;

   // Clicks from properties not owned by the publisher for which the traffic
   // the publisher has paid for or acquired through incentivized activity
@@ -806,6 +812,230 @@
   // Number of website URL clicks on any location surface after an impression.
   // This measure is coming from Asset based location.
   optional double view_through_conversions_from_location_asset_website = 281;
+
+  // Orders is the total number of purchase conversions you received attributed
+  // to your ads.
+  // How it works: You report conversions with cart data for
+  // completed purchases on your website. If a conversion is attributed to
+  // previous interactions with your ads (clicks for text or Shopping ads, views
+  // for video ads etc.) it's counted as an order.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt in an order on your website. Even though they bought 2
+  // products, this would count as 1 order.
+  // This metric is only available if you report conversions with cart data.
+  optional double orders = 296;
+
+  // Average order value is the average revenue you made per order attributed to
+  // your ads.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. Average order value is the total revenue from your orders
+  // divided by the total number of orders.
+  // Example: You received 3 orders which made $10, $15 and $20 worth of
+  // revenue. The average order value is $15 = ($10 + $15 + $20)/3.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 average_order_value_micros = 297;
+
+  // Average cart size is the average number of products in each order
+  // attributed to your ads.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. Average cart size is the total number of products sold
+  // divided by the total number of orders you received.
+  // Example: You received 2 orders, the first included 3 products and the
+  // second included 2. The average cart size is 2.5 products = (3+2)/2.
+  // This metric is only available if you report conversions with cart data.
+  optional double average_cart_size = 298;
+
+  // Cost of goods sold (COGS) is the total cost of the products you sold in
+  // orders attributed to your ads.
+  // How it works: You can add a cost of goods sold value to every product in
+  // Merchant Center. If you report conversions with cart data, the products you
+  // sold are matched with their cost of goods sold value and this can be used
+  // to calculate the gross profit you made on each order.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The hat has a cost of goods sold value of $3, the shirt
+  // has a cost of goods sold value of $5. The cost of goods sold for this order
+  // is $8 = $3 + $5.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 cost_of_goods_sold_micros = 299;
+
+  // Gross profit is the profit you made from orders attributed to your ads
+  // minus the cost of goods sold (COGS).
+  // How it works: Gross profit is the revenue you made from sales attributed to
+  // your ads minus cost of goods sold. Gross profit calculations only include
+  // products that have a cost of goods sold value in Merchant Center.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt in an order from your website. The hat is priced $10 and
+  // the shirt is priced $20. The hat has a cost of goods sold value of $3, but
+  // the shirt has no cost of goods sold value. Gross profit for this order will
+  // only take into account the hat, so it's $7 = $10 - $3.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 gross_profit_micros = 300;
+
+  // Gross profit margin is the percentage gross profit you made from orders
+  // attributed to your ads, after taking out the cost of goods sold (COGS).
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. Gross profit margin is the gross profit you made divided
+  // by your total revenue and multiplied by 100%. Gross profit margin
+  // calculations only include products that have a cost of goods sold value in
+  // Merchant Center.
+  // Example: Someone bought a hat and a shirt in an order on your website. The
+  // hat is priced $10 and has a cost of goods sold value of $3. The shirt is
+  // priced $20 but has no cost of goods sold value. Gross profit margin for
+  // this order will only take into account the hat because it has a cost of
+  // goods sold value, so it's 70% = ($10 - $3)/$10 x 100%.
+  // This metric is only available if you report conversions with cart data.
+  optional double gross_profit_margin = 301;
+
+  // Revenue is the total amount you made from orders attributed to your ads.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. Revenue is the total value of all the orders you received
+  // attributed to your ads, minus any discount.
+  // Example: Someone clicked on a Shopping ad  for a hat then bought the same
+  // hat and a shirt in an order from your website. The hat is priced $10 and
+  // the shirt is priced $20. The entire order has a $5 discount. The revenue
+  // from this order is $25 = ($10 + $20) - $5.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 revenue_micros = 302;
+
+  // Units sold is the total number of products sold from orders attributed to
+  // your ads.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. Units sold is the total number of products sold from all
+  // orders attributed to your ads.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat, a shirt and a jacket. The units sold in this order is 3.
+  // This metric is only available if you report conversions with cart data.
+  optional double units_sold = 303;
+
+  // Cross-sell cost of goods sold (COGS) is the total cost of products sold as
+  // a result of advertising a different product.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the order the customer
+  // places is a sold product. If these products don't match then this is
+  // considered cross-sell. Cross-sell cost of goods sold is the total cost of
+  // the products sold that weren't advertised.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The hat has a cost of goods sold value of $3, the shirt
+  // has a cost of goods sold value of $5. The cross-sell cost of goods sold for
+  // this order is $5.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 cross_sell_cost_of_goods_sold_micros = 304;
+
+  // Cross-sell gross profit is the profit you made from products sold as a
+  // result of advertising a different product, minus cost of goods sold (COGS).
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the purchase is a sold
+  // product. If these products don't match then this is considered cross-sell.
+  // Cross-sell gross profit is the revenue you made from cross-sell attributed
+  // to your ads minus the cost of the goods sold.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The shirt is priced $20 and has a cost of goods sold value
+  // of $5. The cross-sell gross profit of this order is $15 = $20 - $5.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 cross_sell_gross_profit_micros = 305;
+
+  // Cross-sell revenue is the total amount you made from products sold as a
+  // result of advertising a different product.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the order the customer
+  // places is a sold product. If these products don't match then this is
+  // considered cross-sell. Cross-sell revenue is the total value you made from
+  // cross-sell attributed to your ads.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The hat is priced $10 and the shirt is priced $20. The
+  // cross-sell revenue of this order is $20.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 cross_sell_revenue_micros = 306;
+
+  // Cross-sell units sold is the total number of products sold as a result of
+  // advertising a different product.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the order the customer
+  // places is a sold product. If these products don't match then this is
+  // considered cross-sell. Cross-sell units sold is the total number of
+  // cross-sold products from all orders attributed to your ads.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat, a shirt and a jacket. The cross-sell units sold in this order is 2.
+  // This metric is only available if you report conversions with cart data.
+  optional double cross_sell_units_sold = 307;
+
+  // Lead cost of goods sold (COGS) is the total cost of products sold as a
+  // result of advertising the same product.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with has an associated
+  // product (see Shopping Ads) then this product is considered the advertised
+  // product. Any product included in the order the customer places is a sold
+  // product. If the advertised and sold products match, then the cost of these
+  // goods is counted under lead cost of goods sold.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The hat has a cost of goods sold value of $3, the shirt
+  // has a cost of goods sold value of $5. The lead cost of goods sold for this
+  // order is $3.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 lead_cost_of_goods_sold_micros = 308;
+
+  // Lead gross profit is the profit you made from products sold as a result of
+  // advertising the same product, minus cost of goods sold (COGS).
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the order the customer
+  // places is a sold product. If the advertised and sold products match, then
+  // the revenue you made from these sales minus the cost of goods sold is your
+  // lead gross profit.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The hat is priced $10 and has a cost of goods sold value
+  // of $3. The lead gross profit of this order is $7 = $10 - $3.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 lead_gross_profit_micros = 309;
+
+  // Lead revenue is the total amount you made from products sold as a result of
+  // advertising the same product.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the order the customer
+  // places is a sold product. If the advertised and sold products match, then
+  // the total value you made from the sales of these products is shown under
+  // lead revenue.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat and a shirt. The hat is priced $10 and the shirt is priced $20. The
+  // lead revenue of this order is $10.
+  // This metric is only available if you report conversions with cart data.
+  optional int64 lead_revenue_micros = 310;
+
+  // Lead units sold is the total number of products sold as a result of
+  // advertising the same product.
+  // How it works: You report conversions with cart data for completed purchases
+  // on your website. If the ad that was interacted with before the purchase has
+  // an associated product (see Shopping Ads) then this product is considered
+  // the advertised product. Any product included in the order the customer
+  // places is a sold product. If the advertised and sold products match, then
+  // the total number of these products sold is shown under lead units sold.
+  // Example: Someone clicked on a Shopping ad for a hat then bought the same
+  // hat, a shirt and a jacket. The lead units sold in this order is 1.
+  // This metric is only available if you report conversions with cart data.
+  optional double lead_units_sold = 311;
+
+  // The number of unique users who saw your ad during the requested time
+  // period. This metric cannot be aggregated, and can only be requested for
+  // date ranges of 92 days or less. This metric is available for following
+  // campaign types - Display, Video, Discovery and App.
+  optional int64 unique_users = 319;
+
+  // The average number of times a unique user saw your ad during the requested
+  // time period. This metric cannot be aggregated, and can only be requested
+  // for date ranges of 92 days or less. This metric is available for following
+  // campaign types - Display, Video, Discovery and App.
+  optional double average_impression_frequency_per_user = 320;
 }

 // Search volume range.