入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

点击追踪报表(Tracking Reports)

V1.1

loading


本节将为您介绍如何获取点击追踪报表,更详细的介绍可以参考【点击追踪报表】章节。

所属权限(scope):Ads Insight


点击追踪报表

tracking_reports/get

GET

*为必填项
名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
date_range*
struct 日期范围
start_date*
string 开始投放日期,日期格式:YYYY-MM-DD,且日期小于等于 end_date
字段长度为 10 字节
end_date*
string 结束投放日期,日期格式:YYYY-MM-DD,大于等于今天,且大于等于 begin_date ;如果希望长期投放,传空字符串
字段长度最小 0 字节,长度最大 10 字节
time_granularity
enum 时间粒度,默认小时报表,[枚举详情]
枚举列表:{ DAILY, HOURLY }
promoted_object_type
enum 推广目标类型,[枚举详情]
枚举列表:{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION }
promoted_object_id
string 推广目标 id,详见 [查询推广目标 id]
字段长度最小 0 字节,长度最大 128 字节
feedback_url
string 转发点击的 url 地址,小于 1024 个英文字符
字段长度最小 0 字节,长度最大 1024 字节
page
integer 搜索页码,默认值:1
最小值 1,最大值 99999
page_size
integer 一页显示的数据条数,默认值:10
最小值 1,最大值 100

curl -G 'https://api.e.qq.com/v1.1/tracking_reports/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'date_range={"start_date":"2017-09-10","end_date":"2017-10-10"}' \
-d 'time_granularity=HOURLY' \
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_APP_IOS' \
-d 'feedback_url=https://www.tencent.com/tracking' \
-d 'page=1' \
-d 'page_size=10' 
					
名称 类型 描述
list
struct[] 点击追踪报表
date
string 日期,日期格式:YYYY-MM-DD
hour
number 整数
raw_clicks
integer 转发点击数
1min_clicks
integer 1 分钟内成功转发的点击数
2min_clicks
integer 2 分钟内成功转发的点击数
15min_clicks
integer 15 分钟内成功转发的点击数
request_fail
integer TSA 侧点击转发发送失败的点击量
response_fail
integer TSA 侧点击转发正常,但接受侧无响应的点击量
http_status_error
integer TSA 侧点击转发,http_status 错误量
other_error
integer 其他未点击转发成功的点击量
source_type
enum 配置来源,[枚举详情]
page_info
struct 分页配置信息
page
integer 搜索页码
page_size
integer 一页显示的数据条数
total_number
integer 总条数
total_page
integer 总页数
{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "date": 20171001,
                "hour": 13,
                "raw_clicks": 1555,
                "1min_clicks": 14,
                "2min_clicks": 29,
                "15min_clicks": 512,
                "request_fail": 30,
                "response_fail": 20,
                "http_status_error": 2,
                "other_error": 1
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}