用户交互记录回传(非基于推荐服务产生的行为)
6.4.0 用途说明#
●历史数据:建议提供推荐服务上线前最近3-4周的用户交互记录,用于算法训练启动;时间上越近,规模上越大,算法效果就越好
●对照组:在推荐服务接入开始跑动后,建议回传所推荐的资源位置,所有流量的用户交互记录,用于算法优化及效果统计
6.4.1 曝光#
●路径:/media_cultivation/api/v1/data_report/batch_impression
●请求方法:POST
●访问端需在Header参数中添加名称为Authentication的参数,参数值为访问时提供的media_app_id对应的私钥。
●若访问端提供的media_app_id对应的媒体为数据上报系统所支持的媒体,且Authentication参数内容与服务器中的私钥记录相同,则数据可被成功上报;否则将会返回4011的错误代码。
●媒体对应的私钥请咨询接口相关人员
●批量上报数据量最大值限制为:1000
●请求参数: ○Headers:
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json | 请求内容类型 |
| Authentication | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | 是 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | media_app_id 对应私钥 |
○Body:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| object [] | 非必须 | ||
| report_id | string | 必须 | 请求唯一ID,由媒体侧生成 |
| report_time | number | 非必须 | 曝光时间戳,精确到ms,例: 1621937423000 |
| media_app_id | string | 必须 | 媒体应用ID,平台生成后分配给渠道 |
| position_id | string | 非必须 | 资源位ID,平台生成后分配给渠道 |
| ad_type | number | 必须 | 10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染 |
| creative_id | string | 非必须 | 媒体侧展示的创意 |
| material_type | string | 非必须 | 1图片,2视频,3组图,4文案 |
| app_id | string | 必须 | 游戏ID |
| channelid | string | 必须 | 渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配) |
| network | string | 非必须 | 13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G |
| client_ip | string | 非必须 | 一般为app用户所在的网络的ip地址 |
| device_type | string | 非必须 | 1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid |
| ua | string | 非必须 | |
| brand | string | 非必须 | 手机品牌 |
| model | string | 非必须 | 设备型号 |
| carrier | string | 非必须 | 运营商 |
| app_pkg | string | 非必须 | 游戏P包名(package_name) |
| app_version | string | 非必须 | 游戏的版本(version_name) |
| platid | number | 必须 | 平台类型id,0:ios 1:android 3:other |
| imei | string | 非必须 | 设备IMEI(仅android设备有) |
| imei_md5 | string | 非必须 | 设备IMEI MD5(仅android设备) |
| oaid | string | 非必须 | 设备OAID(仅android设备有) |
| oaid_md5 | string | 非必须 | 设备OAID MD5(仅android设备) |
| android_id | string | 非必须 | 设备ANDROID_ID(仅android设备有) |
| android_id_md5 | string | 非必须 | 设备ANDROID_ID MD5 (仅android设备) |
| idfa | string | 非必须 | 设备IDFA(仅iOS设备) |
| idfa_md5 | string | 非必须 | 设备IDFA MD5(仅iOS设备) |
| caid | string | 非必须 | 设备caid(仅iOS设备) |
| caid_md5 | string | 非必须 | 设备caid MD5 (仅iOS设备) |
| qimei36 | string | 非必须 | 设备qimei36 |
| qimei36_md5 | string | 非必须 | 设备qimei36 MD5 |
| order_no | number | 非必须 | 排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。 |
| report_content | string | 非必须 | 数据报送携带内容。(搜索栏:关键词) |
| content_type | number | 非必须 | 内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词) |
| group_id_media | string | 非必须 | 分组ID-媒体侧 |
| cpm_cost | float | 非必须 | 曝光成本价(单位:分) |
●返回数据:
| 名称 | 类型 | 是否必须 |
|---|---|---|
| code | number | 非必须 |
| msg | string | 非必须 |
6.4.2 点击#
●路径:/media_cultivation/api/v1/data_report/batch_click
●请求方法:POST
●访问端需在Header参数中添加名称为Authentication的参数,参数值为访问时提供的media_app_id对应的私钥。
●若访问端提供的media_app_id对应的媒体为数据上报系统所支持的媒体,且Authentication参数内容与服务器中的私钥记录相同,则数据可被成功上报;否则将会返回4011的错误代码。
●媒体对应的私钥请咨询接口相关人员
●批量上报数据量最大值限制为:1000
●请求参数:
○Headers:
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json | 请求内容类型 |
| Authentication | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | 是 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | media_app_id 对应私钥 |
○Body:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| object [] | 非必须 | ||
| report_id | string | 必须 | 请求唯一ID,由媒体侧生成 |
| report_time | number | 非必须 | 点击时间戳,精确到ms,例: 1621937423000 |
| media_app_id | string | 必须 | 媒体应用ID,平台生成后分配给渠道 |
| position_id | string | 非必须 | 资源位ID,平台生成后分配给渠道 |
| ad_type | number | 必须 | 10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染 |
| creative_id | string | 非必须 | 媒体侧展示的创意 |
| material_type | string | 非必须 | 1图片,2视频,3组图,4文案 |
| app_id | string | 必须 | 游戏ID |
| channelid | string | 必须 | 渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配) |
| network | string | 非必须 | 13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G |
| client_ip | string | 非必须 | 一般为app用户所在的网络的ip地址 |
| device_type | string | 非必须 | 1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid |
| ua | string | 非必须 | |
| brand | string | 非必须 | 手机品牌 |
| model | string | 非必须 | 设备型号 |
| carrier | string | 非必须 | 运营商 |
| app_pkg | string | 非必须 | 游戏P包名(package_name) |
| app_version | string | 非必须 | 游戏的版本(version_name) |
| platid | number | 必须 | 平台类型id,0:ios 1:android 3:other |
| imei | string | 非必须 | 设备IMEI(仅android设备有) |
| imei_md5 | string | 非必须 | 设备IMEI MD5(仅android设备) |
| oaid | string | 非必须 | 设备OAID(仅android设备有) |
| oaid_md5 | string | 非必须 | 设备OAID MD5(仅android设备) |
| android_id | string | 非必须 | 设备ANDROID_ID(仅android设备有) |
| android_id_md5 | string | 非必须 | 设备ANDROID_ID MD5 (仅android设备) |
| idfa | string | 非必须 | 设备IDFA(仅iOS设备) |
| idfa_md5 | string | 非必须 | 设备IDFA MD5(仅iOS设备) |
| caid | string | 非必须 | 设备caid(仅iOS设备) |
| caid_md5 | string | 非必须 | 设备caid MD5 (仅iOS设备) |
| qimei36 | string | 非必须 | 设备qimei36 |
| qimei36_md5 | string | 非必须 | 设备qimei36 MD5 |
| order_no | number | 非必须 | 排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。 |
| report_content | string | 非必须 | 数据报送携带内容。(搜索栏:关键词) |
| content_type | number | 非必须 | 内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词) |
| group_id_media | string | 非必须 | 分组ID-媒体侧 |
| cpm_cost | float | 非必须 | 曝光成本价(单位:分) |
●返回数据:
| 名称 | 类型 | 是否必须 |
|---|---|---|
| code | number | 非必须 |
| msg | string | 非必须 |
6.4.3 下载#
●路径:/media_cultivation/api/v1/data_report/batch_download
●请求方法:POST
●访问端需在Header参数中添加名称为Authentication的参数,参数值为访问时提供的media_app_id对应的私钥。
●若访问端提供的media_app_id对应的媒体为数据上报系统所支持的媒体,且Authentication参数内容与服务器中的私钥记录相同,则数据可被成功上报;否则将会返回4011的错误代码。
●媒体对应的私钥请咨询接口相关人员
●批量上报数据量最大值限制为:1000
●请求参数:
○Headers:
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json | 请求内容类型 |
| Authentication | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | 是 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | media_app_id 对应私钥 |
○Body:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| object [] | 非必须 | ||
| report_id | string | 必须 | 请求唯一ID,由媒体侧生成 |
| report_time | number | 非必须 | 下载时间戳,精确到ms,例: 1621937423000 |
| media_app_id | string | 必须 | 媒体应用ID,平台生成后分配给渠道 |
| position_id | string | 非必须 | 资源位ID,平台生成后分配给渠道 |
| ad_type | number | 必须 | 10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染 |
| creative_id | string | 非必须 | 媒体侧展示的创意 |
| material_type | string | 非必须 | 1图片,2视频,3组图,4文案 |
| app_id | string | 必须 | 游戏ID |
| channelid | string | 必须 | 渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配) |
| network | string | 非必须 | 13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G |
| client_ip | string | 非必须 | 一般为app用户所在的网络的ip地址 |
| device_type | string | 非必须 | 1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid |
| ua | string | 非必须 | |
| brand | string | 非必须 | 手机品牌 |
| model | string | 非必须 | 设备型号 |
| carrier | string | 非必须 | 运营商 |
| app_pkg | string | 非必须 | 游戏P包名(package_name) |
| app_version | string | 非必须 | 游戏的版本(version_name) |
| platid | number | 必须 | 平台类型id,0:ios 1:android 3:other |
| imei | string | 非必须 | 设备IMEI(仅android设备有) |
| imei_md5 | string | 非必须 | 设备IMEI MD5(仅android设备) |
| oaid | string | 非必须 | 设备OAID(仅android设备有) |
| oaid_md5 | string | 非必须 | 设备OAID MD5(仅android设备) |
| android_id | string | 非必须 | 设备ANDROID_ID(仅android设备有) |
| android_id_md5 | string | 非必须 | 设备ANDROID_ID MD5 (仅android设备) |
| idfa | string | 非必须 | 设备IDFA(仅iOS设备) |
| idfa_md5 | string | 非必须 | 设备IDFA MD5(仅iOS设备) |
| caid | string | 非必须 | 设备caid(仅iOS设备) |
| caid_md5 | string | 非必须 | 设备caid MD5 (仅iOS设备) |
| qimei36 | string | 非必须 | 设备qimei36 |
| qimei36_md5 | string | 非必须 | 设备qimei36 MD5 |
| order_no | number | 非必须 | 排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。 |
| report_content | string | 非必须 | 数据报送携带内容。(搜索栏:关键词) |
| content_type | number | 非必须 | 内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词) |
| group_id_media | string | 非必须 | 分组ID-媒体侧 |
| cpm_cost | float | 非必须 | 曝光成本价(单位:分) |
●返回数据:
| 名称 | 类型 | 是否必须 |
|---|---|---|
| code | number | 非必须 |
| msg | string | 非必须 |
6.4.4 下载完成#
●路径:/media_cultivation/api/v1/data_report/batch_downloaded
●请求方法:POST
●访问端需在Header参数中添加名称为Authentication的参数,参数值为访问时提供的media_app_id对应的私钥。
●若访问端提供的media_app_id对应的媒体为数据上报系统所支持的媒体,且Authentication参数内容与服务器中的私钥记录相同,则数据可被成功上报;否则将会返回4011的错误代码。
●媒体对应的私钥请咨询接口相关人员
●批量上报数据量最大值限制为:1000
●请求参数:
○Headers:
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | application/json | 请求内容类型 |
| Authentication | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | 是 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | media_app_id 对应私钥 |
○Body:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| object [] | 非必须 | ||
| report_id | string | 必须 | 请求唯一ID,由媒体侧生成 |
| report_time | number | 非必须 | 下载完成时间戳,精确到ms,例: 1621937423000 |
| media_app_id | string | 必须 | 媒体应用ID,平台生成后分配给渠道 |
| position_id | string | 非必须 | 资源位ID,平台生成后分配给渠道 |
| ad_type | number | 必须 | 10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染 |
| creative_id | string | 非必须 | 媒体侧展示的创意 |
| material_type | string | 非必须 | 1图片,2视频,3组图,4文案 |
| app_id | string | 必须 | 游戏ID |
| channelid | string | 必须 | 渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配) |
| network | string | 非必须 | 13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G |
| client_ip | string | 非必须 | 一般为app用户所在的网络的ip地址 |
| device_type | string | 非必须 | 1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid |
| ua | string | 非必须 | |
| brand | string | 非必须 | 手机品牌 |
| model | string | 非必须 | 设备型号 |
| carrier | string | 非必须 | 运营商 |
| app_pkg | string | 非必须 | 游戏P包名(package_name) |
| app_version | string | 非必须 | 游戏的版本(version_name) |
| platid | number | 必须 | 平台类型id,0:ios 1:android 3:other |
| imei | string | 非必须 | 设备IMEI(仅android设备有) |
| imei_md5 | string | 非必须 | 设备IMEI MD5(仅android设备) |
| oaid | string | 非必须 | 设备OAID(仅android设备有) |
| oaid_md5 | string | 非必须 | 设备OAID MD5(仅android设备) |
| android_id | string | 非必须 | 设备ANDROID_ID(仅android设备有) |
| android_id_md5 | string | 非必须 | 设备ANDROID_ID MD5 (仅android设备) |
| idfa | string | 非必须 | 设备IDFA(仅iOS设备) |
| idfa_md5 | string | 非必须 | 设备IDFA MD5(仅iOS设备) |
| caid | string | 非必须 | 设备caid(仅iOS设备) |
| caid_md5 | string | 非必须 | 设备caid MD5 (仅iOS设备) |
| qimei36 | string | 非必须 | 设备qimei36 |
| qimei36_md5 | string | 非必须 | 设备qimei36 MD5 |
| order_no | number | 非必须 | 排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。 |
| report_content | string | 非必须 | 数据报送携带内容。(搜索栏:关键词) |
| content_type | number | 非必须 | 内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词) |
| group_id_media | string | 非必须 | 分组ID-媒体侧 |
| cpm_cost | float | 非必须 | 曝光成本价(单位:分) |
●返回数据:
| 名称 | 类型 | 是否必须 |
|---|---|---|
| code | number | 非必须 |
| msg | string | 非必须 |