Google Analytics Data API Updates: Ads and item-scoped metrics

[Ilya Kuleshov]

On behalf of the Google Analytics team I would like to announce the following updates to the Google Analytics Data API:

New Ads metrics added to the API Schema:

• advertiserAdClicks Ads clicks. Total number of times users have clicked on an ad to reach the property.
• advertiserAdCost Ads cost. The total amount you paid for your ads.
• advertiserAdCostPerClick Ads cost per click. Ads cost per click is ad cost divided by ad clicks and is often abbreviated CPC.
• advertiserAdCostPerConversion Cost per conversion. Cost per conversion is ad cost divided by conversions.
• advertiserAdImpressions Ads impressions. The total number of impressions.
• returnOnAdSpend Return on ad spend. Return On Ad Spend (ROAS) is total revenue divided by advertiser ad cost.

New item scoped metrics added to the API Schema:

• itemsAddedToCart Items added to cart. The number of units added to cart for a single item.
• itemsCheckedOut Items checked out. The number of units checked out for a single item.
• itemsClickedInList Items clicked in list. The number of units clicked in list for a single item.
• itemsClickedInPromotion Items clicked in promotion. The number of units clicked in promotion for a single item.
• itemsViewed Items viewed. The number of units viewed for a single item.
• itemsViewedInList Items viewed in list. The number of units viewed in list for a single item.
• itemsViewedInPromotion Items viewed in promotion. The number of units viewed in promotion for a single item.

Feedback

As part of the testing process, we kindly ask you to answer a quick Google Analytics 4 APIs Tester Survey and provide any feedback you have regarding the testing experience.