Skip to main content

trafficAnalysis

Returns session counts grouped by referrer and UTM values for a site and required window, ordered by count descending. Visits are valid, non-deleted, non-virtual recordings with page counts, excluding recording format version 1. Use urls for exact normalized landing-URL matches or trafficAnalysisUrls for landing-page comparisons. This list has a row limit and no cursor. Requires traffic analysis view access.

trafficAnalysis(
  siteId: Int!
  startAt: Int!
  endAt: Int!
  limit: Int
  urls: [String!]
): [TrafficAnalysisResult!]!

Arguments​

trafficAnalysis.siteId ● Int! non-null scalar​

Site ID from sites; requires access to this site.

trafficAnalysis.startAt ● Int! non-null scalar​

Inclusive session recording-time start in Unix seconds.

trafficAnalysis.endAt ● Int! non-null scalar​

Inclusive session recording-time end in Unix seconds.

trafficAnalysis.limit ● Int scalar​

Maximum referrer/UTM groups, default 1000; no cursor pagination.

trafficAnalysis.urls ● [String!] list scalar​

Normalized landing URLs to match exactly; entries are ORed. Omit or pass an empty list for all landing URLs.

Type​

TrafficAnalysisResult object​

Aggregated traffic-analysis bucket keyed by the combined referrer and UTM values rather than by a stable identifier.