分析服务（微信小程序）

简介

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

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

您将建立什么

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

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

您将会学到什么

如何使用微信开发者工具高效的集成HUAWEI Analytics Kit能力
如何正确使用HUAWEI Analytics Kit的各个接口

硬件要求

开发计算机（台式机或笔记本电脑）。

软件要求

微信小程序IDE开发工具，例如微信开发者工具。
包管理工具npm，运行环境Node.js。
codelab sample code。

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

如何在AppGallery Connect上创建应用
集成分析服务SDK。

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

登录AppGallery Connect网站，单击"我的项目"图标。
选择需要集成分析服务SDK的应用。
单击"华为分析"下的任意菜单可开通分析服务。（注：需拥有产品管理权限才可开通服务）
进入"项目接入设置"页面，设置数据处理位置、选择是否开启"产品改进"功能、完善更多设置的信息。点击"完成"，即完成Analytics Kit服务开通。

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

源码下载

使用开发工具导入示例代码工程

启动示例工程

打开微信小程序IDE开发工具，在当前项目中开启npm功能：
如果项目中没有"package.json"文件，可以在项目的根目录下，使用以下命令来创建：
```
npm init
```
启动命令终端进入项目根目录，运行以下命令安装工程相关的依赖。
```
npm install --save @hw-hmscore/analytics-sdk-miniprogram
```
点击开发者工具菜单栏中的"工具 > 构建 npm"，构建当前工程的npm库文件。
点击IDE工具的"编译"、"预览"按钮。
- 编译：模拟器显示效果。
- 预览：真机显示效果。
如果您使用预览功能，当前工程需使用测试号自动生成的AppID。
启动成功后，Demo显示效果如下。

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

安装SDK依赖

我们需要将Analytics SDK引入到应用工程中，由于使用npm作为工程的包管理工具，可以通过npm install命令来安装所需的依赖，对于这个codelab，我们已经在package.json中加入了SDK相关的依赖，在前一步执行npm install后，相应的SDK已安装，您也可以再次检查或者手动执行如下命令安装所需依赖。


npm install --save @hw-hmscore/analytics-sdk-miniprogram

导入并初始化SDK

打开app.js，添加如下代码。


// TODO: Import necessary modules.  
import agconnect from '@agconnect/api';  
import '@agconnect/instance';  
import '@hw-hmscore/analytics-sdk-miniprogram';

登录AppGallery Connect网站，选择"我的项目"，在项目中找到需要集成SDK的应用，然后切换到"项目设置"页面，拷贝agConnectConfig到您的代码工程中，并完成SDK的初始化。此外，您需要登录微信公众平台，将SDK代码片段中的"url"和"collector_url"配置到域名白名单。
```
// TODO: Replace the following code with the configuration of your app. 
const agConnectConfig = { 
// ... 
}; 
// Initialize the configuration. 
agconnect.instance().configInstance(agConnectConfig); 
// Initialize the Analytics Kit instance. 
let analytics = agconnect.analytics();
```
sample code全局变量是app.js文件中的globalData，为了方便在组件中调用Analytics Kit的接口，可以将分析服务实例挂载到App的全局变量上，方便在其他文件中调用。
在app.js文件中，赋值如下全局变量。
```
this.globalData.analytics = agconnect.analytics(); 
this.globalData.agconnect = agconnect;
```
打开answerdemo.js，添加以下代码以导入相关依赖。
```
const app = getApp();
```

添加以下代码以完成reportAnswer方法（示例上报自定义事件）。


reportAnswer(answer) {  
       // TODO: Report a custom event.   
      let answerTime = this.formatDate();  
      let reportMessage = {  
         question: this.data.questions[this.data.currentNumber],  
         answer: answer,  
         answerTime: answerTime  
      }  
      app.globalData.analytics.onEvent("Answer", reportMessage);  
 }

添加以下代码以完成postScore方法（示例上报预置事件）。



postScore() {  
      // TODO: Report a score through the SUBMITSCORE event.  
      let scoreMessage = {} 
      scoreMessage[app.globalData.agconnect.analytics.ParamName.SCORE] = this.data.score; 
      app.globalData.analytics.onEvent(app.globalData.agconnect.analytics.EventName.SUBMITSCORE, scoreMessage); 
 }

修改Setting.js

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


save() {  
       this.data.sport && app.globalData.analytics.setUserProfile('favor_sport', this.data.sport);  
       wx.navigateBack();  
 }

执行预览启动应用，根据界面引导操作报告事件。

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

常见FAQs

应该在什么位置初始化？

请在应用的app.js的开始处进行初始化，否则可能影响自动采集的生命周期事件的处理。

HUAWEI Analytics Kit如何识别用户？

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

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

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

AAID超过有效期。
用户清除微信小程序数据。

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

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

在"实时概览"中可查看部分分析结果，其它分析功能如"事件分析"、"启动分析"等需要第二天凌晨加工处理完成后才能看到数据分析结果。

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

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

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

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

源码下载

Code copied