广告数据洞察 (Ad Insights)

V1.1

loading

本节将为您介绍广告数据洞察 (Ad Insights) 相关接口。 Marketing API 支持查询帐号层级、推广计划层级、广告组层级等多个维度的日报表和小时报表，同时还支持基于性别、年龄、地域三个定向维度的广告人群分析。关于广告数据洞察更详细的介绍可以参考【广告数据洞察】章节。

特别注意：联盟广告位级别报表（REPORT_LEVEL_UNION_POSITION）目前仅灰度开放。

• 获取日报表（daily_reports/get）

所属权限（scope）：Ads Insight

• 获取小时报表（hourly_reports/get）

所属权限（scope）：Ads Insight

• 获取定向标签报表（targeting_tag_reports/get）

所属权限（scope）：Ads Insight

• 获取商品库报表（product_catalogs_reports/get）

所属权限（scope）：Ads Insight

获取日报表

全部接口

V1.1

loading

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。

请求参数

标有*的参数为必填项

使用说明

1. level 取值 REPORT_LEVEL_PRODUCT_CATELOG 时，group_by 的使用规则如下： 1）按商品信息层级聚合：单选，支持按如下层级聚合，商品 id（product_outer_id），商品系列（product_set_id），品牌 id（brand_id），店铺 id（shop_id），一级类目 id（first_category_id），二级类目 id（second_category_id ），三级类目 id（third_category_id），例如：希望获取商品系列的整账户表现，可指定 group by product_set_id ； 2）按数据层级聚合：单选，支持按如下数据层级聚合，账户（不指定时默认为账户），计划（campaign_id），广告组（adgroup_id），广告（ad_id），例如：希望获取计划层级的商品库报表，可指定 group by campaign id ； 3）按商品信息层级（单选）x 数据层级（单选）聚合进行，例如：希望获取商品*计划粒度的报表数据，可指定 groupby product_outer_id campaign id。
2. 商品报表仅支持查看指定商品库下，单日花费最高的 10000 条商品的效果数据。
3. 该接口所有涉及金额的字段，单位为分。
4. 腾讯广告投放平台升级全新的指标体系，请及时改造。详细升级情况及新老指标体系映射关系请查看公告[腾讯广告投放端-指标升级指引]。当您使用新的指标调用方式时（即 adq_accounts_upgrade_enabled 传 true），您可以请求新指标体系内指标。
5. 报表数据量限制：page * pageSize 小于等于 20000, 超过 20000 条数据，请使用创建异步报表任务接口。

请求示例

curl -G 'https://api.e.qq.com/v1.1/daily_reports/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'level=ADGROUP' \
-d 'date_range={"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}' \
-d 'filtering=[{"field":"adgroup_id","operator":"EQUALS","values":[111111111]}]' \
-d 'group_by=["date"]' \
-d 'order_by=[{"sort_field":"impression","sort_type":"ASCENDING"}]' \
-d 'page=1' \
-d 'page_size=10' \
-d 'fields=[]' 
					

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "date": "2017-05-01",
                "campaign_id": "<CAMPAIGN_ID>",
                "adgroup_id": "<ADGROUP_ID>",
                "ad_id": "<AD_ID>",
                "cost": 1200,
                "image_click": 0,
                "like_or_comment": 0,
                "app_payment_count": 0,
                "app_payment_amount": 0,
                "app_installation": 0,
                "activation": 0,
                "click": 1200,
                "conversion": 0,
                "download": 0,
                "follow": 0,
                "impression": 12000,
                "order_placement": 0,
                "register": 0,
                "reservation": 0,
                "share": 0
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

curl -G 'https://api.e.qq.com/v1.1/hourly_reports/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'level=CAMPAIGN' \
-d 'date_range={"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}' \
-d 'filtering=[{"field":"campaign_id","operator":"EQUALS","values":["<CAMPAIGN_ID>"]}]' \
-d 'group_by=["hour"]' \
-d 'order_by=[{"sort_field":"impression","sort_type":"ASCENDING"}]' \
-d 'page=1' \
-d 'page_size=10' \
-d 'fields=[]' 
					

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "hour": 2,
                "campaign_id": "<CAMPAIGN_ID>",
                "adgroup_id": "<ADGROUP_ID>",
                "ad_id": "<AD_ID>",
                "cost": 130,
                "image_click": 0,
                "like_or_comment": 0,
                "activation": 0,
                "app_payment_count": 0,
                "app_payment_amount": 0,
                "app_installation": 0,
                "click": 120,
                "conversion": 0,
                "download": 0,
                "follow": 0,
                "impression": 12000,
                "order_placement": 0,
                "register": 0,
                "reservation": 0,
                "share": 0
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

curl -G 'https://api.e.qq.com/v1.1/targeting_tag_reports/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'type=GENDER' \
-d 'level=CAMPAIGN' \
-d 'date_range={"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}' \
-d 'filtering=[{"field":"campaign_id","operator":"EQUALS","values":[456792]}]' \
-d 'group_by=["date"]' \
-d 'order_by=[{"sort_field":"impression","sort_type":"ASCENDING"}]' \
-d 'page=1' \
-d 'page_size=10' 
					

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "date": "2017-04-25",
                "gender": "FEMALE",
                "cost": 1200,
                "activation": 0,
                "click": 1200,
                "conversion": 0,
                "download": 0,
                "impression": 12000,
                "register": 0,
                "reservation": 0
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

curl -G 'https://api.e.qq.com/v1.1/product_catalogs_reports/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'date_range={"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}' \
-d 'filtering=[]' \
-d 'group_by=[]' \
-d 'order_by=[]' 
					

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "adgroup_id": "<ADGROUP_ID>"
            }
        ]
    }
}