小程序广告变现与商业闭环

<!-- banner：页面内固定位置 -->
<ad
  unit-id="adunit-xxxxxxxxxxxx"
  ad-type="banner"
  ad-theme="white"
  binderror="onAdError"
  bindload="onAdLoad"
/>

<!-- 视频广告：ad-intervals 为轮播间隔秒数，取值 30 到 120 -->
<ad
  unit-id="adunit-yyyyyyyyyyyy"
  ad-type="video"
  ad-intervals="60"
  binderror="onAdError"
/>

<!-- 格子广告：grid-count 控制格子数量 -->
<ad
  unit-id="adunit-zzzzzzzzzzzz"
  ad-type="grid"
  grid-count="5"
  grid-opacity="0.9"
/>

// utils/rewarded-ad.js
let adInstance = null;

function getAd(adUnitId) {
  // 同一 adUnitId 复用实例，重复创建会报错
  if (adInstance) return adInstance;
  if (!wx.createRewardedVideoAd) return null;
  adInstance = wx.createRewardedVideoAd({ adUnitId });
  adInstance.onError((err) => {
    console.error('激励视频错误', err.errCode, err.errMsg);
  });
  return adInstance;
}

function showRewardedAd(adUnitId) {
  const ad = getAd(adUnitId);
  if (!ad) return Promise.reject(new Error('当前基础库不支持激励视频'));

  return new Promise((resolve, reject) => {
    const onClose = (res) => {
      ad.offClose(onClose);
      // isEnded 为 true 表示完整观看，此时才能发放奖励
      resolve({ rewarded: !!(res && res.isEnded) });
    };
    ad.onClose(onClose);

    ad.show().catch(() => {
      // 首次加载失败时先 load 再重试一次
      ad.load()
        .then(() => ad.show())
        .catch((err) => {
          ad.offClose(onClose);
          reject(err);
        });
    });
  });
}

const SHOW_LIMIT = 5;
const KEY = 'rewarded_count';

function canShow() {
  const today = new Date().toDateString();
  const cache = wx.getStorageSync(KEY) || {};
  if (cache.date !== today) return true;
  return cache.count < SHOW_LIMIT;
}

function markShown() {
  const today = new Date().toDateString();
  const cache = wx.getStorageSync(KEY) || {};
  const count = cache.date === today ? cache.count + 1 : 1;
  wx.setStorageSync(KEY, { date: today, count });
}

let interstitial = null;

function showInterstitial(adUnitId) {
  // 同一 adUnitId 在页面生命周期内只创建一次实例
  if (!interstitial) {
    interstitial = wx.createInterstitialAd({ adUnitId });
    interstitial.onError((err) => console.warn('插屏广告错误', err));
  }
  interstitial.show().catch(() => {
    // 未加载成功时静默忽略，不阻塞业务流程
  });
}

// 按用户维度稳定分组，避免同一用户频繁切换策略
function getAdGroup(openid) {
  const hash = [...openid].reduce((acc, ch) => acc + ch.charCodeAt(0), 0);
  return hash % 100 < 50 ? 'A' : 'B';   // A 组对照组，B 组实验组
}

// 跳转到合作小程序并携带归因参数
function jumpToPartner(item, extra) {
  wx.navigateToMiniProgram({
    appId: item.appId,
    path: item.path,
    extraData: {
      // 归因信息会透传给目标小程序
      source: 'plumephp',
      uid: extra.uid,
      channel: extra.channel
    },
    envVersion: 'release',
    fail: () => wx.showToast({ title: '跳转失败', icon: 'none' })
  });
}

function canUseVirtualPay() {
  const { platform } = wx.getDeviceInfo();
  // 虚拟支付仅在 Android 且已开通权限时可用
  return platform === 'android' && hasVirtualPayPermission();
}

function renderPayEntry() {
  if (canUseVirtualPay()) {
    this.setData({ payType: 'virtual' });
  } else {
    // iOS 上隐藏支付入口，仅保留会员权益说明
    this.setData({ payType: 'none' });
  }
}

function trackAd(event, payload) {
  wx.reportEvent('ad_event', {
    event,                       // show / click / close / error
    adUnitId: payload.adUnitId,
    position: payload.position,
    errCode: payload.errCode || 0,
    ts: Date.now()
  });
}