AppMetricaFMDB 5.7.0

AppMetricaFMDB 5.7.0

Monster Frankenstein 维护。



  • 作者
  • August Mueller

CocoaPods Compatible SPM Index Swift Versions SPM Index Platforms

AppMetrica 是一个包含安装归因、应用分析和推送活动的全方位营销平台。AppMetrica 提供了三个关键功能来评估您的应用性能:广告跟踪、使用分析和崩溃分析。

安装

Swift 包管理器

通过 Xcode

  1. 转到 文件 > 添加包依赖项
  2. 将 AppMetrica SDK 的 GitHub 链接放入其中:https://github.com/appmetrica/appmetrica-sdk-ios
  3. 添加到目标 中,为不需要的模块选择

通过 Package.swift 清单

  1. 将 SDK 添加到项目的依赖项中
dependencies: [
    .package(url: "https://github.com/appmetrica/appmetrica-sdk-ios", from: "5.0.0")
],
  1. 列出目标依赖项中的模块
.target(
    name: "YourTargetName",
    dependencies: [
        .product(name: "AppMetricaCore", package: "appmetrica-sdk-ios"),
        // Add other modules like AppMetricaCrashes if needed.
    ]
)

CocoaPods

  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
  1. 使用 pod install 安装依赖项。
  2. 使用 .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)

  1. 在您的 AppDelegate 中导入 import AppMetricaCore

  2. application(_:didFinishLaunchingWithOptions:) 方法中使用您的 API 密钥初始化 AppMetrica。

对于 UIKit

将此内容放在您的 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
}

对于 SwiftUI

创建一个新的 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 网络界面设置 下提供的用于您应用的唯一标识符。

高级配置

配置发送事件、配置属性和收益

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

  • 用户画像:为了深入了解您的用户群,请设置发送用户属性。这允许您通过对自定义属性进行细分来更深入地分析用户行为。请注意,一个用户属性只能保存一个值,发送一个新的属性值将替代现有的一个值。有关更多信息,请参阅用户画像

  • 应用程序内购买(收入跟踪):为了有效地监控应用程序内购买,请配置发送收入事件。此功能使您可以全面跟踪应用程序内的交易。有关设置详细信息,请参阅应用程序内购买

SDK集成测试

在您进行测试之前,建议您将测试数据从实际的应用程序统计数据中分离。考虑使用发送统计数据到另一个API密钥或通过AppMetrica界面添加另一个带有新API密钥的应用实例。

测试库操作的步骤

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

  2. 互联网连接:确保运行应用程序的设备连接到互联网,以便将数据传输到AppMetrica。

  3. 验证AppMetrica界面中的数据:登录AppMetrica界面并确认以下内容

    • 受众报告中出现了新用户,表示用户跟踪成功。
    • 参与度 → 会话报告中,可见会话数目增加,表示应用程序活跃使用。
    • 您设置的定制事件和用户属性在事件画像报告中得到反映,这意味着事件跟踪和用户画像功能按预期工作。

如果遇到任何问题,请咨询故障排除部分

文档

您可以在我们的完整文档中找到关于集成、安装、配置、测试等的详细信息。

许可证

AppMetrica遵循MIT许可证发布。许可证协议可在LICENSE中找到。