跳转至

API转化追踪工具列表查询

通过该接口可以查询监控链接

请求地址

https://openapi.aiclk.com/openapi/v1/conv/targeturl_monitor/list

所属权限

ads_read

请求方式

GET

请求参数

Url中添加如下参数:

字段名 类型 是否必须 描述
account_id int 广告主ID(广告投放平台的userID)
conversion_type string 转化类型,需和adgroup_id一起使用
允许值:
APP内部转化:API_DOWNLOAD
落地页转化:API_LANDING_PAGE
keywords string 模糊查询的关键词
adgroup_id int 关联的单元ID,返回适合该单元的监控链接
需和conversion_type一起使用
click int 上报类型
允许值:
未激活,无上报:0
激活,上报成功:1
未激活,上报失败:2
conversion_goal int 转化目标 允许值:未知:-1,激活:0,注册:1 ...(具体可参考api对接文档中的op2值)
deeplink string 查询deeplink链接
show_share int 是否展示被共享链接 0:不展示 1:展示,默认为1
app_package string 查询app包名
page int 页数,默认:1
page_size int 每页大小,默认:10

说明:

adgroup_idconversion_type需要配合一起使用。可以筛选出符合所选单元且满足转化目标的监控链接列表
如果只传其中一个参数,将不会进行有效筛选

请求示例

curl -X GET \
  'https://openapi.aiclk.com/openapi/v1/conv/targeturl_monitor/list?account_id=1000002&page_size=10&page=1&keywords=&conversion_goal=3&adgroup_id=20195330&conversion_type=API_DOWNLOAD&click=1' \
  -H 'OGW_ACCESS_TOKEN: your_access_token'

返回字段释义

仅返回已激活且启用状态的监控链接

字段名 类型 描述
code int 返回码
message string 返回信息
data []object 返回结果
- create_time string 创建时间
- id string 监控链接id
- monitor_url string 监控链接
- name string 转化名称
- target_url int 监控链接
- deeplink string deeplink链接
- app_package string app包名
- type int 监控类型
枚举值:
落地页访问:1
应用下载:2
- update_time int 更新时间
- conversion_goal string 转化目标 允许值:未知:-1,激活:0,注册:1 ...(具体可参考api对接文档中的op2值)
- status int 状态。允许值:0-正常,1-删除
- share_status int 监控链接是否为共享链接 允许值:0-非共享,1-共享

返回示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "create_time": "2019-12-12T16:16:15+08:00",
            "id": 182,
            "monitor_url": "",
            "name": "落地页转化",
            "status": 0,
            "share_status": 0,
            "target_url": "http://pt.lovemaker.club/qutoutiao/ad/click?androidid=__ANDROIDID__&cid=__CID__&imei=__IMEI__&imeimd5=__IMEIMD5__&uid=__UID__&os=__OS__&tsms=__TSMS__&plan=__PLAN__&unit=__UNIT__&callback_url=__CALLBACK_URL__",
            "type": 1,
            "conversion_gaol": "6,5,2,0",
            "update_time": "0001-01-01T00:00:00Z"
        },
        {
            "create_time": "2020-04-07T14:37:23+08:00",
            "id": 214,
            "monitor_url": "",
            "name": "落地页",
            "status": 0,
            "share_status": 0,
            "target_url": "https://qbugreport.html5.qq.com/kbstat?urlid=3&cid=___CID___&imei=__IMEI__&os=__OS__&timestamp=__TS__&plan=__PLAN__&unit=__UNIT__&callback_url=__CALLBACK_URL__&imeimd5=__IMEIMD5__&tsms=__TSMS__&androidid=__ANDROIDID__&uid=__UID__",
            "type": 1,
            "conversion_gaol": "6,5,2,0",
            "update_time": "0001-01-01T00:00:00Z"
        }
    ]
}