CTV Video Tracking

import Permutive_iOS

// The iOS SDK does not auto-nest publisher properties under `video` like
// Android does — hand-build the nested EventProperties dictionary so the
// emitted event matches the schema (`video.title`, `video.content_type`, ...).
let videoProps = try? EventProperties([
    "video": [
        "title": "Show Title - S1E1",
        "genre": ["Drama", "Thriller"],
        "content_type": ["Series", "Episode"]
    ]
])

let context = Context(
    title: "Now Playing",
    url: URL(string: "https://example.com/show/s1e1")
)

// `duration` is a TimeInterval (seconds), not milliseconds.
mediaTracker = try? Permutive.shared.createVideoTracker(
    duration: videoDurationSeconds,
    properties: videoProps,
    context: context
)

// Sync with player
player.observe(\.timeControlStatus) { player, _ in
    switch player.timeControlStatus {
    case .playing:
        mediaTracker?.play()
    case .paused:
        mediaTracker?.pause()
    default:
        break
    }
}

// Track completion
override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    mediaTracker?.stop()
}

import com.permutive.android.MediaTracker

// Create MediaTracker when video starts
videoTracker = permutive.trackVideoView(
    durationMilliseconds = videoDurationMs,
    videoProperties = MediaTracker.VideoProperties(
        title = "Show Title - S1E1",
        genre = listOf("Drama", "Thriller"),
        contentType = listOf("Series", "Episode"),
        seasonNumber = 1,
        episodeNumber = 1
    ),
    pageProperties = MediaTracker.PageProperties(
        title = "Now Playing",
        url = Uri.parse("https://example.com/show/s1e1")
    )
)

// Sync with ExoPlayer
exoPlayer.addListener(object : Player.Listener {
    override fun onIsPlayingChanged(isPlaying: Boolean) {
        if (isPlaying) {
            videoTracker.play()
        } else {
            videoTracker.pause()
        }
    }
})

// Track completion
override fun onDestroy() {
    super.onDestroy()
    videoTracker.stop()
}

' Generate view ID for this content session
m.global.permutive.view_id = CreateObject("roDeviceInfo").GetRandomUUID()

' Track video start
m.global.permutive.event = {
    name: "Videoview"
    properties: {
        video: {
            title: m.video.title
            genre: m.video.genres
            season_number: m.video.season
            episode_number: m.video.episode
            runtime: m.video.duration
        }
    }
}

' Track video completion
sub onVideoComplete()
    m.global.permutive.event = {
        name: "VideoCompletion"
        properties: {
            video: {
                title: m.video.title
            }
            aggregations: {
                VideoEngagement: {
                    completion: m.player.position / m.player.duration
                    engaged_time: m.engagedSeconds
                }
            }
        }
    }
end sub

' Track ad events
sub onAdStart(ad as Object)
    m.global.permutive.event = {
        name: "VideoAdView"
        properties: {
            ad: {
                title: ad.title
                duration: ad.duration
                muted: ad.muted
                campaign_id: ad.campaignId
                creative_id: ad.creativeId
            }
        }
    }
end sub

// Android example
exoPlayer.addListener(object : Player.Listener {
    override fun onPlaybackStateChanged(state: Int) {
        when (state) {
            Player.STATE_BUFFERING -> videoTracker.pause()
            Player.STATE_READY -> {
                if (exoPlayer.isPlaying) videoTracker.play()
            }
        }
    }
})