Zum Hauptinhalt springen
POST
/
media-bridge
/
v1
/
events
/
attention-span
Event vom Typ „Aufmerksamkeitsspanne“ erstellen
curl --request POST \
  --url https://api.hubapi.com/media-bridge/v1/events/attention-span \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mediaType": "AUDIO",
  "occurredTimestamp": 123,
  "rawDataMap": {},
  "sessionId": "<string>",
  "_hsenc": "<string>",
  "contactId": 123,
  "contactUtk": "<string>",
  "derivedValues": {
    "totalPercentPlayed": 123,
    "totalSecondsPlayed": 123
  },
  "externalId": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageUrl": "<string>",
  "rawDataString": "<string>"
}
'
{
  "contactId": 123,
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaBridgeObjectTypeId": "<string>",
  "mediaName": "<string>",
  "mediaType": "AUDIO",
  "occurredTimestamp": 123,
  "percentRange": "<string>",
  "portalId": 123,
  "providerId": 123,
  "sessionId": "<string>",
  "totalPercentPlayed": 123,
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "pageUrl": "<string>",
  "rawData": "<string>",
  "totalSecondsPlayed": 123
}

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

Autorisierungen

​
Authorization
string
header
erforderlich

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

Body

application/json
​
mediaType
enum<string>
erforderlich
Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
​
occurredTimestamp
integer<int64>
erforderlich
​
rawDataMap
object
erforderlich
​
sessionId
string
erforderlich
​
_hsenc
string
​
contactId
integer<int64>
​
contactUtk
string
​
derivedValues
object
​
externalId
string
​
mediaBridgeId
integer<int64>
​
mediaName
string
​
mediaUrl
string
​
pageId
integer<int64>
​
pageName
string
​
pageUrl
string
​
rawDataString
string

Antwort

successful operation

​
contactId
integer<int64>
erforderlich

Die ID des Kontakts im System von HubSpot, der die Medien aufgerufen 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<int64>
erforderlich
​
mediaBridgeObjectCoordinates
string
erforderlich
​
mediaBridgeObjectTypeId
string
erforderlich
​
mediaName
string
erforderlich
​
mediaType
enum<string>
erforderlich
Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
​
occurredTimestamp
integer<int64>
erforderlich

Der Zeitstempel, zu dem dieses Event aufgetreten ist, in Millisekunden seit Beginn der Epoche.

​
percentRange
string
erforderlich
​
portalId
integer<int32>
erforderlich

Die ID des HubSpot-Accounts.

​
providerId
integer<int32>
erforderlich
​
sessionId
string
erforderlich
​
totalPercentPlayed
number
erforderlich

Der Prozentsatz der Medien, die der Benutzer aufgerufen hat. Die Berechnungsgrundlage ist je nach Anbieter verschieden, abhängig davon, wie wiederholte Aufrufe desselben Medienteils berücksichtigt werden. Aus diesem Grund versucht die API nicht, totalPercentWatched anhand der Informationen zur Aufmerksamkeitsspanne für das Event zu validieren. Wenn diese fehlt, berechnet HubSpot sie wie folgt aus der Aufmerksamkeitsspannen-Karte: (Anzahl der Spannen mit einem Wert von 1 oder mehr)/(Gesamtzahl der Spannen).

​
mediaUrl
string
​
pageId
integer<int64>

Die ID der Seite, wenn sie auf HubSpot gehostet wird. Erforderlich für HubSpot-Seiten.

​
pageName
string

Der Name der Seite. Erforderlich, wenn die Seite nicht auf HubSpot gehostet wird.

​
pageObjectCoordinates
string
​
pageUrl
string

Die URL der Seite, auf der ein Event aufgetreten ist. Erforderlich, wenn die Seite nicht auf HubSpot gehostet wird.

​
rawData
string

Rohdaten, die präzise Daten über die Medienspanne liefern und darüber, wie oft der Benutzer jede Spanne aufgerufen hat. Wenn beispielsweise ein Besucher bei einem 10-Sekunden-Video, bei dem jede Sekunde eine Spanne darstellt, die ersten 5 Sekunden des Videos ansieht, dann das Video neu startet und die ersten 2 Sekunden erneut ansieht, würde der resultierende „rawDataString“ wie folgt aussehen: „0=2;1=2;2=1;3=1;4=1;5=0;6=0;7=0;8=0;9=0;“.

​
totalSecondsPlayed
integer<int32>

Die Sekunden, die ein Benutzer mit dem Aufruf der Medien verbracht hat. Die Media Bridge berechnet diesen Wert als „totalPercentPlayed“*„mediaDuration“. Wenn ein Anbieter diesen Wert anders berechnen möchte, kann beim Erstellen des Events der vorab berechneten Wert angegeben werden.

Last modified on December 8, 2025