Overview

Log Live Play

Records a live video play event for the logged-in user on a specific device. The body identifies the live show, optional display name, playback position, and event type (Start, Progress, End, or Skip).

Use this when: the user is watching live video playback, not for on-demand music or podcast streams, which use Log Play or Log Offline Plays. Send Start when viewing begins, Progress as the user watches, and End or Skip when they leave or jump away. Reuse the same Guid across events in one viewing session so analytics can link the events for the same session.

Security Model

oAuth

Header Parameters

Authorizationstring Required

Credentials with catalogue:read scope.

StoreIdstring Required

StoreId API Key provided by Tuned Global for accessing the service.

Path Parameters

deviceIdstring Required

Id of the device

Body Parameters

Idstring

Id of the show

EventNamestring

Name of the show

LogPlayTypestring

The type of event being logged

Enum values:

StartProgressEndSkip

Secondsinteger

Epoch time in seconds

Sourcestring

Live play source

Enum values:

LiveVideo

SourceIdstring

Id of the play source

PlayTypestring

Play action

Enum values:

StreamOfflineCacheDownloadPreview

Latitudenumber

Latitude of the user

Longitudenumber

Longitude of the user

Guidstring

Guid for each distinct play

Response

200

Object

true

Sections

Log Live Play

Security Model

Header Parameters

Path Parameters

Body Parameters

Response

Response