Appearance

Matomo Integration Guide ​

This guide covers how to send Videobot events to Matomo using Matomo Tag Manager (MTM). Videobot pushes events directly to the window._mtm data layer — no custom JavaScript required on your site.

Prerequisites ​

  • Matomo Tag Manager is installed on your site with the _mtm data layer snippet loaded before Videobot
  • You have access to your Matomo Tag Manager container to create triggers, variables, and tags

Matomo Tag Manager vs. Matomo Tracker

This integration requires Matomo Tag Manager, not just the standard Matomo tracking snippet (_paq). If you only have _paq loaded on your site, you'll need to install Matomo Tag Manager first.

Step 1: Configure Videobot ​

  1. Open the Videobot you wish to track from the Videobots page
  2. Navigate to the Settings tab and then the Tracking & analytics section
  3. Set the integration type to: Matomo
  4. Save and Publish the changes
  5. Repeat for each Videobot instance in use

Step 2: Create Data Layer Variables in MTM ​

In your Matomo Tag Manager container, create Data Layer variables for the event fields you want to capture. Create a variable for each field:

Variable nameData layer key
videobot_idvideobot_id
videobot_languagevideobot_language
videobot_referrervideobot_referrer
videobot_video_idvideobot_video_id
videobot_video_namevideobot_video_name
videobot_video_timevideobot_video_time
videobot_current_slide_idvideobot_current_slide_id
videobot_current_slide_namevideobot_current_slide_name
videobot_next_slide_idvideobot_next_slide_id
videobot_next_slide_namevideobot_next_slide_name
videobot_click_urlvideobot_click_url
videobot_click_textvideobot_click_text
videobot_form_idvideobot_form_id
videobot_form_namevideobot_form_name

To create each variable:

  1. Go to Variables in your MTM container
  2. Click Create new variable
  3. Choose type Data Layer
  4. Set the variable name and matching data layer key from the table above

Step 3: Create a Trigger ​

Create a trigger that fires on all Videobot events:

  1. Go to Triggers and click Create new trigger
  2. Choose trigger type: Custom Event
  3. Set the Event name to: ^videobot_.* and enable Use regular expression
  4. Name the trigger: Videobot Events
  5. Save the trigger

Step 4: Create a Tag ​

Create a tag to send Videobot events to Matomo as tracking events:

  1. Go to Tags and click Create new tag
  2. Choose tag type: Matomo Analytics (or Custom HTML if you prefer full control)
  3. Configure the tag:
    • Track type: Event
    • Category: Videobot (or a value of your choice)
    • Action: Use the built-in variable for the event name
    • Name / Label: Optionally map or other variables
  4. Set the Trigger to: Videobot Events
  5. Save and publish the container

Custom HTML tag

If you need more control, you can use a Custom HTML tag instead. The tag fires whenever a Videobot event is pushed, and you can access all mapped variables via etc.

Step 5: Verify ​

  1. Open your site in a browser and interact with a Videobot (open it, play a video, etc.)
  2. Open the browser console and run:
    js
    window._mtm
    You should see an array containing objects with event keys like videobot_open, videobot_play, etc.
  3. In your Matomo Tag Manager container, use the Preview / Debug mode to confirm the trigger fires and the tag executes
  4. Check Matomo reports → Events to confirm events are being recorded (allow a few minutes for data to appear)

Further Reading ​