微信激励广告配置指南 ​

概述 ​

本指南说明如何在签名生成功能中配置和使用微信激励广告。

配置步骤 ​

1. 申请广告位 ​

1. 登录微信公众平台
2. 进入小程序后台
3. 选择"流量主" -> "广告位管理"
4. 创建新的激励视频广告位
5. 获取广告位ID（adUnitId）

2. 更新配置文件 ​

编辑 utils/ad-config.js 文件，将实际的广告位ID替换占位符：

export const REWARDED_VIDEO_AD_CONFIG = {
  // 签名生成页面的激励广告
  SIGNATURE_GENERATION: {
    adUnitId: 'adunit-xxxxxxxxxxxxxxxx', // 替换为实际的广告位ID
    name: '签名生成激励广告'
  }
}

3. 测试广告 ​

1. 在微信开发者工具中测试
2. 确保广告能正常加载和播放
3. 测试广告播放完成后的回调

功能流程 ​

用户操作流程 ​

1. 用户输入签名内容
2. 选择字体和颜色
3. 点击"生成签名"按钮
4. 系统检查广告是否可用
5. 如果广告可用，播放激励广告
6. 用户完整观看广告后，自动生成签名
7. 如果广告不可用，直接生成签名

广告播放逻辑 ​

// 检查广告是否可用
if (this.data.rewardedVideoAd && this.data.isAdLoaded) {
  // 显示广告
  this.data.rewardedVideoAd.show()
} else {
  // 直接生成签名
  this.generateSignatureDirectly()
}

广告回调处理 ​

// 广告关闭回调
rewardedVideoAd.onClose((res) => {
  if (res && res.isEnded) {
    // 正常播放结束，生成签名
    this.generateSignatureDirectly()
  } else {
    // 播放中途退出，提示用户
    wx.showToast({
      title: '需要完整观看广告才能生成签名',
      icon: 'none'
    })
  }
})

错误处理 ​

常见错误码 ​

• 1004: 广告位ID错误
• 1005: 广告位已关闭
• 1006: 广告位已满
• 1007: 广告位不存在
• 1008: 广告位审核中
• 1009: 广告位已禁用

错误处理策略 ​

1. 广告加载失败: 直接生成签名，不阻塞用户
2. 广告播放失败: 重新加载广告，再次失败则直接生成签名
3. 用户中途退出: 提示用户需要完整观看广告

开发环境测试 ​

测试模式 ​

在开发环境中，如果广告位ID未配置或环境不支持广告，系统会自动跳过广告播放：

if (!adUnitId || adUnitId === 'your-ad-unit-id-for-signature') {
  console.log('广告位ID未配置，直接生成签名')
  this.setData({ isAdLoaded: true })
  return
}

调试技巧 ​

1. 在控制台查看广告相关日志
2. 使用微信开发者工具的广告调试功能
3. 测试不同网络环境下的广告加载

注意事项 ​

用户体验 ​

1. 不阻塞用户: 广告加载失败时直接生成签名
2. 清晰提示: 按钮显示"观看广告获得签名"
3. 完整观看: 只有完整观看广告才能获得签名

合规要求 ​

1. 确保广告内容符合微信小程序规范
2. 不得强制用户观看广告
3. 提供跳过广告的选项（在开发环境中）

性能优化 ​

1. 预加载广告，减少用户等待时间
2. 合理处理广告加载失败的情况
3. 避免频繁创建和销毁广告实例

相关文件 ​

• pages/onesign/onesign.js - 签名页面逻辑
• pages/onesign/onesign.wxml - 签名页面结构
• pages/onesign/onesign.wxss - 签名页面样式
• utils/ad-config.js - 广告配置文件