Skip to main content
POST
Créer un événement

Supported products

Autorisations

Authorization
string
header
requis

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

Corps

application/json
mediaType
enum<string>
requis

Le type de média impliqué dans l'événement. Les valeurs valides incluent « VIDÉO », « AUDIO », « DOCUMENT », « AUTRE » et « IMAGE ».

Options disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requis

L'horodatage de l'événement, représenté par un horodatage Unix en millisecondes.

rawDataMap
object
requis

Une carte des paires clé-valeur de données brutes fournissant un contexte supplémentaire sur l'événement.

sessionId
string
requis

L'identifiant unique de la session au cours de laquelle l'événement s'est produit.

_hsenc
string

Une chaîne encodée utilisée à des fins d'encodage spécifiques à HubSpot.

contactId
integer<int64>

L'identifiant unique du contact associé à l'événement.

contactUtk
string

La clé de suivi unique pour le contact, utilisée à des fins de suivi.

derivedValues
object
externalId
string

Un identifiant externe pour l’événement, généralement utilisé pour la corrélation avec des systèmes externes.

externalPlayContext
enum<string>

Contexte additionnel concernant l'événement de lecture, généralement utilisé pour les intégrations externes.

Options disponibles:
EMAIL,
EXTERNAL_PAGE
mediaBridgeId
integer<int64>

L'identifiant unique de l'instance du pont média.

mediaName
string

Le nom du média impliqué dans l'événement.

mediaUrl
string

L'URL du média impliqué dans l'événement.

pageId
integer<int64>

L'identifiant unique de la page où l'événement s'est produit.

pageName
string

Le nom de la page où l'événement s'est produit.

pageUrl
string

L'URL de la page où l'événement s'est produit.

rawDataString
string

Une chaîne de données brutes contenant des informations supplémentaires sur l'événement.

Réponse

successful operation

contactId
integer<int64>
requis

Une chaîne représentant l'identifiant unique du contact associé à l'événement.

mediaBridgeId
integer<int64>
requis

Une chaîne représentant l'identifiant unique de l'instance de pont multimédia.

mediaBridgeObjectCoordinates
string
requis

Une chaîne détaillant les coordonnées de l'objet du pont média.

mediaBridgeObjectTypeId
string
requis

Une chaîne représentant l'identifiant de type de l'objet pont média.

mediaName
string
requis

Une chaîne représentant le nom du contenu multimédia.

mediaType
enum<string>
requis

Une chaîne de caractères indiquant le type de média impliqué dans l'événement, tel que « VIDÉO », « AUDIO », etc.

Options disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requis

Chaîne de caractères représentant l'horodatage de l'événement, au format ISO 8601.

percentRange
string
requis

Une chaîne indiquant la plage de pourcentages lus pendant le scénario.

portalId
integer<int32>
requis

Un entier représentant l'identifiant unique du portail HubSpot.

providerId
integer<int32>
requis

Une chaîne représentant l'identifiant unique du fournisseur de médias.

sessionId
string
requis

Une chaîne représentant l'identifiant unique de la session pendant laquelle le média a été lu.

totalPercentPlayed
number
requis

Un nombre indiquant le pourcentage total du média qui a été lu.

externalPlayContext
enum<string>

Une chaîne fournissant un contexte supplémentaire sur l'événement de scénario à partir d'une source externe.

Options disponibles:
EMAIL,
EXTERNAL_PAGE
mediaUrl
string

Chaîne contenant l'URL du contenu multimédia.

pageId
integer<int64>

Une chaîne représentant l'identifiant unique de la page.

pageName
string

Une chaîne représentant le nom de la page où le média a été consulté.

pageObjectCoordinates
string

Une chaîne détaillant les coordonnées de l'objet de la page.

pageUrl
string

Chaîne contenant l'URL de la page où le média a été consulté.

rawData
string

Une chaîne contenant les données brutes associées à l'événement.

totalSecondsPlayed
integer<int32>

Un nombre représentant le total de secondes de média qui ont été lues.

Dernière modification le 6 octobre 2026