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_id和conversion_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__×tamp=__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"
}
]
}