手把手教你接入华为分析的Android SDK

  公司最近开发了一个Android版手游应用,想了解一下上线以来玩家充值情况,就让我接入华为分析的Android SDK。今天我就来给大家分享一下如何将Analytics Kit添加到安卓应用中去。本文是基于Android平台,关于iOS应用接入华为分析服务SDK的方法,可以参考:接入华为分析的iOS SDK。我接入的版本是5.0.0.301

  当我们开始接SDK时,我们要注意以下两个方面:

  1. 参考华为开发者联盟最新的SDK接入文档,并注意你接入的SDK版本
  2. 不要遗漏文档中需要复制的代码细节

  具体步骤包括:

  1. 配置AppGallery Connect
  2. 集成HMS Core SDK
  3. 接入Analytics

1 配置AppGallery Connect

  请按照如下步骤为你的安卓应用配置AppGallery Connect。如果你的应用同时拥有Android和iOS版本,你可以将两个应用放在同一个项目内,后续可以灵活切换,以对全量用户做跨平台、跨设备的统一数据分析。

在这里插入图片描述

(一)开发前准备

  1. 为你的安卓应用准备好包名(向开发人员询问)。
  2. 登录 AppGallery Connect 网站 并创建一个新项目。

在这里插入图片描述

  项目创建好后,你会进入一个页面,左侧导航栏展示了AGC的多种功能菜单。

在这里插入图片描述
3. 点击“添加应用“按钮,在项目下创建Android应用。

在这里插入图片描述
  点击确定后会直接进入到“设置SDK”的引导页面中,我建议大家先去检查并确保已经完成高级分析服务的开通。

(二)开通华为分析服务

  点击“API管理“,看到Analystics Kit已默认开启。

在这里插入图片描述

  回到左侧导航栏,转到“华为分析”,你将看到各种数据报告,包括用户分析、行为分析、受众分析等,点击任意菜单即可开通分析服务。
  然后进入“项目接入设置”页面,设置数据存储位置、时区、货币、设置用户数据留存时间、设置自然周定义后,单击“完成”,即完成Analytics Kit服务开通。

在这里插入图片描述

集成HMS Core SDK

  点击“添加SDK”,即可回到引导页面,按照步骤操作即可。

在这里插入图片描述

第一步:添加AppGallery Connect配置文件

a) 下载配置文件“agconnect-services.json”

b) 将“agconnect-services.json”文件拷贝到应用级根目录下

在这里插入图片描述

第二步:添加SDK

  在Gradle文件中设置AppGallery Connect的Gradle插件以及AppGallery Connect SDK基础包。

a) 设置项目级build.gradle

allprojects {  
    repositories {  
            //Add Maven  
            maven {url 'http://developer.huawei.com/repo/'}  
    }  
}  
...  
buildscript{  
    repositories {  
        //Add Maven  
        maven { url 'http://developer.huawei.com/repo/' }  
    }  
    dependencies {  
        // Add this line  
        classpath 'com.huawei.agconnect:agcp:1.1.1.300'  
    }  
}

b) 设置模块级build.gradle

dependencies {  
    // Add this line  
    implementation 'com.huawei.agconnect:agconnect-core:1.0.0.300'  
}  
...  
// Add to the bottom of the file  
apply plugin: 'com.huawei.agconnect'

c)单击“Sync now”或“Sync Project with Gradle Files”,开始构建工程。

接入Analytics

  1. 在你的应用中初始化Analytics SDK
    最后一步是在你的应用中添加初始化代码。通过 getInstance 接口SDK根据配置完成初始化。

  2. 通过 onEvent 接口记录定义事件。
    如果你不确定如何标记事件,请查看事件说明

  3. 参考“API说明”,调用接口实现各类功能。
    另外,在开发过程中,推荐启用调试模式,借助华为分析的应用调试功能,可以实时查看事件的上报情况,观察上报结果并做调测。

开启/停用调试模式

  1. 开启调试模式:在Android设备上执行如下命令行,开启调试模式。调试模式打开后会保持启用状态,所有事件将实时上报。
adb shell setprop debug.huawei.hms.analytics.app package_name
  1. 停用调试模式:您可执行如下命令行,停用调试模式:
adb shell setprop debug.huawei.hms.analytics.app .none.

  数据成功上报后,华为分析的应用调试界面会展示出数据,如下图:

在这里插入图片描述
  更详细的开发指南参考华为开发者联盟官网https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050040566


原文链接:https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201296913629300024&fid=18

原作者:小鱼

posted @ 2020-07-17 13:56  华为开发者论坛  阅读(1929)  评论(0编辑  收藏