Appearance

Piwik PRO Integration Guide ​

This guide covers how to send Videobot events to Piwik PRO using Piwik PRO Tag Manager. Piwik PRO Tag Manager uses the same window.dataLayer interface as Google Tag Manager, so the Videobot integration is configured with the shared Google Tag Manager / Piwik PRO option.

Prerequisites ​

  • Piwik PRO Tag Manager is installed on your site
  • You have access to your Piwik PRO Tag Manager container to create triggers, variables, and tags

Already using GTM?

If you have an existing GTM setup for Videobot, your triggers and variables work identically in Piwik PRO — both platforms read from window.dataLayer. You can adapt the same configuration described in the GTM guide.

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: Google Tag Manager / Piwik PRO
  4. Save and Publish the changes
  5. Repeat for each Videobot instance in use

Step 2: Create Data Layer Variables in Piwik PRO TM ​

In your Piwik PRO Tag Manager container, create Data Layer variables for the event fields you want to capture:

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 container
  2. Click Add variable
  3. Choose type Data layer
  4. Set the variable name and the matching data layer key from the table above

Step 3: Create a Trigger ​

  1. Go to Triggers and click Add 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 your Piwik PRO analytics:

  1. Go to Tags and click Add tag
  2. Choose tag type: Piwik PRO (to fire a custom event) or Custom code for full control
  3. For a Piwik PRO tag:
    • Track type: Custom event
    • Category: Videobot
    • Action: {% raw %}{% endraw %} (the built-in event name variable)
    • Name: Optionally map or other variables
  4. Set the Trigger to: Videobot Events
  5. Save and publish the container

Step 5: Verify ​

  1. Open your site and interact with a Videobot
  2. Open the browser console and run:
    js
    window.dataLayer
    You should see push objects with event keys like videobot_open, videobot_play, etc.
  3. Use Piwik PRO Tag Manager → Preview mode to confirm the trigger fires and the tag executes
  4. Check Piwik PRO Analytics → Reports → Events to confirm events are being recorded

Further Reading ​