Zum Hauptinhalt springen
POST
/
media-bridge
/
v1
/
events
/
media-played-percent
Quartil-Event erstellen
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 '{
  "mediaUrl": "<string>",
  "contactId": 123,
  "externalId": "<string>",
  "mediaType": "VIDEO",
  "sessionId": "<string>",
  "playedPercent": 123,
  "pageId": 123,
  "pageName": "<string>",
  "occurredTimestamp": 123,
  "contactUtk": "<string>",
  "pageUrl": "<string>",
  "_hsenc": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>"
}'
{
  "mediaUrl": "<string>",
  "contactId": 123,
  "mediaType": "VIDEO",
  "sessionId": "<string>",
  "playedPercent": 123,
  "pageId": 123,
  "mediaBridgeObjectTypeId": "<string>",
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "occurredTimestamp": 123,
  "providerId": 123,
  "portalId": 123,
  "pageUrl": "<string>",
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaName": "<string>"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos
Diese API erfordert einen der folgenden Bereiche:
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
Available options:
VIDEO,
AUDIO,
DOCUMENT,
OTHER,
IMAGE
sessionId
string
required
playedPercent
integer
required
occurredTimestamp
integer
required
mediaUrl
string
contactId
integer
externalId
string
pageId
integer
pageName
string
contactUtk
string
pageUrl
string
_hsenc
string
mediaBridgeId
integer
mediaName
string

Response

successful operation

contactId
integer
required

Die ID des Kontakts im System von HubSpot, der die Medien in Anspruch genommen hat. Kann mit der HubSpot-API „Kontakt nach usertoken (utk) abrufen“ abgerufen werden. Die API unterstützt auch die Angabe eines Benutzertokens und wandelt dieses automatisch in eine Kontakt-ID um.

mediaType
enum<string>
required
Available options:
VIDEO,
AUDIO,
DOCUMENT,
OTHER,
IMAGE
sessionId
string
required
playedPercent
integer
required
mediaBridgeObjectTypeId
string
required
occurredTimestamp
integer
required
providerId
integer
required
portalId
integer
required

Die ID des HubSpot-Accounts.

mediaBridgeId
integer
required
mediaBridgeObjectCoordinates
string
required
mediaName
string
required
mediaUrl
string
pageId
integer

Die Content-ID der Seite, auf der ein Event aufgetreten ist, für HubSpot-Seiten. Erforderlich, wenn die Seite eine HubSpot-Seite ist.

pageName
string

Der Name oder Titel der Seite, auf der ein Event aufgetreten ist. Erforderlich für Nicht-HubSpot-Seiten.

pageObjectCoordinates
string
pageUrl
string

Die URL der Seite, auf der ein Event aufgetreten ist. Erforderlich für Nicht-HubSpot-Seiten.

I