AppMetrica 是一个包含安装归因、应用分析和推送活动的全方位营销平台。AppMetrica 提供了三个关键功能来评估您的应用性能:广告跟踪、使用分析和崩溃分析。
- 转到 文件 > 添加包依赖项。
- 将 AppMetrica SDK 的 GitHub 链接放入其中:https://github.com/appmetrica/appmetrica-sdk-ios。
- 在 添加到目标 中,为不需要的模块选择 无。
- 将 SDK 添加到项目的依赖项中
dependencies: [
.package(url: "https://github.com/appmetrica/appmetrica-sdk-ios", from: "5.0.0")
],
- 列出目标依赖项中的模块
.target(
name: "YourTargetName",
dependencies: [
.product(name: "AppMetricaCore", package: "appmetrica-sdk-ios"),
// Add other modules like AppMetricaCrashes if needed.
]
)
- 如果您尚未设置 CocoaPods,请在项目目录中运行
pod init
。 - 在 Podfile 中添加 AppMetrica 依赖项
target 'YourAppName' do
# For all analytics features, add this umbrella module:
pod 'AppMetricaAnalytics', '~> 5.0.0'
# If you need specific integration, skip 'AppMetricaAnalytics' and add specific modules:
pod 'AppMetricaCore', '~> 5.0.0'
# Add other modules like 'AppMetricaCrashes', 'AppMetricaWebKit' or 'AppMetricaAdSupport' if needed.
end
- 使用
pod install
安装依赖项。 - 使用
.xcworkspace
文件在 Xcode 中打开您的项目。
为符合 Apple App Store 对儿童隐私(如 COPPA)的规定,请添加 AppMetrica,但不要包括 AppMetricaAdSupport
模块
-
CocoaPods:
pod 'AppMetricaCore', '~> 5.0.0' pod 'AppMetricaCrashes', '~> 5.0.0' pod 'AppMetricaWebKit', '~> 5.0.0'
-
SPM:不要包括
AppMetricaAdSupport
。在 Xcode 中选择包时选择 无,或者在Package.swift
中指定依赖项。
AppMetricaCore
:用于基本 SDK 使用。AppMetricaCrashes
:启用崩溃报告。AppMetricaWebKit
:用于处理来自 WebKit 的事件。AppMetricaAdSupport
:用于收集 IDFA,请不要在儿童应用中使用。
以下是向您的项目添加 AppMetrica 的方法(适用于 SwiftUI 和 UIKit)
-
在您的
AppDelegate
中导入import AppMetricaCore
。 -
在
application(_:didFinishLaunchingWithOptions:)
方法中使用您的 API 密钥初始化 AppMetrica。
将此内容放在您的 AppDelegate.swift
中
import AppMetricaCore
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
if let configuration = AppMetricaConfiguration(apiKey: "Your_API_Key") {
AppMetrica.activate(with: configuration)
}
return true
}
创建一个新的 Swift 文件以与 AppDelegate
兼容,并使用此代码
import UIKit
import AppMetricaCore
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
if let configuration = AppMetricaConfiguration(apiKey: "Your_API_Key") {
AppMetrica.activate(with: configuration)
}
return true
}
}
然后在您的 App
结构体中
@main
struct YourAppNameApp: App {
// Use the `@UIApplicationDelegateAdaptor` property wrapper to work with AppDelegate and set up AppMetrica
@UIApplicationDelegateAdaptor var appDelegate: AppDelegate
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
注意:用您的实际 AppMetrica API 密钥替换 "Your_API_Key"
,该密钥是您在 AppMetrica 网络界面 的 设置 下提供的用于您应用的唯一标识符。
-
发送自定义事件:为了捕获和分析您的应用内的用户操作,您应该配置发送自定义事件。有关更多信息,请参阅 事件。
-
用户画像:为了深入了解您的用户群,请设置发送用户属性。这允许您通过对自定义属性进行细分来更深入地分析用户行为。请注意,一个用户属性只能保存一个值,发送一个新的属性值将替代现有的一个值。有关更多信息,请参阅用户画像。
-
应用程序内购买(收入跟踪):为了有效地监控应用程序内购买,请配置发送收入事件。此功能使您可以全面跟踪应用程序内的交易。有关设置详细信息,请参阅应用程序内购买。
在您进行测试之前,建议您将测试数据从实际的应用程序统计数据中分离。考虑使用发送统计数据到另一个API密钥或通过AppMetrica界面添加另一个带有新API密钥的应用实例。
-
启动应用程序:启动与AppMetrica SDK集成的应用程序并与之交互一段时间以生成测试数据。
-
互联网连接:确保运行应用程序的设备连接到互联网,以便将数据传输到AppMetrica。
-
验证AppMetrica界面中的数据:登录AppMetrica界面并确认以下内容
如果遇到任何问题,请咨询故障排除部分。
您可以在我们的完整文档中找到关于集成、安装、配置、测试等的详细信息。
AppMetrica遵循MIT许可证发布。许可证协议可在LICENSE中找到。