使用前提

该探针只适用于未使用小程序第三方插件的小程序原生框架和mpvue框架,目前不支持使用了小程序插件的项目

由于日志上报需要使用阿里云日志服务接口,需要在微信公众平台的小程序开发 > 开发设置 > 服务器域名中将prod.cn-hangzhou.log.aliyuncs.com添加到request合法域名

本地引入

请根据当前小程序使用的框架选择正确的集成方式

taro(1.x)框架集成

推荐开启在线配置,并在调整好配置参数后将探针下载到本地,由于taro框架与小程序原生框架和mpvue实现原理的不同,初始化探针需要将taro本身作为一项配置传入探针,下载到本地的探针需要再做一点调整.

每次在线修改过探针配置后,都需要更新小程序工程目录中的探针文件

import { __myWebLogTracker__ } from './utils/myWebLogTracker.min.wxmp.js'

// 可直接通过该实例调用探针接口方法
__myWebLogTracker__.report('自定义事件名称', {
  /* 自定义事件内容对象 */
});

__myWebLogTracker__.registUser({
  tenant_code: 'mysoft',
  user_account: 'zhangss',
  user_group: 'admin'
});

mpvue框架集成

推荐开启在线配置,并在调整好配置参数后将探针下载到本地,接入小程序工程目录并在mpvue主入口文件中导入已初始化的探针实例,可直接通过该实例调用探针接口方法

每次在线修改过探针配置后,都需要更新小程序工程目录中的探针文件

将小程序探针源码文件放在项目中,导入Taro框架

将Taro框架作为初始化参数 taro: Taro 传入探针

项目主入口,app.js导入探针初始化实例,确保在项目初始化时,初始化天眼探针

import { __myWebLogTracker__ } from './tracker/myWebLogTracker.min.js'

// 可直接通过该实例调用探针接口方法
__myWebLogTracker__.report('自定义事件名称', {
  /* 自定义事件内容对象 */
});

__myWebLogTracker__.registUser({
  tenant_code: 'mysoft',
  user_account: 'zhangss',
  user_group: 'admin'
});

原生框架集成

推荐开启在线配置,并在调整好配置参数后将探针下载到本地,在小程序主入口app.js中最顶端引入探针,无需手动初始化探针,探针在引入时自动初始化,并将实例myWebLogTracker挂在到global对象上

每次在线修改过探针配置后,都需要更新小程序工程目录中的探针文件

require('./utils/myWebLogTracker.min.wxmp.js');
/* 
  引入探针后 探针将根据在线配置自动初始化 并将实例挂载到global对象上
*/

// 在需要主动调用探针方法时
global.__myWebLogTracker__ && global.__myWebLogTracker__.report('自定义事件名称', {
  /* 自定义事件内容对象 */
});

global.__myWebLogTracker__ && global.__myWebLogTracker__.registUser({
  tenant_code: 'mysoft',
  user_account: 'zhangss',
  user_group: 'admin'
})

移动PaaS平台集成

通过移动PaaS构建的应用需要集成探针时,在应用构建 -> 链接管理 -> 数据收集URL,将应用专属的探针地址填写到数据收集URL一栏即可完成集成

注意,此处填写的探针地址为Web探针地址(如果只显示了小程序探针地址,应将后缀.min.wxmp.js改为.min.js)

results matching ""

    No results matching ""