# 社交玩法激励包

# 介绍

针对接入社交玩法的游戏，平台提供 用户运营激励，助力游戏内容联动 及 用户活跃召回。

用户运营激励包，下发规则参考社区活动规则。

• 社交玩法激励活动——第 2 期 2026 年 7 月
• 社交玩法激励活动——第 1 期 2026 年 2 月

# 接入指引

# 1. 查看 & 使用激励

位置：运营功能管理 - 基础配置 - 社交玩法激励包

# 2. 配置激励资源包

点击「新建奖励」，配置 选择 使用场景「自定义接口」或 「擂台赛组件」及规模。不同的激励包，可用场景范围不同。

• 总数量：配置的总上限，可修改
• 已发放数据：实时的已发放数量

# 3. 擂台赛场景配置使用

• 接入擂台赛组件（接入文档），最低版本要求：从基础库 3.16.1 开始支持
• 完成玩法配置，位置：MP-运营功能管理-基础配置-游戏玩法 ID 设置
• 完成擂台赛配置，位置：MP-能力地图-擂台赛组件
  • 完成基础配置
  • 关联奖励库。添加「社交玩法激励」至 活动奖励库中

• 将 激励包 配置进 擂主/挑战者 相应奖励位置处。必得奖励建议配置游戏道具。

• 完成擂台赛整体测试发布流程

# 4. 自定义接口使用

游戏内自定义的社交玩法，通过接口发放平台激励。（需 MP 配置奖励后，再调用接口）

# 接口说明

# 1、PreSendCheck

发放前预校验接口，用于在实际发放前判断是否建议向用户发放平台激励，不触发实际发放。

# 请求方法

POST

# 请求路径

https://api.weixin.qq.com/wxa/game/reward/pre_send_check?access_token=ACCESS_TOKEN

# 请求参数 - Query

# 请求参数 - Body

# 响应参数

# send_suggest_level 说明

# 错误码说明

# 2、CreateRewardSendOrder

创建奖励发放订单接口

# 请求方法

POST

# 请求路径

https://api.weixin.qq.com/wxa/game/reward/create_reward_send_order?access_token=ACCESS_TOKEN

# 请求参数 - Query

# 请求参数 - Body

# 响应参数

# 错误码说明

# 3、PageManager

使用 pageManager 打开对应 openlink，在 query 中传入调用发奖接口获取的 orderId，调用通用领奖组件执行后续操作。监听组件抛出的事件，做出对应响应。

社交用户运营激励，openlink 为固定值：1U0tLZIkbBQ1I6TYL_EMir3pqeAk8UYTlfESyNbSwQI0sBiOZl96AuLqCu8a5SCSzB1IJ_e85-XYQ7w30Mt78A

# 代码示例

const pageManager = wx.createPageManager();
const getRewardLoadReq = {
  openlink: "1U0tLZIkbBQ1I6TYL_EMir3pqeAk8UYTlfESyNbSwQI0sBiOZl96AuLqCu8a5SCSzB1IJ_e85-XYQ7w30Mt78A",
  query: {
    orderId: 'xxxxxxxxxxxx'
  }
};
pageManager.load(getRewardLoadReq).then((res) => {
  // 加载成功调用显示
  pageManager.show();

  // 监听事件，根据 res 响应
  pageManager.on('rewardInfoUpdated', (res) => {
    console.log('rewardInfoUpdated:', res);
  });
});

# 字段说明

# 事件监听

# rewardInfoUpdated，奖励信息更新

# currentStepUpdated，当前阶段更新

# 类型枚举

# 奖励类型

# 2.4. 当前阶段