LEVEL Agency
Measurement Docs

Event Reference (v1) / Video Events

Video Start video_start

Measures when a user begins watching a video. This should only occur once per-video/page.

Playing a video from a paused state should NOT trigger this event.

  • Name
    Event Name Required
    Value
    event: video_start
    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.