# WeCare公益计划接入指引

# 什么是WeCare公益计划

2024年7月16日，微信小游戏宣布联手开发者和腾讯公益打造 WeCare公益计划，该计划将成为微信小游戏未来长期建设的公益品牌。平台将持续通过产品公益能力、公益项目发起与参与、公益反馈、开发者公益激励等多种方式，针对科技、教育、文化等方向，鼓励并与小游戏开发者携手公益向善，创造更多社会价值。
小游戏开发者可以通过MP后台，线上签约参加WeCare公益计划，按季度设置捐赠额度，平台将对应额度的游戏收益，划转捐赠到公益项目。同时平台提供捐赠报告、专属标识、进展反馈、用户口碑曝光等系列权益。

# 如何参加WeCare公益计划

企业主体开发者在【mp.weixin.qq.com-游戏能力地图-运营能力-特色能力-WeCare公益计划】查看、同意相关协议后，设置当季度捐赠额度，并点击“去确认”即可，IAP、IAAP游戏确认后约1～3天完成捐出，IAA游戏确认后约20天完成捐出，获得证书

# 捐赠步骤示意

1.在游戏能力地图找到WeCare公益计划入口

2.点击签约按钮，完成【线上签约】

3.点击捐赠按钮，完成【公益捐助金额设置】

4.点击【去确认】，完成捐赠确认，即进入资金捐出流程

5.捐赠完成后，点击【申请开票】，即可开票

# 参加WeCare公益计划，有什么权益

# C端权益，传播用户口碑

公益标识：在搜索、游戏内、游戏中心等微信内主要场景展示“做好事”专属标识；小游戏介绍页的标识用户点击可进入WeCare官网，查看参与的开发者及项目进展等
做好事分类：参与WeCare的小游戏可进入游戏中心【做好事】分类

用户口碑感知：WeCare官网换游戏卡片、小游戏菜单页入口、公众号

捐赠证书：开发者捐赠完成后可在MP后台生成捐赠证书，捐赠证书共有三种：

1. 捐赠证明：资金在流转中、未捐赠至公益项目时，为捐赠证明（主要为IAA）；

2. 捐赠证书：资金实际捐出后，生成捐赠证书（可选择隐藏捐赠金额/不隐藏）；

3. 历史捐赠总结：可查看历史捐赠总结（可选择隐藏捐赠金额/不隐藏）;

企业社会责任报告：可在捐赠证书中一并查看企业社会责任报告（左下角二维码）

线上开票：授权并捐赠后，可在MP点击【申请开票】，由受捐项目提供捐赠发票等（公益报告抬头为小游戏注册主体，发票抬头可自由提供；预计2周内会完成发票的开具，并将发票发送至邮箱。请开发者留意新邮件，如未收到，可再反馈）

公益进展：捐赠落地情况、受捐师生反馈视频等，WeCare项目专属群同步
其他权益：你的小游戏活跃用户可以为你的善意点赞，获得“做好事”微信状态，并社交传播，带动好友进入游戏获得状态（详情操作方法如下）

# WeCare点赞互动能力接入步骤示意

# 1.策划游戏内入口

策划公益弹窗拉起时机和相应入口（例如活动面板常驻、完成广告/支付/分享、达成xx等级/成就、在线xx时长等、排行榜已设置公益状态的好友头像框等）。入口覆盖手机端即可，点赞组件暂不支持pc端；

设计中如需使用腾讯公益“小红花”素材，参照素材及使用规范地址：https://designforgood.qq.com/#/brand/flower
头像框设计可参考样式：

# 2.公益点赞接入示例代码

注意：入口的调用时机，需在用户点击直接操作入口时调用

建议的逻辑：比如A游戏有一个WeCare的活动入口，点击这个活动入口才会调用loadWeCare此时存在额度的时候正常拉起半屏；若用户当天额度用完，给文案提示，类似「今日额度已用完，请明天再来」

/**
 *  公益活动参考代码
 *    核心由 pageManager实例 + openlink值 决定活动，开发者可根据下方代码自行适配
 */

let wecarePageManager

async function loadWeCare() {
  // 低版本兼容逻辑：>= 3.7.6 版本基础库才支持，此处直接使用if判断
  if (!wx.createPageManager) {
    throw { errCode: -2, errInfo: '当前基础库版本暂不支持。' }
  }
  const pageManager = wx.createPageManager()
  const res = await pageManager.load({
    openlink:
'wCIJpZM7N0rsMbYlKH03Z1uFI2G6Nr1nUhPqMc9lC4pqchc4G-s-zfU09baSzQWeztheB0DEF1KC8hbqI2ST31oGgGeJBipmVSO1trYCNmQ',
  })

  // 监听半屏关闭事件
  pageManager.on('onClose', () => {
    // 当公益半屏关闭时
    // your codes...
  })

  wecarePageManager = pageManager
  return res
}

/**
 *  拉起半屏，成功代表成功拉起
 */
async function showWeCare() {
  if (!wecarePageManager) {
    await loadWeCare()
  }
  return await wecarePageManager.show()
}

// 游戏场景load时
loadWeCare()
  .then(res => {
    // res.user_status 提供用户今日点赞状态 1: 未点赞； 3: 已点赞（可用于再次提供入口前往设置小红花状态）
  })
  .catch(err => {
    // 此处不可拉起Wecare公益半屏界面；
    // 开发者如需细分各种原因请参阅下面判断
    if (err.errCode === -4 && err.errInfo.errcode === -1) {
      // 因无额度导致失败
    } else if (err.errCode === -6) {
      // 因网络问题导致加载失败 开发者可以自行选择是否后面重试加载
    } else if (err.errCode === -3) {
      // 因当前设备不支持（如PC中无法访问）
    } else {
      // 其他错误可以统一按照无活动权限等处理
    }
  })

// 需要展示时
showWeCare()