微信小程序探针集成

本文介绍在小程序应用里集成天眼小程序探针的操作过程。

小程序使用的框架不同,集成方式存在差异,请根据小程序使用的框架选择正确的集成方式。

前提条件

  • 该探针只适用于未使用小程序第三方插件的小程序原生框架和mpvue框架,目前不支持使用了小程序插件的项目
  • 由于日志上报需要使用阿里云日志服务接口,需要在微信公众平台的小程序开发 > 开发设置 > 服务器域名中将prod.cn-hangzhou.log.aliyuncs.com添加到request合法域名

taro(1.x|2.x|3.x)框架集成

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

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

const Taro = require('@tarojs/taro');
global.__myWebLogTracker__ = global.myWebLogTracker.default({taro: Taro,"ignore_pages": [], "user_account_query": {"key": "", "range": ["url", "localstorage", "cookie"]}, "user_group_query": {"key": "", "range": ["url", "localstorage", "cookie"]}, "collect_event_types": ["event", "page", "api", "click", "error", "crash", "user-defined"], "is_spa": true, "replay": {"error": 0}, "log_event_attribute": "data-event", "product_code": "fast-test", "report_logs_threshold": {"WeChat Mini Program": 20}, "page_interval": 1800000, "app_code": "xxx", "manual_report_page_load": false, "api_url_regx": "", "log_module_attribute": "data-module", "report_api_params": false, "log_content_attribute": "data-log", "trace_config": null, "tenant_code_query": {"key": "", "range": ["url", "localstorage", "cookie"]}, "include_search": true, "env_code": "prod", "api_ignore_urls": []});Object.defineProperty(wx.__proto__, '__myWebLogTracker__', {
                value: global.__myWebLogTracker__,
                writable: false
              });
exports.__myWebLogTracker__ =   global.__myWebLogTracker__;

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

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

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

---
#### <span id="mpvue-way">mpvue框架集成</span>

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

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

![](https://note.youdao.com/yws/public/resource/9581d88aacf5982b9f5fbfb206cd216a/xmlnote/644D5668C040497488C17BFAEA919DF7/12721)

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

![](https://note.youdao.com/yws/public/resource/9581d88aacf5982b9f5fbfb206cd216a/xmlnote/994A2931AA7E4B3C874B8FF40ABBA0F2/12729)

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

![](https://note.youdao.com/yws/public/resource/9581d88aacf5982b9f5fbfb206cd216a/xmlnote/D8A5D655130F4AD887FBB79FC7D30124/12739)

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


````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 ""