Record Media Played Percentage
This endpoint allows you to record the percentage of media that has been played. It is useful for tracking user engagement with media content, such as videos or audio files, by capturing the extent to which the media has been consumed. This data can be used for analytics and improving content delivery strategies.
Supported products
Supported products
Required Scopes
Required Scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
The type of media that was played. Valid values include 'VIDEO', 'AUDIO', 'DOCUMENT', 'OTHER', and 'IMAGE'.
AUDIO, DOCUMENT, IMAGE, OTHER, VIDEO The timestamp when the media play event occurred.
The percentage of the media that has been played.
The unique identifier for the session in which the media was played.
HubSpot encoding parameter for tracking purposes.
The unique identifier for the contact associated with the media play event.
The user token key associated with the contact.
An external identifier for the media, provided by the user.
Additional context provided externally about the media play event.
EMAIL, EXTERNAL_PAGE The unique identifier for the media bridge instance.
The name of the media that was played.
The URL where the media is hosted.
The unique identifier for the page where the media was played.
The name of the page where the media was played.
The URL of the page where the media was played.
Response
successful operation
The unique identifier for the contact associated with the media event. It is a string value.
The unique identifier for the media bridge instance. It is a string value.
Coordinates that specify the location of the media bridge object. It is a string value.
The type identifier for the media bridge object. It is a string value.
The name of the media content being played. It is a string value.
The type of media being played, such as 'VIDEO', 'AUDIO', etc. It is a string value.
AUDIO, DOCUMENT, IMAGE, OTHER, VIDEO The timestamp when the media play event occurred. It is a string value in ISO 8601 format.
The percentage of the media content that has been played. It is a number value.
The unique identifier for the HubSpot portal. It is an integer value.
The unique identifier for the media provider. It is a string value.
The unique identifier for the session during which the media was played. It is a string value.
Contextual information about the external environment where the media is played. It is a string value.
EMAIL, EXTERNAL_PAGE The URL of the media content being played. It is a string value.
The unique identifier for the page where the media is being played. It is a string value.
The name of the page where the media is being played. It is a string value.
Coordinates that specify the location of the page object. It is a string value.
The URL of the page where the media is being played. It is a string value.