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:是否开启调式日志
*/
yhxwfx456.init({
   appurl:"https://up.456.com/logcount.html",
   website:'10018614',
   channel:'huawei',
   custompage:'',
   logflag:true
},this.context);

3. 进阶配置（可选）

用户属性设置

代码示例

//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?yhxwcookie=前面获取的appCookie&yhxwcounttype=app&yhxwsystemtype=harmony