HarmonyOS 接入 - 456数据开发文档

快速开始

1

注册账号

创建应用获取打点地址和应用编号

2

下载 SDK

集成 HarmonyOS SDK 到您的App

3

验证接入

验证数据是否正常上报

4

查看数据看板

实时查看访客数据

1. 注册账号

登录 456 数据控制台，在「我的应用」中点击「创建应用」，然后点击该应用「操作」列里的「统计代码」，在弹出的窗口里获取您的打点地址和应用编号。

2. 下载HarmonyOS SDK

请点击这里下载HarmonyOS SDK并集成到您的App中

将Yhxwfx456AnalyticsSdk.har文件添加到工程目录中，参考如下配置，在 oh-package.json5 文件中添加依赖指向 Yhxwfx456AnalyticsSdk.har 文件放置的位置，然后点击同步。

代码示例

{
  "name": "entry",
  "version": "1.0.0",
  "description": "Please describe the basic information",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {
    "Yhxwfx456AnalyticsSdk": "file:libs/Yhxwfx456AnalyticsSdk.har"
  }
}

3. 初始化 SDK

SDK 共需要三个权限，需要应用进行配置：

代码示例

ohos.permission.INTERNET：必须权限，允许应用发送统计数据，SDK 发送埋点数据需要此权限
ohos.permission.GET_NETWORK_INFO：必须权限，允许应用检测网络状态
ohos.permission.GET_WIFI_INFO：可选权限，允许应用获取 WIFI 信息

在Application中初始化SDK：

代码示例

import  {yhxwfx456}  from 'Yhxwfx456AnalyticsSdk';
/*
appurl:打点地址，不需要修改
website:应用编号
channel:渠道
custompage:传入需要自定义标题的页面路径，每个页面用 | 隔开，如"pages/Content|pages/Control|pages/Error",还可以用(*)定义多个页面，如果没有需要自定义标题的页面，传''.
logflag:是否开启调试日志
autoclick:是否开启自动采集点击元素功能，true 或 false（必填）
*/
yhxwfx456.init({
   appurl:"https://www.456.cn/logcount/logcount.html",
   website:'1000000X',
   channel:'huawei',
   custompage:'',
   autoclick:false,
   logflag:true
},this.context);

4. 如何确认接入成功

测试时在初始化配置中把 logflag 设为 true，运行 App，打开几个页面。
在 DevEco Studio 的日志窗口中搜索「yhxwfx456 - 」：每条上报成功后会打印一行以「yhxwfx456 - 」开头、带「页面 | 」「事件 | 」等类型的日志；出现「Failed to send data」表示发送失败；出现「未正确填写初始化配置参数」请检查 appurl 和 website。
登录 456 数据控制台，在「我的应用」中点击该应用的「查看报表」，进入「访问分析」→「用户轨迹」→「实时用户」，能看到这台设备的访问，即为接入成功。如果调用了自定义事件，可在「使用行为」→「事件分析」中查看。
正式发布前，请把 logflag 改回 false，关闭调试日志。

5. 进阶配置（可选）

用户属性设置

代码示例

//userid 和 username 这两个为必填属性,其他属性可以自定义
 yhxwfx456.trackUserSet({userid:"321",username:"Leo"});

自定义事件设置

代码示例

//不带属性
yhxwfx456.trackEvent("event","购物", "加入购物车");

//带属性
yhxwfx456.trackEvent("event","购物", "加入购物车", {"商品id":"29","金额":"88"});

app和H5打通

App使用SDK ，采集到数据后，发往H5，H5 收到 App 发送的数据后，设置用户的Cookie,这样就保持了用户唯一识别标识的统一。

App端通过以下方法获取App中的用户唯一识别标识：

代码示例

let appCookie:string = yhxwfx456.getUserCookie();

H5端：

代码示例

apph5.html?yhxw456cookie=前面获取的appCookie&yhxw456counttype=app&yhxw456systemtype=harmony