# 平台社交红包能力介绍

平台红包是微信小游戏推出的裂变拉新组件，通过简单配置即可上线，让游戏中的玩家主动邀请好友进入游戏，以更低的获客成本带来真实活跃的新用户或回流用户

**详细接入文档见：**[平台社交红包裂变能力](Introduction_config)

---

## 一、功能介绍

**核心机制**：开发者配置每个节点解锁需要的“价值” → 配置用户做对应行为产生的“价值”  → 用户完成行为（**邀请**/充值/看广告）→ 每完成1次行为获得价值，进度推进 → 进度达到对应节点的要求，解锁奖励

**请注意：**  发布后，游戏用户若满足平台条件（有明显的活跃游戏行为），将自动触发平台入口

若发布前游戏想内部测试全流程，不希望直接面向用户，可通过「mp-右下角-开发者小助手」联系客服，发送 2 次「社交红包加白转人工」即可，具体能力见文档 [特殊能力](https://docs.qq.com/doc/DQWVJSHZtVHBtYkhL)

---
## 二、玩法体验

![](https://res8.wxqcloud.qq.com.cn/wxdoc/0b04c400-a9bd-468f-ba73-52eca9a2e006.png)

### 3.1 进度结构

红包活动分 4 节点，用户初始从40%开始计算：

| 阶段   | 用户视角进度 | 开发者需配的奖励                        | 获得条件                |
| ------ | ---- | ------------------------------- | ----------------------- |
| 首奖   | 40%  | 红包（最低0.1元）+ 道具（固定） | **邀请1个新用户后解锁** |
| 节点一 | 60%  | 红包 或 道具（可选）        | 累积价值达到 V₁         |
| 节点二 | 80%  | 红包 或 道具（可选）        | 累积价值达到 V₁+V₂      |
| 最终节点   | 100% | 红包（固定）                    | 累积价值达到 V₁+V₂+V₃   |

V₁/V₂/V₃ 为开发者配置奖励时生成的价值，配置内容如下
![](https://res8.wxqcloud.qq.com.cn/wxdoc/a74283bc-07ed-4619-af3b-0d854e7ed92d.png)

**请注意：活动发布后无法修改，配置的道具礼包，建议从用户视角命名，比如「体力x15」，避免「红包活动礼包」、「首邀礼包」之类的表达**
![](https://res8.wxqcloud.qq.com.cn/wxdoc/1e213a7e-f902-4829-9397-2c06679e4b90.png)

用户行为产生的"价值"也可自由配置，如下图，活动生效过程中可修改，价值将换算为进度百分比根据其积累的价值进行提升

![](https://res8.wxqcloud.qq.com.cn/wxdoc/5ab2194a-3ab5-42ed-87c8-d7b2d7fd588c.png)

### 3.2 用户体验流程

**发起者侧**：

—— 登录5分钟且账号正常，游戏内将展示红包活动入口

**请注意，游戏内入口可能会被其他平台活动覆盖，建议游戏尽可能还是在游戏内加[自定义入口](custom_entry)，以提高覆盖率**

—— 点击进入红包主页，看到4个节点奖励和当前进度

—— 选择"邀请好友"，发送特殊消息卡片

—— 好友进入游戏后获得对应进度，到达节点后可领取奖励

**被邀请者侧**：

—— 在会话中看到好友分享的红包卡片

—— 点击进入游戏（转化为游戏用户）

**—— 若用户账号状态正常，且在该游戏没有正在进行中的红包，则可以拆红包，红包奖励为「初始阶段-首奖」配置的奖励（8%概率为红包，92%概率为道具）**

—— 拆开后，自动参与红包活动，变为邀请者，可继续邀请其他好友

—— 若希望自定义分享卡片，可在后台“邀请用户价值配置”进行上传，活动生效过程中也可修改，不上传平台会兜底展示

![](https://res8.wxqcloud.qq.com.cn/wxdoc/6dd21e43-48cf-443f-82ea-249847457151.png)

---

## 四、配置策略举例

不同游戏品类适合不同配置策略，以下为典型参考：

**目标**：配置**注册价值=1.0**（即邀请一个新用户进入游戏，可获得价值1.0的进度）
| 用户视角进度 | 奖励             | 里程碑价值（开发者配置）  |
| ------ | ---------------- | ---- |
| 初始进度40%    | 0.1元红包  | 无法修改，邀请新用户后自动解锁    |
| 60%    | 游戏道具      | V₁=2 |
| 80%    | 3元红包      | V₂=3 |
| 最终奖励100%   | 5元红包  | V₃=5 |

**行为模拟**：用户进度从 40% 开始计算，每个阶段是 20% 的进度

【1】邀请第1个注册用户（积累价值：0+1=1） → 1 ＞ 满足初始奖励“邀请新用户”的条件，可领取 0.1 元红包，但 1.0＜V1 → 进度=40%+(1/V1)×20%=50% 

【2】邀请第2人（积累价值=1+1=2＞V₁=2），此时第一个节点解锁，用户可领取奖励  →  进度=60%+(2-2)/2×20%=60% 

【3】邀请第3人（积累价值=3＜V1+V2=5），意味着还无法解锁第二个节点 → 进度=60%+(5-3)/3×20% = 73% 

以此类推....当用户邀请到第五个人时，进度到 80%，就能解锁 V2 节点，领取 3 元红包

——

**成本计算建议**：若不考虑道具成本，**单用户真实成本 = 现金成本/（邀请来的注册+回流用户数）**，你会发现该数值低于后台配置的实际数值

| 场景 |邀请人数&总成本             | 单人头成本  |
| ------ | ---------------- | ---- |
| 停在80%  | 邀请 5 人，邀请人领取现金：3.1 / 被邀请人领取现金：0.1x5x0.08=0.04 ，累计为 3.14     | 0.628 |
| 最终奖励100%   | 邀请 10 人，邀请人领取现金：8.1 / 被邀请人领取现金：0.1x10x0.08=0.08 ，累计为 8.18         | 0.818 |

开发者可自由调整配置参数，以此形成不同的用户体验，如「先易后难」、「最终大刺激」、「小金额快速买量」等，比如如果注册价值为 1.0，第一个节点价值可以配置为 1.1，这样用户就会发现差一点点就能解锁，更愿意进行邀请

## 五、如何查看效果
【1】数据看板：可在“发放数据”查看基本情况，领取价值与库存实时更新，邀请人数 ROI 等 T+1 更新

【2】下载用户参与明细：共 3 个表格，成功邀请其他用户参与的openid及对应邀请人数，被邀请的用户的openid，完成了充值或广告任务的用户的 openid

**❗️请注意**

**①红包金额不等于实际支出**：看板的红包金额为用户可领取的红包金额奖励（非实际领取金额），会存在部分用户没有领取，实际现金成本以账号余额为准

**②实际邀请数更高**：部分用户会有同时参与的上限，或机型系统不支持参与活动，这部分用户不会在看板展示，因此实际邀请用户数可能更多，具体可以用下方的方法【3】，游戏自行归因

**③其他口径**：回收流水只统计用户进入游戏后 90 天，且内购流水只统计官方支付方式，其余支付方式不统计，若游戏会统计更长的周期或有多种流水方式，最后 roi 可按需自行归因
![](https://res8.wxqcloud.qq.com.cn/wxdoc/f73867bc-12a9-46e8-b91d-fbce65bca59a.png)
【3】数据抓取：可以调用 [Object wx.getLaunchOptionsSync()](Object wx.getLaunchOptionsSync())或 [Object wx.getEnterOptionsSync()](/minigame/dev/api/base/app/life-cycle/wx.getEnterOptionsSync.md) 方法，在用户启动时，若其中 **JSON.parse（query）  或 JSON.parse(query.query)** 有wxgame_platform_act_template_id ：66，则代表用户是通过红包活动启动的用户

## 六、接入流程

**可先阅读  [红包常见问题](redbag_QA)**

【1】**在[「MP-侧边栏-运营功能管理-现金红包配置」](/minigame/introduction/commercialization/special-abilities/activity-cash.md)提前进行开通发现金能力**，确保游戏能发现金

【2】完成[礼包道具](/minigame/dev/guide/open-ability/game-gift)（MP-运营功能管理-基础配置-游戏礼包道具）与[红包](/minigame/introduction/commercialization/special-abilities/activity-cash.md)（MP-运营功能管理-基础配置-现金红包配置）的配置和发布，完成奖励配置，配置的内容选择「平台红包组件」

充值提现/配置红包需要开通 「资金操作权限」，权限开通路径： MP管理员，前往「管理-成员管理-项目成员-功能权限管理」添加 对应账号的 资金操作 权限

【3】前置工作完成后，在 「MP-侧边栏-游戏能力地图-游戏运营-平台红包组件」进入后，进行活动配置
![](https://res8.wxqcloud.qq.com.cn/wxdoc/df009de7-4dfa-4333-9182-a50f625054e3.png)
![](https://res8.wxqcloud.qq.com.cn/wxdoc/7976616c-965d-489f-80e4-0b554b0a4d8b.png)

【4】关键配置注意事项

① 活动会在配置的时间段内自动上下线，请确保**道具/红包奖励**的有效期能覆盖整个活动周期

**② 背景图格式要求**：414x364 最佳、png 格式、不大于500kb 最佳 

**③ 活动奖品库：**
把之前配置好的奖励添加到奖品库，请确保奖品有效期要能覆盖活动有效期
![](https://res8.wxqcloud.qq.com.cn/wxdoc/bf0df928-5b4c-44c3-b733-83eec1e8b02f.png)

**④ 奖励配置：将奖品库的奖品配置到对应的节点**

【1】首个节点，用户邀请任一用户，邀请者必得红包；被邀请者进入游戏后有较低概率得红包，否则得到道具礼包，因此建议首个节点的红包价值可以配较低的值

【2】一个奖品无法同时配置在多个奖励节点，如果你希望阶段奖励一和阶段奖励二的红包都是 0.3 元，则需要创建俩个不同的 0.3 元红包奖励进行配置
![](https://res8.wxqcloud.qq.com.cn/wxdoc/225e5715-03fe-4031-9019-2a064ca75b44.png)

⑤ **配置邀请任务奖励（必选）：根据邀请来的用户的属性不同，获得对应的价值**

*价值配置范围为[0.01,99]，默认数值仅供参考，开发者可根据实际情况自行调整。

- 注册用户（元/个）：参与活动的用户，每成功邀请一个注册用户，可以获得的进度价值折算。
- 回流用户（元/个）：参与活动的用户，每成功邀请一个回流用户（最近30天没玩过该游戏），可以获得的进度价值折算
- 活跃用户（元/个）：参与活动的用户，每成功邀请一个活跃用户（最近30天内玩过该游戏），可以获得的进度价值折算
![](https://res8.wxqcloud.qq.com.cn/wxdoc/9fd6fdd5-666e-4247-a5ff-fbb079858185.png)

⑥**配置自定义任务奖励（可选）：参与活动的用户完成看广告/充值，可获得的价值**

- 单用户该任务可获得的上限价值（元）：在活动期间内，活动参与者可通过该活动获得的最多价值折算，比如配置了看 1 次广告 0.01 元，上限为 0.05 元，则即便用户看了 8 次广告，也最多只能获得 0.05 元的价值
- 此处用户只要在游戏内看了广告都会计数，不需要通过活动看广告
![](https://res8.wxqcloud.qq.com.cn/wxdoc/50bdaddd-2c65-419d-a37f-398960448466.png)

⑦ 上线后，会自动在游戏内出现入口（需要用户登录且时长＞5 分钟，并且奖品有库存才可见），用户点击入口后，按照我们的配置项看到活动内容进行参与，**请注意，游戏内入口可能会被其他平台活动覆盖，建议游戏尽可能还是在游戏内加[自定义入口](custom_entry)，以提高覆盖率**