Appearance

Configuring External Analytics Integrations ​

While Videobot provides built-in metrics for monitoring its performance, integrating with third-party analytics services offers additional benefits such as:

  • Consolidating Videobot data with your existing website analytics
  • Tracking conversions across your entire user journey
  • Enabling A/B testing with specialized tools
  • Creating custom audience segments based on video interactions

Videobot supports integration with virtually any analytics platform — including Google Analytics, Google Tag Manager, Matomo, Piwik PRO, Adobe Analytics, and custom setups. This guide will help you understand the available options and choose the most appropriate solution for your needs.

Available Integration Options ​

The analytics integration is configured per Videobot from the Settings → Tracking & analytics section of the dashboard. The dropdown offers the following options:

Off (default) ​

Analytics integration is disabled. No events are sent to any external platform. This is the default for new bots and widgets.

Automatic ​

Best for: Non-technical users who want events to appear in whichever analytics platform their site already uses.

Videobot detects all supported analytics platforms present on the parent page and pushes events to all of them simultaneously. Detection and dispatch order:

  • GTM / Piwik PRO — if window.dataLayer is present, pushes to dataLayer
  • Matomo Tag Manager — if window._mtm is present, pushes to _mtm
  • Adobe Launch — if window._satellite is present, calls _satellite.track()
  • Adobe Client Data Layer — if window.adobeDataLayer is present, pushes to adobeDataLayer

TIP

Automatic mode logs which platforms it detected to the browser console for easy debugging: [Videobot] Analytics: detected GTM, Matomo TM

WARNING

Automatic mode does not push directly to gtag(). If you use GA4 without GTM, select GA4 (standalone) instead to avoid missed events.

Google Tag Manager / Piwik PRO ​

Best for: Sites already using GTM or Piwik PRO Tag Manager.

Pushes Videobot events to window.dataLayer. Both GTM and Piwik PRO use the same dataLayer interface, so a single integration option covers both platforms.

Setup instructions → · Piwik PRO guide →

Adobe Analytics ​

Best for: Sites using Adobe Experience Platform Launch or the Adobe Client Data Layer.

Videobot auto-detects the Adobe stack: it tries _satellite.track() first (Adobe Launch / Direct Call Rules), and falls back to adobeDataLayer.push() (Adobe Client Data Layer). If neither is detected, a console warning is shown.

No Measurement ID or container ID is required — zero configuration needed.

Setup instructions →

Matomo ​

Best for: Sites using Matomo Tag Manager.

Pushes Videobot events to window._mtm, which Matomo Tag Manager uses as its data layer. Requires Matomo Tag Manager (not just the Matomo tracker) to be installed on the parent page.

Setup instructions →

GA4 (standalone) ​

Best for: Sites using Google Analytics 4 directly via gtag.js, without GTM.

Sends events directly to your GA4 property using the global gtag() function. This is the only mode that requires configuration — you must supply your GA4 Measurement ID (e.g. G-XXXXXXXXXX).

TIP

If you use GA4 through GTM, choose Google Tag Manager / Piwik PRO instead to avoid double-counting.

Custom (postMessage) ​

Best for: Custom analytics implementations, or embedding Videobot in an iframe where the parent page handles event routing.

Videobot sends raw analytics events to the parent window via the postMessage API. Your page is responsible for receiving and forwarding them to whatever platform you use.

Setup instructions →

Legacy Options ​

Bots that were configured before this update may still use the older Google Analytics (Direct) or Google Tag Manager (Embedded) modes. These options are hidden from the dropdown for new selection, but remain fully functional. If your bot has one of these values set, it will appear in the dropdown with a Legacy label (e.g., Google Analytics (Direct) — Legacy).

You can switch away from a legacy option at any time. Once switched, the legacy option is no longer available for re-selection.

Implementation Recommendations ​

Your setupRecommended option
GTM already on the siteGoogle Tag Manager / Piwik PRO
Piwik PRO Tag ManagerGoogle Tag Manager / Piwik PRO
GA4 directly (no GTM)GA4 (standalone)
Adobe Launch or ACDLAdobe Analytics
Matomo Tag ManagerMatomo
Multiple platforms, unsureAutomatic
Custom or iframe embedCustom (postMessage)
No analytics neededOff

Platform Guides ​