用户交互记录回传(非基于推荐服务产生的行为)
#
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 | 非必须 |