高效快捷的微信小程序统计,助力小程序运营。

小程序统计 SDK 集成说明

微信小程序海度统计sdk快速集成

目录

    1. 配置合法域名
    1. SDK初始化上报
    1. 页面统计上报
    1. 自定义事件上报
    1. 标准事件上报

1、配置request合法域名

使用HiidoSDK小程序统计分析时,需要您在微信小程序后台进行相应的配置:

1) 以管理员或开发者身份登录微信公众平台: https://mp.weixin.qq.com/

2) 在设置中选择开发设置,如下图

图片

3) 在request合法域名中添加:

https://ylog.hiido.com

该域名用于HiidoSDK接受微信小程序的统计信息,非常重要,请勿填错。 注: 微信小程序允许同时设置5个request合法域名,且一个月内最多修改3次。 配置安全域名后,请重启IDE,以保证配置生效。

2、SDK初始化

为了提高集成效率,我们对一些微信公开的标准功能做了自动统计处理,这样可以减少您的代码部署量。 初始化步骤:

1)将下载的SDK包解压后将其中的hdweapp.js文件导入您的项目中;

2)在项目的入口文件 app.js 中导入SDK:

var HD = require('./utils/hdweapp'); 在 app.js 的生命周期调用SDK:

var HD = require('./utils/hdweapp');
 App({
    onLaunch: function () {
        HD.launch({
            appkey: '您在hiido创建的小程序App ID',
            appName: '您的应用名称',
            versionName: 'versionName',
            versionCode: 'versionCode',
            autoOnAppShow: true,
            autoOnAppHide: true,
            autoOnPageUnload: true,
            autoOnPullDownRefresh: true,
            autoOnReachBottom: true,
            autoOnShare: true
        });
   // versionName为小程序的用户可见版本号;versionCode为小程序的内部版本号,便于版本管理
    },
    onShow: function () {
        // HD.show();  // 如果上面的参数  autoOnAppShow 设置为 false,需要添加此行
    },
    onHide: function () {
        // HD.hide();  // 如果上面的参数  autoOnAppHide 设置为 false,需要添加此行
    }
});

注: 1、如果您不希望开启自动采集,可将autoOnAppShow等参数置为 false。设置后,请在相关生命周期或函数内添加代码以便正常统计。

2、采用自动采集处理方式时,海度小程序 SDK 默认修改了微信小程序的生命周期,仅用于自动监听必要事件,不做其他处理。

3、页面统计上报

此功能可帮助开发者统计应用中各个页面的访问次数和停留时长,为产品优化提供依据。我们默认取当前页面path为pageName。

在需要被统计的页面内导入SDK,在相关生命周期调用SDK,页面在关闭时会将页面访问信息上报。

微信目前提供了两种不同的页面实现方式:Navigation等链接方式、Tabs方式。Navigation等链接方式下,微信小程序会依次触发onLoad、onUnload;在Tabs方式下,微信小程序不会多次触发onLoad、onUnload,所以这种方式下需要在onShow中进行调用才能准确统计页面数据。 两种实现方式下具体调用方法如下:

1、当页面实现方式为Tabs时,在onShow、onHide位置进行调用:

var HD = require('../../utils/hdweapp');
Page({
​onShow: function () {
​​HD.Page.load(true); // 此时,需要在HD.Page.load()中设置参数true,用于说明此时为Tabs方式;
​},
​onHide: function () {
​​//HD.Page.unload(); // 如果初始化时autoOnPageUnload 设置为 false,则需要添加此行。参数为false或空;
​}
})

2、当页面实现方式为navigation等链接方式打开时,在onLoad、onUnload位置进行调用:

var HD = require('../../utils/hdweapp');
Page({
​onLoad: function () {
​​HD.Page.load();
​},
​onUnload: function () {
​​//hd.Page.unload(); // 如果初始化时autoOnPageUnload 设置为 false,则需要添加此行
​}
})

4、自定义事件上报

调用HD.event()方法上报自定义事件:

 // wxml
<view bindtap="bindEvent">
    <text>点我触发自定义事件</text>
</view>

// js
var HD = require('../../utils/hdweapp');

Page({
    onLoad: function () {
        HD.Page.load();
    },
    onUnload: function () {
        // HD.Page.unload(); // 如果初始化时 autoOnPageUnload 设置为 false,需要添加此行
    },
    bindEvent: function () {
        HD.event({
            id: 'id1',
            label: 'label1',
            params: {
                key: 'key1',
                value: 'value1'
            }
        });
    }
})

5 标准事件上报

对于微信小程序的标准事件:分享、下拉刷新、页面触底,我们提供了标准事件接口: 如果在SDK初始化时以下参数为true时,我们自动采集分享事件:

autoOnPullDownRefresh: true,
autoOnReachBottom: true,
autoOnShare: true

相应的事件ID、Label及参数分别如下:

|自定义事件ID| 事件含义| Label及含义|参数1及含义| 参数2及含义|参数3及含义 | 参数4及含义 |----|-----| ------- | ---- | --- | --- | --- | WeappPullDownRefresh| 页面下拉页面刷新操作| Path(触发下拉动作位置) |WeappReachBottom|页面触底操作| Path(触发上拉触底事件位置) |WeappShare|用户点击右上角分享|Path(发起分享的位置)|User(发起分享的用户HDID)| Title(自定义分享标题)| Desc(自定义分享描述)|Path(分享内容的路径)

如果不希望自动采集以上三个标准事件,也可以调用以下方法,完成对上述用户行为的统计。建议采用与我们相同的事件ID、Lable及参数, 以便报表对此事件做更深入分析。 如果以上参数不能满足您的需求,您也可以采用按需调用HD.event()进行事件追踪。

var app = getApp();var HD = require('../../utils/hdweapp.js');
Page({
    onLoad () {
        HD.Page.load();
    },
    onUnload () {
        HD.Page.unload();
    },
    onShareAppMessage: function () {
        HD.Page.share({
            title: '自定义分享标题',
            desc: '自定义分享描述',
            path: 'pages/page3/index?a=1&b=2&from=hdsdk'
        });
        return {
            title: '自定义分享标题',
            desc: '自定义分享描述',
           path: 'pages/page3/index?a=1&b=2&from=HDsdk'
        }
    },
    onPullDownRefresh: function () {
        HD.Page.pullDownRefresh();
    },
    onReachBottom: function () {
        HD.Page.onReachBottom();
    }
});

补充说明:

  • 1、 小程序统计到的机型依赖微信平台;

  • 2、 目前微信小程序不支持Android 7.0及以上版本;

  • 3、 微信小程序统计暂时无法统计到运营商等信息。

  • 4、 事件上报时机为异步,30秒上报一次,每次上报把该30秒内的事件批量上报

  • 5、 如有需要请联系 YY: 909015539 黄波