快投报表服务 (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 周