Skip to content

Video Played ​

Video Played is the single event chosen for video tracking. It combines what the Segment Video Playback and Video Content specs capture into one event.

Status: not sent yet

This is the chosen alternative to Video Playback and Video Content, but no app sends Video Played yet.

Video Played ​

Description: Fired at the start, end, and specific intervals of a video watching session (the necessities of the Playback and Content specs in one).

Destinations: BigQuery, Amplitude.

PropertyTypeRequiredDescription
session_idStringYesThe unique identifier of a particular video watching session.
positionIntegerYesWhere (in seconds) in the video/session the user is. Fired at 3, 10, 30, and 60 seconds, then every 60 seconds until the video is stopped.
total_lengthIntegerYesThe total length of the video in seconds.
content_idStringYesThe internal ID for the content of the video being watched.
content_slugStringYesThe slug or other string identifier of the content.
content_nameStringYesThe title of the content.
youtube_idStringNo(If applicable) The corresponding YouTube ID of the content.
user_idStringYesInternal unique identifier for the individual performing the event.
group_idStringYesInternal unique identifier for the organization of the individual performing the event (church slug).
emailStringYesEmail for the individual performing the event.
is_logged_inBooleanYesIf the user was logged in when performing the event.

Implementation example:

javascript
analytics.track("Video Played", {
  session_id: "frying-pan-92773-dkjhf",
  position: 10,
  total_length: 100,
  content_id: "2739",
  content_slug: "how-to-find-your-way-out-of-a-tower",
  content_name: "How To Find Your Way Out of a Tower",
  youtube_id: "pascal87890",
  group_id: "rapunzel-and-flynn",
  user_id: "2087903",
  email: "hairfordays@tower.com",
  is_logged_in: true,
});

Apollos Platform Documentation