Skip to main content

AdPerformanceTopAd

Ranked ad metrics returned by performance queries, or a synthetic UTM group in UTM mode.

type AdPerformanceTopAd {
  adId: Int!
  platform: AdPlatformSource
  platformId: String
  name: String!
  campaignName: String
  adGroupName: String
  previewSnippet: AdPerformancePreviewSnippet
  spendMicros: Int!
  adTrafficVisits: Int!
  totalConversions: Int!
  convertedVisitors: Int!
  conversionRate: Float!
  totalRevenueMicros: Int!
  returnOnAdSpend: Float!
}

Fields

`AdPerformanceTopAd.adId` ● `Int!` non-null scalar

Crazy Egg ad id in platform mode; synthetic negative group id in UTM mode, unusable by preview queries.

`AdPerformanceTopAd.platform` ● `AdPlatformSource` enum

Imported provider; null for synthetic UTM groups.

`AdPerformanceTopAd.platformId` ● `String` scalar

Provider ad id in platform mode, or UTM content value in UTM mode; null when unavailable.

`AdPerformanceTopAd.name` ● `String!` non-null scalar

`AdPerformanceTopAd.campaignName` ● `String` scalar

Imported campaign name or UTM campaign value; null when unavailable.

`AdPerformanceTopAd.adGroupName` ● `String` scalar

Imported ad-group name or UTM source value; null when unavailable.

`AdPerformanceTopAd.previewSnippet` ● `AdPerformancePreviewSnippet` object

Imported creative excerpt without provider refresh; null in UTM mode or when no content is available.

`AdPerformanceTopAd.spendMicros` ● `Int!` non-null scalar

Imported spend in millionths of ad-account currency; multiple currencies are summed without conversion. Zero in UTM mode.

`AdPerformanceTopAd.adTrafficVisits` ● `Int!` non-null scalar

Tracked visits matched to selected imported ads, or UTM-grouped visits in UTM mode.

`AdPerformanceTopAd.totalConversions` ● `Int!` non-null scalar

Attributed conversion count for the selected goal or all goals.

`AdPerformanceTopAd.convertedVisitors` ● `Int!` non-null scalar

Attributed converted visitor count used as the numerator of conversionRate.

`AdPerformanceTopAd.conversionRate` ● `Float!` non-null scalar

Converted visitors divided by tracked visits, as a ratio rather than percent, rounded to four decimals; zero with no visits.

`AdPerformanceTopAd.totalRevenueMicros` ● `Int!` non-null scalar

Attributed revenue in millionths of the tracked base amount; no currency code or conversion to ad-account currency is returned.

`AdPerformanceTopAd.returnOnAdSpend` ● `Float!` non-null scalar

Tracked revenue divided by imported spend, rounded to four decimals; zero with no spend. Currency conversion is not applied.

Member Of

AdPerformanceRecommendationSection object ● AdPerformanceTopAdsForKey object ● AdPerformanceTopAdsForMetric object

Fields
Member Of