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 '
{
"mediaType": "AUDIO",
"occurredTimestamp": 123,
"playedPercent": 123,
"sessionId": "<string>",
"_hsenc": "<string>",
"contactId": 123,
"contactUtk": "<string>",
"externalId": "<string>",
"externalPlayContext": "EMAIL",
"mediaBridgeId": 123,
"mediaName": "<string>",
"mediaUrl": "<string>",
"pageId": 123,
"pageName": "<string>",
"pageUrl": "<string>"
}
'{
"contactId": 123,
"mediaBridgeId": 123,
"mediaBridgeObjectCoordinates": "<string>",
"mediaBridgeObjectTypeId": "<string>",
"mediaName": "<string>",
"mediaType": "AUDIO",
"occurredTimestamp": 123,
"playedPercent": 123,
"portalId": 123,
"providerId": 123,
"sessionId": "<string>",
"externalPlayContext": "EMAIL",
"mediaUrl": "<string>",
"pageId": 123,
"pageName": "<string>",
"pageObjectCoordinates": "<string>",
"pageUrl": "<string>"
}ユーザーが表示しているメディアが四分位の基準に到達したことを表すイベントを作成します。
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 '
{
"mediaType": "AUDIO",
"occurredTimestamp": 123,
"playedPercent": 123,
"sessionId": "<string>",
"_hsenc": "<string>",
"contactId": 123,
"contactUtk": "<string>",
"externalId": "<string>",
"externalPlayContext": "EMAIL",
"mediaBridgeId": 123,
"mediaName": "<string>",
"mediaUrl": "<string>",
"pageId": 123,
"pageName": "<string>",
"pageUrl": "<string>"
}
'{
"contactId": 123,
"mediaBridgeId": 123,
"mediaBridgeObjectCoordinates": "<string>",
"mediaBridgeObjectTypeId": "<string>",
"mediaName": "<string>",
"mediaType": "AUDIO",
"occurredTimestamp": 123,
"playedPercent": 123,
"portalId": 123,
"providerId": 123,
"sessionId": "<string>",
"externalPlayContext": "EMAIL",
"mediaUrl": "<string>",
"pageId": 123,
"pageName": "<string>",
"pageObjectCoordinates": "<string>",
"pageUrl": "<string>"
}サポートされる製品
必須スコープ
The access token received from the authorization server in the OAuth 2.0 flow.
AUDIO, DOCUMENT, IMAGE, OTHER, VIDEO EMAIL, EXTERNAL_PAGE successful operation
メディアを消費した、HubSpotのシステム内のコンタクトのID。これは、HubSpotのユーザートークン(utk)でコンタクトを取得するAPIを使用して取得できます。APIはユーザートークンの提供もサポートしており、コンタクトIDへの自動変換を処理します。
AUDIO, DOCUMENT, IMAGE, OTHER, VIDEO HubSpotアカウントのID。
EMAIL, EXTERNAL_PAGE HubSpotページで、イベントが発生したページのコンテンツID。ページがHubSpotページの場合は必須です。
イベントが発生したページの名前またはタイトル。HubSpot以外のページに必須です。
イベントが発生したページのURL。HubSpot以外のページに必須です。