接口文档SDK业务专题开发者工具

点击追踪报表

本节将为您介绍如何获取点击追踪报表。

点击追踪报表获取接口主要面向使用API方案一接入转化事件的广告主。通过调用这个接口,您可以借此了解腾讯广告平台给您发送的点击信息的成功率和及时性。接口提供基于天和小时维度的统计数据,并提供点击转发的成功率、点击转发服务的时延以及转发失败原因。

获取点击追踪报表的请求路径为tracking_reports/get,您可以通过帐号id、时间范围、标的物类型、标的物id、转发点击的url地址(定义转化事件时填写的url)、查询精度(时间粒度,可以取整天或分小时)来进行查询。

请求示例


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' 
					

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "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
        }
    }
}

特别注意

    • 2分钟内成功转发的点击数包含1分钟内成功转发的点击(即2分钟内成功转发的点击数=1分钟内成功转发的点击数+1到2分钟内成功转发的点击数);
    • 15分钟内成功转发的点击数包含1分钟、2分钟内成功转发的点击(即15分钟内成功转发的点击数=1分钟内成功转发的点击数+1到2分钟内成功转发的点击数+2到15分钟内成功转发的点击数)

关于点击追踪报表更详细的用法,可以参考 接口清单-tracking_reports