用户行为数据上报
每种用户行为尽量都上报,曝光、点击行为必须要进行上报。
目前存在两种宏,一种是带大括号{}的,一种是带下划线的。所有宏均需替换,例如:根据实际情况,将曝光链接{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. 播放上报播放上报:视频类的广告在播放的时候,则即时进行播放上报,播放上报是根据播放进度进行上报的,所以需要注意其中的宏替换时机。播放上报是可选的。
上报失败的话可进行重复上报直至成功,如果已经上报成功,仍重复上报的则判定为无效上报。
#
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. 竞价上报竞价上报:当我们的广告参与竞价后,需要进行竞价上报。
一般来说,无论我们的广告竞胜还是竞败,都要进行竞价上报。
#
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" : "" // 描述信息 } |