# Swift 与 iOS (https://talivia.com/zh-CN/docs/mobile-analytics/swift)



在 Xcode 中通过 Swift Package Manager 添加公开的 Talivia 包，并从以下地址选择 `0.1.0` 版本：

```text
https://github.com/talivia-group/swift.git
```

如果在另一个 Swift 包中使用，请添加 `.package(url: "https://github.com/talivia-group/swift.git", from: "0.1.0")`，并依赖 `Talivia` 库产品。

## 初始化与追踪 [#初始化与追踪]

```swift
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 个事件。购买收入应由可信服务端验证；应用商店购买不会自动追踪。

[查看 iOS 分析](https://talivia.com/zh-CN/mobile-app-analytics/swift) · [查看包源代码](https://github.com/talivia-group/swift)