幸运魔方（随机道具）接入指南

我的收藏

幸运魔方介绍

幸运魔方定义（又名：随机道具）：是一种趣味随机玩法，用户可以免费或支付1钻获得幸运魔方，使用后可随机获得玩法内效果（该效果对应价值可能大于或等于用户消费金额，但效果仅在玩法内一次性展现）；
幸运魔方目标：通过「降低参与/支付门槛」和「增加玩法趣味性」，可以增加玩法趣味性，强化用户互动，提升开发者经济收益。

「幸运魔方」是抖音直播玩法推出的趣味玩法，接入该能力后，满足圈选条件用户的摇杆面板将展示幸运魔方送出机会，仅需支付1钻，用户即可随机送出大于等于1钻礼物的效果，并且平台为了做深经营破冰力度，将加码投入，限时由平台出资承担成本向符合特定条件的用户额外下发免费送出幸运魔方机会。

接入幸运魔方具有如下优势：

✅开发量小：接入便捷，仅需0.5-1pd即可完成接入

✅效果显著：对付费破冰用户规模、付费率提升显著

✅平台出资：平台出资限时补贴中，早接入早享受

用户策略与路径

用户策略	分步骤路径
`平台出资策略` •下发人群：历史未付费的高潜破冰用户 •策略内容：符合圈选条件的用户，每日可免费无门槛获得幸运魔方1个，当满足看播>=60s后，可获得第2个免费幸运魔方 •下发频次：用户首次送出免费幸运魔方后，连续3日下发平台承担成本限时补贴ing，强烈建议接入❗️预期可显著提升付费破冰规模，长期带来ltv和gmv提升❗️❗️
`用户付费策略` •下发人群：【全量看播】 •策略内容：用户支付1钻，获得幸运魔方1个 •下发频次：每个玩法每日3次，第二日重置送出机会
备注：存在部分用户命中2个圈选策略，单日单玩法可送出5次幸运魔方

接入后效果

•目前已接入幸运魔方的玩法看播覆盖率可达平台一半以上，尽早接入幸运魔方，可以尽早享受平台预算，同时打平用户在其他玩法直播间体验，让用户享受到趣味玩法；
•从已接入幸运魔方玩法效果看，付费uv提升幅度普遍可达11%+，十分有利于玩法转化更多付费用户，并为长期提升LTV和流水收益打下用户基础；
•幸运魔方送出率可达43%+，显著高于其他礼物送出率，且人均送出次数持续高涨，用户对幸运魔方接受度高，尝新、喜爱、情绪浓厚。

研发接入指引

1. 能力配置

配置项	配置说明	示意图
直播间礼物互动能力配置	1.开发者可在直播玩法后台【能力】-【基础互动能力】中找到【直播间礼物互动能力配置】 2.点击「能力配置」，进入【直播间礼物互动能力配置】页面 a.找到礼物效果配置区域，操作开启「幸运魔方」开关，并保存

2. API接入

沿用获取礼物数据

幸运魔方加密对外的礼物ID：9tPFzcpEQFovisU3j3coz5tqj/qQ5LHJQJWob/X5bLbxm1s7kYLj0aGSb4k=

若开发者开启「幸运魔方」开关，且用户送出「幸运魔方」，则礼物数据推送中将增加sec_magic_gift_id字段，代表用户送出了幸运魔方礼物，sec_gift_id为幸运魔方随机到的礼物，请结合「sec_gift_id」和「gift_num」输出对应礼物效果

开发者请务必校验礼物数据中test字段，如果 test字段为 true ，代表推送的是测试数据，应在数据统计场景进行过滤（如榜单场景），否则存在数据统计异常的风险，需自行担责。

测试数据生产来源说明：1）开放平台控制台的自查工具模拟发送的测试数据；2）版本发布时，因平台审核玩法交互表现等，模拟发送的测试数据；

[ 
  {
    msg_id: "123456782", // string类型id
    sec_openid: "xxxx", // 用户的加密openid，当前其实没有加密
    sec_gift_id: "xxxx", // 加密的礼物id
    gift_num: 123, // 送出的礼物数量
    gift_value: 10000, // 礼物总价值，单位分
    avatar_url: "xxx", // 用户头像
    nickname: "xxxx", // 用户昵称(不加密)
    timestamp: 1649068964, // 礼物毫秒级时间戳
    test: true, // 如果是抖音平台的测试数据，则会下发该字段且值为 true。测试工具下发的送礼数据属于调试模式，不会有该字段
    audience_sec_open_id:"xxx", // 被送礼的嘉宾openid，当前没有加密
    sec_magic_gift_id: "xxx", // 加密的幸运魔方礼物id（有该字段，代表的是由幸运魔方抽取到的礼物。sec_gift_id是幸运魔方抽取到的礼物）
  },
];

3. 能力测试

测试项	配置说明	示意图
openAPI自测	1.进入【开发】-【自查工具】-【openAPI自测工具】 2.编辑礼物数据 a.礼物名称下拉菜单选择「幸运魔方」，数量1，点击保存 b.则平台将推送「幸运魔方」数据至测试数据推送域名
直播间测试	1.使用真实的抖音账号添加调试成员 2.通过伴侣挂载本地包体，调试成员可在直播间查看小摇杆内的「幸运魔方」按钮	/

Q&A

为什么开启开关之后，在调试环境看不到幸运魔方礼物？

当前未打开用户侧开关，用户侧暂时无法看到幸运魔方礼物，对前期进行接入的厂商，会将厂商侧已配置的调试成员加入可见名单，若仍出现看不见幸运魔方礼物的问题，可告知运营，提报抖音号名单。

礼物流水数据如何统计？

通过sec_magic_gift_id字段判断用户是否送出幸运魔方，若送出则流水记为1钻。

厂商如何分成？

幸运魔方单个价值1钻，主播、厂商也将按照1钻进行正常的分成结算。

随机概率规则及控制方式？

目前会按礼物单价金额映射对应玩法效果，分为“高价值组”、“中价值组”、“低价值组”3档，并分别按单礼物区间给予概率，概率根据效果价值增高而降低。每日单玩法内，平台会控制“高价值组”效果可随机到总数量上限，以避免对厂商的玩法影响。

厂商画布内该如何展示效果？

平台玩家送礼气泡信息会显示为“送出幸运魔方X1”，主播感知收到1钻礼物。厂商可自行选择用默认随机到的效果展示，或自行优化补充展示信息（注意需符合提审要求）。