Calculate attribution and campaign ROI

Calculate multi-touch attribution, funnel conversion, and campaign ROI

Demand-gen and growth teams running multi-channel campaigns who need deterministic attribution without external API dependencies.

• · Attribution journey data (touchpoints, channels, timestamps, conversions, revenue)
• · Funnel data (stage names, counts per stage)
• · Campaign data (name, channel, spend, revenue, impressions, clicks, leads, customers)

• · Attribution credit allocation (5 models: first-touch, last-touch, linear, time-decay, custom)
• · Funnel drop-off analysis (stage-by-stage conversion rates)
• · Campaign ROI metrics (ROAS, CPA, LTV, CAC payback)
• · High-signal insights and budget reallocation recommendations

• · Journey/funnel/campaign data in JSON format matching schema
• · Minimum 2 data points for time-decay or conversion analysis
• · Valid JSON and matching array lengths in funnel data

• · Pure LLM attribution — no ground truth validation
• · Funnel analysis assumes single-path conversion — does not account for multi-path journeys
• · No handling of dark social or offline conversions
• · Time-decay assumptions (default 7-day half-life) may not match actual customer cycle

• · Three Python CLI tools (attribution_analyzer, funnel_analyzer, campaign_roi_calculator)
• · Standard library only — no external dependencies or API calls
• · Five attribution models implemented (first, last, linear, time-decay, custom)
• · Input validation and error handling specified (KeyError, ValueError, TypeError)