/attribution-scope

name: attribution-scope
description: "GA4 has three distinct attribution scopes. Using the wrong scope gives misleading results. Choose based on the question you are answering."

Attribution Scope

GA4 has three distinct attribution scopes. Using the wrong scope gives misleading results. Choose based on the question you are answering.

The three scopes

| Scope | Dimension prefix | Question it answers | When to use | |---|---|---|---| | **Session** | `session` | Where did THIS session come from? | Traffic Acquisition — volume, engagement, conversions by source | | **First-user** | `firstUser` | Which channel originally acquired this user? | User Acquisition — who brought in new users | | **Event/attribution** | *(no prefix)* | Which channel gets credit for this conversion? | Advertising reports — AI-weighted conversion credit allocation |

Dimensions by scope

**Session scope** — use for traffic analysis:

• `sessionDefaultChannelGroup`
• `sessionSource`
• `sessionMedium`
• `sessionCampaignName`
• `sessionSourceMedium`

**First-user scope** — use for acquisition analysis:

• `firstUserDefaultChannelGroup`
• `firstUserSource`
• `firstUserMedium`
• `firstUserCampaignName`

**Event/attribution scope** — use only in advertising/conversion contexts:

• `defaultChannelGroup` *(no prefix)*
• `source` *(no prefix)*
• `medium` *(no prefix)*

How to choose

**"Where is my traffic coming from?"** → session scope

dimensions: ["sessionDefaultChannelGroup", "sessionSource", "sessionMedium"]
metrics: ["sessions", "totalUsers", "engagedSessions", "keyEvents"]

**"Which channels are bringing in new users?"** → first-user scope

dimensions: ["firstUserDefaultChannelGroup", "firstUserSource"]
metrics: ["newUsers", "totalUsers"]

**"How should I attribute conversion credit across channels?"** → event scope (Use only with advertising campaign analysis; this is AI-weighted attribution.)

Common mistake

A user acquired via Instagram who later converts via Google Organic will show:

• `sessionDefaultChannelGroup = "Organic Search"` (where this session came from)
• `firstUserDefaultChannelGroup = "Organic Social"` (where they were first acquired)

These are different questions. Mixing scopes in one query produces meaningless results. Never combine `sessionSource` with `firstUserMedium` in the same report.

Nested filters

When filtering, use the same scope as your dimensions:

// Filtering traffic acquisition report — use session-scoped dimension
{"filter": {"fieldName": "sessionDefaultChannelGroup", "stringFilter": {"value": "Organic Search", "matchType": "EXACT"}}}

// NOT source (attribution scope) — wrong scope for this report
{"filter": {"fieldName": "source", "stringFilter": {"value": "google", "matchType": "EXACT"}}}