标准版小程序SDK接入指南—广告主

一、配置域名

在微信公众平台开发设置中,添加request合法域名

https://log.xmadx.net/

二、接入sdk

(一)引入文件

小盟广告,广告主接入SDK,广告主在小程序内引入dsp_sdk.js和dsp_sdk_config,步骤如下:

(1)将下载的dsp_sdk.js和dsp_sdk_config.js拷贝到小程序项目的 utils文件夹中。

(2)在dsp_sdk_config.js 文件,填写在广告主后台申请的 app_key并配置plugin

//dsp_sdk_config.js
exports.app_key = "xmf71ad2fce1d45711c9e6689f2a808c";//此处请填广告主从小盟广告-广告主DSP后台-推广标的物获取的appkey
exports.plugin = false //您的小程序中是否使用了插件。根据是否启用插件会有不同的接入方式,默认为false,表示没有启用插件
exports.getOpenid = true //是否授权小盟来获取您的openid

注:app_key在广告主后台(http://dsp.xmadx.com/)

具体位置为广告主后台-工具—推广标的物里面获取,具体位置如下图:

(3)在app.js中,顶部引入dsp_sdk.js文件。

//app.js
var xmad = require('./utils/dsp_sdk.js')

(4)关于引入了阿拉丁的其它sdk服务

如果引入了阿拉丁的其它sdk服务。例如,统计、小盟广告、小神推等,则在app.js中引入顺序如下:

(二)获取openid

不上传openid会导致没有有效的数据上报。另一方面,小盟平台检测到SDK没有上传openid会将相应的计划停止,以免造成严重的数据准确性问题。

1)授权小盟获取用户openid,此时不需要做任何代码上的处理。强烈推荐!

//dsp_sdk_config.js
exports.getOpenid = "true"; //是否授权小盟来获取用户的openid;默认为true,开启状态,改为false为手动上报。

2)手动向小盟上报用户openid,调用wx.dsp.setOpenid(openId)方法向小盟上报用户openId。请务必在和后端置换回openid后进行上报 参考下列代码示例。

require('./utils/xmadx_sdk.js')
App({
  onShow(){
    wx.login({
      success(res){

        // 需要从服务端获取用户openId
        wx.request({
          url: 'https://blog.superwang.cn/getOpenId', //后端接口地址
          method: "post",
          data: {
            jscode : res.code
          },
          success(res){
            // 上传openId
            wx.dsp.setOpenid(res.data.data.openid)
          }
        })
      }
    })
  }
});

三、接入验证

程序开启三秒内,有health和app上报,即为sdk成功引入。

sdk引入成功后请到小盟广告主后台进行接入成功检测

results matching ""

    No results matching ""