# 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.捐赠完成后，点击【申请开票】，即可开票

# 可捐赠哪些项目

• 杭州嘉互助学基金会《追光助学计划》

  • 连接小游戏开发者、社会爱心力量与受助学生，通过资金流向公开、学生成长反馈和项目执行跟踪，让每一份爱心清晰可见，提升公益助学的透明度与参与感，帮助更多青年顺利完成学业、追逐人生理想、成长为行业潜力人才。目前已与香港中文大学（深圳）、中山大学、深圳大学、陕西延安中学等学校开展合作，爱心捐赠可用于合作学校奖学金，奖学金评选方式可结合企业公益理念共同设计。
  

• 深圳壹基金公益基金会 《给孩子一堂科技课》

  • 号召社会关注并帮助欠发达地区的科技师生，为他们的科技学习和梦想，提供一个窗口。 自 2023年6月发起后，受到了全国中小学科技教师和科创教育名家的大力支持。目前，项目已在全国28个省、直辖市、自治区支持200所学校开展科技教育。
  

• 上海真爱梦想公益基金会 《支持孩子去远方看看》

  • 以儿童为中心，帮助孩子们学习研学出行的必备知识基本技能，通过小组合作，制定研学旅行方案，方案合格将获得实践资格。在远方用孩子的视角体验、学习、收获，认识我们的祖国、认识身边的人和事，更重要的是认识自己。
  

• 芭莎公益慈善基金会 《助力乡村儿童美育启蒙》

  • 主要为乡村小学送去优质美育资源。通过配备美育物资包、配套美育主题课程、培训乡村美育教师的方式，帮助乡村小学改善美育教育环境，让更多乡村儿童接受优质的美育教育内容，助力教育公平。
  

• 北京爱它动物保护公益基金会《流浪动物的回家之路》

  • 为社区流浪动物治理提出良性解决方案，共建人宠和谐家园。
  

• 深圳市一个地球自然基金会《共同守护濒危物种》

  • 针对不同濒危物种，其面临的实际威胁，结合实际情况，制定其适合的保护方案。通过开展物种保护、栖息地修复、巡护、社区生计帮扶、环境教育等工作，守护他们的栖息环境。
  

# 参加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.公益金互动接入示例代码

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

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

let wecarePageManager

async function loadWeCareGift() {
  // 低版本兼容逻辑：>= 3.7.6 版本基础库才支持
  if (!wx.createPageManager) {
    throw { errCode: -2, errInfo: '当前基础库版本暂不支持。' }
  }
  const pageManager = wx.createPageManager()
  const res = await pageManager.load({
    openlink:
      'X5TclDH7CWVKbF8uUysD_Qgj93ixPLYkuY57VTjGQ9797nwh9kT-rCy3fqSLsjW50BsiioV8OBPuXw4-vFG92Ge1PJHiXduZ5ilVE6rlURICbL35bMPxm68lGNhy1fK5',
  })

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

  wecarePageManager = pageManager
  return res
}

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

// 游戏场景 load 时
loadWeCareGift()
  .then(res => {
    // 加载成功，可以在合适的时机调用 showWeCareGift() 拉起半屏
  })
  .catch(err => {
    // 此处不可拉起公益金半屏界面；
    // 开发者如需细分各种原因请参阅下面判断
    if (err.errCode === -6) {
      // 因网络问题导致加载失败，开发者可以自行选择是否后面重试加载
    } else if (err.errCode === -3) {
      // 因当前设备不支持（如PC中无法访问）
    } else {
      // 其他错误可以统一按照无活动权限等处理
    }
  })

// 需要展示时
showWeCareGift()

# 3.API列表

打开WeCare公益金互动页面

• 相关API见createPageManager

• WeCare公益金互动页面openlink固定为：

'X5TclDH7CWVKbF8uUysD_Qgj93ixPLYkuY57VTjGQ9797nwh9kT-rCy3fqSLsjW50BsiioV8OBPuXw4-vFG92Ge1PJHiXduZ5ilVE6rlURICbL35bMPxm68lGNhy1fK5'

使用说明参考前面示例代码

# WeCare公益金互动完整交互

以下所有交互体验、页面均由平台侧统一维护和支持，开发者无需介入

# 1. 拉起WeCare弹窗过渡页

该页面由showWeCare()拉起（见前面示例代码），拉起的效果

• 升起四分之三屏，展示游戏名、福袋样式，点击“开启福袋”后跳转至下一页面

• 页面素材、文案、内容由平台统一控出，游戏侧无需操作

# 2. 查看受捐公益项目，并选择

• 可点击“黄色箭头”左右切换公益项目，点击瓶子会进入该公益项目的介绍详情页

• 点击“投入瓶子”按钮，即使用公益金成功，页面出现动效，进入下一页面领取微信状态

# 3. 查看状态详情，可分享或设置个人状态

• 展示状态大图，可点击分享WeCare公益计划给好友，或设置个人微信状态

# 4. 个人状态展示，并社交传播

• 设置成功个人“做好事”微信状态

• 好友可通过主页下拉查看状态，并点击跳转WeCare公益计划页，点击“领取公益金福袋”，拉起小游戏和WeCare弹窗过渡页（进入上文第1步）

# 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()

# 3.API列表

打开WeCare公益点赞页面

• 相关API见createPageManager

• WeCare公益点赞页面openlink固定为：

'wCIJpZM7N0rsMbYlKH03Z1uFI2G6Nr1nUhPqMc9lC4pqchc4G-s-zfU09baSzQWeztheB0DEF1KC8hbqI2ST31oGgGeJBipmVSO1trYCNmQ'

使用说明参考前面示例代码

# WeCare公益点赞完整交互

以下所有交互体验、页面均由平台侧统一维护和支持，开发者无需介入

# 1. 拉起WeCare弹窗过渡页

该页面由showWeCare()拉起（见前面示例代码），拉起的效果

• 升起四分之三屏，展示游戏名、游戏icon、公益项目名、社交点赞等信息，引导用户参与“做好事”点赞，点击后跳转至下一页面

• 页面素材、文案、内容由平台统一控出，游戏侧无需操作

# 2. 查看受捐公益项目，并点赞

• 点击“点赞助力”按钮，点赞成功，进入下一页面领取微信状态

• 点击项目大图，跳转查看项目进展详情

# 3. 点赞成功，领取“小红花”状态

• 小红花动效，展示开发者主体、游戏名信息，点击按钮领取微信状态

# 4. 查看状态详情，可分享或设置个人状态

• 展示状态大图，可点击分享WeCare公益计划给好友，或设置个人微信状态

# 5. 个人状态展示，并社交传播

• 设置成功个人“做好事”微信状态

• 好友可通过主页下拉查看状态，并点击跳转WeCare公益计划页，点击“领小红花状态”，拉起小游戏和WeCare弹窗过渡页（进入上文第1步）

# 捐款资金如何流转？

• 完成授权和捐款额度设置后，平台直接在对应小游戏的安卓内购分成后收益内划转捐出到受捐公益项目

• WeCare当前为开发者B端直捐（起捐额1万元/季度），非C端用户捐款

WeCare，期待你的加入！

# Q&A

1.参与WeCare公益捐赠是否影响广告激励金？

• 不影响

2.现在接入的项目都有什么？分别属于哪个基金会？（在MP平台可以看到项目细节信息、更多项目也在持续接入中

• 杭州嘉互助学基金会《追光助学计划》

• 深圳壹基金公益基金会 《给孩子一堂科技课》

• 上海真爱梦想公益基金会 《支持孩子去远方看看》

• 芭莎公益慈善基金会 《助力乡村儿童美育启蒙》

• 北京爱它动物保护公益基金会《流浪动物的回家之路》

• 深圳市一个地球自然基金会《共同守护濒危物种》