PostHog Integration
Send server-side events to PostHog for product analytics, funnels, and session recordings.
Overview
PostHog provides product analytics with event-level granularity. Scout sends events to PostHog for funnel analysis, user journeys, and conversion tracking without relying on client-side scripts.
Scout captures events, maps user identifiers to PostHog distinct_id, and sends events via PostHog Capture API. Session data and user properties are included for rich analytics.
Requirements
Event Mapping
Scout events are sent to PostHog with their original names and properties:
User Identification
Scout maps user email or external_id to PostHog distinct_id. Anonymous events use the Scout session ID. PostHog handles identity merging when a user is later identified.
Event Properties
All Scout event properties (value, currency, items, UTM parameters) are forwarded to PostHog as event properties. Session data (referrer, landing page, page URL) is included automatically.
Troubleshooting
Events not appearing in PostHog
Verify Project API Key and host URL. Check PostHog ingestion status. Self-hosted instances may have ingestion delays.
Events not linked to correct user
Ensure identify is called with email or external_id before tracking events. PostHog merges anonymous and identified users automatically.