SDK 集成

Android 的 AppMetrica SDK 以 AAR 库的形式发布。 该库可在 Maven 仓库 中获取。

下面的步骤说明如何启用并初始化 AppMetrica SDK：

步骤 1. 将AppMetrica库添加到你的项目中

如果你使用 Gradle 构建应用，请在应用的 Gradle 文件中添加以下依赖：

dependencies {
    // AppMetrica SDK.
    implementation("io.appmetrica.analytics:analytics:8.5.1")
}

dependencies {
    // AppMetrica SDK.
    implementation 'io.appmetrica.analytics:analytics:8.5.1'
}

步骤 2. 初始化 AppMetrica 库

在您的应用中初始化 AppMetrica 库。 要做到这一点，请扩展Application类，并重写onCreate()方法，如下所示：

class YourApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // Creating an extended library configuration.
        val config = AppMetricaConfig.newConfigBuilder(API_KEY).build()
        // Initializing the AppMetrica SDK.
        AppMetrica.activate(this, config)
    }
}

public class YourApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // Creating an extended library configuration.
        AppMetricaConfig config = AppMetricaConfig.newConfigBuilder(API_KEY).build();
        // Initializing the AppMetrica SDK.
        AppMetrica.activate(this, config);
    }
}

在用扩展的启动配置初始化库时，日志记录 会被启用。

步骤 3. (可选) 配置位置检测

位置检测帮助您了解用户的地理位置。 默认情况下，发送设备位置被禁用，但可以在启动配置中启用。 详情请参见使用库发送设备位置。

第 4 步。 (可选) 配置事件发送、用户属性和收入 (#send)

要收集用户在应用中的操作信息，请设置发送自定义事件。 要了解更多信息，请参见发送自定义事件。

要收集用户信息，请设置发送用户属性。 要了解更多信息，请查看用户配置文件。

要跟踪应用内购买，请设置收入发送。 要了解更多信息，请查看应用内购买。

第5步。 测试库的操作

在开始测试之前，我们建议设置将数据传输到额外的API密钥或添加使用新API密钥的应用。 这会帮助你将测试数据与核心统计数据分开。

要测试库的功能：

1. 启动包含 AppMetrica SDK 的应用，并使用一段时间。
2. 确保您的设备已连接到互联网。
3. 在 AppMetrica 界面中，请确保：
   • 在 受众 报告中有新用户。
   • 在 Engagement → Sessions 报告中的会话数已增加。
   • 在 Events 和 Profiles 报告中有事件和个人资料属性.

了解更多

• 发送自定义事件
• 发送用户属性
• 发送电商事件
• 发送收入数据
• 发送广告收入数据
• 如何启用发送用户位置？
• 如何确保已安装最新版本的Android库？

故障排查

• 会话数量保持不变
• 报告中没有事件
• 向项目添加库时出错
• 用户会话时长无效，手动跟踪
• 由 AppMetrica 库导致的高功耗
• 使用自动收集 Fyber 广告收入数据时出现代码冲突
• 我的问题没有列出

如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。