Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Run an attribution query. Wraps POST /api/query-attribution — see the API reference.

​
Usage

upstack query-attribution \
  --dimension utm_source \
  --model first_click \
  --window 30 \
  --date-start 2026-04-01 \
  --date-end 2026-04-30

​
Required flags

FlagDescription
--dimension <d>Dimension to attribute by (e.g. utm_source, utm_campaign).
--model <m>first_click, last_click, or any_click.
--window <days>Attribution window. One of 1, 7, 14, 30, 60, 90, -1 (unlimited).
--date-start <YYYY-MM-DD> --date-end <YYYY-MM-DD>Date range.

​
Optional flags

FlagDescriptionDefault
--timezone <tz>IANA timezone.UTC
--value-source <s>orders or events.orders
--conversion-event <name>Required when --value-source=events.purchase
See upstack query for the shared output / interactive / from-file flags.

​
Examples

# First-click attribution by UTM source, last 30 days
upstack query-attribution \
  --dimension utm_source --model first_click --window 30 \
  --date-start 2026-04-01 --date-end 2026-04-30

# Last-click, unlimited window, event-based valuation
upstack query-attribution \
  --dimension utm_campaign --model last_click --window -1 \
  --value-source events --conversion-event signup_completed \
  --date-start 2026-04-01 --date-end 2026-04-30

# Interactive
upstack query-attribution -i