Using Matomo with Drupal

Matomo (formerly Piwik) is an open‑source analytics platform that provides detailed visitor statistics. Integrating Matomo with Drupal allows you to track traffic, user behavior, and conversions directly from your site. On ruachost.com, you can connect Drupal to Matomo either by using a module or by editing your theme.

Why Use Matomo?

• Privacy‑friendly alternative to Google Analytics.

• Provides detailed traffic reports and visitor insights.

• Helps optimize site performance and content strategy.

• Fully open‑source and self‑hosted for maximum control.

Methods to Integrate Matomo with Drupal

Method 1: Use the Matomo Analytics Module

1. Install Matomo on your hosting account (via Softaculous or manually).

2. Download the Matomo Analytics module.

3. Log in to Drupal as an administrator.

4. Go to Extend → Install new module and upload the .zip file.

5. Enable the module under Extend → List → Statistics → Matomo Analytics.

6. Go to Configuration → System → Matomo Analytics.

7. Enter:

   • Site ID → Found in your Matomo dashboard under Websites → Manage.

   • Matomo URL → e.g., https://example.com/matomo.

8. Save configuration.

✅ Matomo is now tracking your Drupal site.

Method 2: Edit the Drupal Theme Directly

1. Log in to your Matomo account.

2. Go to Administration → Websites → Tracking Code.

3. Copy the full JavaScript tracking snippet.

4. On your server, navigate to your Drupal theme directory.

5. Open the page.html.twig or template file for your theme.

6. Paste the tracking code before the closing </body> tag.

7. Save changes and clear Drupal caches.

✅ Matomo will now track all pages on your site.

Important Notes

• Modules are easier to manage but add slight overhead.

• Editing the theme is lightweight but requires re‑adding the code if you change themes.

• Always back up your site before making changes.