跳到主要内容

Native

集成指南​

当前版本仅支持使用微信/抖音/mPaaS/支付宝官方提供的微信/抖音/mPaaS/支付宝开发者工具开发的小程序项目。

  • 微信小程序项目中集成，解压BonreeSDK_TDEM_MP_Wechat.zip，将bonreeSDK_MP_Wechat.min.js加入到项目中；
  • 抖音小程序项目中集成，解压BonreeSDK_TDEM_MP_ Tiktok.zip，将bonreeSDK_MP_Tiktok.min.js加入到项目中；
  • mPaaS小程序项目中集成，解压BonreeSDK_TDEM_MP_mPaaS.zip，将bonreeSDK_MP_mPaaS.min.js加入到项目中。
  • 支付宝小程序项目中集成，解压BonreeSDK_TDEM_MP_Alipay.zip，将bonreeSDK_MP_Alipay.min.js加入到项目中。

微信小程序项目中集成如图所示（其他平台项目同理）：

image

  • 使用公有云平台，需要在微信/抖音/mPaaS/支付宝小程序管理后台中的服务器域名内加入数据上报域名。示例为微信小程序管理后台添加公有云数据上报域名https://oneupload.bonree.com，私有化环境域名请根据实际部署情况进行配置，或联系技术支持获取。

image

接入​

  • 在app.js文件中引入探针文件：

    微信小程序中引入：

    const BonreeSDK = require('./bonreeSDK_MP_Wechat.min.js')

    抖音小程序中引入：

    const BonreeSDK = require('./bonreeSDK_MP_Tiktok.min.js')

    mPaaS小程序中引入：

    const BonreeSDK = require('./bonreeSDK_MP_mPaaS.min.js')

    支付宝小程序中引入：

    const BonreeSDK = require('./bonreeSDK_MP_Alipay.min.js')

  • 启动小程序探针，在传入的配置参数中设置Config地址与AppID：

<#Config地址#> 与 <#AppID#> 请于平台上获取，获取方式参见《如何查询AppID和Config地址？》。如有问题请联系技术支持。

const BRSAgent = BonreeSDK.start({
    configAddress: "<#Config地址#>",
    appId: "<#AppID#>"
})
  • 微信/抖音小程序导出SDK实例化对象，供其它文件使用：
module.exports = BRSAgent // 支持微信和抖音小程序

微信/抖音小程序示例如下：

// app.js
const BonreeSDK = require('./bonreeSDK_MP_Wechat.min.js')   // 微信小程序中引入
// const BonreeSDK = require('./bonreeSDK_MP_Tiktok.min.js')// 抖音小程序中引入

const BRSAgent = BonreeSDK.start({
    configAddress: '<#Config地址#>',
    appId: '<#AppID#>',
})
module.exports = BRSAgent

App({
    onLaunch() {

    },
    onShow(){
    
    },
    globalData: {}
})
  • mPaaS/支付宝因为沙箱限制了全局对象的访问权限，所以需要挂载SDK实例化对象到全局，供其它文件使用：
// app.js
App({
  onLaunch() {
    // 挂载到App全局对象上
    this.BRSAgent = BRSAgent;
  },
  onShow() {

  },
});

mPaaS/支付宝小程序示例如下：

// app.js
const BonreeSDK = require('./bonreeSDK_MP_mPaaS.min.js')     // mPaaS小程序中引入
// const BonreeSDK = require('./bonreeSDK_MP_Alipay.min.js') // 支付宝小程序中引入

const BRSAgent = BonreeSDK.start({
  configAddress: '<#Config地址#>',
  appId: '<#AppID#>',
})

App({
  onLaunch() {
    // 挂载到App全局对象上
    this.BRSAgent = BRSAgent;
  },
  onShow() {

  },
});

运行后在微信/抖音/mPaaS/支付宝开发者工具的调试器中查看Network，有config请求结果输出且响应中的rc字段为10000即标识嵌码成功。下图为微信开发者工具中的响应结果示例：

image

注意：建议您嵌码完成后，立即到平台安装部署/规则配置/数据采集/终端应用配置采集规则，避免平台数据和您预期不一致。