Segment

Segment is a Customer Data Platform (CDP) that allows you to easily manage data and integrations with services across your growth, product, and marketing stack. By tracking events and users via Segment’s API and libraries, you can send your product’s data to all of your analytics/marketing platforms, with minimal instrumentation code. They offer support for most platforms, including iOS, Android, JavaScript, Node.js, PHP, and more.

Before integrating with Segment, we recommend you read our CDP integration guide to understand the different options for integrating with PostHog.

Setting up Segment

Make sure you have a Segment account and a PostHog account, using PostHog Cloud or self-hosting.

1. In the Segment workspace, create a new project and enable PostHog as an integration. We are listed as a 'Destination' on Segment
2. Grab the PostHog API key from the 'Project Settings' page in PostHog
3. Use one of Segment's libraries to send events
4. See the events coming into PostHog

Enabling all features via Segment with your website

The simple Segment destination only supports tracking of pageviews, custom events and identifying users.

In order to use the full feature set of PostHog (autocapture, session recording, feature flags, heatmaps or the toolbar) we need to load our own Javascript snippet directly.

1. In addition to Segment, install your PostHog JS snippet

2. Modify the initialization as documented below to pass the segment analytics through for PostHog JS to sync with:

   JavaScript

   // Load PostHog JS
   !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.async=!0,p.src=s.api_host+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="capture identify alias people.set people.set_once set_config register register_once unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagPayload reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
   
   // Segment script
   var analytics = "<Segment analytics snippet code>"; 
   analytics.load("<your-segment-key>");
   
   analytics.ready(() => {
       window.posthog.init("<your-posthog-key>", {
           api_host: 'https://app.posthog.com', // Use eu.posthog.com for EU instances
           segment: window.analytics, // Pass window.analytics here - NOTE: `window.` is important
           capture_pageview: false, // You want this false if you are going to use segment's `analytics.page()` for pageviews
           // When the posthog library has loaded, call `analytics.page()` explicitly.
           loaded: () => window.analytics.page(),
       });
   })

Sending events to PostHog

Once you have set up Segment and the destination properly configured, can use it to send events to PostHog. You can do this through the Segment API, or one of the Segment libraries. For example, with javascript you can use the analytics.track('Event Name') function to send events to Segment, which will then be sent to PostHog.

For the full list of functions see the relevant SDK docs e.g. the Javascript SDK.

Using group analytics

If you want to use group analytics, each event should include the property $groups as an key-value object of group type and ID like { "company": "42dlsfj23f" } where 42dlsfj23f is the id of the group.