搜狗首页  |   服务首页  |   客服热线:010-56898080

信息流推广  |  数据报告

说明: 此接口是信息流报告实时接口,通过此接口可获取包括:账户、计划、组、创意的消耗、展示等数据。
入门指导

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/iflow/report/getApiReports

请求参数体:

{
    "body": {
            "startDate": "",
            "endDate": "",
            "ifSum": true,
            "reportType":100,
            "statisticType":0
     },
    "header": {
        "adType": 3,
        "agentpassword": "",
        "agentusername": "",
        "apiusertype": "",
        "password": "",
        "token": "",
        "username": ""
    }
}
参数说明:
参数 类型 必须 说明
startDate String 开始日期,格式:yyyy-MM-dd,如2019-10-01
要求: 1) 不能超过今天
2) 不能超过1年前
endDate String 开始日期,格式:yyyy-MM-dd,如2019-10-01
要求:
1) 不能超过今天 2) 不能和开始日期跨度超过180天
3)查询今日数据和历史数据分开查询
ifSum Boolean 是否包含合计数据
true包含,false不包含
默认true
reportType Integer 查询的数据层级
账户(100)
计划(101)
组(102)
创意(103)
statisticType Integer 数据汇总方式
按日:0
合计:4
adType Integer 信息流,adType=3

响应结果:

{
    "data": {
        "accountId": 0,
        "reportDtos": [
            {
                "accountId": 0,
                "clickNumbers": 0,
                "consumes": 0.00,
                "cpc": 0.00,
                "cpm": 0.00,
                "ctr": 0.00,
                "date": "",
                "groupId": 0,
                "groupName": "",
                "ideaId": 0,
                "planId": 0,
                "planName": "",
                "pv": 0
            }
        ],
        "reportSumDto": {
            "accountId": 0,
            "clickNumbers": 0,
            "consumes": 0.00,
            "cpc": 0.00,
            "cpm": 0.00,
            "ctr": 0.00,
            "groupId": 0,
            "groupName": "",
            "ideaId": 0,
            "planId": 0,
            "planName": "",
            "pv": 0
        }
    },
    "desc": "",
    "failures": [],
    "oprs": 0,
    "oprtime": 0,
    "quota": 0,
    "rquota": 0,
    "status": 0
}
参数说明:
参数 类型 说明
accountId Long 账户ID
reportDtos jsonArray 数据详情内容
reportSumDto json 数据合计内容
如果请求参数ifSum为false,此项为null
date String 日期
planId Long 计划id
当查询层级为账户reportType=100时,为空
planName String 计划名称
如果计划被删除,显示:已删除计划
groupId Long 推广组id
当查询层级为账户或计划reportType=100或101时,为空
groupName String 推广组名称
ideaId Long 创意id
当查询层级为创意时才存在
pv Long 展示数
查询今日数据没有展示数
clickNumbers Long 点击数
consumes double 消耗,单位:元
ctr double 点击率
cpc double 每次点击的费用
cpm double 每千次展现费用