# hms-analytics-demo-miniprogram

**Repository Path**: hms-core/hms-analytics-demo-miniprogram

## Basic Information

- **Project Name**: hms-analytics-demo-miniprogram
- **Description**: HmsAnalyticsKitDemo is a app that applying HUAWEI Hianalytics SDK used for showing how to collect user engagement and user preference.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-11-24
- **Last Updated**: 2023-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 华为分析服务微信小程序SDK示例代码

## 目录

* [简介](#简介)
* [快速入门](#快速入门)
* [安装](#安装)
* [配置](#配置)
* [环境要求](#环境要求)
* [操作结果](#操作结果)
* [授权许可](#授权许可)

## 简介
HmsAnalyticsKitDemo提供了华为分析服务（HUAWEI Analytics Kit）与微信小程序集成的示例代码。其演示了如何通过收集预定义事件和自定义事件以提高用户参与度和用户偏好。
[了解更多有关Hianalytics的信息](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050745149).

## 快速入门

更多开发指导，请参考以下链接文档：

[开发指南](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050745149)。

[API参考](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/overview-0000001077819400)。

以HmsAnalyticsKitDemo为例演示了如何使用微信小程序分析服务SDK。

首先，我们通过克隆此仓库或下载压缩包的方式来下载HmsAnalyticsKitDemo。

在微信开发者工具中，点击“导入项目”，选择“HmsAnalyticsKitDemo”。

您可以直接点击“编译”按钮运行工程。

您需要在AppGallery Connect中创建应用，获取agconnect-services.json文件，并将文件中的json数据赋值给HiAnalyticsConfig.js文件的agconnectConfig变量。[进一步了解开发流程](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050745149).

## 安装
1. 使用微信开发者工具打开解压后的工程，我们提供了两个demo：
    1. miniprogram.hmsanalyticskitdemo：已集成sdk的demo
    2. miniprogram.hmsanalyticskitdemo-start：未集成sdk的demo，你可以从这个demo开始尝试如何集成sdk
2. 开启npm功能[[微信小程序npm支持]](https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html)
3. 执行以下命令安装依赖
    ```bash
    npm install --save @hw-hmscore/analytics-sdk-miniprogram
    ```
4. 点击菜单栏 “工具 -> 构建NPM” 完成npm库的依赖

## 配置
1. 在AppGallery Connect中创建应用，并获取应用配置文件agconnect-services.json。在微信开发者工具中，将文件中的json数据赋值给HiAnalyticsConfig.js文件的agconnectConfig变量。 

## 环境要求
硬件要求：
1. 电脑（台式机或笔记本）
2. 安装有微信APP的测试手机，用于应用真机预览和调试
  
软件要求：
1. 华为分析服务6.3.0
2. 微信开发者工具
3. Node.js

## 操作结果
运行该app后，您将会看到如下页面：

<img src="screenshot/screen_0.png" height="534" width="300" style="max-width: 100%;">

点击“TRUE”或“FALSE” 按钮进行答题；点击“NEXT” 按钮进入下一道题；点击“POST SCORE”按钮记录用户获得的分数。所有信息将被上传到Hianalytics控制台，您可以使用Debug View实时查看这些信息。

点击SETTINGS按钮：

<img src="screenshot/screen_1.png" height="534" width="300" style="max-width: 100%;">

当点击SETTINGS按钮，设置您最喜欢的运动。您的选择将作为用户属性记录到Hianalytics中。

## 授权许可
HmsAnalyticsKitDemo经过[Apache 2.0授权许可](http://www.apache.org/licenses/LICENSE-2.0)。