SDK code review

小盟广告 SDK 接口流程

在接入之前，请确认您已经完成企业认证，并已经创建了媒体和广告位。

一、准备工作

1. 下载 SDK 包。

2. 微信公众平台|小程序后台 - 设置 - 开发设置：添加 request 合法域名。

   1 2	https://engine.xmadx.net/ https://log.xmadx.net/

3. 微信公众平台|小程序后台 - 设置 - 开发设置：添加业务域名。

   1	https://engine.xmadx.net

4. 请保持微信公众平台登录状态，后边需要填入AppID

二、SDK 接入小程序

1. 引入 JS 文件：将解压后的xmadx_sdk.min.js、xmadx_MD5.js、xmadx_conf.js放入utils文件夹中，若没有utils请创建。
2. 引入 H5 容器：将解压后的xmadH5文件夹放入pages中，若没有pages请创建。
3. 引入广告组件：将解压后的xmAD文件放入components文件夹中，若没有components请创建。

目录结构：

三、基本配置

1. 配置xmadx_conf.js文件：app_key为您在小盟流量变现平台 - 广告管理 - 我的媒体 中的媒体 ID。
   
   AppID(小程序 ID)：在 微信公众平台|小程序后台 - 设置 - 开发设置 - 开发者 ID 中。
   AppSecret(小程序密钥)：在 微信公众平台|小程序后台 - 设置 - 开发设置 - 开发者 ID 中。
2. 根目录下app.js中引入aldApp:

   1	var App = require('./utils/xmadx_sdk.js').aldApp;

四、接入广告

假如您要接入的页面为/pages/index/index.wxml。

1. 在index.json中引入xm-ad组件：

1
2
3
4
5

{
  "usingComponents": {
    "xm-ad": "/components/xmAD/xmAD"
  }
}

2. 在index.js中引入 aldPage 和广告位ID xmadID：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

// 页面顶部引入
var Page = require("../../utils/xmadx_sdk.js").aldPage;
Page({
  data: {
    // 需在xmadID中配置广告位ID
    xmadID: ["填入广告位ID", "填入广告位ID", "填入广告位ID"],
    // 您的其它数据
    yourOtherData: {}
    // ...
  }
  // 您的其它方法
  onLoad: function (options) {
  }
  // ...
});

广告位ID：小盟流量变现平台 - 广告管理 - 我的广告位页面表格中广告ID。

3. 在index.wxml中引入广告：

1
2
3
4
5
6
7
8
9
10
11
12

<!-- banner广告 -->
<view class="xm_banner">
    <xm-ad class="xm_component" data-id="填入广告位ID" bindclick='appoIntView' bindclose='xmadClose' adData="{{adData}}"></xm-ad>
</view>
<!-- 插屏广告 -->
<view class="xm_insert">
    <xm-ad class="xm_component" data-id="填入广告位ID" bindclick='appoIntView' bindclose='xmadClose' adData="{{adData}}"></xm-ad>
</view>
<!-- 悬浮窗广告 -->
<view class="xm_fixed">
    <xm-ad class="xm_component" data-id="填入广告位ID" bindclick='appoIntView' bindclose='xmadClose' adData="{{adData}}"></xm-ad>
</view>

至此，接入完成。

1

优化 vue-cli（webpack）实现：npm run build 发布到线上环境，npm run test 发布到测试环境，而不是每次切换发布环境的时候去代码里改具体的地址。

记录常用git命令

记录我的 VSCode 配置。

神说，要有光。于是便有了光。
头说，你得分享点东西。于是便有了这篇文章。

注意：接口统一加platform 6.广告主 7媒体主

本文是我对中间件的收集整理及个人理解的记录。仅代表个人水平、个人理解。如有问题，师请雅正。