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 '{
  "_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>"
}

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
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

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.

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

Die ID des HubSpot-Accounts.

providerId
integer
required
sessionId
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.