移动应用分析
Swift 与 iOS
将 Talivia Swift 包添加到原生 iOS 应用,追踪页面、事件和已知用户。
在 Xcode 中通过 Swift Package Manager 添加公开的 Talivia 包,并从以下地址选择 0.1.0 版本:
https://github.com/talivia-group/swift.git如果在另一个 Swift 包中使用,请添加 .package(url: "https://github.com/talivia-group/swift.git", from: "0.1.0"),并依赖 Talivia 库产品。
初始化与追踪
import Talivia
let analytics = try Talivia(
websiteId: "YOUR_WEBSITE_UUID",
hostname: "example.com"
)
try await analytics.screen("Home")
try await analytics.track("signup_completed", data: ["plan": .string("pro")])
try await analytics.identify("your-stable-user-id")
// 退出登录时:analytics.reset()这些方法限定在主 actor 上运行。应用显示其他页面时调用 screen();该包不会自动观察 SwiftUI 或 UIKit 导航。操作实际发生后再记录产品事件,并仅在隐私设置允许采集时初始化。
使用与网站相同的 Website ID 和域名,在一个工作区查看活动。稳定 ID 一致时可以关联已知账户身份记录,但当前跨设备漏斗仍按访客标识统计。内存中的重试队列最多容纳 100 个事件。购买收入应由可信服务端验证;应用商店购买不会自动追踪。