Matomo iOS SDK 使用教程
项目介绍
Matomo iOS SDK 是一个用于将应用程序分析数据发送到 Matomo 服务器的 iOS、tvOS 和 macOS SDK。MatomoTracker 可以用 Swift 和 Objective-C 编写,旨在帮助开发者轻松集成 Matomo 分析到他们的移动应用中。
项目快速启动
安装
MatomoTracker 可以通过 CocoaPods、Carthage 和 Swift Package Manager 进行安装。
使用 CocoaPods
在你的 Podfile
中添加以下内容:
pod 'MatomoTracker', '~> 7.5'
然后运行 pod install
。
使用 Carthage
在你的 Cartfile
中添加以下内容:
github "matomo-org/matomo-sdk-ios"
然后运行 carthage update
。
使用 Swift Package Manager
在你的 Package.swift
文件中添加以下依赖:
dependencies: [
.package(url: "https://github.com/matomo-org/matomo-sdk-ios.git", from: "7.5.0")
]
初始化 MatomoTracker
在你的应用中初始化 MatomoTracker:
import MatomoTracker
let matomoTracker = MatomoTracker(siteId: "23", baseURL: URL(string: "https://demo2.matomo.org/piwik.php")!)
发送事件
你可以发送各种事件到 Matomo 服务器:
matomoTracker.track(eventWithCategory: "interaction", action: "tap", name: "Malaysia", url: URL(string: "https://dummy.matomo.org/liveaboard/malaysia"))
应用案例和最佳实践
目标跟踪
Matomo iOS SDK 支持目标跟踪:
matomoTracker.trackGoal(id: 1, revenue: 99.99)
订单跟踪
Matomo iOS SDK 支持订单跟踪:
let items = [
OrderItem(sku: "product_sku_1", name: "iPhone Xs", category: "phone", price: 999.99, quantity: 1),
OrderItem(sku: "product_sku_2", name: "iPhone Xs Max", category: "phone", price: 1199.99, quantity: 1)
]
matomoTracker.trackOrder(id: "order_id_1234", items: items, revenue: 2199.98, subTotal: 2000, tax: 190.98, shippingCost: 9)
高级用法
手动分发事件
MatomoTracker 会每 30 秒自动分发事件。如果你想要手动分发事件,可以使用 dispatch()
函数:
matomoTracker.dispatch()
典型生态项目
Matomo 生态系统还包括其他平台的 SDK,如 Android、Cordova/Ionic 等,这些 SDK 提供了跨平台的分析解决方案,使得开发者可以在多个平台上使用 Matomo 进行应用分析。
Android SDK
Matomo 提供了适用于 Android 平台的 SDK,可以用于跟踪 Android 应用的分析数据。
Cordova/Ionic SDK
对于使用 Cordova 或 Ionic 框架开发的应用,Matomo 也提供了相应的 SDK,方便开发者集成 Matomo 分析功能。
通过这些生态项目,Matomo 提供了全面的移动应用分析解决方案,帮助开发者更好地理解和优化他们的应用。