Unified.to
All articles

Advertising Report Metrics by Integration


June 12, 2026

Endpoint: GET /ads/{connection_id}/reportList all reports

This is a reference for the metrics returned by the Advertising Report endpoint: which metrics each supported integration populates, and how each platform's native field maps onto Unified.to's single normalized reporting model.

How reports return metrics

A call to GET /ads/{connection_id}/report returns an array of Report objects. Each report describes the performance of an advertising entity over a window, and carries its metrics in a single normalized array:

FieldTypeDescription
idstringReport identifier
created_at / updated_atdateISO-8601 timestamps
start_at / end_atdateThe reporting window the metrics cover
currencystringCurrency for all monetary metrics in the report
organization_idstringThe advertising organization the report belongs to
metricsarrayThe normalized performance metrics (the subject of this document)
rawanyThe untransformed payload from the underlying platform
The value of the metrics array is that it is the same shape regardless of which platform connection_id points to. Whether the connection is Meta Ads or LinkedIn, a CLICKS metric means the same thing and is read the same way. Behind the scenes, Unified.to handles the platform-specific renaming, the nested-field extraction, and the unit conversions — and where a platform doesn't return a value directly, it computes it. If you ever need the original platform field, it remains available under raw.

The unified metric model

Each ad platform reports the same fundamental ideas — a click, an impression, a dollar spent — but names and shapes them differently. A click is clicks in Meta, METRIC_CLICKS in Google DV360, and Clicks in Microsoft Ads. Cost arrives as raw currency in some platforms and as micro-units (millionths of a currency unit) in Google Ads, which must be divided by 1,000,000 before it means anything.

Unified.to collapses all of that into one vocabulary of 92 normalized metrics (written in UPPER_SNAKE_CASE). The tables below show, for each normalized metric, the native field it is sourced from on each of the five integrations the Report endpoint supports: Meta Ads, Google Ads, Google DV360, LinkedIn, and Microsoft Ads. A means that integration does not expose the metric, so it will not appear in the metrics array for that connection.

Coverage at a glance

The breadth of the metrics array depends entirely on which integration the connection is for. Not all platforms expose data at the same depth:

IntegrationMetrics returnedCharacter of the data
LinkedIn57 / 92Deepest coverage, driven by a large set of social, lead-gen, and "viral" (organic amplification) metrics
Google DV36045 / 92Strong on viewability, video engagement, and cost/financial breakdowns
Google Ads30 / 92Broad core coverage plus search-specific and viewability metrics
Meta Ads19 / 92Focused on core performance and detailed video-watch metrics
Microsoft Ads14 / 92Core performance metrics only
Coverage is highly uneven across the metric set. Of the 92 normalized metrics, 60 are returned by only a single integration, while just 8 are returned by all five. The long tail is dominated by LinkedIn's social and viral metrics and DV360's financial and viewability metrics, which have no equivalent elsewhere. Write your code defensively: check for a metric's presence rather than assuming every report contains it.

The universal core

These eight metrics are the common denominator — every supported integration returns them, making them the safe foundation for any cross-connection report or comparison:

CLICKS · IMPRESSIONS · CONVERSIONS · COST · CTR · CPC · CONVERSION_VALUE · CPA

Even within this universal set, the source data differs. COST is spend in Meta but arrives in micro-units in Google Ads and as costInLocalCurrency in LinkedIn (all normalized to the report's currency). CONVERSIONS is a clean field in most platforms but is pulled from Meta's nested actions[purchase]. And CTR, CPC, and CPA are all derived for LinkedIn — a reminder that "returned" sometimes means "computed for you," not "delivered by the platform."

Two near-universal ratios fall just short of full coverage: ROAS is derived everywhere it exists but is absent from DV360, and CPM is missing only from Google Ads.

Core performance metrics

The headline numbers most reports are built on — volume, cost, and the efficiency ratios derived from them.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
CLICKSclicksclicksMETRIC_CLICKSclicksClicks
IMPRESSIONSimpressionsimpressionsMETRIC_IMPRESSIONSimpressionsImpressions
CONVERSIONSactionspurchaseconversionsMETRIC_TOTAL_CONVERSIONSexternalWebsiteConversionsConversions
COSTspendcost_micros (/1e6)METRIC_REVENUE_ADVERTISERcostInLocalCurrencySpend
CTRctrctrMETRIC_CTRderivedCtr
CPCcpcaverage_cpc (/1e6)METRIC_REVENUE_ECPC_ADVERTISERderivedAverageCpc
CONVERSION_VALUEaction_valuespurchaseconversions_valueMETRIC_TRUEVIEW_TOTAL_CONVERSION_VALUES_ADVERTISERconversionValueInLocalCurrencyRevenue
CPAcost_per_action_typepurchasecost_per_conversion (/1e6)METRIC_REVENUE_ECPA_ADVERTISERderivedCostPerConversion
ROASderivedderivedderivedderived
CPMcpmMETRIC_REVENUE_ECPM_ADVERTISERderivedAverageCpm
ECPMMETRIC_REVENUE_ECPM_ADVERTISER

Conversion detail

Beyond the headline conversion count, platforms differ on how they attribute and segment conversions. Google Ads and Microsoft Ads add "all conversions" totals and their revenue counterparts; DV360 and LinkedIn distinguish post-click from view-through (post-view) conversions; and Google Ads alone exposes cross-device conversions and raw interactions.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
POST_CLICK_CONVERSIONSMETRIC_POST_CLICK_CONVERSIONSexternalWebsitePostClickConversions
VIEW_THROUGH_CONVERSIONSview_through_conversionsMETRIC_POST_VIEW_CONVERSIONSexternalWebsitePostViewConversionsViewThroughConversions
ALL_CONVERSIONSall_conversionsAllConversions
ALL_CONVERSION_VALUEall_conversions_valueAllRevenue
CROSS_DEVICE_CONVERSIONScross_device_conversions
INTERACTIONSinteractions

Video engagement

Video is the most fragmented category, because each platform instruments playback in its own way. Quartile completion (25/50/75/100%) is the one widely shared concept, supported across Meta, Google Ads, DV360, and LinkedIn — though Google Ads reports quartiles as rates while the others report counts. From there the platforms diverge: Meta uniquely tracks VIDEO_AVG_TIME_WATCHED and VIDEO_THRUPLAY; DV360 captures rich-media interaction signals like pauses, mutes, skips, and companion-banner activity; and Google Ads surfaces search-driven views.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
VIDEO_VIEWSvideo_viewsMETRIC_TRUEVIEW_VIEWSvideoViewsVideoViews
VIDEO_PLAYSvideo_play_actionsMETRIC_RICH_MEDIA_VIDEO_PLAYSvideoStarts
VIDEO_COMPLETIONSMETRIC_RICH_MEDIA_VIDEO_COMPLETIONSvideoCompletions
VIDEO_QUARTILE_25video_p25_watched_actionsvideo_quartile_p25_rateMETRIC_RICH_MEDIA_VIDEO_FIRST_QUARTILE_COMPLETESvideoFirstQuartileCompletions
VIDEO_QUARTILE_50video_p50_watched_actionsvideo_quartile_p50_rateMETRIC_RICH_MEDIA_VIDEO_MIDPOINTSvideoMidpointCompletions
VIDEO_QUARTILE_75video_p75_watched_actionsvideo_quartile_p75_rateMETRIC_RICH_MEDIA_VIDEO_THIRD_QUARTILE_COMPLETESvideoThirdQuartileCompletions
VIDEO_QUARTILE_100video_p100_watched_actionsvideo_quartile_p100_rateMETRIC_RICH_MEDIA_VIDEO_COMPLETIONS
VIDEO_AVG_TIME_WATCHEDvideo_avg_time_watched_actions
VIDEO_THRUPLAYvideo_thruplay_watched_actions
AVERAGE_CPVaverage_cpv (/1e6)
EARNED_VIEWSMETRIC_TRUEVIEW_EARNED_VIEWS
UNIQUE_VIEWERSMETRIC_TRUEVIEW_UNIQUE_VIEWERS
VIDEO_VIEWS_FROM_SEARCHvideo_views_from_google_search_results
VIDEO_FULLSCREENSMETRIC_RICH_MEDIA_VIDEO_FULL_SCREENSfullScreenPlays
VIDEO_PAUSESMETRIC_RICH_MEDIA_VIDEO_PAUSES
VIDEO_MUTESMETRIC_RICH_MEDIA_VIDEO_MUTES
VIDEO_SKIPSMETRIC_RICH_MEDIA_VIDEO_SKIPS
COMPANION_CLICKSMETRIC_RICH_MEDIA_VIDEO_COMPANION_CLICKS
COMPANION_VIEWSMETRIC_RICH_MEDIA_VIDEO_COMPANION_VIEWS

Social engagement

Likes, shares, comments, and follows are native to the social-first platforms. LinkedIn reports them directly, and DV360 exposes the YouTube "earned" equivalents (earned likes, shares, and subscribers). Curiously, Google Ads maps SHARES and SAVES onto Gmail-specific forward and save actions — an artifact of how Gmail Ads engagement was instrumented.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
ENGAGEMENTMETRIC_ENGAGEMENT_RATEderived (sum)
ENGAGEMENTSengagementsMETRIC_ENGAGEMENTS
TOTAL_ENGAGEMENTStotalEngagements
OTHER_ENGAGEMENTSotherEngagements
LIKESMETRIC_TRUEVIEW_EARNED_LIKESlikes
SHARESgmail_forwardsMETRIC_TRUEVIEW_EARNED_SHARESshares
COMMENTScomments
FOLLOWSMETRIC_TRUEVIEW_EARNED_SUBSCRIBERSfollows
SAVESgmail_savesMETRIC_TRUEVIEW_EARNED_PLAYLIST_ADDITIONS
COMMENT_LIKEScommentLikes
OPENSopens

Click and impression breakdowns

Most of these granular click types are LinkedIn-specific, reflecting its sponsored-content and document-ad formats (card clicks, company-page clicks, text-URL clicks, and so on). Meta contributes LANDING_PAGE_CLICKS (its inline_link_clicks) and UNIQUE_CLICKS, while LinkedIn adds an approximate unique-impression count.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
LANDING_PAGE_CLICKSinline_link_clickslandingPageClicks
AD_UNIT_CLICKSadUnitClicks
CARD_CLICKScardClicks
CARD_IMPRESSIONScardImpressions
COMPANY_PAGE_CLICKScompanyPageClicks
ACTION_CLICKSactionClicks
TEXT_URL_CLICKStextUrlClicks
GMAIL_SECONDARY_CLICKSgmail_secondary_clicks
UNIQUE_CLICKSunique_clicks
UNIQUE_IMPRESSIONSapproximateUniqueImpressions

Lead generation

Native lead-form metrics are exclusive to LinkedIn in this mapping, tied to its one-click Lead Gen Forms.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
LEADSoneClickLeads
LEAD_FORM_OPENSoneClickLeadFormOpens

Viewability and measurement

Viewability — whether an impression was actually seen — is a Google ecosystem strength. Google Ads and DV360 share the Active View family (viewable, measurable, and percent-viewable impressions), DV360 adds billable and eligible impression counts plus average viewable time, and Google Ads contributes top-of-page impression share metrics from search.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
VIEWABLE_IMPRESSIONSactive_view_impressionsMETRIC_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS
MEASURABLE_IMPRESSIONSactive_view_measurable_impressionsMETRIC_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS
VIEWABILITY_RATEactive_view_viewabilityMETRIC_ACTIVE_VIEW_PCT_VIEWABLE_IMPRESSIONS
BILLABLE_IMPRESSIONSMETRIC_BILLABLE_IMPRESSIONS
ELIGIBLE_IMPRESSIONSMETRIC_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS
ACTIVE_VIEW_AVG_TIMEMETRIC_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME
ABSOLUTE_TOP_IMPRESSION_SHAREabsolute_top_impression_percentage
TOP_IMPRESSION_SHAREtop_impression_percentage

Cost and financial breakdowns

DV360 is the only integration that decomposes cost into its component fees — media cost, data fees, platform fees — and reports advertiser-level revenue and profit. This reflects its role as a programmatic buying platform where margin transparency matters.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
REVENUEMETRIC_REVENUE_ADVERTISER
MEDIA_COSTMETRIC_MEDIA_COST_ADVERTISER
TOTAL_MEDIA_COSTMETRIC_TOTAL_MEDIA_COST_ADVERTISER
DATA_FEESMETRIC_DATA_COST_ADVERTISER
PLATFORM_FEESMETRIC_PLATFORM_FEE_ADVERTISER
PROFITMETRIC_PROFIT_ADVERTISER

Viral / organic amplification (LinkedIn)

LinkedIn's "viral" metrics measure the organic spread of sponsored content — engagement that happens when someone's network sees an ad because a connection interacted with it. This entire 19-metric family is exclusive to LinkedIn and mirrors its standard metrics (impressions, clicks, conversions, video quartiles, leads) but for organically-amplified reach. No other integration models this concept.

Unified MetricMeta AdsGoogle AdsGoogle DV360LinkedInMicrosoft Ads
VIRAL_IMPRESSIONSviralImpressions
VIRAL_CLICKSviralClicks
VIRAL_LIKESviralLikes
VIRAL_COMMENTSviralComments
VIRAL_SHARESviralShares
VIRAL_FOLLOWSviralFollows
VIRAL_VIDEO_PLAYSviralVideoStarts
VIRAL_VIDEO_VIEWSviralVideoViews
VIRAL_VIDEO_COMPLETIONSviralVideoCompletions
VIRAL_VIDEO_QUARTILE_25viralVideoFirstQuartileCompletions
VIRAL_VIDEO_QUARTILE_50viralVideoMidpointCompletions
VIRAL_VIDEO_QUARTILE_75viralVideoThirdQuartileCompletions
VIRAL_LEADSviralOneClickLeads
VIRAL_LEAD_FORM_OPENSviralOneClickLeadFormOpens
VIRAL_LANDING_PAGE_CLICKSviralLandingPageClicks
VIRAL_CONVERSIONSviralExternalWebsiteConversions
VIRAL_POST_CLICK_CONVERSIONSviralExternalWebsitePostClickConversions
VIRAL_VIEW_THROUGH_CONVERSIONSviralExternalWebsitePostViewConversions
VIRAL_ENGAGEMENTSviralTotalEngagements

Integration-by-integration takeaways

LinkedIn is the deepest integration by a wide margin. Beyond solid core coverage, it owns two large metric families that exist nowhere else: native lead-form metrics and the complete "viral" organic-amplification set. If a report needs B2B lead data or organic-reach attribution, LinkedIn is the only source.

Google DV360 is the choice for media-buying transparency. It uniquely breaks cost into media, data, and platform fees and reports profit, and it offers the richest video-interaction signals (pauses, mutes, skips, companion banners) alongside full Active View viewability.

Google Ads provides broad, dependable core coverage plus search-native metrics — impression share, cross-device conversions, and "all conversions" rollups. Watch for its two quirks: micro-unit cost fields that need dividing by a million, and quartile metrics expressed as rates rather than counts.

Meta Ads concentrates on core performance and granular video-watch behavior. Its conversion and value figures come from nested action breakdowns rather than flat fields, so the purchase action type must be extracted explicitly.

Microsoft Ads is the leanest integration, covering the universal core plus video views, view-through conversions, and "all conversions" totals — sufficient for standard performance reporting but without engagement, viewability, or social depth.

Working with the response

  • Build cross-connection reports on the universal eight. CLICKS, IMPRESSIONS, CONVERSIONS, COST, CTR, CPC, CONVERSION_VALUE, and CPA are the only metrics guaranteed to appear in the metrics array for every supported integration.
  • Check for presence, don't assume it. With 60 of 92 metrics returned by only one integration, code that reads the metrics array should handle a metric being absent rather than expecting a fixed set.
  • Read currency from the report, not the metric. All monetary metrics are normalized into the report's currency field; Google Ads micro-units (/1e6) and per-platform conventions are already resolved for you.
  • Some metrics are computed. Ratios like ROAS, and several of LinkedIn's rates, are derived by Unified.to rather than supplied by the platform — they arrive in the metrics array all the same.
  • Drop to raw when you need the original. Anything platform-specific that the normalized model doesn't capture remains available on the report's raw field.
All articles