Question 1

How to track custom events in Matomo iOS SDK?

Accepted Answer

Use the track(eventWithCategory:action:name:value:) method with parameters like category, action, and optional name/value. This allows logging specific user interactions such as button taps or slider adjustments, as shown in the README examples.

Question 2

Does MatomoTracker support offline tracking?

Accepted Answer

Yes, events are queued in memory and dispatched later when online, but they are lost if the app closes before dispatching. An experimental UserDefaultsQueue can persist events to disk, though it's not the default setup.

Question 3

MatomoTracker vs Firebase Analytics: which should I choose?

Accepted Answer

MatomoTracker offers data privacy and self-hosting control, while Firebase provides easy setup and real-time dashboards. Choose Matomo if you need full data ownership; opt for Firebase for quicker integration and broader ecosystem features.

Question 4

How to set up MatomoTracker with Swift Package Manager?

Accepted Answer

Add the package dependency in Xcode or Package.swift using the URL https://github.com/matomo-org/matomo-sdk-ios.git and specify the product MatomoTracker. Then import it in your Swift files to start tracking.

Question 5

Can I use MatomoTracker with Objective-C?

Accepted Answer

Yes, the SDK supports Objective-C for basic tracking, but advanced features like custom events with customTrackingParameters are Swift-only, so check the FAQ for Objective-C usage guidelines.

Question 6

How to handle user consent and opt-out in MatomoTracker?

Accepted Answer

Set the isOptedOut property to true to disable all tracking. Implement this based on user preferences, ensuring compliance with privacy laws by asking for consent before initializing the tracker.

Matomo

What is Matomo?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions