# PostHog Funnel Tracking Agent

> Track every step of your conversion funnel in PostHog. See where users drop off, capture conversion events at each stage, and tag users who make it through.

Source: https://cotera.co/solutions/marketing/posthog-funnel-tracking-agent

---

- **Team:** Marketing
- **Tools:** PostHog
- **Difficulty:** medium
- **Setup time:** 10 min
- **Time saved:** 2-3 hrs/week

## How it works
1. **Track Funnel Pages** — Record page views at each stage of the funnel with URLs, titles, and traffic source data
2. **Capture Conversions** — Send conversion events when users complete actions at each stage with full metadata
3. **Identify Converters** — Tag users who convert with properties like plan selected, conversion date, and traffic source
4. **Surface Drop-offs** — Summarize where users abandon the funnel and recommend optimizations

## Example requests
- Track our signup funnel in PostHog: /home -> /pricing -> /signup -> /welcome for user maria@startup.io from a Google ad campaign
- Set up funnel tracking for our e-commerce checkout: product page, cart, checkout, and order confirmation with conversion events at each step
- Build a trial-to-paid conversion funnel in PostHog: track /trial-signup, /onboarding, /first-project, and /upgrade pages with user identification

## Prompt

```markdown
## Task

Use @PostHog/Track Page View to record page views at each stage of a conversion funnel, @PostHog/Capture Event to capture conversion events when users complete key actions at each stage, and @PostHog/Identify User to tag users who reach conversion milestones with properties like "converted", "funnel_stage", and "conversion_date". This builds a complete funnel tracking setup in PostHog that shows where users drop off and who converts.

## Input

The user provides:
1. The funnel stages with their corresponding page URLs (e.g., landing page -> pricing -> signup -> onboarding)
2. Conversion events to capture at each stage (e.g., "pricing_viewed", "signup_started", "signup_completed")
3. User identifiers for users moving through the funnel
4. Optional: UTM parameters or traffic source context

**Example:** "Track our signup funnel: landing page at /home, pricing page at /pricing, signup form at /signup, and welcome page at /welcome. Capture conversion events at each step for user maria@startup.io who came from a Google ad."

## Context

### Funnel Stage Tracking

1. Use @PostHog/Track Page View for each page in the funnel sequence
2. Include properties with each page view: Page URL and title, funnel stage name and position, traffic source and UTM parameters, referrer URL
3. Track pages in the order users encounter them to build an accurate funnel

### Conversion Event Capture

1. Use @PostHog/Capture Event at each funnel transition
2. Include conversion metadata: time spent on previous stage, entry source, any selections made
3. Capture drop-off signals: "funnel_abandoned" if a user leaves without completing the current stage

### User Identification at Conversion

1. Use @PostHog/Identify User when a user converts or reaches a significant milestone
2. Set conversion-related properties: funnel_completed, conversion_date, funnel_entry_source, plan_selected, time_to_convert

## Output

**Funnel Tracking Summary:**

**Funnel Definition:**
| Stage | Page | Conversion Event | Status |
|-------|------|-----------------|--------|
| 1. [Stage Name] | [URL] | [event_name] | Tracked |

**Page Views Recorded:**
- [URL 1]: tracked with [properties]

**Conversion Events Captured:**
| Event | Stage | Properties | Status |

**User Identified:**
- User: [distinct_id]
- Conversion status: [converted/in_progress/abandoned]
- Properties updated: [list]

**Funnel Insights:**
- Total stages tracked: [count]
- Conversion path: [stage 1] -> [stage 2] -> ... -> [final stage]
- Ready to build funnel visualization in PostHog
```

## Related reading
- [The Best Product Analytics Platforms in 2026 (Tested With Real Data)](https://cotera.co/articles/product-analytics-platform-comparison.md)
- [User Behavior Analytics Tools: What Actually Tells You Why Users Churn](https://cotera.co/articles/user-behavior-analytics-tools.md)