Event Reference (v1) / Video Events

Video Progress video_progress

When a user reaches a specific percentage of a video. This event can be triggered multiple times per-video/page - but only when different thresholds are reached.

  • Name
    Event Name Required
    Value
    event: video_progress
    Type
    event: string

Video Properties (Inherited)

These properties apply to all video_* events.

  • Name
    Video ID Required
    Type
    video_id: integer|string
    Description

    The unique identifier for the video. This can be as simple and as a HTML id attribute. Or it can be a native video ID from a CMS or other system.

    E.g.
    https://www.youtube.com/watch?v=dQw4w9WgXcQ
  • Name
    Video URL Required
    Type
    video_url: string
    Description

    The URL to the video. This can be a direct link to the video file or a link to a video hosting platform (e.g. YouTube, Vimeo etc...).

    E.g.
    https://www.youtube.com/watch?v=dQw4w9WgXcQ
  • Name
    Video Title Optional
    Type
    video_title: string
    Description

    A human readable name for the video. These should be dynamically set from the system that provides the video.

    E.g.
    Rick Astley - Never Gonna Give You Up (Official Music Video)
  • Name
    Video Duration Optional
    Type
    video_duration: integer
    Description

    The length of the video in seconds (rounded to the nearest second).

    E.g.
    212
  • Name
    Optional
  • Name
    Optional
    E.g.
    youtube

© 2026 Level Agency.