Matomo Quick-Start Guide
Start sending Confection data to Matomo with a few simple steps.
Issues? Questions? Feedback? Leave a comment. Already have a Confection account? Already installed Confection on your site or app? Skip to step four. New to Confection? Learn more here.
If you haven’t already, create a Confection account. If you already have a Confection account, log in.
Click “My Account” (or “Set Up My Account” if you’re accessing your account for the first time). Enter your contact information, the domain(s) on which you want to use Confection, and select one of our two data storage options. Then, click “Save Changes.”
Click "Install Confection" (If you're accessing your account for the first time, this will be the default screen.) Select your preferred langauge, CMS, platform, or framework to download the relevant scripts.
At this point, use the relevant language, framework, CMS, or platform quick start guide to get Confection up and running on your site or app. Then, continue with step four.
We suggest you create a unique Matomo website entry for Confection. This will prevent duplicate data from entering your existing property and will allow you to compare Matomo native data with Confection data.
To create a unique Matomo website entry for Confection, follow this guide. To differentiate it from your other website entries, give the new entry a name like "Confection Enabled." Note, you can use the same URL as your existing entry. For example, if you're already using Matomo on xyz.com, leave that entry as is. Just create a new website entry for the same domain (xyz.com). This will cause no reporting conflicts.
Next, click "All Websites" in your Matomo dashboard header. Click the Confection website entry name, and then click the cog in the upper right corner to load that site's admin settings.
Under the "Personal" header in the sidebar, click "Security." Then, scroll down to "Auth tokens." Create the token, and copy it for the next step.
Next, click "Integrations" in your Confection account. Then, click "New Integration," and select "Matomo."
For this step, you'll need both your Matomo Server URL and your site ID. You can get both from your Matomo tracking code. Click the cog in the upper right corner of your Matomo dashboard to load your site's admin settings. (Just make sure you're working in your Confection-dedicated website entry vs. another entry.)
Under "Measurables," click "Tracking Code." There, you'll see something like the following:
Your Matomo Server URL is api.yourdomain.com from line eight (api.xyz.com in the example) + the script name in line nine (matomo.php in the example). Using the above snippet, our Matomo Server URL would be https://api.xyz.com/matomo.php.
You can find your site ID on line ten: _paq.push(['setSiteId', '%site id here%']); In the example, the site ID is 2 (from _paq.push(['setSiteId', '2']);).
In your Confection dashboard, enter the Matomo Server URL in the "Matomo URL" field, including https:// (eg., https://api.xyz.com/matomo.php), and enter your site ID in "Site ID" field.
Next, enter the Matomo Auth token you created in the previous step in the "Matomo Auth" field. And, finally, click "Create".
On the next screen, select whether or not you want to send all events -- including any custom events -- to Matomo or just pageview and purchase events. By default, Confection won't link custom events with pageviews. For example, if you have a "Click" event attached to a button, we'll just send the raw interaction count to Matomo. If you'd like to see where an event occurred, select the "Link Events and Pageviews" option.
If you'd like to send Confection UUIDs to Matomo as platform user IDs, click "Submit Custom UUID as User ID to Matomo when available." When active, Confection will send a user's most recent UUID to Matomo. This will allow you to group metrics using Confection UUIDs and group multiple visits under one specific identifier.
Next, click "Update" and, finally, "Activate Integration." Your site or app will begin sending data to Matomo immediately.
Enrichment Add-On
Send the names of companies who visit your site and visitor geolocation information to Matomo by activating Confection's enrichment add on. To do so, schedule a call with our team. To learn more about the add-on, see this blog post.
Once the add-on is active, Confection will send company data to Matomo as Company events.
If you've added two or more (sub)domains to your Confection account -- test.com and sub.anotherdomain.com, for example -- and each has its own Matomo website entry, you'll want to do one last thing. Otherwise, the Confection Matomo integration will write all your data to all your properties (ie., you'll see test.com data in sub.anotherdomain.com's Matomo website entry and vice versa).
In the upper right corner of the Matomo integration screen, you'll see a box labeled "Filter Type." Under "Reporting Domain," enter the top-level domain (eg., mydomain.com) or subdomain (eg., sub.mydomain.com) you'd like to associate with this Matomo website entry.
For example, if you only want to write data from mydomain.com to this Matomo entry, enter mydomain.com in the input field. Then, click "Update" (and, if you haven't already, "Activate Integration").
That's it. You're done.
You can manage your integrations by returning to the integrations screen. Just click "Integrations" in the admin menu. Then, click any integration in the list to pause or update it.
Questions or comments about using Confection with Matomo? Leave them below.
You can also use the chat app in the lower right corner.