How do I install the Matomo tracking code in Tag Rocket for BigCommerce

Tag Rocket for BigCommerce is a tagging solution that streamlines data collection across major ad platforms like Google, Facebook, and Microsoft. It includes support for Matomo Analytics through the app integration to enhance conversion tracking and remarketing.

This guide explains how to integrate Matomo and Tag Rocket for BigCommerce. Before tracking, ensure compliance with data privacy regulations by obtaining user consent where required.

Requirements

Before you start, make sure you have a valid Matomo account with active tracking configured for your website, and admin access to a BigCommerce account linked to the same website.

Install and configure the Tag Rocket App

  1. In your BigCommerce admin account, navigate to Apps & Integrations.
  2. Search for Tag Rocket and install the app.
    install the tag rocket app for matomo

Enable Tag Rocket API events

  1. In BigCommerce, go to Apps > Tag Rocket.
  2. In the Tag Rocket dashboard, scroll down to the Administration section.
  3. Navigate to Global Tag Values and click Settings.
  4. Enable Fire All Events. ⚠️This is critical — without it, Tag Rocket will not send events for the Matomo script.
  5. Click Finish Editing to save your changes.
  6. Go back to the Tag Rocket dashboard and click the (Publish or) Republish button at the top right. This will apply the changes to your store.
    configure tag rocket for matomo

Add the Matomo tracking script

  1. In your BigCommerce admin, navigate to Storefront > Script Manager.
  2. Click Create a Script to add a new one.

  3. Copy the script for Matomo tracking from the BigCommerce – Tag Rocket official repository:
    copy tag rocket tracking script for matomo

  4. In BigCommerce Script manager, select Script as the Script type.

  5. Paste the copied code into the Script Content area.
    tag rocket paste matomo tracking script

Customise the Matomo tracking script

  1. At the top of the script, update the following placeholders with your Matomo account details:
    var matomoTrackingDomain = 'your-matomo-subdomain.matomo.cloud';
    var matomoSiteId = 'your-site-id';
  2. Replace with your Matomo subdomain and the Site ID for your website in Matomo. For example, if your Matomo subdomain is example.matomo.cloud and your site ID is 3, update the script accordingly.
    tag rocket set matomo url site id

Validate the configuration

Once these steps are complete, your Matomo tracking should be active. This includes pageviews across all pages and eCommerce events. To validate the integration, make sure tracking is not blocked by consent settings, ad blockers, or browser privacy features.

  1. Open your website and perform test actions.  
  2. Navigate to your Matomo dashboard and view the Visits in real-time widget to verify your website visit appears in the log.
  3. Check your Tag Rocket reports are capturing the relevant interactions.

If you experience any issues, double-check the following:

  1. The Tag Rocket app is correctly installed and configured as outlined in the instructions above.
  2. The API and Fire All Events setting must be enabled.
  3. The script is correctly configured with your Matomo URL and site ID details.
  4. The script is placed in the Header and set for All pages.

Once Tag Rocket and Matomo are integrated, explore Matomo reporting tools to analyse your Ecommerce and campaign performance, track user behaviour, and uncover optimisation opportunities.

Happy Analytics!

Disclaimer: The use of any third-party tools (plugins, extensions, platforms, APIs, widgets, etc.) is at your own risk. Matomo does not own, control, maintain or support any third-party tools that integrate with our product. We recommend checking your privacy setup is correctly configured across your environment when using any third party tools.

Previous FAQ: How do I install the Matomo tracking code on my PrestaShop store