接入Analytics

分析服务提供基于您上报事件的分析数据模型。

分析数据模型采用了Event-Param-User模型来记录数据，通过不同的参数对事件进行描述，同时对用户的特征也进行了描述。

术语	名称	说明
Event	事件	描述一个用户在某个时间点、某个地方、以某种方式完成了某个具体的事情。包含who、when、where、how、what等关键要素。
Param	参数	事件上报的关联参数。如加入购物车事件中的商品名称参数，商品价格参数，支持后续的深入分析。
UserProfile	用户属性	用户的属性表，常见的用户属性有设备型号、应用版本、自定义的用户属性（如食品偏好）等。

Analytics Kit会收集AAID。AAID是应用匿名标识符，每个App在同一个设备上会分配不同的AAID。AAID用于连通华为提供的各项服务，例如分析服务和远程配置。

AAID在“用户清除微信小程序数据”场景下会重置。

接入步骤

导入并初始化SDK。
1. 导入SDK。
```
import agconnect from '@agconnect/api'; 
import '@agconnect/instance'; 
import '@hw-hmscore/analytics-sdk-miniprogram';
```
2. 初始化SDK。
  
  SDK初始化时会发送网络请求，请您务必在用户同意隐私协议后再初始化SDK。
  
  登录AppGallery Connect网站，选择“我的项目”，在项目中找到需要集成SDK的应用，然后切换到“项目设置”页面，拷贝agConnectConfig代码片段到您的代码工程的app.js中，并完成SDK的初始化。此外，您需要登录微信公众平台，将以下SDK代码片段中的“url”和“collector_url”配置到域名白名单。
```
// TODO: 用您应用的配置替换下方代码
const agConnectConfig = {
  // ...
};
// 配置agconnect实例
agconnect.instance().configInstance(agConnectConfig);
// 初始化分析实例
let analytics = agconnect.analytics();
```
通过onEvent接口记录定义事件。

事件的定义请参见事件说明。
请参见API说明，调用接口实现各类功能。

示例代码

导入SDK。

import agconnect from '@agconnect/api'; 
import '@agconnect/instance'; 
import '@hw-hmscore/analytics-sdk-miniprogram';

初始化配置拷贝成功后，在“app.js”的入口初始化Analytics SDK，获得WxHiAnalytics的实例。若拷贝的内容不正确，则无法进行埋点。

// TODO: 用您应用的配置替换下方代码
const agConnectConfig = {
  // ...
};
// 配置agconnect实例
agconnect.instance().configInstance(agConnectConfig);
// 初始化分析实例
let analytics = agconnect.analytics();

自定义事件埋点，在代码合适位置插入埋点代码。

// 自定义事件埋点，在工程合适位置插入埋点代码
let eventId = "Complete_Exam";
let eventParams = {
  "Score": 95,
  "Level": "high"
};
analytics.onEvent(eventId, eventParams);

预置事件埋点，在代码合适位置插入埋点代码。

// 预置事件埋点，在工程合适位置插入埋点代码
let preDefineParams = agconnect.analytics.ParamName;
let preDefineEvents = agconnect.analytics.EventName;
let eventParams = {};
eventParams[preDefineParams.PRODUCTID] = 'item_ID';
eventParams[preDefineParams.PRODUCTNAME] = 'name';
eventParams[preDefineParams.CATEGORY] =  'category';
eventParams[preDefineParams.QUANTITY] =  100;
eventParams[preDefineParams.PRICE] =  10.01;
eventParams[preDefineParams.REVENUE] =  10;
eventParams[preDefineParams.CURRNAME] =  'currency';
eventParams[preDefineParams.PLACEID] =  'location_ID';
analytics.onEvent(preDefineEvents.ADDPRODUCT2WISHLIST, eventParams);

查看实时概览数据

数据成功上报后，“华为分析 > 概览 > 实时概览”页面会展示出数据，如下图：

点击放大

在AppGallery Connect网站查看上报数据，请参见实时概览。

接入调试

在开发过程中可以启用调试模式，实时查看事件的记录情况，观察具体结果并根据需要进行调整。

[h2]开启调试模式

在SDK初始化之前，添加以下代码以启用调试模式（切勿在生产环境使用调试模式）。

// 启用调试模式
agconnect.analytics.InitSettings.debugMode = true;
// 调试模式下，自定义终端标识
agconnect.analytics.InitSettings.terminalName = "custom terminal name";
// 初始化分析实例 
let analytics = agconnect.analytics();

调试模式打开后，所有事件将实时上报，在“华为分析 > 应用调试”界面可实时查看上报的数据如下图：