Skip to main content

用户交互记录回传(非基于推荐服务产生的行为)

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-Typeapplication/jsonapplication/json请求内容类型
Authenticationxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxmedia_app_id
对应私钥

○Body:

名称类型是否必须备注
object []非必须
report_idstring必须请求唯一ID,由媒体侧生成
report_timenumber非必须曝光时间戳,精确到ms,例: 1621937423000
media_app_idstring必须媒体应用ID,平台生成后分配给渠道
position_idstring非必须资源位ID,平台生成后分配给渠道
ad_typenumber必须10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染
creative_idstring非必须媒体侧展示的创意
material_typestring非必须1图片,2视频,3组图,4文案
app_idstring必须游戏ID
channelidstring必须渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配)
networkstring非必须13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G
client_ipstring非必须一般为app用户所在的网络的ip地址
device_typestring非必须1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid
uastring非必须
brandstring非必须手机品牌
modelstring非必须设备型号
carrierstring非必须运营商
app_pkgstring非必须游戏P包名(package_name)
app_versionstring非必须游戏的版本(version_name)
platidnumber必须平台类型id,0:ios 1:android 3:other
imeistring非必须设备IMEI(仅android设备有)
imei_md5string非必须设备IMEI MD5(仅android设备)
oaidstring非必须设备OAID(仅android设备有)
oaid_md5string非必须设备OAID MD5(仅android设备)
android_idstring非必须设备ANDROID_ID(仅android设备有)
android_id_md5string非必须设备ANDROID_ID MD5 (仅android设备)
idfastring非必须设备IDFA(仅iOS设备)
idfa_md5string非必须设备IDFA MD5(仅iOS设备)
caidstring非必须设备caid(仅iOS设备)
caid_md5string非必须设备caid MD5 (仅iOS设备)
qimei36string非必须设备qimei36
qimei36_md5string非必须设备qimei36 MD5
order_nonumber非必须排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。
report_contentstring非必须数据报送携带内容。(搜索栏:关键词)
content_typenumber非必须内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词)
group_id_mediastring非必须分组ID-媒体侧
cpm_costfloat非必须曝光成本价(单位:分)

●返回数据:

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

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-Typeapplication/jsonapplication/json请求内容类型
Authenticationxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxmedia_app_id
对应私钥

○Body:

名称类型是否必须备注
object []非必须
report_idstring必须请求唯一ID,由媒体侧生成
report_timenumber非必须点击时间戳,精确到ms,例: 1621937423000
media_app_idstring必须媒体应用ID,平台生成后分配给渠道
position_idstring非必须资源位ID,平台生成后分配给渠道
ad_typenumber必须10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染
creative_idstring非必须媒体侧展示的创意
material_typestring非必须1图片,2视频,3组图,4文案
app_idstring必须游戏ID
channelidstring必须渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配)
networkstring非必须13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G
client_ipstring非必须一般为app用户所在的网络的ip地址
device_typestring非必须1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid
uastring非必须
brandstring非必须手机品牌
modelstring非必须设备型号
carrierstring非必须运营商
app_pkgstring非必须游戏P包名(package_name)
app_versionstring非必须游戏的版本(version_name)
platidnumber必须平台类型id,0:ios 1:android 3:other
imeistring非必须设备IMEI(仅android设备有)
imei_md5string非必须设备IMEI MD5(仅android设备)
oaidstring非必须设备OAID(仅android设备有)
oaid_md5string非必须设备OAID MD5(仅android设备)
android_idstring非必须设备ANDROID_ID(仅android设备有)
android_id_md5string非必须设备ANDROID_ID MD5 (仅android设备)
idfastring非必须设备IDFA(仅iOS设备)
idfa_md5string非必须设备IDFA MD5(仅iOS设备)
caidstring非必须设备caid(仅iOS设备)
caid_md5string非必须设备caid MD5 (仅iOS设备)
qimei36string非必须设备qimei36
qimei36_md5string非必须设备qimei36 MD5
order_nonumber非必须排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。
report_contentstring非必须数据报送携带内容。(搜索栏:关键词)
content_typenumber非必须内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词)
group_id_mediastring非必须分组ID-媒体侧
cpm_costfloat非必须曝光成本价(单位:分)

●返回数据:

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

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-Typeapplication/jsonapplication/json请求内容类型
Authenticationxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxmedia_app_id
对应私钥

○Body:

名称类型是否必须备注
object []非必须
report_idstring必须请求唯一ID,由媒体侧生成
report_timenumber非必须下载时间戳,精确到ms,例: 1621937423000
media_app_idstring必须媒体应用ID,平台生成后分配给渠道
position_idstring非必须资源位ID,平台生成后分配给渠道
ad_typenumber必须10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染
creative_idstring非必须媒体侧展示的创意
material_typestring非必须1图片,2视频,3组图,4文案
app_idstring必须游戏ID
channelidstring必须渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配)
networkstring非必须13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G
client_ipstring非必须一般为app用户所在的网络的ip地址
device_typestring非必须1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid
uastring非必须
brandstring非必须手机品牌
modelstring非必须设备型号
carrierstring非必须运营商
app_pkgstring非必须游戏P包名(package_name)
app_versionstring非必须游戏的版本(version_name)
platidnumber必须平台类型id,0:ios 1:android 3:other
imeistring非必须设备IMEI(仅android设备有)
imei_md5string非必须设备IMEI MD5(仅android设备)
oaidstring非必须设备OAID(仅android设备有)
oaid_md5string非必须设备OAID MD5(仅android设备)
android_idstring非必须设备ANDROID_ID(仅android设备有)
android_id_md5string非必须设备ANDROID_ID MD5 (仅android设备)
idfastring非必须设备IDFA(仅iOS设备)
idfa_md5string非必须设备IDFA MD5(仅iOS设备)
caidstring非必须设备caid(仅iOS设备)
caid_md5string非必须设备caid MD5 (仅iOS设备)
qimei36string非必须设备qimei36
qimei36_md5string非必须设备qimei36 MD5
order_nonumber非必须排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。
report_contentstring非必须数据报送携带内容。(搜索栏:关键词)
content_typenumber非必须内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词)
group_id_mediastring非必须分组ID-媒体侧
cpm_costfloat非必须曝光成本价(单位:分)

●返回数据:

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

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-Typeapplication/jsonapplication/json请求内容类型
Authenticationxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxmedia_app_id
对应私钥

○Body:

名称类型是否必须备注
object []非必须
report_idstring必须请求唯一ID,由媒体侧生成
report_timenumber非必须下载完成时间戳,精确到ms,例: 1621937423000
media_app_idstring必须媒体应用ID,平台生成后分配给渠道
position_idstring非必须资源位ID,平台生成后分配给渠道
ad_typenumber必须10001 开屏广告、10002 激励视频、10004 插屏广告、10005信息流广告、10006 原生自渲染
creative_idstring非必须媒体侧展示的创意
material_typestring非必须1图片,2视频,3组图,4文案
app_idstring必须游戏ID
channelidstring必须渠道ID(iOS统一为1;Android为游戏分发渠道跟腾讯联运分成所用的渠道号,由腾讯游戏飞鹰中台分配)
networkstring非必须13-1-0:未知,13-1-2:wifi,13-1-4:2G,13-1-5:3G,13-1-6:4G,13-1-7:5G
client_ipstring非必须一般为app用户所在的网络的ip地址
device_typestring非必须1 imei ,2 oaid,3 android_id, 4 idfa ,5 caid
uastring非必须
brandstring非必须手机品牌
modelstring非必须设备型号
carrierstring非必须运营商
app_pkgstring非必须游戏P包名(package_name)
app_versionstring非必须游戏的版本(version_name)
platidnumber必须平台类型id,0:ios 1:android 3:other
imeistring非必须设备IMEI(仅android设备有)
imei_md5string非必须设备IMEI MD5(仅android设备)
oaidstring非必须设备OAID(仅android设备有)
oaid_md5string非必须设备OAID MD5(仅android设备)
android_idstring非必须设备ANDROID_ID(仅android设备有)
android_id_md5string非必须设备ANDROID_ID MD5 (仅android设备)
idfastring非必须设备IDFA(仅iOS设备)
idfa_md5string非必须设备IDFA MD5(仅iOS设备)
caidstring非必须设备caid(仅iOS设备)
caid_md5string非必须设备caid MD5 (仅iOS设备)
qimei36string非必须设备qimei36
qimei36_md5string非必须设备qimei36 MD5
order_nonumber非必须排位(序号) 取值范围:【0,999】 0:表示当前资源位无序号信息,不适用。 1~999:表示相应序号值。
report_contentstring非必须数据报送携带内容。(搜索栏:关键词)
content_typenumber非必须内容类型。关键词类型 (1:用户主动输入;2:热门搜索;3:热门标签;4 历史搜索关键词)
group_id_mediastring非必须分组ID-媒体侧
cpm_costfloat非必须曝光成本价(单位:分)

●返回数据:

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