Skip to main content

AdPerformance

Performance response combining effective filters, aggregate metrics, rankings, charts, recommendations, and load statuses. Returned by adPerformance and adsLibraryPreviewPerformance.

type AdPerformance {
  controls: AdPerformanceControls!
  summary: AdPerformanceSummary!
  trackingCoverage: AdPerformanceTrackingCoverage
  connections: [AdPerformanceConnectionStatus!]!
  topAds: [AdPerformanceTopAdsForMetric!]!
  dailyMetrics: [AdPerformanceDailyMetricsForMetric!]!
  topAdsByKey: [AdPerformanceTopAdsForKey!]!
  dailyMetricsByKey: [AdPerformanceDailyMetricsForKey!]!
  recommendations: [AdPerformanceRecommendationSection!]!
  slices: AdPerformanceSlices
}

Fields​

AdPerformance.controls ● AdPerformanceControls! non-null object​

AdPerformance.summary ● AdPerformanceSummary! non-null object​

AdPerformance.trackingCoverage ● AdPerformanceTrackingCoverage object​

Null in UTM mode, with hierarchy filters, or when coverage loading fails.

AdPerformance.connections ● [AdPerformanceConnectionStatus!]! non-null object​

Enabled connection statuses, filtered by selected platforms in platform mode.

AdPerformance.topAds ● [AdPerformanceTopAdsForMetric!]! non-null object​

Top three eligible ads per ranking family across the full period.

AdPerformance.dailyMetrics ● [AdPerformanceDailyMetricsForMetric!]! non-null object​

Daily values for the period's ranked ads; RETURN charts revenue micro-units.

AdPerformance.topAdsByKey ● [AdPerformanceTopAdsForKey!]! non-null object​

Top three eligible ads for each summary key, ranked across the full selected period.

AdPerformance.dailyMetricsByKey ● [AdPerformanceDailyMetricsForKey!]! non-null object​

Daily stacks in date order using each summary key's additive stackQuantity.

AdPerformance.recommendations ● [AdPerformanceRecommendationSection!]! non-null object​

Computed suggested actions; these results do not change campaigns or budgets.

AdPerformance.slices ● AdPerformanceSlices object​

Load statuses for partial-result interpretation; failed slices may have zero or empty fallbacks.

Returned By​

adPerformance query ● adsLibraryPreviewPerformance query