Overview
The Segment integration:- Loads the Segment Analytics.js snippet on pages where your TrackPlay video is embedded
- Fires
analytics.track()calls for all key player interactions - Works with every Segment destination. No extra configuration.
Setup Instructions
Step 1: Create a Segment Source
- Log into Segment
- Go to Connections → Sources → Add Source
- Select JavaScript (Browser)
- Copy the Write Key
Step 2: Connect in TrackPlay
- Go to Integrations in your TrackPlay dashboard
- Find Segment and click Connect
- Paste your Write Key
- Click Save. The integration is active immediately.
Events Sent to Segment
Every call carriesvideoCode, including the ones that list other properties.
Conversions do not come through Segment
There is noVideo Conversion event, and there cannot be one.
A conversion completes on your cart’s domain, after the viewer has left your page. The
player is gone by then, so the browser never sees the sale and has nothing to send.
Use one of these instead:
Cart postbacks
Your cart posts the sale to TrackPlay server-side, and it lands on the viewer’s
session.
Webhooks
Subscribe to
conversion.created and forward it into Segment from your own backend.Troubleshooting
Events not appearing in Segment
- Verify the Write Key is correct and the source is active
- Check the browser console for Segment analytics.js errors
- Use the Segment Debugger (Connections → your source → Debugger) to monitor incoming events in real time