一、功能介绍

1）产品概述

淘宝平台为游戏开发者提供购物红包营销能力支持。开发者可自主出资采购平台购物红包权益，发放给游戏玩家（淘宝消费者），提升游戏内活动的用户参与度与转化效果。

核心优势如下：

• 用户心智明确：购物红包为淘宝用户高频认知的权益形态，使用路径清晰，感知价值强。
• 效果可预期：对比虚拟道具/实物权益，红包可直接抵扣现金，转化效率更具竞争力。

使用须知：

• 采购入口：开发者需通过商家权益营销平台完成红包采买。
• 当前支持类型：仅限购物红包，其他平台权益暂未开放接入，请勿下单采买。

适用场景

1. 提升用户活跃

• 场景示例：登录签到、任务成就、赛季奖励等
• 效果价值：通过红包激励提升玩家次日留存率、周活跃频次等核心指标。

2. 促进付费转化

• 场景示例：首充礼包、高价值道具捆绑、付费任务返利等
• 效果价值：降低付费决策门槛，促进付费转化。

3. 用户增长裂变

• 场景示例：邀请好友助力、排行榜竞赛、社交分享奖励等
• 效果价值：通过红包吸引玩家主动传播，扩大游戏用户池。

二、红包采买链路

1）操作入口

所有采买红包的操作皆在商家权益营销平台，地址：https://ibenefit.taobao.com/#/

厂商进行红包采买的负责人请注意，需要登陆已绑定支付宝的淘宝账号，否则无法进行采买。

操作入口：权益奖品->展开子菜单，找到淘宝小游戏红包采买，点击进入。

3）新建商家红包

点击新建按钮，进入新建商家红包的表单。此处页面如下，具体填写规则见下文。

业务类型：请选择要发放红包的小游戏名称（以控制台处游戏名为准）。如此处无对应小游戏可选，请提交游戏名称+appKey给运营 @卿识，进行配置。不要选其他游戏名，如因此无法发放，后果自负。

模版名称：本次发放活动名，游戏方可理解即可，无硬性要求。

红包类型：目前只支持采买固定面额红包，采买总费用=红包面额x数量。如游戏内需要发放多种面额的红包，可分多次进行采买，每次采买不同面额的红包。

领取时间：用户领取红包的有效期，超过该期限则无法领取该模版对应的红包权益。建议领取时间大于活动时间，否则可能有完成活动但错过领取的舆情。

使用时间：用户领取到红包后的使用有效期，超过该有效期则无法核销使用。可根据厂商需求，自行规定 固定时间/相对时间/相对自然日时间。建议使用时间设置合理，不要过短。

单用户总限领：可选。设置限领数后，则规定单用户领取该红包模版下权益总数量不能超过该限制。

单用户周期限领：可选。设置周期限领数后，则规定单用户每一段时间周期内，可领取该红包模版下权益数量。

注意：模版一旦建立后，不支持修改领取、使用有效期，请谨慎填写模版信息。如果有修改需求，建议新建红包模版，重新填写。

4）进行支付

确认提交上一步的表单后，平台会根据红包面额及发放总量自动计算红包发放所需的保证金总额，点击“确定”后跳转到支付宝页面进行支付。如该淘宝账号没有绑定支付宝，则会在这一步跳转失败。

完成支付后，则采买成功，可进行技术接入，请参考第三章节。

如需查看支付成功的权益，需要选择对应的游戏名，才能查看游戏下的权益。

5）追加模版

如模版内红包提前库存告紧，游戏方无需新建红包权益，而是可以通过追加预算到现有模版，对权益进行补充，模版的信息不会因此改动。支持对固定面额红包进行数量追加。确认追加后会自动计算总金额，跳转支付宝进行支付。

6）失效红包模版

如果希望提前结束权益的线上投放，则可以选择失效该红包权益。失效后，已经投放出去的权益不会受到影响，失效的权益无法恢复投放和发放。

权益失效后，红包资金池里的钱不会被撤回，依然要等到活动结束后才会返回到充值帐户。

三、技术接入

技术接入请参考以下接口文档内容。在使用接口前，请前往控制台申请【权益营销平台-通用开放】的权限。确保获得权限后，再调用接口。

1）发奖查询安全接口

rewardDistributionCheck

适用场景

该方法用于在用户领取游戏内奖励前，实时评估该账号在淘宝平台是否有过非安全历史行为。开发者可根据返回的安全状态动态调整奖励发放策略，减少资损风险。

注意事项

1）针对非安全用户，只能适量降低奖励数量避免资损，不能完全不发放奖励。

2）禁止在前端透出“风险用户/非安全用户”等敏感提示，奖励差异需通过玩法设计自然过渡。如安全用户非安全用户的奖励不同，则前台奖励的表达上需要兼顾，如“最高xx奖励”。

3）出现接口超时等情况时，安全结果可能缺省（未知）。用户安全状态未知时，游戏侧可自行根据奖励成本、用户体验进行决策。若奖励成本较高，建议将未知用户视为非安全用户，发放兜底奖励；若活动以用户体验为重，建议将未知用户视为安全用户，发放正常奖励。

2）查询红包库存接口

alibaba.lafite.seller.benefit.list

适用场景

在给用户展示红包活动前，通过查询接口，查看账号下有哪些权益、及对应的权益面额、库存数量等信息，可根据这些信息决定是否要给用户透出红包活动、透出面额多大的红包。

一个小游戏下若有多个权益，可以通过投放接口查看不同红包权益的benefit_code，用于后续发放时区分具体发放哪一个红包权益。

参数说明

source必填，为：tb_interact_game_isv

注意事项

使用该接口必须由采买权益的商家账号进行授权，具体授权流程参考用户授权介绍。此处与游戏用户授权无关。

3）红包发放接口

alibaba.latour.strategy.issue

适用场景

用户完成游戏内任务或达成成就时，通过调用红包发放接口，进行发放。如果小游戏下有多个权益，可以通过benefit_code进行区分，benefit_code可通过查询库存接口获得。

参数说明

• strategy_code：每个游戏的投放计划code不同，请请联系运营同学，获取自己游戏的投放计划code。
• channel：入参固定，不会因游戏不同而变化，为：lafite_mt_common_isv_draw

4）查询发放记录接口

alibaba.latour.winrecord.query

适用场景

不建议使用，如需使用，请联系对应运营单独添加权限。

如游戏有较复杂的限中逻辑，可通过查询该用户是否已领取过红包自行实现逻辑。但建议优先使用模版中的限中功能进行实现。

参数说明

• strategy_code：每个游戏的投放计划code不同，请请联系运营同学，获取自己游戏的投放计划code。
• channel：入参固定，不会因游戏不同而变化，为：lafite_mt_common_isv_draw

四、测试验收

平台将提供红包活动的测试报告规范，游戏侧需要按照规范对必选项进行验收，并提交测试报告。测试报告中需要提交活动玩法的产品文档、基础交互，平台运营会一同评估玩法是否存在资损漏洞。报告中包含必做项与建议项，必做项为保障红包活动的基础能力及防刷的基本预案措施。

?三方游戏厂商采买拉菲红包验收标准.docx

五、数据查询

1）操作路径

如果需要查看红包权益的发放、核销数据，点击权益右侧的详情，即能看到该权益对应的权益详情、中奖记录、发放数据。

2）数据看板

权益详情将会展示该红包对应的发放规则、发放时间、发放数量/总数量等信息。

在中奖记录中，可以查看具体的红包领取记录。通过用户OpenId+AppKey，即可查询具体某一个用户是否领取该红包权益、领取的权益面额、领取时间等。

在发放数据中，可以看到领取、核销等统计值。具体字段参考面板下的字段说明。

五、退款操作

未使用、未发放的红包将会自动退款到您的支付宝账号上，红包退款分多个阶段：

阶段一：发放有效期结束。

红包发放有效期结束后（或者用户主动点击退款后），没有发放的红包会在结束后即可返回到您的账户（可能有天级延迟，为系统正常延时）。

阶段二：使用有效期结束。

红包使用有效期结束后，没有使用的红包会陆续在有效期结束后即刻返回到您的账户（可能有天级延迟，为系统正常延时）。

六、常见问题

1. 为什么红包支付失败？

A：此页面为支付宝充值报错，请完成以下检查：

第一步：是否超时--在创建红包模版后，必须要在72小时内完成支付哦！过期后就不能够再进行支付了，请重新创建红包模版。

第二步：是否换绑店铺支付宝账号--由于商家换绑店铺支付宝账号，或者在支付页面更改支付宝登陆账号，导致创建模版用的支付宝账号和付款用的支付宝账号不匹配，此报错仅表示充值失败，不会触发扣款；建议重新创建一个模版，在不切换支付宝账号的情况下充值

2. 平台是否支持开票？

暂不支持开发票或收据。可查看支付宝账号下的账单进行对账。