Zum Hauptinhalt springen
POST
/
media-bridge
/
v1
/
events
/
media-played-percent
Créer un événement de quartile
curl --request POST \
  --url https://api.hubapi.com/media-bridge/v1/events/media-played-percent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "_hsenc": "<string>",
  "contactId": 123,
  "contactUtk": "<string>",
  "externalId": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>",
  "mediaType": "AUDIO",
  "mediaUrl": "<string>",
  "occurredTimestamp": 123,
  "pageId": 123,
  "pageName": "<string>",
  "pageUrl": "<string>",
  "playedPercent": 123,
  "sessionId": "<string>"
}'
{
  "contactId": 123,
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaBridgeObjectTypeId": "<string>",
  "mediaName": "<string>",
  "mediaType": "AUDIO",
  "mediaUrl": "<string>",
  "occurredTimestamp": 123,
  "pageId": 123,
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "pageUrl": "<string>",
  "playedPercent": 123,
  "portalId": 123,
  "providerId": 123,
  "sessionId": "<string>"
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit
Cette API requiert l'une des portées suivantes :
media_bridge.write

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
mediaType
enum<string>
required
Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer
required
playedPercent
integer
required
sessionId
string
required
_hsenc
string
contactId
integer
contactUtk
string
externalId
string
mediaBridgeId
integer
mediaName
string
mediaUrl
string
pageId
integer
pageName
string
pageUrl
string

Response

successful operation

contactId
integer
required

L’identifiant du contact dans le système HubSpot qui a consulté le média. Il peut être récupéré via l’API Obtenir le contact par l'usertoken (utk) de HubSpot. Cette API permet également de fournir un usertoken, qu’elle convertira automatiquement en ID de contact.

mediaBridgeId
integer
required
mediaBridgeObjectCoordinates
string
required
mediaBridgeObjectTypeId
string
required
mediaName
string
required
mediaType
enum<string>
required
Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer
required
playedPercent
integer
required
portalId
integer
required

L'ID du compte HubSpot.

providerId
integer
required
sessionId
string
required
mediaUrl
string
pageId
integer

L'ID de contenu de la page sur laquelle l’événement a eu lieu, pour les pages HubSpot. Obligatoire si la page est une page HubSpot.

pageName
string

Le nom ou le titre de la page sur laquelle l’événement a eu lieu. Obligatoire pour les pages qui ne sont pas hébergées sur HubSpot.

pageObjectCoordinates
string
pageUrl
string

L’URL de la page sur laquelle l’événement a eu lieu. Obligatoire pour les pages non hébergées sur HubSpot.