简介

华为分析服务预置大量分析模型,可帮助您清晰地了解用户的行为方式,从而实现用户、 产品、 内容的深度洞察,让您实现基于数据驱动的运营,可以就应用营销和产品优化制定明智的决策。
HUAWEI Analytics Kit 采集端侧数据,用于支持Analytics功能:

您将建立什么

参照本文档的开发流程,通过文档指定的方式调用接口,采集用户设备的ROM版本号、机型、应用名、包名、渠道号、应用版本号 、操作系统版本、系统语言、制造商、屏幕宽度、屏幕高度、操作时间(其中部分信息由SDK接口内部自动采集)上报数据到分析平台的租户中,分析平台通过这些信息进行大数据统计。

您将会学到什么

硬件要求

软件要求

必备知识

集成HUAWEI HMS Core能力,需要完成以下准备工作

具体操作,请按照《开发准备》中详细说明来完成。

  1. 登录AppGallery Connect网站,单击"我的项目"图标。
  2. 选择需要查看分析数据的应用。
  3. 单击"华为分析"下的任意菜单可开通分析服务。(注:需拥有产品管理权限才可开通服务)
  4. 进入"项目接入设置"页面,设置数据存储位置、数据共享设置、支持行业分析、标识用户、时区、货币、设置用户数据留存时间、设置自然周定义后,点击"完成",即完成Analytics Kit服务开通。对于支持行业分析,如果您已经设置应用的分类情况,则默认开启。
  5. "开启API权限"默认开启,如您本次不开启,将无法上报数据,后续可以在"项目设置 > API管理",手动开启华为分析的API权限。
  6. 下载配置文件
  7. 配置文件导入,在Android Studio中,切换至Project视图,将agconnect-services.json文件移至Android应用模块app的根目录下。

添加SDK依赖

  1. 在主工程gradle中添加Maven仓地址和agconnect服务依赖。
    a) 打开主工程目录下的build.gradle文件。
  2. b) 将Maven仓地址添加到"repositories"中。

    repositories { maven {url 'https://developer.huawei.com/repo/'} }

    c) 将agconnect服务依赖添加到"dependencies"中。

    dependencies { classpath 'com.huawei.agconnect:agcp:1.4.2.300 }
  3. 在app模块的gradle中添加HUAWEI Analytics Kit依赖。

    a) 打开app目录下的build.gradle文件。

    b) 将编译依赖项添加到"dependencies"中。

    dependencies { implementation 'com.huawei.hms:hianalytics:5.3.1.300' }

    c) 添加agconnect插件配置。
    Android Studio 4.0之前版本,在文件头apply plugin: ‘com.android.application'下一行添加如下配置。

    apply plugin: 'com.huawei.agconnect''

    Android Studio 4.0及之后版本,在"plugins"中添加如下配置。

    plugins { id 'com.android.application' //添加如下配置 id 'com.huawei.agconnect' }
  4. 点击Sync now或Sync Project with Gradle Files,开始构建工程。

    配置混淆脚本

    1、如果开发者使用了"AndResGuard",需要在混淆配置文件中加入"AndResGuard"允许清单。

    "R.string.hms*", "R.string.connect_server_fail_prompt_toast", "R.string.getting_message_fail_prompt_toast", "R.string.no_available_network_prompt_toast", "R.string.third_app_*", "R.string.upsdk_*", "R.layout.hms*", "R.layout.upsdk_*", "R.drawable.upsdk*", "R.color.upsdk*", "R.dimen.upsdk*", "R.style.upsdk*", "R.string.agc*"

    在上一小节中,您已成功集成了HUAWEI Analytics Kit,本小节您将尝试编写一个Demo,学会如何使用 HUAWEI Analytics Kit的主要接口。这是一个具有答题功能的Demo,您可以不用关心业务逻辑,我们为您准备了现成的代码,您只需要按照下文每一步的提示,学会如何利用HUAWEI Analytics Kit将您所关心的事件,如"回答问题"、"计算分数"、"设置用户属性"等,上报即可。

    源码下载

    将示例代码提取到src目录

    复制代码文件

    将所有Java文件从代码目录复制到您的项目中

    复制资源文件

    将所有资源文件从res目录复制到您的项目中

    修改AndroidManifest.xml

    在"application"模块中设置meta-data参数,配置应用安装来源。例如:安装来源为应用市场。

    <application ...... <meta-data android:name="install_channel" android:value="AppGallery"> </meta-data> ...... </application>

    在"application"模块中声明SettingActivity。

    <application <activity android:name=".SettingActivity"> </activity> </application>

    截止目前,您的应用软件已经具备了所需的业务功能,接下来将使用HUAWEI Analytics Kit上报您所关心的事件

    修改MainActivity类

    从Analytics Kit中导入以下类

    // TODO: Import classes from Analytics Kit. import com.huawei.hms.analytics.HiAnalytics; import com.huawei.hms.analytics.HiAnalyticsInstance; import com.huawei.hms.analytics.HiAnalyticsTools; import static com.huawei.hms.analytics.type.HAEventType.*; import static com.huawei.hms.analytics.type.HAParamType.*;

    添加以下代码为AnalyticInstance定义变量

    private int score = 0; // TODO: Define a variable for the Analytics Kit instance. HiAnalyticsInstance instance;

    在onCreate方法中添加以下代码以初始化Analytics Kit

    @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // TODO: Initialize Analytics Kit. // Enable Analytics Kit logging. HiAnalyticsTools.enableLog(); // Generate an Analytics Kit instance. instance = HiAnalytics.getInstance(this); txtQuestion = (TextView)findViewById(R.id.question_text_view); txtQuestion.setText(questions[curQuestionIdx]);

    添加以下代码以完成reportAnswerEvt方法

    private void reportAnswerEvt(String answer) { // TODO: Report a custom event. // Event Name: Answer // Event Parameters: // -- question: String // -- answer: String // -- answerTime: String // Initialize parameters. Bundle bundle = new Bundle(); bundle.putString("question", txtQuestion.getText().toString().trim()); bundle.putString("answer",answer); SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.ENGLISH); bundle.putString("answerTime",sdf.format(new Date())); // Report a custom event. instance.onEvent("Answer", bundle); }

    添加以下代码以完成postScore方法

    private void postScore() { // TODO: Report the score by using the SUBMITSCORE event. // Initialize parameters. Bundle bundle = new Bundle(); bundle.putLong(SCORE, score); // Report a predefined event. instance.onEvent(SUBMITSCORE, bundle); }

    修改SettingActivity类

    从HUAWEI Analytics Kit中导入以下类

    // TODO: Import classes from Analytics Kit. import com.huawei.hms.analytics.HiAnalytics; import com.huawei.hms.analytics.HiAnalyticsInstance;

    添加以下代码为AnalyticInstance定义变量

    // TODO: Define a variable for the Analytics Kit instance. HiAnalyticsInstance instance;

    添加以下代码以初始化Analytics Kit

    // TODO: Generate an Analytics Kit instance. instance = HiAnalytics.getInstance(this);

    添加以下代码以保存用户属性

    btnSave.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { editFavorSport = (EditText)findViewById(R.id.edit_favorite_sport); // TODO: Set users' favorite sport using the setUserProfile API. instance.setUserProfile("favor_sport",strFavorSport); } });

    关于API简介,请参见《Huawei Analytics API参考》

    在模拟器中启动应用。

    单击一些按钮以报告事件。

    1. 登录AppGallery Connect网站,点击"我的项目"图标。
    2. 选择需要查看分析数据的应用。
    3. 点击"华为分析"页签。
    4. 检查数据, 有关详细信息,请参见《 Huawei Analytics操作指南》

    应用调试

    在Android设备上执行如下命令行开启调试模式:

    adb shell setprop debug.huawei.hms.analytics.app <package_name>

    打开后会保持启用状态,所有事件将在"华为分析"页签的"应用调试"实时上报,直到执行如下命令行停用调试模式:

    adb shell setprop debug.huawei.hms.analytics.app .none.

    查看上报的调试数据:

    常见FAQs

    1. 应该在什么时候初始化?
      答: 请在应用的第一个Activity的onCreate( )方法中进行初始化,否则可能影响自动采集页面生命周期事件的处理,HUAWEI Analytics Kit必须在主线程中初始化。
    2. HUAWEI Analytics Kit如何识别用户?
      答:HUAWEI Analytics Kit使用AAID(匿名应用程序标识符)来识别用户。
    3. 什么时候会重置AAID?重置后, HUAWEI Analytics Kit如何收集用户的统计信息?
      答:在以下情况下,将重置AAID:
      • 用户卸载后重装应用。
      • 用户恢复出厂设置。
      • 用户清除应用数据。
      • 应用主动调用clearCachedData()接口。
        重置AAID后,该用户将被计为新用户。
    4. HUAWEI Analytics Kit需要哪些权限?
      答:HUAWEI Analytics Kit需要以下权限,但是Analytics Kit已在内部对其进行了预设,因此开发人员无需申请权限。
      • android.permission.INTERNET
      • android.permission.ACCESS_NETWORK_STATE
      • com.huawei.appmarket.service.commondata.permission.GET_COMMON_DATA
    5. 测试中无法查看到当前上报数据的分析结果?
      答:(1)当应用调试关闭时,在"实时概览"中可查看部分分析结果,其它分析功能如"事件分析"、"行为分析"等需要第二天凌晨加工处理完成后才能看到数据分析结果;(2)当应用调试开启时,上报的测试数据不会被处理分析,只会在"应用调试"中查看到。
    6. gradle-wrapper.properties文件报错如何处理?
      答:Analytics Kit提供的示例代码中默认配置的gradle版本可能高于您当前使用的版本,出现报错情况,建议您修改为低版本。例如:gradle-4.10.2-all。

    干得好,你已经成功完成了HUAWEI Analytics Kit的使用,并学到了:

    • 如何集成HUAWEI Analytics Kit
    • 如何使用HUAWEI Analytics Kit的各个接口

    您可以阅读下面链接,了解更多相关的信息。
    相关文档
    您可以点击下方按钮下载源码:

    源码下载

    Code copied