Advertising Dimensions & Metrics

These dimensions and metrics are supported in Analytics Data API Conversions reports.

Dimensions

The following dimensions can be requested in reports for any property. Specify the "API Name" in a Dimension resource's name field for a column of the dimension in the report response.

API Name UI Name Description
campaignName Campaign The name of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
continent Continent The continent from which the user activity originated. For example, Americas or Asia.
country Country The country from which the user activity originated.
defaultChannelGroup Default channel group The conversion's default channel group is based primarily on source and medium. An enumeration with a value of Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, Video, or Display.
deviceCategory Device category The type of device: Desktop, Tablet, or Mobile.
medium Medium The medium attributed to the conversion event.
platform Platform The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId.
primaryChannelGroup Primary channel group The primary channel group attributed to the conversion event. Primary channel groups are the channel groups used in standard reports in Google Analytics and serve as an active record of your property's data in alignment with channel grouping over time. To learn more, see Custom channel groups.
source Source The source attributed to the conversion event.
sourceMedium Source / medium The combined values of the dimensions source and medium.
sourcePlatform Source platform The source platform of the conversion event campaign.
subcontinent Subcontinent The subcontinent from which the user activity originated.

Metrics

The following metrics can be requested in reports for any property. Specify the "API Name" in a Metric resource's name field for a column of the metric in the report response.

API Name UI Name Description
advertiserAdClicks Ads clicks Total number of times users have clicked on an ad to reach the property. Includes clicks from linked integrations like linked Search Ads 360 advertisers. Also includes uploaded clicks from data import.
advertiserAdCost Ads cost The total amount you paid for your ads. Includes costs from linked integrations like linked Google Ads accounts. Also includes uploaded cost from data import; to learn more, see Import cost data.
advertiserAdCostPerAllConversionsByConversionDate Cost per all conversions (by conv. time) Cost per conversion in the conversion date range.
advertiserAdCostPerAllConversionsByInteractionDate Cost per all conversions (by int. time) Cost per conversion in the interaction date range.
advertiserAdCostPerClick Ads cost per click Ads cost per click is ad cost divided by ad clicks and is often abbreviated CPC.
advertiserAdImpressions Ads impressions The total number of impressions. Includes impressions from linked integrations like linked Display & Video 360 advertisers. Also includes uploaded impressions from data import.
allConversionsByConversionDate All conversions (by conv. time) Counts conversions on the specific day they happened, regardless of when the interaction event occurred.
allConversionsByInteractionDate All conversions Counts conversions attributed to the day the interaction originally occurred.
returnOnAdSpendByConversionDate Return on ad spend (by conv. time) Ratio of total revenue in the conversion date range to advertiser ad cost.
returnOnAdSpendByInteractionDate Return on ad spend (by int. time) Ratio of total revenue in the interaction date range to advertiser ad cost.
totalRevenueByConversionDate Total revenue (by conv. time) The sum of revenue from purchases, subscriptions, and advertising minus refunded transaction revenue, in the conversion date range.
totalRevenueByInteractionDate Total revenue (by int. time) The sum of revenue from purchases, subscriptions, and advertising minus refunded transaction revenue, in the interaction date range.