简介

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

您将建立什么

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

您将会学到什么

硬件要求

软件要求

创建应用获取配置

在AGC 中创建应用,获取工程化配置文件agconnect-services.json,流程如下:

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

导入SDK

配置文件导入

  1. 在AndroidStudio中,切换至Project视图,将agconnect-services.json文件移至Android应用模块app的根目录下。

Maven集成

  1. 打开Android Studio工程根目录下的build.gradle文件。
  2. 进入"allproject ->repositories",配置Analytics-Kit SDK的Maven仓库地址。

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

    进入"buildscript ->repositories",配置Analytics-Kit SDK的Maven仓库地址。

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

    进入"buildscript ->repositories",添加agconnect服务依赖,依赖版本参考agconnect服务最新版本。

    buildscript { dependencies { classpath 'com.huawei.agconnect:agcp:1.0.0.300' } }
  3. 在app模块的gradle中添加Analytics-Kit依赖(版本请根据各业务的发布版本设置)。
    打开app目录下的build.gradle文件
  4. 将编译依赖项添加到"dependencies"中。

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

    在文件头中添加插件依赖。

    apply plugin: 'com.huawei.agconnect'
  5. 点击Sync now或Sync Project with Gradle Files,开始构建工程。

源码下载

将示例代码提取到src目录

复制代码文件

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

复制资源文件

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

修改AndroidManifest.xml

添加以下代码:

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

修改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 var for Analytics Instance HiAnalyticsInstance instance;

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

@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); //TODO Initiate Analytics Kit //Enable Analytics Kit Log HiAnalyticsTools.enableLog(); //Generate the Analytics Instance instance = HiAnalytics.getInstance(this); //Enable collection capability instance.setAnalyticsCollectionEnabled(true); //Enable Automatically collection capability instance.setAutoCollectionEnabled(true); txtQuestion = (TextView)findViewById(R.id.question_text_view); txtQuestion.setText(questions[curQuestionIdx]);

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

private void reportAnswerEvt(String answer) { //TODO Report a customzied Event //Event Name: Answer //Event Parameters: // -- question: String // -- answer:String // -- answerTime: String //Initiate 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 preddefined Event instance.logEvent("Answer", bundle); }

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

private void postScore() { // TODO: Report score by using HA_POST_SCORE Event //Initiate Parameters Bundle bundle = new Bundle(); bundle.putLong(HA_SCORE, score); //Report a preddefined Event instance.logEvent(HA_POST_SCORE, bundle); }

修改SettingActivity类

从Analytics-Kit中导入以下类

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

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

//TODO Define a var for Analytics Instance HiAnalyticsInstance instance;

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

//TODO Genarate Analytics Kit Instance instance = HiAnalytics.getInstance(this);

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

btnSave.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { editFavorSport = (EditText)findViewById(R.id.edit_favoraite_sport); strFavorSport = editFavorSport.getText().toString().trim(); //TODO save favorite sport by user setUserProperty instance.setUserProperty("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方法中进行初始化,否则可能影响自动采集页面生命周期事件的处理,Analytics-Kit必须在主线程中初始化。
2. HA如何识别用户?
答:HA使用AAID(匿名应用程序标识符)来识别用户。
3.什么时候会重置AAID?重置后,HA如何收集用户的统计信息?
答:在以下情况下,将重置AAID:(1)卸载或重新安装应用程序。 (2)用户清除应用程序数据。
重置AAID后,该用户将被计为新用户。
4. Analytics Kit需要哪些权限?
答:Analytics Kit需要以下权限,但是Analytics Kit已在内部对其进行了预设,因此开发人员无需申请权限。

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

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

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

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

相关文档

您可以直接下载Analytics-Kit的Demo,进行Analytics-Kit开发体验。

源码下载

已复制代码