Skip to main content

adPerformance

Returns a site's ad spend, tracked ad visits, attributed conversions and revenue, top-ad rankings, daily charts, and recommendations for a date range. Parts that time out or fail return zeros or empty lists, so check slices before trusting them. Use adPerformanceHeader for sync status only. Requires Ad Performance view access.

adPerformance(
  siteId: Int!
  startAt: Int
  endAt: Int
  presetDate: String
  platforms: [AdPlatformSource!]
  campaignIds: [Int!]
  adGroupIds: [Int!]
  adIds: [Int!]
  goalId: Int
  dataMode: AdPerformanceDataMode
  attributionModel: AdPerformanceAttributionModel
  conversionWindowDays: Int
): AdPerformance

Arguments​

adPerformance.siteId ● Int! non-null scalar​

Accessible site id from sites.

adPerformance.startAt ● Int scalar​

Unix seconds; uses the UTC date as an inclusive start. Omit for no lower bound; presetDate takes precedence.

adPerformance.endAt ● Int scalar​

Unix seconds; uses the UTC date as an inclusive end. Omit for no upper bound; presetDate takes precedence.

adPerformance.presetDate ● String scalar​

Case-insensitive UTC preset that overrides startAt/endAt: today, yesterday, recent, last 7 days, last 30 days, this month, last month. recent includes today; last 7/30 days exclude it. Other values return an error.

adPerformance.platforms ● [AdPlatformSource!] list enum​

Providers to include in PLATFORM mode; omitted or [] selects all enabled connections. Ignored in UTM mode.

adPerformance.campaignIds ● [Int!] list scalar​

Crazy Egg campaign ids from adPerformanceAdTree; unioned with ad-group/ad filters. First 500 unique ids used; ignored in UTM mode.

adPerformance.adGroupIds ● [Int!] list scalar​

Crazy Egg ad-group ids from adPerformanceAdTree; unioned with campaign/ad filters. First 500 unique ids used; ignored in UTM mode.

adPerformance.adIds ● [Int!] list scalar​

Crazy Egg ad ids from adPerformanceAdTree; unioned with campaign/ad-group filters. First 500 unique ids used; ignored in UTM mode.

adPerformance.goalId ● Int scalar​

Goal id from goalCardList or controls.availableGoals; 0 counts all goals. When omitted, a goal with conversions in the range is chosen and reported in controls.selectedGoalId, or all goals when none has any.

adPerformance.dataMode ● AdPerformanceDataMode enum​

PLATFORM matches imported ads and includes spend; UTM groups tracking parameters without spend. Defaults to PLATFORM.

adPerformance.attributionModel ● AdPerformanceAttributionModel enum​

Earliest or latest eligible ad visit before conversion; defaults to LAST_TOUCH.

adPerformance.conversionWindowDays ● Int scalar​

Lookback from conversion to eligible ad visit, in days: 1, 7, 30, or 90. Defaults to 1; other values fall back to 1.

Type​

AdPerformance object​

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