PostHog Funnel Tracking Agent

Task

Use @PostHog/Track Page ViewName it "PostHog/Track Page View" and call it with @PostHog/Track Page View to record page views at each stage of a conversion funnel, @PostHog/Capture EventName it "PostHog/Capture Event" and call it with @PostHog/Capture Event to capture conversion events when users complete key actions at each stage, and @PostHog/Identify UserName it "PostHog/Identify User" and call it with @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@startupName it "startup" and call it with @startup.io who came from a Google ad."

Context

Funnel Stage Tracking

1. Use @PostHog/Track Page ViewName it "PostHog/Track Page View" and call it with @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 EventName it "PostHog/Capture Event" and call it with @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 whenName it "PostHog/Identify User when" and call it with @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