Skip to main content

Integrate the Vimeo player with Google Analytics and Google Tag Manager

This feature requires a Business, Premium, Advanced, or Enterprise membership.

As a Vimeo user, you can use Google Analytics to track events on all Vimeo players embedded on your site, except for Vimeo Live. Google Analytics is not available to Vimeo live players.

You can find instructions for installing Google Analytics via Google’s Tag Manager at 'Google Support: Deploy Universal Analytics with Tag Manager. The tracking code triggers Google Analytics events for plays, impressions, contact forms, and when the progress through a video embedded on your site hits 25%, 50%, 75%, or 100% complete.  

You can find more information at the Google Analytics Help Center and the Google Tag Manager Help Center

In this article:

How to add the Vimeo tracking script to your site

  1. Go to the Marketing tab in your Vimeo Account Settings.
  2. Copy the tracking code below the Google Analytics heading.
  3. Paste this tracking code underneath the Google Analytics script wherever it appears in the HTML source code of your website. 

The Marketing tab of Account Settings. The tracking code can be found under the Google Analytics header. There is a textbox with the tracking code that can be copied and pasted.

💡Tip: If you are unable to modify your website’s HTML code, you can also to inject the tracking code into your website using Google Tag Manager:

  1. Go to the Google Tag Manager workspace for your site.
  2. Next, go to Triggers from Tag Manager’s main Workspace menu.
  3. Click New.
  4. Choose Trigger type DOM ready under Page View and set it for all events.
    The trigger configuration page. Under the trigger configuration header is the trigger type (shown as 'Page view- DOM ready'). There is a pencil icon next to the trigger. This can be selected to edit the trigger type. Below is the header 'This trigger fires on' with two selectable options: 'All DOM Ready Events' and 'Some DOM Ready Events'.
  5. Save your changes.
  6. Now click on Tags from Tag Manager’s main Workspace menu.
  7. Click on New.
  8. Under Tag Configuration, choose the Custom HTML tag type.
  9. Insert your unique Vimeo tracking code into the HTML box.
  10. Under Triggering, select the DOM Ready trigger created in previous steps.
    The Tag Configuration window. The top panel shows the tag type (the example showing 'Custom HTML'). Below is a text window for HTML. The example shows a tracking code. Below the text window is the Triggering panel. The example firing trigger shown is 'DOM Ready'.

⚠️Note: If you have a more advanced setup that adds new embeds to the page after the initial load (for example, if using a lightbox or pop up player), you'll need to either call the function window.__vimeoRefresh() in the script used to load your iframe embeds, or you can insert this custom script into your webpage's source code beneath the Vimeo GA script:

<script>setTimeout(function(){ window.__vimeoRefresh(); }, 3000);</script>

You can insert this script using GTM within the same tag used to trigger your Vimeo GA tracking script, as shown here:

The Tag Configuration window. The top panel shows the tag type (the example showing 'Custom HTML'). Below is a text window for HTML. The example shows a tracking code and a setTimeout script. Below the text window is a checkbox to select 'Support document.write'. Below is a dropdown panel for 'Advanced settings'.

Confirm that the Vimeo tracking code has been installed properly

  1. First go, to Google Tag Manager and click on the Preview button to enter Preview Mode.
  2. Navigate to the site you've set the tracking code on. There, you'll see the Google Tag Manager console. You can verify this by confirming there are Vimeo entries under the Summary section, as well as by clicking on the Data Layer tab within the console itself to verify the existence of Vimeo events.

The Data Layer section of Tag Manager. It shows a Vimeo entry under the Summary section of the page.

⚠️Note: If you’re not seeing the debug window when accessing your webpage, please make sure you’ve properly installed Google Tag Manager in your website.

User-defined variables and triggers

Once you've confirmed that the Vimeo tracking code has been installed, we recommend following Google's guidance on creating user-defined variables and triggers to track your events.

The following specifications may be helpful for creating variables and triggers:

Variable settings

  • event_category: Video
  • event_action (values must be lowercase and match the formatting below):
    • load
    • play
    • progress - 25%
    • progress - 50%
    • progress - 75%
    • progress - 100%
    • emailcapture
  • event_label: Video title + video ID. Eg: "My Vimeo Video | 78934"

Trigger settings

  • Trigger type: Custom Event
  • Event name: vimeo (value must be lowercase)

More information

A few more technical details to keep in mind about the integration with Google Analytics:

  • The script will work with universal analytics, classic analytics, and Google Tag Manager only if the tracking libraries are defined as ga for universal, _gaq for classic, or dataLayer for Google Tag Manager.
  • If you use the script, please do not add the Vimeo player API (https://player.vimeo.com/api/player.js). If you need functionality from that library, you should put the code after the Google Analytics tracking script.

Related articles