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

快投报表规则与字段说明  |  快投报表服务

快投报表服务 (KuaitouReportService)

数据类型

KuaitouReportRequestType

属性名 类型 说明 限制
startDate Date 统计开始时间 必填,格式参考:2010-08-01T00:00:00.000
endDate Date 统计结束时间 必填,格式参考:2010-08-01T00:00:00.000
reportType Integer 报告类型 必填
0 :账户报告
1 :计划报告
2 :推广组报告
3 :关键词报告
99: 高级样式,查询新无线样式请传该值
sumType Integer 统计时间单位 选填,默认值为 1
取值范围:
1 :日报
2 :周报
3 :月报
statRange Integer 统计范围 选填,默认值为 0
0 :账户范围
1 :计划范围
2 :推广组范围
3 :关键词范围
注意:统计范围不能细于当前的统计粒度,例如统计粒度为计划,则统计范围不能细到推广组
statIds Long[] 统计范围下的 id 集合 选填,根据 StatRange 的不同类型填写不同 id。
默认 NULL ,表示统计范围为全账户;
statRange 为 1 时填写计划 id;
statRange 为 2 时填写推广组 id;
statRange 为 3 时填写关键词 cpcid;
deviceType Integer 推广平台 选填,默认为0
取值范围:
0:全部设备
1:计算机
2:移动设备
idOnly Boolean 是否只需要 id 选填;默认为 false
取值范围:
true :只获取 id
false :既获取 id 也获取字面
itemIds int[] 指定绩效数据 必填
取值范围: 1 2 3 4 5
1: 点击数
2: 消耗
3: 展示数
4: 点击率
5: 点击均价
styleType Integer 样式类型 必填
取值范围: 0 1 2 3 30003 30004 30005 30080 30081
0: 全部样式
1: 商品轮展样式
2: 商品聚合样式
3: 单品直达样式
30003: 快投无线商品轮展
30004: 快投无线商品聚合
30005: 快投无线单品直达
30080: 快投无线图文卡片样式
30081: 快投无线卡片增强样式
Opt Opt 无效属性

KuaitouDetailDataType

属性名 类型 说明 限制
styleType String 样式类型
startDate Date 统计开始时间
endDate Date 统计结束时间
accountName String 账户
cpcId Long 关键词Id
cpcName String 关键词
cpcGroupId Long 推广组Id
cpcGroupName String 推广组
cpcPlanId Long 推广计划Id
cpcPlanName String 推广计划
consume Double 消耗
click Long 点击数
pv Long 展示
ctr Double 点击率
avgPrice Double 平均价格
Opt Opt 无效属性

KuaitouSummaryDataType

属性名 类型 说明 限制
sumConsume Double 汇总消耗
sumClick Long 汇总点击数
sumPv Long 汇总展示量
sumCtr Double 汇总点击率
sumAvgPrice Double 汇总平均价格
Opt Opt 无效属性

KuaitouReportResponseType

属性名 类型 说明 限制
kuaitouDetailDataType KuaitouDetailDataType [] 明细数据列表
kuaitouSummaryDataType KuaitouSummaryDataType 汇总数据
Opt Opt 无效属性

接口描述

getKuaitouReport

方法说明:获取。
输入信息: getKuaitouReportRequest
说明如下 :

属性名 类型 说明 限制
getKuaitouReportRequest GetKuaitouReportRequest - -

返回信息: getKuaitouReportResponse

属性名 类型 说明 限制
getKuaitouReportResponse GetKuaitouReportResponse - -

快投报表限制

数据容量:

返回的数据不可超过 30 万条。

时间跨度:

报告时间跨度不得超过3个月,最早查询时间为2018年10月15日。

数据实时性:

当天上午10点之后可以获取昨天的数据。

查询次数:

每个账户每个接口每天最多调用2000次。

报告有效期:

1 周