分析服务（HDC）

简介

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

提供埋点与上报接口，支持代码级自定义事件埋点与上报
支持用户属性设置，最多保存25个用户属性
支持自动事件采集与Session计算，预置事件ID与事件参数

您将建立什么

在这个codelab中，您将基于我们提供的Demo project，创建一个Demo App。通过Demo App您可以体验到：

使用HUAWEI Analytics SDK上报用户事件。
在华为分析服务平台查看事件分析报告。

您将会学到什么

如何使用Android Studio高效地集成HUAWEI Analytics Kit能力
如何正确使用HUAWEI Analytics Kit的各个接口

硬件要求

开发计算机（台式机或笔记本电脑）
HUAWEI手机一部，用于运行开发调试版本App

软件要求

开发计算机
- JDK 1.8及以上
- Android Studio 3.6.1及以上
- Android Gradle插件 3.5.4及以上
华为手机
Android API-Level 18（Android 4.3 Jelly Bean）及以上

必备知识

Android基础开发能力
Android多线程开发能力

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

在AppGallery Connect上创建应用
创建Android Studio工程
添加应用包名并保存配置文件
配置Maven仓地址及AGC gradle插件

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

登录AppGallery Connectt网站，单击"我的项目"图标。
选择需要集成分析服务SDK的应用。
单击"华为分析"下的任意菜单可开通分析服务。（注：需拥有产品管理权限才可开通服务）
进入"项目接入设置"页面，设置数据处理位置、选择是否开启"产品改进"功能、完善更多设置的信息。点击"完成"，即完成Analytics Kit服务开通。
下载配置文件。
配置文件导入，在Android Studio中，切换至Project视图，将"agconnect-services.json"文件移至Android应用模块app的根目录下。

添加SDK依赖

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

b) 在"buildscript > repositories"中配置HMS Core SDK的Maven仓地址。
```
repositories { 
    maven {url 'https://developer.huawei.com/repo/'} 
}
```
c) 在"allprojects > repositories"中配置HMS Core SDK的Maven仓地址。
```
repositories { 
    maven {url 'https://developer.huawei.com/repo/'} 
}
```


dependencies { 
    classpath 'com.huawei.agconnect:agcp:1.4.2.300' 
}

在app模块的gradle中添加HUAWEI Analytics Kit依赖。
a) 打开app目录下的build.gradle文件。

b) 将编译依赖项添加到"dependencies"中。
```
dependencies { 
    implementation 'com.huawei.hms:hianalytics:6.6.0.300' 
}
```
codelab中依赖的版本号不一定是最新版本号，如果需要依赖最新版本请参见版本更新说明，修改依赖版本号即可。
如：implementation ‘com.huawei.hms:hianalytics:x.x.x.xxx'

c) 添加agconnect插件配置。请根据实际情况选择：
方法一：在文件头部声明下一行添加如下配置。
```
apply plugin: 'com.huawei.agconnect'
```
方法二：在"plugins"中添加如下配置。
```
plugins { 
    id 'com.android.application' 
    //添加如下配置 
    id 'com.huawei.agconnect' 
}
```
插件不能加在gradle首行，否则会出现应用闪退。
点击Sync Now或Sync Project with Gradle Files，开始构建工程。

配置混淆脚本

如果开发者使用了"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 SDK，本小节您将尝试编写一个Demo，学会如何使用 HUAWEI Analytics Kit的主要接口，例如："记录自定义事件"、"设置用户属性"等。

源码下载

初始化Analytics Kit SDK

从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 com.huawei.hms.analytics.type.HAEventType; 
import com.huawei.hms.analytics.type.HAParamType;

在第一个Activity的onCreate方法中初始化Analytics SDK，获得HiAnalyticsInstance实例。


@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. 
    HiAnalyticsInstance instance = HiAnalytics.getInstance(this);

使用预置事件埋点

上报"添加商品到收藏夹"预置事件。


// TODO: Report a predefined event 
    Bundle bundle_pre = new Bundle(); 
    bundle_pre.putString(HAParamType.PRODUCTID, "item_ID"); 
    bundle_pre.putString(HAParamType.PRODUCTNAME, "name"); 
    bundle_pre.putString(HAParamType.CATEGORY, "category"); 
    bundle_pre.putLong(HAParamType.QUANTITY, 100L); 
    bundle_pre.putDouble(HAParamType.PRICE, 10.01); 
    bundle_pre.putDouble(HAParamType.REVENUE, 10.01); 
    bundle_pre.putString(HAParamType.CURRNAME, "currency"); 
    bundle_pre.putString(HAParamType.PLACEID, "location_ID"); 
    instance.onEvent(HAEventType.ADDPRODUCT2WISHLIST, bundle_pre);

设置用户属性

设置自定义用户属性


// TODO: Call the setUserProfile method to set user attributes. 
 instance.setUserProfile("userKey","value");

关于API简介，请参见《HUAWEI Analytics API参考》。

请开启调试模式，然后在模拟器/真机中启动应用，即可实时查看上报的数据。

开启调试模式

执行如下adb命令，调试模式打开后，所有事件将实时上报。
```
adb shell setprop debug.huawei.hms.analytics.app <package_name>
```
数据成功上报后，"华为分析 > 应用调试"页面会展示出数据，如下图：

停用调试模式

执行如下命令行，停用调试模式。


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

登录AppGallery Connect网站，点击"我的项目"图标。
选择需要查看分析数据的应用。
点击"华为分析 > 概览 > 实时概览"页签。
检查数据，有关详细信息，请参见《HUAWEI Analytics操作指南》。

常见FAQs

应该在什么位置初始化？

请在应用的第一个Activity的onCreate()方法中进行初始化，否则可能影响自动采集的生命周期事件的处理，HUAWEI Analytics Kit必须在主线程中初始化。

HUAWEI Analytics Kit如何识别用户？

HUAWEI Analytics Kit使用AAID（匿名应用程序标识符）来识别用户。

什么时候会重置AAID？重置后，HUAWEI Analytics Kit如何收集用户的统计信息？

在以下情况下，将重置AAID：

用户卸载后重装应用。
用户恢复出厂设置。
用户清除应用数据。
应用主动调用clearCachedData()接口。

重置AAID后，该用户将被计为新用户。

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

测试中无法查看到当前上报数据的分析结果？

当应用调试关闭时，在"实时概览"中可查看部分分析结果，其它分析功能如"事件分析"、"启动分析"等需要第二天凌晨加工处理完成后才能看到数据分析结果。
当应用调试开启时，上报的测试数据不会被处理分析，只会在"应用调试"中查看到。

gradle-wrapper.properties文件报错如何处理？

Analytics Kit提供的示例代码中默认配置的gradle版本可能高于您当前使用的版本，出现报错情况，建议您修改为低版本。例如：gradle-4.10.2-all。

干得好，您已经成功完成了HUAWEI Analytics Kit的使用，并学到了：

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

您可以阅读下面链接，了解更多相关的信息。

相关文档
您可以点击下方按钮下载源码。

源码下载

Code copied