AppMetrica 是一个一站式的营销平台，提供安装归因、应用程序分析和推送活动。AppMetrica 提供了三个关键功能来评估您的应用程序性能：广告跟踪、使用分析和崩溃分析。

1. 转到 文件 > 添加包依赖项。
2. 将 AppMetrica SDK 的 GitHub 链接放入其中： https://github.com/appmetrica/appmetrica-sdk-ios。
3. 在 添加到目标 中，选择您不想包含的模块的 None。

1. 将 SDK 添加到项目的依赖项中

dependencies: [
    .package(url: "https://github.com/appmetrica/appmetrica-sdk-ios", from: "5.0.0")
],

2. 在目标依赖项中列出模块

.target(
    name: "YourTargetName",
    dependencies: [
        .product(name: "AppMetricaCore", package: "appmetrica-sdk-ios"),
        // Add other modules like AppMetricaCrashes if needed.
    ]
)

1. 如果您还没有设置 CocoaPods，请在项目目录中运行 pod init。
2. 在您的 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

3. 使用 pod install 安装依赖项。
4. 使用 .xcworkspace 文件在 Xcode 中打开您的项目。

为了遵守苹果 App Store 关于儿童隐私规则（如 COPPA），添加 AppMetrica，但不包括 AppMetricaAdSupport 模块。

• CocoaPods:

  pod 'AppMetricaCore', '~> 5.0.0'
  pod 'AppMetricaCrashes', '~> 5.0.0'
  pod 'AppMetricaWebKit', '~> 5.0.0'

• SPM：不要包含 AppMetricaAdSupport。您可以选择 Xcode 中的此模块的 None，或者在 Package.swift 中指定依赖项。

• AppMetricaCore：基本 SDK 使用必需。
• AppMetricaCrashes：启用崩溃报告。
• AppMetricaWebKit：用于处理来自 WebKit 的事件。
• AppMetricaAdSupport：需要收集 IDFA，不要用于儿童应用。

以下是如何将 AppMetrica 添加到您的项目的方法（适用于 SwiftUI 和 UIKit）

1. 在您的 AppDelegate 中导入 import AppMetricaCore。

2. 在 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
}

创建一个用于兼容 AppDelegate 的新 Swift 文件，并使用以下代码

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()
        }
    }
}

注意：将 "Your_API_Key" 替换为您的实际 AppMetrica API 密钥。这是在 AppMetrica 网络界面 中的 设置 下提供的应用程序的唯一标识符。

• 发送自定义事件：为了捕获和分析应用程序内部的用户操作，您应该配置自定义事件的发送。有关更多信息，请参阅事件。

• 用户档案：为了深入了解您的用户基础，请设置发送档案属性。这允许您根据自定义属性细分用户行为进行更深入的分析。请注意，档案属性只能保存一个值，为新属性发送新值将覆盖现有值。有关更多信息，请参阅用户档案。

• 应用内购买（收入跟踪）：为了有效监控应用内购买，请配置发送收入事件。此功能使您能够全面跟踪应用内的交易。有关设置详情，请参阅应用内购买。

在开始测试之前，建议将测试数据与实际应用统计信息分开。您可以考虑通过将统计信息发送到另一个API密钥或通过AppMetrica界面添加另一个带有新API密钥的应用实例来使用单独的API密钥进行测试。

1. 启动应用：启动与AppMetrica SDK集成的应用程序，并与它互动一段时间以生成测试数据。

2. 互联网连接：确保运行应用的设备连接到互联网，以允许向AppMetrica传输数据。

3. 在AppMetrica界面验证数据：登录AppMetrica界面并确认以下内容

   • 在受众报告中出现新用户，表明成功追踪用户。
   • 在参与度 → 会话报告中，可见会话数量增加，表明活跃的应用使用。
   • 您已设置的自定义事件和档案属性反映在事件和档案报告中，这意味着事件跟踪和用户档案工作如预期。

如果遇到任何问题，请参考故障排除部分。

您可以在我们的完整文档中找到全面的集成细节和安装、配置、测试等说明。

AppMetrica采用MIT许可证发布。许可证协议可在LICENSE中找到。