🛒 8. E-Commerce Tracking

Tracking e-commerce transactions accurately is the most critical function of an analytics setup for any online store.
The JaJuMa Matomo Analytics extension offers two distinct methods for tracking conversions, each with significant differences in accuracy and implementation.

Navigate to JaJuMa -> Matomo Analytics -> Configuration
and expand the E-Commerce Tracking section.

🧐 8.1 Choosing Your Tracking Method: JS vs. PHP

The most important decision in this section is the Tracking Type.
This is not just a technical choice; it's a strategic business decision that determines the accuracy of your most valuable data.

While the JavaScript tracker is simple to enable, we strongly recommend the Matomo PHP Tracker for all production environments.
It is the only way to guarantee that 100% of your orders are tracked, providing you with the reliable data necessary for making critical business decisions.

🔧 8.2 E-Commerce Tracking Configuration

First, you must enable the feature.

Enable E-Commerce Tracking

• Yes: Enables the tracking of e-commerce events like product views, add-to-cart actions, and completed orders.
• No: Disables all e-commerce tracking.

Tracking Type

Select your desired tracking method as described in the table above.

• Matomo Javascript Tracker
• Matomo PHP Tracker

If you select Matomo PHP Tracker, you must complete the following prerequisites and additional configuration:

⚠️ Prerequisite: Install PHP Tracker Library
For the PHP Tracker to function, you must install the matomo/matomo-php-tracker library.

• Composer Installation:
  If you installed this extension via composer, this dependency is handled automatically.
• Manual Installation:
  If you installed this extension manually (e.g., via FTP), you must also manually install the PHP tracker library.
  You can find instructions and download it from the official repository:
  matomo/matomo-php-tracker.

You must also have configured the Tracker Access Token in the General settings for this feature to work.

PHP Tracker Mode

This setting controls how server-side tracking events are sent to Matomo.

• Yes (recommended) - Use Queue: Add-to-cart actions and conversions are added to a queue and sent to Matomo in batches via a Magento cron job.
  This method has no performance impact on the user's experience.
• No - Real-time: Tracking data is sent to Matomo immediately as the action occurs.
  This can add a slight delay to the user's action (e.g., during checkout).

Push Order Data Action

This setting determines when an order is tracked as a conversion.

• Order Success:
  The order is tracked as soon as the customer successfully places it and reaches the success page.
  This tracks all placed orders.
• Invoice Success:
  The order is only tracked after an invoice has been successfully generated in Magento.
  This is useful for tracking only confirmed, paid orders (e.g., for payment methods that are not instant).

📞 Need Help?

Still have questions or need help with your configuration? Our expert team is here to assist. Please don't hesitate to contact our support team for personalized assistance.