一、功能概述
广告探测器是 Taku 开发者后台「高级功能」下的能力模块,用于将广告展示时的素材截图与对应的广告链路信息留存到平台,便于开发者在事后通过多维度筛选或以图搜图的方式查询已展示的广告素材。
功能构成
|
模块 |
说明 |
|
素材收集展示 |
展示已采集的广告素材列表,并查看每条记录对应的广告与设备信息。 |
|
以图搜图 |
上传一张图片,系统通过图片特征匹配返回最相似的已采集素材及其对应的广告与设备信息。 |
流程概述
-
开发者在广告展示回调中获取截图,再调用素材上报 API将素材截图上报到服务端进行存储展示;
-
开发者在广告探测器页面通过多维度筛选浏览素材数据列表,或通过「以图搜图」入口上传客诉图片匹配定位问题素材来源
二、操作指引
2.1 如需使用请联系运营开通功能权限
广告探测器为开发者级别的增值能力,如需使用请联系对接的 Taku 商务 / 运营同学申请开通。
2.2 素材收集展示功能
2.2.1 进入广告探测器主页面
登录 Taku 开发者后台,依次点击「高级功能 → 广告探测器」,进入广告探测器主页面。

2.2.2 数据列表字段说明
数据列表以记录形式展示满足查询条件的素材,每条记录包含一张缩略图和对应的广告 / 设备信息字段。各字段含义如下:
|
列名 |
字段说明 |
|
上报时间 |
素材上报时间。 |
|
素材缩略图 |
截图缩略图,点击可查看截图大图 |
|
系统平台 |
Android / iOS |
|
应用 |
开发者已在后台创建的应用 |
|
广告位 |
所选应用下的广告位 |
|
广告类型 |
聚合中的具体广告源 |
|
广告平台 |
广告平台渠道(如 Pangle、AdMob、Mintegral 等) |
|
广告源 |
具体的广告源 |
|
设备 ID |
设备唯一标识 |
|
Taku Request ID |
Taku 发起广告加载时的请求 ID |
|
广告平台 Creative ID |
广告平台侧的素材 ID |
|
请求时间 |
广告请求发起时间 |
|
填充时间 |
广告填充获取时间 |
|
展示时间 |
广告展示 / 曝光时间 |
2.3 以图搜图功能
以图搜图用于在拥有一张客诉截图或手机翻拍照片时,快速从平台已采集的素材库中匹配出最相似的素材记录,从而定位广告平台、广告源和设备。匹配算法对截图裁剪、分辨率差异以及手机翻拍引入的摩尔纹、角度偏移具备一定容忍度,但为了保证匹配成功率,建议尽量按照以下要求进行拍摄:
-
拍照时将需要搜索的内容填满整个画面
-
尽量减少反光
-
像素尽量高
2.3.1 进入以图搜图入口
在广告探测器主页面点击右上方「以图搜图」按钮,会以弹窗 / 子页面的形式打开图片上传界面。


2.3.2 上传待匹配图片
在上传区域选择本地图片,或将图片拖拽到上传框内。支持的格式为 JPG / PNG,单张图片大小不超过 5MB,既支持系统截图也支持手机拍照得到的照片。
2.3.3 查看匹配结果
匹配完成后会返回结果页。结果页会自动清除主页面的其他筛选项,仅展示与本次搜索相关的素材:
-
所有匹配度为 100% 的素材(即与上传图片高度一致的留存截图)。
-
若不足时,会补充匹配度未到 100% 的相似素材,整体返回 匹配度Top 3~5 张候选截图。
结果以列表形式展示,字段与「素材收集展示」中的数据列表完全一致,包括缩略图、广告平台、广告源、设备 ID、各类时间戳等。点击缩略图同样可查看截图详情。

2.3.4 常见问题
|
问题 |
说明 / 处理建议 |
|
|
上传图片提示文件过大 |
检查图片是否超过 5MB,可使用截图工具或图片压缩后再上传。 |
|
|
上传图片提示格式不支持 |
当前仅支持 JPG / PNG 格式,请先转换格式。 |
|
|
搜索结果为空或匹配度普遍偏低 |
可能原因:(1) 该素材未被采集(对应应用 / 广告平台 / 广告样式未启用监测);(2) 已超过素材存储周期;(3) 客诉图片与原始展示画面差异过大(例如二次编辑、裁切过多)。 |
|
|
同一张图返回多条 100% 匹配记录 |
属于正常现象——该素材在不同设备 / 不同时间被多次展示,分别留存了独立的展示记录,可据此进一步定位具体设备。 |
|