游戏推荐池上报(用于定期向推荐服务侧同步用于推荐的游戏列表,若采用游可赢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-Type | application/json | 是 | application/json | 请求内容类型 |
Authentication | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | 是 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | media_app_id 对应私钥 |
●Body:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
object [] | 非必须 | ||
report_date | string | 必须 | 数据报送日期(yyyy-mm-dd) |
report_time | string | 必须 | 数据报送时间(yyyy-mm-dd hh:mi:ss) |
media_app_id | string | 必须 | 媒体应用id,平台生成提供给渠道 |
app_id | string | 必须 | 媒体端游戏ID |
app_name | string | 必须 | 游戏名称 |
platid | number | 非必须 | 平台类型id,0:ios 1:android 3:other |
position_id | string | 非必须 | 资源位ID,表示该游戏可用于该媒体应用下哪些资源位的推荐。若可用于多个资源位,则多个资源位ID之间用英文逗号分隔。若该字段留空,则推荐服务侧默认该媒体应用下所有资源位皆可推荐该游戏。 |
category_id | string | 非必须 | 游戏分类(ID) |
category_name | string | 非必须 | 游戏分类(名称) |
class_id | string | 非必须 | 游戏二级分类(ID) |
class_name | string | 非必须 | 游戏二级分类(名称) |
game_company | string | 必须 | 游戏发行/代理公司(注:腾讯公司统一标识为: tencent) |
app_status | string | 必须 | 游戏状态(预告/内测/公测/运营/停运) |
app_type | string | 必须 | 类型: 单机/网游/其他 |
is_valid | number | 必须 | 在媒体平台上的有效状态; 0 下线 |
media_create_date | string | 必须 | 游戏创建时间 YYYY-MM-DD |
media_update_date | string | 必须 | 游戏更新时间 YYYY-MM-DD |
package_name_android | string | 必须 | 安卓游戏包名 |
package_name_ios | string | 必须 | ios游戏包名(bund_id) |
●返回数据:
名称 | 类型 | 是否必须 |
---|---|---|
code | number | 必须 |
msg | string | 必须 |
●附加说明:package_name_android和package_name_ios必传一个,根据访问端提供的media_app_id为iOS还是安卓端决定