Report a subscriber stream

post

https://api.7digital.com/1.2/user/subscription/log?{userId}&{country}

Report a track that has been streamed by a user which had a subscription.

It is recommended to log streams in near real-time, or the same day in batches of 10-20 logs per request. Before logging actual user data, your Client Success Manager will support you through Compliance Testing to ensure logging accuracy and usage of the appropriate endpoint.

OAuth User token

Path Params

userId

string

required

The unique identifier of the user that played that track. For information on creating users click here.

country

string

required

The 2 letter ISO country code, as with our other endpoints. Should be the country where the user originated the stream from (e.g. set to US if the stream was played by a US user). Please note it can only be placed as a query string parameter, not in the POST body, or authorisation headers if those are used.

Form Data

trackId

int32

required

The MassiveMusic ID of the track that was streamed.

releaseId

int32

required

The MassiveMusic ID of the release that was streamed.

formatId

int32

required

The MassiveMusic ID of the format streamed.

playMode

string

required

Either "online", "offline", or "online-cached". Indicates if the play was with an active or inactive network connection and, if the network connection is active, whether or not it was read from the device cache.

dateTimePlayed

string

required

The date and time when the track was played. Should be in the ISO 8601 format.

totalTimePlayed

int32

required

The total time the track was streamed in seconds.

userAgent

string

required

Details of the device model and application version used to play the track. Values over 256 characters will be truncated.

Language

Loading…