YouTube video trigger

The YouTube Video trigger is used to fire tags based on interactions with embedded YouTube videos on web pages.

With each interaction, data about the video and playback status is pushed to the data layer. Before you work with this trigger configuration, enable built-in video variables for data that you would like to capture.

To create a new YouTube Video trigger:

  1. Click Triggers and then New.
  2. Click Trigger Configuration and choose the YouTube Video trigger type.
  3. Configure the trigger:
    • Capture options
      • Start: Fires an event when the video begins to play.
      • Complete: Fires when the video finishes.
      • Pause, Seeking, and Buffering: If the video is paused, the scrub bar is moved, or if the video buffers, the trigger will fire.
      • Progress: Fires at specified video progress points, configured by percentage or time threshold values:
        • Percentages: This value indicates the percentage of the video that has been played. Enter percentages as a comma separated list of one or more integers. Example: 5, 20, 50, 80, which represents 5%, 20%, 50%, and 80% respectively.
        • Time Thresholds: This value represents the number of seconds that the video has played. Enter time thresholds as a comma-delimited list of one or more integers. Example: 5, 15, 60, 120, which represents 5 seconds, 15 seconds, 60 seconds, and 120 seconds respectively.
      Percentage and time thresholds will only fire the trigger the first time they are reached. If the user seeks past a particular percentage or time threshold in the video, the event will not fire.
    • Advanced
      • Add JavaScript API support to all videos: Check this box to enable the YouTube iFrame Player API. This ensures that the enablejsapi parameter is appended to YouTube video player URLs with an assigned value of 1. This enables the player to be controlled via iFrame or JavaScript. Note: This will cause the video to reload if it plays when Tag Manager loads.

YouTube Video triggers will work both on and after page load, so long as at least one of these items is present when Tag Manager loads:

Was this article helpful?
How can we improve it?