--- 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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-19 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]