Overview
Connected TV (CTV) encompasses a variety of devices and platforms that deliver streaming content to televisions. Permutive provides comprehensive support across the CTV ecosystem, enabling you to track user engagement, build audience segments, and target ads effectively.Permutive’s CTV Philosophy: Rather than building separate SDKs for each CTV platform, Permutive extends existing SDKs to work seamlessly in CTV environments. This means you get the same reliable APIs and features you’re already familiar with from web and mobile.
Platform Selection Guide
Choose your integration approach based on your CTV platform:| Platform | Technology | SDK to Use | Documentation |
|---|---|---|---|
| Samsung Tizen | Web/JavaScript | JavaScript SDK + CTV addon | Web CTV |
| LG WebOS | Web/JavaScript | JavaScript SDK + CTV addon | Web CTV |
| HbbTV | Web/JavaScript | JavaScript SDK + CTV addon | Web CTV |
| tvOS | Native iOS/Swift | iOS SDK | tvOS |
| Android TV / Google TV | Native Android/Kotlin | Android SDK | Android TV |
| Roku | BrightScript/SceneGraph | Permutive Roku Client | Roku |
CTV Environment Types
Understanding your CTV environment helps determine the right integration approach:- Web-Based CTV Apps
- Native CTV Apps
- Dedicated Streaming Platforms
Many CTV platforms run web-based applications using embedded browsers. These include:
- Samsung Tizen - Uses a Chromium-based web engine
- LG WebOS - Uses a WebKit-based web engine
- HbbTV - Standard for hybrid broadcast/broadband TV
Video Tracking Across Platforms
All CTV platforms support Permutive’s video event schema for consistent audience analytics:| Event | Description | Automatic |
|---|---|---|
| Videoview | User initiated video playback | Yes |
| VideoCompletion | User finished or exited video | Yes |
| VideoAdView | Video ad started playing | Manual |
| VideoAdCompletion | Video ad finished | Manual |
| VideoAdClicked | User clicked on video ad | Manual |
Prerequisites
Before integrating CTV, ensure you have:Permutive Workspace
An active Permutive workspace. Contact [email protected] if you need one.
API Credentials
Your workspace API key and ID from the Dashboard.
CTV Addon (Web-based only)
For web-based CTV platforms, enable the CTV addon in your Dashboard integrations.
Video Event Schema
Ensure your video events conform to your workspace schema. Work with Technical Services to configure this.
Features by Platform
| Feature | Web CTV | tvOS | Android TV | Roku |
|---|---|---|---|---|
| Video event tracking | CTV addon | MediaTracker | MediaTracker | Manual |
| Engagement time | Automatic | Automatic | Automatic | Manual |
| User identity | identify() | setIdentities() | setIdentity() | identity field |
| Cohort retrieval | segments() | cohorts | cohorts | cohorts |
| GAM targeting | Automatic | Manual | Manual | gamKeyValues |
| Contextual cohorts | URL-based | URL-based | URL-based | Not available |
Getting Started
Web-Based CTV
Samsung Tizen, LG WebOS, HbbTV integration with JavaScript SDK
tvOS
Native tvOS integration using the iOS SDK
Android TV
Native Android TV integration using the Android SDK
Roku
Roku channel integration with the Permutive Roku Client
Additional Resources
Video Tracking Best Practices
Unified video event implementation guide
JavaScript SDK Reference
Full JavaScript SDK documentation
iOS SDK Reference
Full iOS/tvOS SDK documentation
Android SDK Reference
Full Android SDK documentation
Getting Help
- Customer Success Manager - Your primary contact for strategy and planning
- Technical Services - Technical integration support
- Support - Troubleshooting and help