文档中心 | 一键联接，全心服务

更新日期：2025年 04月 15日QuickSDK开放平台接入文档

<h3> 一、准备工作 </h3> 使用 QuickSDK 开放接口获取 QuickSDK 相关游戏数据前，需要在QuickSDK后台-账号管理-数据接口api-开发者秘钥里去获取使用接口的授权参数 QuickSDK 开放接口授权参数如下： openId : 开发者身份 openKey : 开发者密钥，用于使用接口时加解密数据 同时，开发者应提供调用 API 的服务器白名单地址，使用白名单以外的服务器调用 API 会被拒绝 开放接口的 API 地址为 : https://www.quicksdk.com 完整的访问地址应为 API 地址 + 接口地址 所有接口均返回 json 格式字符串。 所有接口必须附带 sign 字段,具体算法参见第三章 Quick所有开放接口默认调用频率为 1000 次 / 分 , 每小时调用次数不超过 10000次 <h3> 二、接口列表 </h3> <h4> 1. 获取游戏接入的所有渠道 </h4> 1.1 接口地址 open/channelList 1.2 提交方式 HTTP POST 1.3 参数列表  <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 1.4 返回示例 {"status":true,"data":[{"channelName":"UCu4e5du6e38uff08u963fu91ccu6e38u620fuff09","channelCode":"9","marketOs":"1"}]} <h4> 2. 获取游戏配置的所有区服 </h4> 2.1 接口地址 open/serverList 2.2 提交方式 HTTP POST 2.3 参数列表  <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:1011px;"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 2.4 返回示例 {"status":true,"data":[{"serverName":"u516cu6d4b46-u5ba1u5224u8005u7684u7ec8u6781u56fdu5ea6"}]} <h4> 3. 获取游戏内角色信息 </h4> 3.1 接口地址 open/roleInfo 3.2 提交方式 HTTP POST 3.3 参数列表  <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> serverName </td> <td> 是 </td> <td> 游戏区服名称 </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> roleId </td> <td> 否 </td> <td> 游戏内角色 ID (roleId,roleName,username 至少传 1 个) </td> </tr> <tr> <td> roleName </td> <td> 否 </td> <td> 游戏角色名 </td> </tr> <tr> <td> username </td> <td> 否 </td> <td> 渠道用户名 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 3.4 返回示例 {"status":true,"data":{"total":1,"list":[{"uid":"114249300","username":"Doctorwalker","channelCode":"102","serverName":"u516cu6d4b28-u65e0u5c3du7684u96f7u9706u4e4bu6012","roleName":"DWalker","roleId":"11PI6I9","roleBalance":"0","roleLevel":"1","vipLevel":"0","guild":"0","lastLoginTime":"2016-02-24 01:57:34","createTime":"2016-02-24 01:58:01","loginTimes":"2","lastLoginDevice":"68CF043266647B034BDD7226ADD62B24","payTimes":"0","payAmount":"0","ip":"127.0.0.1"}]},"message":""} 3.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> uid </td> <td> string </td> <td> 用户在渠道的UID </td> </tr> <tr> <td> username </td> <td> string </td> <td> 用户在渠道的 username </td> </tr> <tr> <td> channelCode </td> <td> string </td> <td> QuickSDK 渠道号 </td> </tr> <tr> <td> serverName </td> <td> string </td> <td> 游戏区服 </td> </tr> <tr> <td> roleName </td> <td> string </td> <td> 角色名 </td> </tr> <tr> <td> roleId </td> <td> string </td> <td> 角色 ID </td> </tr> <tr> <td> roleBalance </td> <td> string </td> <td> 角色游戏币余额 </td> </tr> <tr> <td> roleLevel </td> <td> string </td> <td> 角色等级 </td> </tr> <tr> <td> vipLevel </td> <td> string </td> <td> 角色VIP 等级 </td> </tr> <tr> <td> gulid </td> <td> string </td> <td> 公会 </td> </tr> <tr> <td> lastLoginTime </td> <td> string </td> <td> 最后登录 2015-01-01 23:32:00 </td> </tr> <tr> <td> createTime </td> <td> string </td> <td> 创建时间 2015-01-01 23:32:00 </td> </tr> <tr> <td> loginTimes </td> <td> string </td> <td> 登录次数 </td> </tr> <tr> <td> lastLoginDevice </td> <td> string </td> <td> 最后登录设备 </td> </tr> <tr> <td> payTimes </td> <td> string </td> <td> 支付次数 </td> </tr> <tr> <td> payAmount </td> <td> string </td> <td> 累计支付总额 </td> </tr> <tr> <td> ip </td> <td> string </td> <td> 最后登录 ip </td> </tr> </tbody> </table> 3.6 其他说明 此接口最多返回符合条件的 10 条记录 <h4> 4. 获取单日报表数据 </h4> 4.1 接口地址 open/dayReport 4.2 提交方式 HTTP POST 4.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> channelCode </td> <td> 否 </td> <td> 渠道 CODE(默认全部渠道) </td> </tr> <tr> <td> bTime </td> <td> 否 </td> <td> 查找条件开始日期(时间戳，默认从 7 天前开始) </td> </tr> <tr> <td> eTime </td> <td> 否 </td> <td> 查找条件结束日期(时间戳，默认到本日结束)起始时间，间隔不超过 30 天 </td> </tr> <tr> <td> usermb </td> <td> 否 </td> <td> 1/0，是否以人民币币种返回数据 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 4.4 返回示例 {"status":true,"data":[{"date":"2015-09-03","channelName":"u6240u6709u6e20u9053","newUser":107439,"newDevice":177574,"userLogin":107531,"newPayUser":2441,"allPayUser":23145,"newUserPay":97015.4,"allPay":1935358.4,"firstPayUser":11477,"currency":null,"usermb":1},{"date":"2015-09-02","channelName":"u6240u6709u6e20u9053","newUser":100397,"newDevice":176052,"userLogin":99317,"newPayUser":2688,"allPayUser":18666,"newUserPay":103870.4,"allPay":1801172.2,"firstPayUser":8723,"currency":null,"usermb":1}],"message":""} 4.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> date </td> <td> string </td> <td> 报表日期 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> newUser </td> <td> int </td> <td> 新增用户 </td> </tr> <tr> <td> newDevice </td> <td> int </td> <td> 新增设备 </td> </tr> <tr> <td> userLogin </td> <td> int </td> <td> 活跃用户数 </td> </tr> <tr> <td> newPayUser </td> <td> int </td> <td> 新用户付费数 </td> </tr> <tr> <td> allPayUser </td> <td> int </td> <td> 总付费数 </td> </tr> <tr> <td> newUserPay </td> <td> string </td> <td> 新用户充值额 </td> </tr> <tr> <td> allPay </td> <td> string </td> <td> 总充值额 </td> </tr> <tr> <td> firstPayUser </td> <td> int </td> <td> 新增付费用户数 </td> </tr> <tr> <td> currency </td> <td> string </td> <td> 渠道币种符号（“¥”，“$”） </td> </tr> <tr> <td> usermb </td> <td> int </td> <td> 1/0，是否以人民币币种返回数据 </td> </tr> </tbody> </table> 4.6 其他说明 如游戏有使用 QuickSDK 接入海外渠道，QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0,为 0 时 currency字段将返回使用的货币符号,同时直接以原始货币金额显示 如果需要获取固定汇率请联系 QuickSDK 工作人员 <h4> 5. 获取每小时报表数据 </h4> 5.1 接口地址 open/dayHourReport 5.2 提交方式 HTTP POST 5.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> channelCode </td> <td> 否 </td> <td> 渠道 CODE(默认全部渠道) </td> </tr> <tr> <td> dateTime </td> <td> 否 </td> <td> 查找条件日期(时间戳，默认当日时间) </td> </tr> <tr> <td> usermb </td> <td> 否 </td> <td> 1/0，是否以人民币币种返回数据 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 5.4 返回示例 {"status":true,"data":[{"date_hour":"2015-08-30 15:59:59","channelName":"u6240u6709u6e20u9053","newUser":32,"newDevice":0,"userLogin":202229,"newPayUser":0,"allPayUser":0,"newUserPay":3344,"allPay":13419.4,"firstPayUser":0,"currency":null,"usermb":1}],"message":""} 5.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> date_hour </td> <td> string </td> <td> 报表时间 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> newUser </td> <td> int </td> <td> 新增用户 </td> </tr> <tr> <td> newDevice </td> <td> int </td> <td> 新增设备 </td> </tr> <tr> <td> userLogin </td> <td> int </td> <td> 活跃用户数 </td> </tr> <tr> <td> newPayUser </td> <td> int </td> <td> 新用户付费数 </td> </tr> <tr> <td> allPayUser </td> <td> int </td> <td> 总付费数 </td> </tr> <tr> <td> newUserPay </td> <td> string </td> <td> 新用户充值额 </td> </tr> <tr> <td> allPay </td> <td> string </td> <td> 总充值额 </td> </tr> <tr> <td> firstPayUser </td> <td> int </td> <td> 新增付费用户数 </td> </tr> <tr> <td> currency </td> <td> string </td> <td> 渠道币种符号（“¥”，“$”） </td> </tr> <tr> <td> usermb </td> <td> int </td> <td> 1/0，是否以人民币币种返回数据 </td> </tr> </tbody> </table> 5.6 其他说明 如游戏有使用 QuickSDK 接入海外渠道，QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0，为 0 时 currency字段将返回使用的货币符号，同时直接以原始货币金额显示 如果需要获取固定汇率请联系 QuickSDK 工作人员 <h4> 6. 获取玩家存留列表 </h4> 6.1 接口地址 open/userLive 6.2 提交方式 HTTP POST 6.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> channelCode </td> <td> 否 </td> <td> 渠道 CODE(默认全部渠道) </td> </tr> <tr> <td> bTime </td> <td> 否 </td> <td> 查找条件开始日期(时间戳，默认从 7 天前开始) </td> </tr> <tr> <td> eTime </td> <td> 否 </td> <td> 查找条件结束日期(时间戳，默认到本日结束)起始时间，间隔不超过 30 天 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 6.4 返回示例 {"status":true,"data":[{"date":"2015-09-03","channelName":"u6240u6709u6e20u9053","newUser":107439,"live_2":59745,"live_3":33254,"live_7":0,"live_15":0},{"date":"2015-09-02","channelName":"u6240u6709u6e20u9053","newUser":100397,"live_2":51542,"live_3":35243,"live_7":0,"live_15":0}],"message":""} 6.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> date </td> <td> string </td> <td> 报表日期 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> newUser </td> <td> int </td> <td> 新增用户 </td> </tr> <tr> <td> live_2 </td> <td> int </td> <td> 次日存留 </td> </tr> <tr> <td> live_3 </td> <td> int </td> <td> 3 日存留 </td> </tr> <tr> <td> live_7 </td> <td> int </td> <td> 7 日存留 </td> </tr> <tr> <td> live_15 </td> <td> int </td> <td> 15 日存留 </td> </tr> </tbody> </table> <h4> 7. 获取渠道报表数据 </h4> 7.1 接口地址 open/channelDaysReport 7.2 提交方式 HTTP POST 7.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> channelCode </td> <td> 否 </td> <td> 渠道 CODE(默认返回全部渠道汇总后的数据) </td> </tr> <tr> <td> bTime </td> <td> 否 </td> <td> 查找条件开始日期(时间戳，默认从 7 天前开始) </td> </tr> <tr> <td> eTime </td> <td> 否 </td> <td> 查找条件结束日期(时间戳，默认到本日结束)，起始时，间隔不超过 30 天 </td> </tr> <tr> <td> usermb </td> <td> 否 </td> <td> 1/0，是否以人民币币种计算(默认以人民币计算) </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 7.4 返回示例 {"status":true,"data":[{"channelName":"u5929u8c61u4e92u52a8_Andorid","newUser":"16098","newDevice":"25871","allPayUser":"1016","allPay":98314,"currency":"$"},{"channelName":"u805au597du73a9","newUser":0,"newDevice":0,"allPayUser":0,"allPay":0,"currency":"u00a5"},{"channelName":"u866bu866b","newUser":0,"newDevice":0,"allPayUser":0,"allPay":0,"currency":"u00a5"},{"channelName":"u540cu6b65u63a8","newUser":0,"newDevice":0,"allPayUser":0,"allPay":0,"currency":"u00a5"}],"message":""} 7.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> newUser </td> <td> int </td> <td> 新增用户 </td> </tr> <tr> <td> newDevice </td> <td> int </td> <td> 新增设备 </td> </tr> <tr> <td> allPayUser </td> <td> int </td> <td> 总付费数 </td> </tr> <tr> <td> allPay </td> <td> string </td> <td> 总充值额 </td> </tr> <tr> <td> currency </td> <td> string </td> <td> 渠道币种符号（“¥”，“$”） </td> </tr> <tr> <td> usermb </td> <td> int </td> <td> 是否以人民币计算 </td> </tr> </tbody> </table> 7.6 其他说明 如游戏有使用 QuickSDK 接入海外渠道,QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0,为 0 时 currency字段将返回使用的货币符号,同时直接以原始货币金额显示 如果需要获取固定汇率请联系 QuickSDK 工作人员 <h4> 8. 获取渠道日报表数据 </h4> 8.1 接口地址 open/channelReport 8.2 提交方式 HTTP POST 8.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> channelCode </td> <td> 否 </td> <td> 渠道 CODE(默认全部渠道) </td> </tr> <tr> <td> dateTime </td> <td> 否 </td> <td> 查找条件开始日期(时间戳，默认从 7 天前开始) </td> </tr> <tr> <td> usermb </td> <td> 否 </td> <td> 1/0，是否以人民币币种计算(默认以人民币计算) </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 8.4 返回示例 {"status":true,"data":[{"channelName":"u7396u5ea6","newUser":"0","newDevice":"0","userLogin":"0","newPayUser":"0","allPayUser":"1","newUserPay":0,"allPay":6,"firstPayUser":"0","currency":"u00a5","usermb":"1"},{"channelName":"u540cu6b65u63a8","newUser":0,"newDevice":0,"userLogin":0,"newPayUser":0,"allPayUser":0,"newUserPay":0,"allPay":0,"firstPayUser":0,"currency":"u00a5","usermb":"1"}],"message":""} 8.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> newUser </td> <td> int </td> <td> 新增用户 </td> </tr> <tr> <td> newDevice </td> <td> int </td> <td> 新增设备 </td> </tr> <tr> <td> userLogin </td> <td> int </td> <td> 活跃用户数 </td> </tr> <tr> <td> newPayUser </td> <td> int </td> <td> 新用户付费数 </td> </tr> <tr> <td> allPayUser </td> <td> int </td> <td> 总付费数 </td> </tr> <tr> <td> newUserPay </td> <td> string </td> <td> 新用户充值额 </td> </tr> <tr> <td> allPay </td> <td> string </td> <td> 总充值额 </td> </tr> <tr> <td> firstPayUser </td> <td> int </td> <td> 新增付费用户数 </td> </tr> <tr> <td> currency </td> <td> string </td> <td> 渠道币种符号（“¥”，“$”） </td> </tr> <tr> <td> usermb </td> <td> int </td> <td> 是否以人民币计算 </td> </tr> </tbody> </table> 8.6 其他说明 如游戏有使用 QuickSDK 接入海外渠道,QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0,为 0 时 currency字段将返回使用的货币符号,同时直接以原始货币金额显示 如果需要获取固定汇率请联系 QuickSDK 工作人员 <h4> 9. 获取流失风险预警列表 </h4> 9.1 接口地址 open/uwlLost 9.2 提交方式 HTTP POST 9.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> time </td> <td> 是 </td> <td> 接口请求时间戳 </td> </tr> <tr> <td> channelCode </td> <td> 否 </td> <td> 渠道 CODE(默认全部渠道) </td> </tr> <tr> <td> dateTime </td> <td> 否 </td> <td> 查找条件日期(时间戳，默认今日) </td> </tr> <tr> <td> page </td> <td> 否 </td> <td> 页码，默认第一页，每页返回 100 条数据 </td> </tr> <tr> <td> level </td> <td> 否 </td> <td> 流失风险等级，取固定值，默认全部 0：全部等级 1：流失风险高 2：流失风险中 3：流失风险低 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 9.4 返回示例 {"status":true,"data":[{"channelName":"vivo","userId":"6b2a75296f112434","payAmount":0,"lastLoginTime":0,"loginWarn":"1","payWarn":"1","onlineWarn":"0","crashWarn":"0","askServiceWarn":"0","abuseWarn":"0","levelWarn":"0","warnLevel":"高"}],"message":""} 9.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> userId </td> <td> string </td> <td> 用户 UID </td> </tr> <tr> <td> payAmount </td> <td> float </td> <td> 用户累计付费 </td> </tr> <tr> <td> lastLoginTime </td> <td> int </td> <td> 用户最后登录时间戳 </td> </tr> <tr> <td> onlineWarn </td> <td> int </td> <td> 是否近两日登录次数出现明显下滑（1 是，0 否） </td> </tr> <tr> <td> crashWarn </td> <td> int </td> <td> 玩家终端是否频繁崩溃 </td> </tr> <tr> <td> askServiceWarn </td> <td> string </td> <td> 是否遇到问题较多频繁联系客服 </td> </tr> <tr> <td> abuseWarn </td> <td> string </td> <td> 是否辱骂客服威胁退游 </td> </tr> <tr> <td> levelWarn </td> <td> int </td> <td> 是否长时间等级停滞 </td> </tr> <tr> <td> payWarn </td> <td> string </td> <td> 是否近期支付金额大幅下降 </td> </tr> <tr> <td> warnLevel </td> <td> string </td> <td> 流失评估 </td> </tr> </tbody> </table> <h4> 10. 获取产品列表 </h4> 10.1 接口地址 open/productList 10.2 提交方式 HTTP POST 10.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 10.4 返回示例 {"status":true,"data":[{"productName":"u6d4bu8bd5u6e38u620f","productCode":"11307116493328899400417645200944"}],"message":""} 10.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> productName </td> <td> string </td> <td> 游戏名称 </td> </tr> <tr> <td> productCode </td> <td> string </td> <td> QuickSDK ProductCode </td> </tr> <tr> <td> productKey </td> <td> string </td> <td> QuickSDK ProductKey </td> </tr> <tr> <td> callbackKey </td> <td> string </td> <td> QuickSDK Callback_Key </td> </tr> <tr> <td> md5Key </td> <td> string </td> <td> QuickSDK Md5_Key </td> </tr> <tr> <td> gameType </td> <td> int </td> <td> 游戏类型，取固定值： 1:角色扮演 2:卡牌对战 3:战略游戏 4:模拟游戏 5:休闲益智 6:竞技格斗 7:射击游戏 8:动作冒险 9:策略塔防 10:动作角色扮演 11:多人角色 12:竞技体育 13:音乐游戏 </td> </tr> <tr> <td> callbackUrl </td> <td> string </td> <td> 游戏 Callback_Url </td> </tr> </tbody> </table> <h4> 11. 获取广告计划效果报表 </h4> 11.1 接口地址 open/adReport 11.2 提交方式 HTTP POST 11.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> QuickSDK 产品 CODE </td> </tr> <tr> <td> sdate </td> <td> 必传 </td> <td> 日志筛选时段开始日期，格式：YYYY-MM-DD </td> </tr> <tr> <td> edate </td> <td> 必传 </td> <td> 日志筛选时段结束日期，格式：YYYY-MM-DD </td> </tr> <tr> <td> plans </td> <td> 选传 </td> <td> 广告计划 CODE，可传多个计划 CODE,多个计划以“|”分隔 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 11.4 返回示例 {"status":true,"data":[],"message":""} 11.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> date </td> <td> string </td> <td> 日期，格式为 YYYY-MM-DD </td> </tr> <tr> <td> planCode </td> <td> string </td> <td> 计划 Code </td> </tr> <tr> <td> installNum </td> <td> int </td> <td> 启动数 </td> </tr> <tr> <td> newUser </td> <td> int </td> <td> 新增用户 </td> </tr> <tr> <td> dau </td> <td> int </td> <td> 活跃用户 </td> </tr> <tr> <td> payNewUser </td> <td> int </td> <td> 新用户付费数 </td> </tr> <tr> <td> payNewUserAmount  </td> <td> float </td> <td> 新用户付费额 </td> </tr> <tr> <td> pay_3 </td> <td> float </td> <td> 新增用户 3日充值总额，计算LTV3为pay_3/newUser。以下 LTV 计算同理 </td> </tr> <tr> <td> pay_7 </td> <td> float </td> <td> 新增用户 7 日充值总额 </td> </tr> <tr> <td> pay_15 </td> <td> float </td> <td> 新增用户 15 日充值总额 </td> </tr> <tr> <td> pay_30 </td> <td> float </td> <td> 新增用户 30 日充值总额 </td> </tr> <tr> <td> pay_60 </td> <td> float </td> <td> 新增用户 60 日充值总额 </td> </tr> <tr> <td> payUser </td> <td> int </td> <td> 总付费用户数 </td> </tr> <tr> <td> payAmount </td> <td> float </td> <td> 总付费额 </td> </tr> <tr> <td> adChannel </td> <td> string </td> <td> 计划推广渠道 </td> </tr> <tr> <td> adMedia_cost </td> <td> float </td> <td> 媒体曝光环节中成本 </td> </tr> <tr> <td> live_N </td> <td> int </td> <td> N 日留存 </td> </tr> <tr> <td> ltvN </td> <td> float </td> <td> N 日 LTV </td> </tr> </tbody> </table> <h4> 12. 获取订单列表 </h4> 12.1 接口地址 open/orderList 12.2 提交方式 HTTP POST 12.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> QuickSDK 产品 CODE </td> </tr> <tr> <td> btime </td> <td> 选传 </td> <td> 日志筛选时段开始日期，格式： YYYY-MM-DD HH:MM:SS，默认为当天 0 点 </td> </tr> <tr> <td> etime </td> <td> 选传 </td> <td> 日志筛选时段结束日期，格式： YYYY-MM-DD HH:MM:SS，默认为当前时间 </td> </tr> <tr> <td> channelList </td> <td> 选传 </td> <td> 订单所在渠道 code，多个值以“,”分隔，不传则为全部渠道 </td> </tr> <tr> <td> page </td> <td> 选传 </td> <td> 页码，默认为第一页。如果数据量多的情况下需要分页请求获取列表，每页数据 50 条 </td> </tr> <tr> <td> orderStatus </td> <td> 选传 </td> <td> 订单状态,不传则查询全部订单，取固定值: 1 支付失败 2 尚未发货 3 发货失败 4 订单完成 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 12.4 返回示例 {"status":true,"data":[],"message":""} 12.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> marketOs </td> <td> int </td> <td> 渠道类型，固定值 1 安卓 2 iOS 正版 3 iOS 越狱 </td> </tr> <tr> <td> channelName </td> <td> string </td> <td> 渠道名称 </td> </tr> <tr> <td> server </td> <td> string </td> <td> 区服 </td> </tr> <tr> <td> orderNo </td> <td> string </td> <td> 订单号 </td> </tr> <tr> <td> userName </td> <td> string </td> <td> 用户名 </td> </tr> <tr> <td> userId </td> <td> string </td> <td> 用户 uid </td> </tr> <tr> <td> roleName </td> <td> string </td> <td> 角色名 </td> </tr> <tr> <td> amount </td> <td> float </td> <td> 订单金额 </td> </tr> <tr> <td> currency </td> <td> string </td> <td> 币种 </td> </tr> <tr> <td> createTime </td> <td> int </td> <td> 订单创建时间，格式为 unix 时间戳 </td> </tr> <tr> <td> status </td> <td> int </td> <td> 订单状态取固定值: 1 支付失败 2 尚未发货 3 发货失败 4 订单完成 </td> </tr> <tr> <td> channelOrderNo </td> <td> string </td> <td> 渠道订单号 </td> </tr> <tr> <td> cpOrderNo </td> <td> string </td> <td> 游戏订单号 </td> </tr> <tr> <td> extrasParams </td> <td> string </td> <td> 订单扩展参数 </td> </tr> <tr> <td> payTime </td> <td> int </td> <td> 订单支付成功时间，格式为 unix 时间戳 </td> </tr> <tr> <td> asyTime </td> <td> int </td> <td> 订单同步游戏时间，格式为 unix 时间戳 </td> </tr> <tr> <td> goodsId </td> <td> string </td> <td> 订单商品 ID </td> </tr> <tr> <td> goodsName </td> <td> string </td> <td> 商品名称 </td> </tr> <tr> <td> price </td> <td> float </td> <td> 商品单价 </td> </tr> <tr> <td> channelCode </td> <td> int </td> <td> 渠道号 </td> </tr> </tbody> </table> <h4> 13. 获取广告主列表 </h4> 13.1 接口地址 open/getMediaApp 13.2 提交方式 HTTP POST 13.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> mediaType </td> <td> 是 </td> <td> 广告媒体类型，固定值 Toutiao </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 13.4 返回示例 {"status":true,"data":[{"appId":"105","mediaId":"T1574740187","mediaName":"tt-test02"},{"appId":"89","mediaId":"T1592634692","mediaName":"tt-test01"}],"message":""} 13.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> appId </td> <td> string </td> <td> 广告主 ID </td> </tr> <tr> <td> mediaId </td> <td> string </td> <td> 广告主媒体方 ID </td> </tr> <tr> <td> mediaName </td> <td> string </td> <td> 广告主名称 </td> </tr> </tbody> </table> <h4> 14. 获取广告计划分组列表 </h4> 14.1 接口地址 open/getAdPlanGroup 14.2 提交方式 HTTP POST 14.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 14.4 返回示例 {"status":true,"data":[{"groupId":"817","groupName": "计划组 01" }],"message":""} 14.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> groupId </td> <td> string </td> <td> 分组 ID </td> </tr> <tr> <td> groupName </td> <td> string </td> <td> 分组名称 </td> </tr> </tbody> </table> <h4> 15. 获取游戏分包列表 </h4> 15.1 接口地址 open/getPackageVersion 15.2 提交方式 HTTP POST 15.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 15.4 返回示例 {"status":true,"data":[{"packId":"3","packName":"gg","versionNo":"121","versionName": "v1.21"}],"message":""} 15.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> packId </td> <td> string </td> <td> 分包 ID </td> </tr> <tr> <td> packName </td> <td> string </td> <td> 分包名称 </td> </tr> <tr> <td> versionNo </td> <td> string </td> <td> 分包版本号 </td> </tr> <tr> <td> versionName </td> <td> string </td> <td> 分包版本名 </td> </tr> </tbody> </table> <h4> 16. 获取广告落地页列表 </h4> 16.1 接口地址 open/getAdPages 16.2 提交方式 HTTP POST 16.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 16.4 返回示例 {"status":true,"data":[{ "pageId":"2","pageName":" 落地页多图 0821","tempId":"5","tempName": "动态多图（配置可点图片）"}],"message":""} 16.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> pageId </td> <td> string </td> <td> 落地页 ID </td> </tr> <tr> <td> pageName </td> <td> string </td> <td> 落地页名称 </td> </tr> <tr> <td> tempId </td> <td> string </td> <td> 落地页模板 ID </td> </tr> <tr> <td> tempName </td> <td> string </td> <td> 落地页模板名 </td> </tr> </tbody> </table> <h4> 17. 创建广告计划 </h4> 17.1 接口地址 open/createAdPlan 17.2 提交方式 HTTP POST 17.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td style="width:10%;"> 参数 </td> <td style="width:6%;"> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> plans </td> <td> 是 </td> <td> 计划名称，批量创建时以“,”分隔 </td> </tr> <tr> <td> platform </td> <td> 是 </td> <td> 产品平台，可选值： APP：手机游戏 WEB：网页游戏 </td> </tr> <tr> <td> channelId </td> <td> 否 </td> <td> 广告媒体ID（参考广告广告 open/getMediaChannel）） </td> </tr> <tr> <td> privateChannel </td> <td> 否 </td> <td> 自定广告媒体名称，当传 channelId 时必填 </td> </tr> <tr> <td> mediaAppId </td> <td> 否 </td> <td> 广告主 appId（参考广告主 open/getMediaApp）传 channelId 时可选填以创建广告媒体转化 </td> </tr> <tr> <td> convertSdkType </td> <td> 否 </td> <td> 广告媒体转化方式，当传 mediaAppId 时必填，可选值： API：api 转化 SDK：sdk 转化 </td> </tr> <tr> <td> covertType </td> <td> 否 </td> <td> 广告媒体转化类型，当传 mediaAppId 时必填，可选值： ACTIVITE：激活(无深度转化) ACTIVITE_REG：激活且注册 ACTIVITE_PAY：激活且付费 KEY_BEHAVIOR：关键行为(仅支持 SDK 转化) ACTIVITE_DEEP_PAY：激活(深度转化-激活&付费) ACTIVITE_DEEP_LIVE：激活(深度转化-激活&次留) </td> </tr> <tr> <td> groupId </td> <td> 否 </td> <td> 广告分组ID （参考广告分组 open/getAdPlanGroup） </td> </tr> <tr> <td> adPageId </td> <td> 否 </td> <td> 落地页 ID（参考落地页列表 open/getAdPages） </td> </tr> <tr> <td> note </td> <td> 否 </td> <td> 备注 </td> </tr> <tr> <td> activeNode </td> <td> 是 </td> <td> 转化节点，可选值： INSTALL：安装 REGISTER：注册 ROLE：创角 PAY：付费 </td> </tr> <tr> <td> urlType </td> <td> 是 </td> <td> 下载链接方式，可选值： URL：手动填写 CLOUD：云端分包 </td> </tr> <tr> <td> gameUrl </td> <td> 否 </td> <td> 下载链接，urlType 为手动填写时必填 </td> </tr> <tr> <td> package </td> <td> 否 </td> <td> 包名，urlType 为手动填写时可用，当传 mediaAppId，并传包名时，广告计划将启动部署媒体转化；否则广告计划立即部署完成 </td> </tr> <tr> <td> gameVersionId </td> <td> 否 </td> <td> 分包 ID （参考分包列表 open/getPackageVersion），urlType 为云分包填写时必填 </td> </tr> <tr> <td> cpsList </td> <td> 否 </td> <td> 云分包标识，urlType 为云分包填写时可用。当传分包标识时，多个标识以“,”分隔，且数量和顺序与计划名称一致；不传分包标识将使用计划 CODE作为标识 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 注意：如果 channelId 不为空，并且该广告媒体的 models 不为空（参考广告媒体列表接口 open/getMediaChannel），创建广告计划可附带媒体 models 附加参数 例如该媒体 models 返回["sign_key","encrypt_key"]，可附加参数为： sign_key string encrypt_key string models 参数也需要参与签名 </td> </tr> </tbody> </table> 17.4 返回示例 {"status":true,"data":{"success": 2,"total": 2,"list": [{"planName": "API_plan02","planCode": "K6wtm8"}] },"message":""} 17.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> success </td> <td> Int </td> <td> 创建成功计划数量 </td> </tr> <tr> <td> total </td> <td> Int </td> <td> 计划总数量 </td> </tr> <tr> <td> list </td> <td> Object </td> <td> 计划列表 </td> </tr> <tr> <td> planName </td> <td> string </td> <td> 计划名称 </td> </tr> <tr> <td> planCode </td> <td> string </td> <td> 计划 CODE </td> </tr> </tbody> </table> <h4> 18. 更新广告计划 </h4> 18.1 接口地址 open/updateAdPlan 18.2 提交方式 HTTP POST 18.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 Code </td> </tr> <tr> <td> action </td> <td> 是 </td> <td> 更新方式，可选值： FROM_CODE：按计划更新 FROM_VERSION：按分包更新 </td> </tr> <tr> <td> plans </td> <td> 否 </td> <td> 计划 CODE，多个计划以“,”分隔，当传 action 为计划更新时必填 </td> </tr> <tr> <td> urlType </td> <td> 是 </td> <td> 下载链接方式，当传 action 为 FROM_CODE 时必填，可选值： URL：手动填写 CLOUD：云端分包 </td> </tr> <tr> <td> gameUrl </td> <td> 否 </td> <td> 下载链接，urlType 为手动填写时必填 </td> </tr> <tr> <td> gameVersionId </td> <td> 否 </td> <td> 分包 ID，urlType 为云分包填写时必填 </td> </tr> <tr> <td> oldVersionId </td> <td> 否 </td> <td> 原分包 ID，当传 action 为 FROM_ VERSION 时必填，所有原分包 ID 的计划将更新为指定新分包 ID </td> </tr> <tr> <td> newVersionId </td> <td> 否 </td> <td> 新分包 ID，当传 action 为 FROM_ VERSION 时必填，所有指定分包 ID 的计划将更新为新分包 ID </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 18.4 返回示例 {"status":true,"data":[],"message":""} 18.5 字段说明 无 <h4> 19. 获取广告计划列表 </h4> 19.1 接口地址 open/getAdPlan 19.2 提交方式 HTTP POST 19.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 CODE </td> </tr> <tr> <td> page </td> <td> 是 </td> <td> 页码 </td> </tr> <tr> <td> pageRows </td> <td> 否 </td> <td> 每页计划数量，默认 100 </td> </tr> <tr> <td> status </td> <td> 否 </td> <td> 部署状态，默认 DEPLOY_COMPLETE，可选值： DEPLOY_WAITTING：等待部署 DEPLOY_PROCESS：正在部署 DEPLOY_COMPLETE：部署完成 DEPLOY_FAILD：部署失败 </td> </tr> <tr> <td> channelId </td> <td> 否 </td> <td> 广告媒体 ID </td> </tr> <tr> <td> adGroupId </td> <td> 否 </td> <td> 广告分组 ID，不传为全部，传 0 为未分组 </td> </tr> <tr> <td> planCode </td> <td> 否 </td> <td> 广告计划 CODE，可传此字段搜索计划 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 19.4 返回示例 {"status":true,"data": {"total": 7,"list": [{"planName": "测试计划组","planCode": "u7im9O","groupId": 817,"channelId": 4,"stat": "DEPLOY_COMPLETE","message": "部署完成 ","createTime": 1598327640,"adPageUrl": "https://adtracking.quickjoy.com/s/u7im9O","downUrl": "https://adtracking.quickjoy.com/p/u7im9O"}]},"message":""} 19.5 字段说明 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> total </td> <td> Int </td> <td> 符合条件的广告计划数 </td> </tr> <tr> <td> list </td> <td> Object </td> <td> 计划列表 </td> </tr> <tr> <td> planName </td> <td> string </td> <td> 计划名称 </td> </tr> <tr> <td> planCode </td> <td> string </td> <td> 计划 CODE </td> </tr> <tr> <td> groupId </td> <td> Int </td> <td> 广告分组 ID </td> </tr> <tr> <td> channelId </td> <td> Int </td> <td> 广告媒体 ID </td> </tr> <tr> <td> stat </td> <td> string </td> <td> 部署状态，参考请求参数 </td> </tr> <tr> <td> message </td> <td> string </td> <td> 描述信息 </td> </tr> <tr> <td> createTime </td> <td> Int </td> <td> 计划创建时间戳 </td> </tr> <tr> <td> adPageUrl </td> <td> string </td> <td> 落地页链接 </td> </tr> <tr> <td> downUrl </td> <td> string </td> <td> 下载短链 </td> </tr> </tbody> </table> <h4> 20. 消息推送(华为、OPPO、VIVO) </h4> 20.1 接口地址 open/pushMessage 20.2 提交方式 HTTP POST 20.3 参数列表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 参数 </td> <td> 必要性 </td> <td> 说明 </td> </tr> <tr> <td> openId </td> <td> 是 </td> <td> 开发者 ID </td> </tr> <tr> <td> productCode </td> <td> 是 </td> <td> 产品 CODE </td> </tr> <tr> <td> channel_code </td> <td> 是 </td> <td> 渠道 CODE，多个以“,”分隔 </td> </tr> <tr> <td> gateway </td> <td> 是 </td> <td> 目标设备类型，取值： huawei 对应华为 vivo 对应 VIVO oppo 对应 OPPO </td> </tr> <tr> <td> title </td> <td> 是 </td> <td> 消息标题 </td> </tr> <tr> <td> body </td> <td> 是 </td> <td> 消息内容 </td> </tr> <tr> <td> sign </td> <td> 是 </td> <td> 签名 </td> </tr> </tbody> </table> 20.4 返回示例 {"status":true,"data":[],"message":""} <h3> 三、签名规则 </h3> 将去掉 sign 的所有参数按键名首字母自然排序排列 将所有参数按如下形式拼接 k1=v1&k2=v2& 在第二步的字符尾部拼接 openKey 的值 将前三步所得字符串 k1=v1&k2=v2&openKey 计算 MD5 所得 MD5 即为签名值