Skip to main content

Matomo Integration

How to connect your self-hosted or cloud Matomo instance to Zeeg to track visitor and booking events on your scheduling pages.

Written by Fernando Figueiredo

Connect your organization's Matomo instance to Zeeg to track visitors and booking events across all your scheduling pages — for every user and team in your organization.

A Business subscription is required to use the Matomo integration. See Zeeg pricing here.


How to connect Matomo to Zeeg

  1. In your Zeeg dashboard, open Integrations and click on Matomo.

  2. Enter your Matomo account details:

    1. Matomo URL — the address of your Matomo instance, for example https://your-instance.matomo.cloud/.

    2. Enter your Site ID — the numeric ID of the site in your Matomo account (for example 1). You can find it under Administration → Websites in Matomo.

    3. Click Save.

The Matomo URL must start with https:// and point to a public hostname of your own Matomo server. IP addresses, addresses with a username or password in them, and addresses on zeeg.me are not accepted.

If Zeeg saves your settings but cannot reach your Matomo instance, you will see a warning. Tracking may not work until the URL is reachable and publicly accessible.


What Zeeg tracks in Matomo

Once connected, Zeeg tracks the following visitor actions as Matomo events (category / action / name):

When an invitee…

Matomo event (category / action / name)

Visits a scheduling page

zeeg / invitee_scheduling_page

Selects a date

zeeg / invitee_selected_day

Selects a time slot

zeeg / invitee_selected_time

Completes a booking

zeeg / invitee_scheduled_meeting

Completes a booking (goal conversion)

Zeeg / BookingCompleted / {event-type slug}

Completes a paid booking

Ecommerce order (with revenue amount)

In addition, Matomo automatically records a page view on every scheduling page load.

Your scheduling pages, public pages and routing forms load Matomo's standard tracker. Page views, events and ecommerce orders are tracked, but Tag Manager containers and plugin features such as heatmaps, session recordings, form and media analytics or A/B tests don't run there.


Privacy and consent

When your organization has any analytics integration active, Zeeg automatically shows invitees a consent banner on your scheduling pages. Matomo loads only after a visitor accepts. By default, Zeeg runs Matomo in cookieless mode — no cookies are written — which is compatible with EU privacy requirements (GDPR, TTDSG).

Zeeg serves the Matomo tracker script itself, so your invitees' visits are reported only to your own Matomo instance.


Frequently asked questions

Does this work with Matomo Cloud?

Yes. Enter your Matomo Cloud URL (for example https://your-instance.matomo.cloud/) as the Matomo URL and your Site ID, then click Save. You don't need to enter a tracker script address: Zeeg loads the tracker itself and sends the tracking data to your Matomo Cloud instance.

Where do I find my Site ID?

In your Matomo account, go to Administration → Websites → Manage. The Site ID is shown in the ID column next to your site's name.

Why is my Matomo URL not accepted?

Zeeg only accepts a URL that starts with https:// and points to a public hostname of your own Matomo server. It is refused if it uses http://, is an IP address, contains a username or password, or is an address on zeeg.me. If you see Enter a valid Matomo URL that starts with https://., check the address for one of these.

Can I set up Matomo as a Matomo Goal?

Yes. Zeeg fires a dedicated Zeeg / BookingCompleted / {slug} event for every completed booking. In Matomo, create a Goal that triggers on Custom Event with category Zeeg and action BookingCompleted. You do not need to know the slug to match it — leaving the name blank matches all event types.

Does Zeeg support Matomo Tag Manager or Matomo plugins such as heatmaps?

No. Your booking pages load Matomo's standard tracker only. It records page views, the events listed above and ecommerce orders. Tag Manager containers and plugin features such as heatmaps, session recordings, form and media analytics or A/B tests don't run on your scheduling pages, public pages or routing forms.

Why does the settings page show a warning after I save?

If Zeeg cannot reach your Matomo instance at the URL you entered, it saves your settings but warns you that tracking may not work. Make sure your Matomo instance is publicly accessible over HTTPS and that there is no firewall or access restriction blocking requests from Zeeg's servers.

Can I use Matomo alongside Google Analytics or Meta Pixel?

Yes. All three integrations can be active at the same time. Zeeg fires events to each platform independently from the same user action.

Did this answer your question?