
Creating and managing campaigns, adding items, understanding nested campaign stats, and circular reference prevention.
A campaign is a named grouping of creators, videos, and/or other campaigns within a project. It gives you aggregate stats across all its items — total views, likes, comments, shares — updated over time.
Common uses:
In your project, go to Campaigns → New campaign. Give it a name and optional description. The description field is readable by AI agents — use it to describe the campaign strategy, target audience, and what you're measuring.
A campaign can contain any combination of:
| Item type | What gets counted |
|---|---|
| Creator | All included / auto_tracked / direct_add videos from that creator |
| Video | That specific video only |
| Sub-campaign | Recursively: all items in that campaign and its children |
To add items, open a campaign and click Add item. You can search by creator handle, video title, or campaign name.
Campaigns can nest arbitrarily deep. When you fetch stats for a parent campaign, trackagoat recursively resolves the full tree — you never need to manually aggregate sub-campaigns.
2026 Program
└── Q1
├── January Launch (videos by creator A)
└── February Expansion (creators B & C)
└── Q2
└── Spring Push (creators A, B, D + direct videos)Fetching stats for 2026 Program gives you the union of everything under it.
Circular reference prevention
trackagoat prevents circular campaign references at the API layer. You cannot add Campaign B to Campaign A if Campaign B already (directly or transitively) contains Campaign A. The UI will show an error if you attempt this.
The campaign stats view shows:
Stats are computed over a configurable date range (default: last 30 days).
Like creators and videos, campaigns have a notes field. Use it for:
Notes are readable via the v1 API as the description field.
Access campaign data programmatically via the v1 API.