Skip to main content

用户行为数据上报

每种用户行为尽量都上报,曝光、点击行为必须要进行上报。

目前存在两种宏,一种是带大括号{}的,一种是带下划线的。所有宏均需替换,例如:根据实际情况,将曝光链接{IMP_EVENT_TYPE}宏替换为ad_imp,将竞价链接_WIN_CODE宏替换为1。

7.1. 曝光上报#

曝光上报:在展示广告并 满足广告有效曝光条件 后,需及时进行曝光上报;上报是有时效性的( 时效性为3小时 ),超过时效性,则该曝光无效。曝光行为必须要进行上报。

对于同一个广告,上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

有效曝光条件: 广告展示时需要满足一定条件才能视为有效曝光。 视频类型广告需要满足以下条件:

核心素材露出至少50%
不透明度在90%及以上
所有以上条件满足1秒的曝光

图片类型广告需要满足以下条件:

核心素材露出至少50%
不透明度在90%及以上
所有以上条件满足1秒的曝光

满足以上条件后即可上报曝光。

请求方式HTTP+GET
如何获取链接广告响应数据中的
Tracking -> imp_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 {IMP_EVENT_TYPE} 宏则需要替换
替换规则:
ad_imp 表示广告曝光
endcard_imp 表示endcard曝光
ad_detail_imp 表示详情页曝光
2) 存在 {WIN_PRICE} 宏则需要替换
替换规则:
媒体侧实际竞得价格,单位是分,需要加密,加密规则在协议里有描述,详见广告请求协议章节价格加密
3) 存在 {AD_WIDTH} 宏则需要替换
替换规则:
广告展示的宽度,单位是 px
4) 存在 {AD_HEIGHT} 宏则需要替换
替换规则:
广告展示的高度,单位是 px
示例https://api.yky.qq.com/api/v1/impression?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEblzaOYvY
f4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNsO5gLKHp
TXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8zlFvGyE5
_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k_tLJVdJ
o8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUxj4Edawg
S6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&media_app_id=10069&platid=1&position_id=10103&is_test=2&imp_event_type={IMP_EVENT_TYPE}&fsq_score=MQ==&fsq_risk_type=MA==&win_price={WIN_PRICE}&ad_width={AD_WIDTH}&ad_height={AD_HEIGHT}
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.2. 点击上报#

点击上报:在曝光广告之后,用户在可点击区域产生了点击行为,需及时进行点击上报;上报是有时效性的( 时效性为3小时 ),超过时效性,则该点击无效。点击行为必须要进行上报。

对于同一个广告,上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应数据中的
Tracking -> click_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 {CLICK_EVENT_TYPE} 宏则需要替换
替换规则:
ad_click 表示广告点击
endcard_click 表示endcard点击
ad_detail_click 表示详情页点击
swipeup 表示上滑打开
2) 存在 {PLAY_DURATION} 宏则需要替换
替换规则:视频广告取点击视频时已播放时长替换,单位是ms
3) 存在 {DELIVERY_TYPE} 宏则需要替换
替换规则:
deeplink 表示实际为deeplink跳转
download 表示实际为直接下载
landing_page 表示实际为跳转落地页
other 表示跳转其他页
示例https://api.yky.qq.com/api/v1/click?request_id=180578a2d2dfe3eb3def
407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEblzaOYvYf4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1k
xm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNsO5gLKHpTXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKV
yRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8zlFvGyE5_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E
8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k_tLJVdJo8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXr
mI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUxj4EdawgS6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&media_app_id=10069&platid=1&position_id=10103&is_test=2&click_event_type={CLICK_EVENT_TYPE}&fsq_score=MQ==&fsq_risk_type=MA==&play_duration={PLAY_DURATION}&delivery_type={DELIVERY_TYPE}
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.3. 下载上报#

下载上报:用户在可点击区域产生了点击行为,并且触发了下载,需及时进行下载上报,由于下载的情况较复杂,并且上报的逻辑居多,需要注意其中的宏替换时机,上报是有时效性的,超过时效性( 时效性为3小时 ),则该下载无效。下载上报Android端是可选的,iOS端不用上报。

上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应数据中的
Tracking -> download_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 {DOWNLOAD_EVENT_TYPE} 宏则需要替换
替换规则:
ad_apk_download_start 表示安装包开始下载
ad_apk_download_pause 表示安装包暂停下载
ad_apk_download_resume 表示安装包继续下载
ad_apk_download_cancel 表示安装包取消下载
ad_apk_download_complete 表示安装包完成下载
ad_apk_download_consume 表示安装包下载耗时
ad_apk_download_fail 表示安装包下载失败
ad_apk_download_start_exist 表示点击广告,触发的安装包下载任务正在进行中
ad_apk_download_start_done 表示点击广告,触发的安装包下载任务在本地已有下完的APK
2) 存在 {DOWNLOAD_SCENE_TYPE} 宏则需要替换
替换规则:
ad_download 表示广告下载
ad_detail_download 表示详情页下载
示例https://api.yky.qq.com/api/v1/download_notice?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUII
vd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEblzaOYvYf4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbr
oOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNsO5gLKHpTXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGi
vxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8zlFvGyE5_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiH
uD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k_tLJVdJo8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28O
u-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUxj4EdawgS6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&is_test=2&download_event_type={DOWNLOAD_EVENT_TYPE}&download_scene_type={DOWNLOAD_SCENE_TYPE}&fsq_score=MQ==&fsq_risk_type=MA==
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.4. 安装上报#

安装上报:用户成功下载完成,并且触发了安装,需即时进行安装上报,由于安装的情况较复杂,并且上报的逻辑居多,我们需要注意其中的宏替换时机,上报是有时效性的( 时效性为3小时 ),超过时效性,则该安装无效。安装上报Android端是可选的,iOS端不用上报。

上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应数据中的
Tracking -> install_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 {INSTALL_EVENT_TYPE} 宏则需要替换
替换规则:
ad_apk_install 表示拉起安装
ad_apk_install_succ 表示安装成功
ad_apk_install_cancel 表示取消安装
ad_apk_install_background 表示拉起安装时应用在后台
示例https://api.yky.qq.com/api/v1/install_notice?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEblzaOYvYf4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN
7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNsO5gLKHpTXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDU
JcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8zlFvGyE5_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R
_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k_tLJVdJo8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZx
S6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUxj4EdawgS6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&is_test=2&install_event_type={INSTALL_EVENT_TYPE}&fsq_sc
ore=MQ==&fsq_risk_type=MA==
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.5. 关闭上报#

关闭上报:关闭广告时(可能是用户点击了关闭按钮,也可能是倒计时结束了自动关闭),需及时进行关闭上报,上报是有时效性的( 时效性为3小时 ),超过时效性,则该关闭无效。关闭上报是可选的。

上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应接口里面的
Tracking -> close_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 {SKIP_EVENT_TYPE} 宏则需要替换
替换规则:
0 表示自动关闭广告
1 表示手动关闭广告
2 表示手动关闭endcard
2) 存在 {PLAY_DURATION} 宏则需要替换
替换规则:视频广告取关闭视频时已播放时长替换,单位是毫秒(ms)
示例https://api.yky.qq.com/api/v1/close_notice?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEb
lzaOYvYf4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNs
O5gLKHpTXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8z
lFvGyE5_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k
_tLJVdJo8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUx
j4EdawgS6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&is_test=2&skip_event_type={SKIP_EVENT_TYPE}&fsq_score=MQ==&fsq_risk_type=MA==&play_duration={PLAY_DURATION}
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.6. 播放上报#

播放上报:视频类的广告在播放的时候,则即时进行播放上报,播放上报是根据播放进度进行上报的,所以需要注意其中的宏替换时机。播放上报是可选的。

上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应数据中的 Tracking -> play_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换存在 {PLAY_EVENT_TYPE} 宏则需要
替换规则:
ad_apk_play_start 表示视频开始播放
ad_apk_play_one_quarter 表示视频播放至四分之一
ad_apk_play_one_half 表示视频播放至二分之一
ad_apk_play_three_quarter 表示视频播放至四分之三
ad_apk_play_complete 表示视频播放完成
ad_apk_play_pause 表示暂停视频播放
ad_apk_play_resume 表示从暂停恢复播放
ad_apk_play_reward 表示激励发放
示例https://api.yky.qq.com/api/v1/play_notice?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEblzaOYvYf4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNsO5gLKHpTXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8zlFvGyE5_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k_tLJVdJo8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUxj4EdawgS6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&is_test=2&play_event_type=**{PLAY_EVENT_TYPE}**&fsq_score=MQ==&fsq_risk_type=MA==
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.7. 曝光结束上报#

曝光结束上报:曝光后,第一次不满足有效曝光条件时即为曝光结束,需及时进行曝光结束上报,上报是有时效性的( 时效性为3小时 ),超过时效性,则该曝光结束无效。曝光结束上报是可选的。

有效曝光条件判断请参考7.1. 曝光上报。

上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应数据中的
Tracking -> imp_end_track_urls 数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 {IMP_EVENT_TYPE} 宏则需要替换
替换规则:
ad_imp 表示广告曝光
endcard_imp 表示endcard曝光
ad_detail_imp 表示详情页曝光
2) 存在 {IMP_DURATION}宏则需要替换
替换规则:
广告展示到曝光结束时的时长,单位是毫秒(ms)
示例https://api.yky.qq.com/api/v1/impression_end?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEblzaOYvY
f4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNsO5gLKHp
TXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8zlFvGyE5
_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k_tLJVdJ
o8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUxj4Edawg
S6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&media_app_id=10069&platid=1&position_id=10103&is_test=2&imp_event_type={IMP_EVENT_TYPE}&fsq_score=MQ==&fsq_risk_type=MA==&imp_duration={IMP_DURATION}
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.8. 竞价上报#

竞价上报:当我们的广告参与竞价后,需要进行竞价上报。

一般来说,无论我们的广告竞胜还是竞败,都要进行竞价上报。

请求方式HTTP+GET
如何获取链接广告响应数据中的 nurl 字段
(v2.1.6及之后版本提供该字段;v2.1.8及之后版本提供win_code、adn_id、winner_bid_price的上报功能)
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) 存在 WIN_CODE 宏则需要替换
竞得成功或者失败原因:需替换为如下枚举值
1 表示YKY竞得
2711 表示竞争力不足,YKY未竞得
2712 表示返回超时,YKY未竞得
2713 表示无广告回包,YKY未竞得
2714 表示其他原因导致YKY未竞得
2) 存在 ADN_ID 宏则需要替换
竞胜方渠道:需替换为如下枚举值
0 表示YKY竞得
1 表示输给YKY其他资源位,
2 表示输给第三方ADN,
3 表示输给自售广告主
3) 存在 WINNER_BID_PRICE 宏则需要替换
表示本次竞胜方出价, 替换规则如下:
本次竞胜方出价,单位是分,需要加密,加密规则在协议里有描述,详见6.3.6.
示例https://api.ykyrtbsz.qq.com/api/v1/win_notice?request_id=2419fc8c-b8e0-4bf8-93c9-e7f0b7c1880c¶m=OO3G-0gZT13rd3Afz9aH36Suj_UMlZtJ1054JOSbochgia0X-Sqkl1oJephvxwj7GWqcygFgRl5m9T1V3zfLBnrNKX4o7ziIQD_7sItCOJKwJq-wxxiSC-4jhMyoJ0HrNd57KoKEm90U7SHsaMIjBPtOZ5JREmDOpac1PQjlY9FJSmE8lNhLgD51uns1Gnyxt7MUA112ND9QBtUWPrwqBUuHpaaO_dOm7BXdw72a3fuaun2bktJptmSZeOzchfpjQ57-jv8gP_zKfdD1xNgFgziiNDaUaHKxJhZcVC9-TATXPvaOO7X40cEylGOpVNBX7fIDKMjM71gSA0e9ZRgt7qB-ADYnWc8zZ9f3A_Nuz-bYs0p2v30AfFw4qT4Vk_h8mvOjKe80MmU73fjAU3D_qAvoNXGIAq3KtNwOFTVOmMBdMc97ZdBpcTbo5jBfN0-Dy1xTjKf0lxdUU3C9KfqMn65JW8I=&is_test=2&win_code=**_WIN_CODE_**&adn_id=**_ADN_ID_**&winner_bid_price=**_WINNER_BID_PRICE_**&fsq_score=NQ==&fsq_risk_type=MA==
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}

7.9. 跳转结果上报#

跳转结果上报:广告点击时,执行跳转时,需及时进行跳转结果上报,上报是有时效性的(时效性为3小时),超过时效性,则该跳转结果无效。跳转结果上报是可选的。

上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。

请求方式HTTP+GET
如何获取链接广告响应接口里面的
Tracking -> jump_result_track_urls数组
注意:在发送GET请求前,请对url 进行encode,不encode可能会因为url有特殊字符导致网络请求发送失败
所需宏替换1) DELIVERY_TYPE 跳转类型宏
替换规则:
1 表示deeplink
2 表示landingpage
3 表示下载(安卓端是下载apk,iOS端跳转至App Store目标应用详情页)
4 表示其他类型
2) JUMP_RESULT 跳转结果宏
替换规则:
1 表示成功
2 表示失败
示例https://api.yky.qq.com/api/v1/jump_result?request_id=180578a2d2dfe3eb3def407257bec5b5¶m=sJDmecaaLii_Mqee-FU2emUPuD_FA_QBXIQLhBLdgzi4Vvo5Vk-UvCQaUIIvd2rBchkLDm3iQGmD6H00w1c6JeiU6TVajVsoy-gQoL0pnEb
lzaOYvYf4N7iW7pR0KfuFY9mqIgOeaZh6AJRkemp-cCZjeW4OiNa0mbVqSfkrKcS_NKoEpgFf-w5DBD1gyncob0gKU9aUeLPRfpvzN7JJ-ovrDj_GRQSHGJEXQ1d7giL8k1kxm-BQ3yRiNWS-jRHUPoJWPTBlcuhd0hzYcFzINXX5kjPuX_XVv1C3FIewMdyixIT82bMMDTJWw5hbroOgmCeQgYwW9PSwRPkv5MgNs0DabQCOS2na7pIVAIHwG0XNs
O5gLKHpTXmXv_xu-EKeDxFFEWgrEsxoiI35iYKSj-ajBZTrR4hT_yrsOhrV8r8AHl5_UFoAPGanC6aShTgc1fdhif35a3vMlHcVHDUJcxOMfpSeS0Bjg8yL9enFNVRMDxzKVyRJm241fm9dxSQeYlJ40QnZaq4k75lvpRbdxlCzAHMeACBQaILL4KrbX-Kiipqatk1tbCRkJnaDuGivxOzI9iVrgJ7umypGRKMIQsDjCPP-JZBlT7kkFSghZVWUY8z
lFvGyE5_SuCodOXyMD_LdrWe9QCwqXt6IPnEM_TLG6dNj8HYdffkBa50iOe3GxWrCjjplP_RZEf9DIJQ_xx8isJrhi0VokQ8vst35R_jP6MH-mPh3Y9pVCa13jquvq9HPA2E8EMPdclsMBjuzbi1OpC1oh1KfSgt0D_wV2AkQmYfLPngUQ1V0_FeRZwgKCTMEAYlDul5NPhHzc2wiHuD5H8hWh6ZG42fyiJ6nVetlzhcDGlDj6i_nNsVGuj8aFUg3k
_tLJVdJo8llByqIoCuOK2s-k6tbnMztlCfIzXUR7pu-z7nq0-hg8gYwbqdwUa1MhmVGHIjpR0IqPQZrCoj_Trp0PSH_r2xvq_AjCZxS6gNPSET07t-GsdynQOD74IKzkaYXrmI6wMB7nA1blHVFLqpOqeteUvXUBHk-MAvmqTAlZG-4qEukiNpBBVh1gxRLYl2uffd-9n1wFUxY28Ou-yoUeUCgpNCll3seeZ-RZ3WTTyDBsPjZ4fGLKCkcC4NbbUx
j4EdawgS6QCVtcvQ3-fJMYhhhGX6IbOo_I6sE8FN0B_dG&is_test=2&jump_result=JUMP_RESULT&delivery_type=DELIVERY_TYPE&fsq_score=MQ==&fsq_risk_type=MA==
返回结果{
"code" : 0,   // 0表示成功,其他值表示失败
"msg" :  ""   // 描述信息
}