Matomo SDK for Android 使用教程

1. 项目介绍

Matomo SDK for Android 是一款开源的 Android 应用分析工具，它可以帮助开发者收集应用的使用数据，并将其发送到 Matomo 分析服务器。该 SDK 支持多种功能，如缓存和离线支持、自动重连处理、仅 WiFi 模式、多线程安全支持、自定义连接实现、完整的 Matomo HTTP API 支持、自定义维度、事件跟踪、内容跟踪、电子商务跟踪以及基于校验和的应用安装/升级跟踪等。

2. 项目快速启动

在开始之前，请确保你已经设置了 Matomo 服务器。以下是将 Matomo SDK 集成到你的 Android 项目中的步骤：

首先，在你的应用模块的 build.gradle 文件中添加 JitPack 仓库和依赖：

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.matomo-org:matomo-sdk-android:<latest-version>'
}

请替换 <latest-version> 为最新的 SDK 版本。

接下来，初始化 Tracker 实例。建议将其存储为单例模式。你可以扩展 MatomoApplication 或创建并存储一个 Tracker 实例：

import org.matomo.sdk.TrackerBuilder;

public class YourApplication extends Application {
    private Tracker tracker;

    public synchronized Tracker getTracker() {
        if (tracker == null) {
            tracker = TrackerBuilder.createDefault("http://domain.tld/matomo.php", 1)
                    .build(Matomo.getInstance(this));
        }
        return tracker;
    }
}

使用 TrackHelper 类来提交事件到你的 Tracker：

// 获取 Tracker 实例
Tracker tracker = ((MatomoApplication) getApplication()).getTracker();

// 跟踪屏幕视图
TrackHelper.track().screen("/activity_main/activity_settings").title("Settings").with(tracker);

// 监控应用安装
TrackHelper.track().download().with(tracker);

3. 应用案例和最佳实践

缓存和离线跟踪

SDK 支持在设备上缓存跟踪请求，并在设备重新连接到互联网时自动发送。这对于确保即使在无网络连接的情况下也能收集数据非常有用。

自定义维度

自定义维度可以让你根据应用特定的需求跟踪额外信息。你可以在 Tracker 初始化时添加自定义维度，并在发送事件时设置它们的值。

4. 典型生态项目

目前，Matomo SDK for Android 已经被广泛使用，并且有一个活跃的开源社区。以下是一些与 Matomo SDK 相关的生态项目：

• Matomo: Matomo 是一个开源的 Web 分析平台，它可以与 SDK 配合使用，以收集和展示应用分析数据。
• Matomo On-Premise: 对于需要完全控制数据隐私和安全的用户，Matomo 提供了本地部署版本。

通过集成 Matomo SDK for Android，开发者可以更好地理解用户行为，优化应用性能，并提升用户体验。