> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# talkvalue path analysis channel attribution

> Per-event acquisition breakdown for a single channel: net new joiners vs members already on the channel.

Compute how a single channel acquired people across each event it appeared on. The response carries the channel's membership context plus a per-event breakdown of who joined the channel because of that event and who was already on it. The dashboard [Channel attribution](/path/analytics/attribution) card uses the same query.

## Synopsis

```bash theme={null}
talkvalue path analysis channel attribution <channelId> [options]
```

## Arguments

| Argument      | Type    | Description                                                                    |
| ------------- | ------- | ------------------------------------------------------------------------------ |
| `<channelId>` | integer | Channel ID. Use [`channel list`](/cli/commands/path/channel/list) to find one. |

## Options

| Flag              | Type                 | Description                                                                                 |
| ----------------- | -------------------- | ------------------------------------------------------------------------------------------- |
| `--event-id <id>` | integer (repeatable) | Limit to specific events. Repeat to pass multiple. Defaults to every event for the channel. |
| `--tag-id <id>`   | integer              | Limit to events that carry the given tag.                                                   |

## Examples

### 1. Attribution for a single event

```bash theme={null}
talkvalue path analysis channel attribution 7 --event-id 18 --json
```

Returns the channel's headline metrics plus a one-element `events` array containing the breakdown for event `18`.

### 2. Roll up every event on a channel

```bash theme={null}
talkvalue path analysis channel attribution 7 --json \
  | jq '{
      channel: .data.channel.name,
      eventParticipationRate: .data.metrics.eventParticipationRate,
      events: (.data.events | map({name, total, joinedSinceLastEvent, acquisitionRate}))
    }'
```

Projects each event down to the four fields you typically chart, leaving the channel headline metrics on top.

### 3. Tag-scoped attribution report

```bash theme={null}
talkvalue path analysis channel attribution 7 --tag-id 4 --json \
  > "reports/channel-7-attribution-$(date +%Y-%m-%d).json"
```

Captures the attribution snapshot for tagged events (for example, every webinar). Drop into a cron job to keep a daily archive.

## Response

```jsonc theme={null}
{
  "data": {
    "channel": { "id": 7, "name": "Newsletter", "icon": "mail", "color": "#5252FF" },
    "metrics": {
      "channelSize": 1843,
      "membersEverRegistered": 1204,
      "eventParticipationRate": 0.6535
    },
    "events": [
      {
        "id": 18,
        "name": "Spring Summit",
        "startAt": "2026-03-12T17:00:00Z",
        "total": 412,
        "joinedSinceLastEvent": 87,
        "alreadyInChannel": 325,
        "acquisitionRate": 0.2112
      }
    ]
  }
}
```

`acquisitionRate` is `joinedSinceLastEvent / total`. `eventParticipationRate` is `membersEverRegistered / channelSize`.

## See also

* [`analysis channel audience`](/cli/commands/path/analysis/audience-overlap). Overlap across multiple channels.
* [`channel get`](/cli/commands/path/channel/get). Confirm channel metadata before running the report.
* [Channel attribution](/path/analytics/attribution). The dashboard surface this command mirrors.
* [Recipe: Channel analysis](/cli/recipes/channel-analysis). Pair attribution with overlap in one script.