腾讯广告

定向标签报表

本节将为您介绍如何获取定向标签报表。

定向标签报表支持以不同人群定向标签为维度查询您的广告投放数据。 Marketing API 当前只支持按以性别、年龄、地域三个维度的标签来查询365天内（含365天）的数据。通过定向标签报表接口，您可以了解到查看或点击过您的广告的用户在性别、年龄、地域等维度是如何分布的。

定向标签报表的请求路径为 targeting_tag_reports/get，您需要指定定向标签类型（type，目前可以是gender、age、region中的一个）、日期范围（date_range，要查询的数据周期起止日期）等字段以便完成查询。

例如，查询帐号123的推广计划111在2018年8月24日~2018年8月26日的人群性别分布情况，请求示例如下：

curl -G 'https://api.e.qq.com/v1.1/targeting_tag_reports/get' \
    -d 'access_token=<ACCESS_TOKEN>' \
    -d 'timestamp=<TIMESTAMP>' \
    -d 'nonce=<NONCE>' \
    -d 'type=GENDER' \
    -d 'level=REPORT_LEVEL_CAMPAIGN' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'date_range={"start_date":"2018-08-24","end_date":"2018-08-26"}' \
    -d 'filtering={"field":"campaign_id","operator":"EQUALS", "values": 111]}' \
    -d 'fields=["date","gender","impression","click","cost"]' \
    -d 'group_by=["date"]' \
    -d 'page=1' \
    -d 'page_size=10'

如果查询到数据，接口将响应类似如下示例数据：

{
    "code": 0, 
    "message": "", 
    "data": {
        "list": [
            {
                "date": "2018-08-24",
                "gender": "MALE",
                "impression": 12000, 
                "click": 1200, 
                "cost": 1200
            }
        ], 
        "page_info": {
            "total_num": 1, 
            "total_page": 1, 
            "page_size": 10, 
            "page": 1
        }
    }
}

以上数据表明推广计划111在2018年8月24日广告曝光均发生在男性用户上。关于定向标签报表接口的更详细用法，请参考接口清单-targeting_tag_reports。