2025-08-25 海纳嗨数如何在uniapp小程序进行埋点上报以及处理过程中遇到的问题

海纳嗨数是一个专门给企业提供数据采集解决方案的多平台（App、Pc、H5、小程序）的数据埋点平台。

官网：https://haishuu.com/ 

业务流程：https://himanual.haishuu.com/docs/hicloud/hicloud-1eus0q48avflh#6s0squ

文档说明：https://himanual.haishuu.com/docs/hicloud/hicloud-1fegunpl050a8

后台：https://hicloud.haishuu.com/login

前提：你已经给海纳嗨数交了钱，拿到了用户账号，还创建了租户，那么你还是一个临时接班来做埋点业务（之前完全不知道埋点是啥的小白），恭喜你！请你看下去。

注意：本文展示uniapp小程序（h5+小程序 2个端）如何进行埋点。

嗯。。。首先你得在App.vue初始化，也就是先得把准备工作做好，你可以参考这里的文档：https://himanual.haishuu.com/docs/hicloud/hicloud-1ehverrfnbhrl

// import方式
import hina from './hina-mini.esm.full.js'

hina.init({
  // 配置采集上报地址URL（在线申请），注意：从海纳嗨数平台上获取对应项目的数据上报地址；
  serverUrl: '采集上报地址URL',
  // 是否允许控制台打印查看埋点数据(建议开启查看)
  showLog: true,
  // 全埋点控制开关
  autoTrack:{
    appLaunch: true,            // 默认为 true，false 则关闭 H_MPLaunch 事件采集
    appShow: true,              // 默认为 true，false 则关闭 H_MPShow 事件采集
    appHide: true,              // 默认为 true，false 则关闭 H_MPHide 事件采集
    pageShow: true,             // 默认为 true，false 则关闭 H_MPViewScreen 事件采集
    pageShare: true,            // 默认为 true，false 则关闭 H_MPShare 事件采集
    mpClick: false,             // 默认为 false，true 则开启 H_MPClick 事件采集
    mpFavorite: true,           // 默认为 true，false 则关闭 H_MPAddFavorites 事件采集
    pageLeave: false            // 默认为 false， true 则开启 H_MPPageLeave事件采集
  },
});

// 将 SDK 实例赋给全局变量 hina
global["hina"] = hina;

App({
  onLaunch: function (options) {
    console.log('app onLaunch', options)
  },
  onShow: function (options) {
    console.log('app onShow', options)
  },
  onHide: function () {
    console.log('app onHide')
  }
})

注意上面示例的代码中引入的sdk你得手动去下载，地址在这儿：https://himanual.haishuu.com/docs/hicloud/hicloud-1gbgs2ee1b8kf

其实上面的初始化操作我之前的同事都已经弄好啦，都是自动采集的，但是没有主动采集指定的数据，所以这活就给到了我。

什么是自动采集呢，原来是以前的同事在海纳嗨数的平台创建了一些元数据，然后和海纳嗨数的一些默认的虚拟属性关联起来，在h5 或 小程序 端上报后就会拿到数据了，下面讲讲怎么自定义埋点：

一：准备后上面说的哪些初始化操作后，在你的业务代码里写如下代码：

// #ifdef H5
        let hina = window.hina;
        hn.track(
          '这里填写你的元数据',
          {
            字段1: 值,
            字段2: 值,
          },
        );
        // #endif
        // #ifdef MP-WEIXIN
        hn.track(
          '这里填写你的元数据',
          {
            字段1: 值,
            字段2: 值,
          },
        );
        // #endif

注意：这里的元数据你得在你的海纳嗨数管理平台来操作，没有的话就去新建一个吧，或者关联到已有的事件中。

如何查看上报的数据？

第一个可以先看本地打印的日志，开启showlog，在hina.init里面设置showlog为true即可，这样只要埋点触发了就可以检查参数是否正确；

第二个你得确保你的虚拟属性已设置为公用属性，如果状态是自定义属性则有可能数据上报了却无法查询出来，或者平台压根不会接受自定义属性值的上报。

======================== 2025-09-19 ========================

如果你在小程序端遇到了埋点不生效的问题，请查看控制台是否出现：

第一种情况：“初始化失败，传入的appid与当前小程序appid不一致”

第二种情况：“上报失败，请先完成初始化”

第一种情况一般都是你在海纳海数那里绑定的appid和现在开发用的appid不对导致，这一情况的出现可能会导致第二种情况的出现

如果真是appid不对的问题，这时候你就得把appid改正才能继续调试。

第三种情况：除了上面2种情况，如果上报的事件无法获取数据，那么我们不妨上报到另一个能获取到数据的已有事件，这样就可以比对一下，或许能有惊喜。

类似上面这些问题可参考官方文档https://himanual.haishuu.com/docs/hicloud/hicloud-1e10mg85s9391

但可恶的是uniapp小程序模块那里一个问题都没收录....