Skip to main content

游戏推荐池上报(用于定期向推荐服务侧同步用于推荐的游戏列表,若采用游可赢API游戏分发,则可略过此环节)

●路径:/media_cultivation/api/v1/data_report/app_info

●请求方法:POST

●更新频率:t+1,建议每天凌晨0-3点之间上报1次

●附加说明:

●访问端需在Header参数中添加名称为Authentication的参数,参数值为访问时提供的media_app_id对应的私钥。

●若访问端提供的media_app_id对应的媒体为数据上报系统所支持的媒体,且Authentication参数内容与服务器中的私钥记录相同,则数据可被成功上报;否则将会返回4011的错误代码。

●媒体对应的私钥请咨询接口相关人员

●请求参数:

●Headers:

参数名称参数值是否必须示例备注
Content-Typeapplication/jsonapplication/json请求内容类型
Authenticationxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxmedia_app_id
对应私钥

●Body:

名称类型是否必须备注
object []非必须
report_datestring必须数据报送日期(yyyy-mm-dd)
report_timestring必须数据报送时间(yyyy-mm-dd hh:mi:ss)
media_app_idstring必须媒体应用id,平台生成提供给渠道
app_idstring必须媒体端游戏ID
app_namestring必须游戏名称
platidnumber非必须平台类型id,0:ios 1:android 3:other
position_idstring非必须资源位ID,表示该游戏可用于该媒体应用下哪些资源位的推荐。若可用于多个资源位,则多个资源位ID之间用英文逗号分隔。若该字段留空,则推荐服务侧默认该媒体应用下所有资源位皆可推荐该游戏。
category_idstring非必须游戏分类(ID)
category_namestring非必须游戏分类(名称)
class_idstring非必须游戏二级分类(ID)
class_namestring非必须游戏二级分类(名称)
game_companystring必须游戏发行/代理公司(注:腾讯公司统一标识为: tencent)
app_statusstring必须游戏状态(预告/内测/公测/运营/停运)
app_typestring必须类型: 单机/网游/其他
is_validnumber必须在媒体平台上的有效状态; 0 下线
media_create_datestring必须游戏创建时间 YYYY-MM-DD
media_update_datestring必须游戏更新时间 YYYY-MM-DD
package_name_androidstring必须安卓游戏包名
package_name_iosstring必须ios游戏包名(bund_id)

●返回数据:

名称类型是否必须
codenumber必须
msgstring必须

●附加说明:package_name_android和package_name_ios必传一个,根据访问端提供的media_app_id为iOS还是安卓端决定