API参考 | 实时报告服务
实时报告服务 (RealTimeReportService)
通过RealTimeReportService ,您可以下载帐户当天小时级别的消耗 、点击均价和点击数信息。
数据类型
RealTimeReportRequest
属性名 |
类型 |
说明 |
限制 |
hour |
Integer |
起始小时 |
必填,起始小时数值,取值范围0-23,例如要取2点至3点的数据,则赋值为2
因有一小时的延迟,若想取23时的数据,可于第二日23点前赋值23获取前一日数据
|
platform |
Integer |
推广平台 |
选填,默认为0
取值范围:
0:全部设备
1:计算机
2:移动设备
|
opt |
Opt |
可选字段 |
目前无效,用于扩展接口 |
RealTimeReportResponse
属性名 |
类型 |
说明 |
限制 |
accountid |
Long |
账户id |
- |
cost |
Double |
消耗,单位为分 |
- |
cpc |
Double |
点击均价,单位为分 |
- |
click |
Integer |
点击数 |
- |
opt |
Opt |
扩展属性 |
- |
SummaryDataRequestType
属性名 |
类型 |
说明 |
限制 |
platform |
Integer |
推广平台 |
选填,默认为0
取值范围:
0:全部设备
1:计算机
2:移动设备
|
date |
dateTime |
统计截至时间,格式参考:2018-01-08T00:00:00.000 |
必填,仅支持查询当日的数据(例如:输入2018-05-09T12:00:00.000,查询的时间为2018-5-9 00:00到2018-5-9 12:00的汇总数据);
实时数据与今日数据有一定时间的延迟,最终消耗数据以历史数据报告为准;
|
opt |
Opt |
可选字段 |
目前无效,用于扩展接口 |
AccountSummaryDataType
属性名 |
类型 |
说明 |
限制 |
accountid |
Long |
账户id |
- |
accountName |
String |
账户名 |
- |
cost |
Double |
消耗,单位为元 |
- |
cpc |
Double |
点击均价,单位为元 |
- |
click |
Integer |
点击数 |
- |
endDate |
dateTime |
截止时间 |
- |
opt |
Opt |
可选字段 |
目前无效,用于扩展接口 |
CpcPlanSummaryDataType
属性名 |
类型 |
说明 |
限制 |
accountid |
Long |
账户id |
- |
accountName |
String |
账户名 |
- |
cpcPlanId |
Long |
计划id |
- |
cpcPlanName |
String |
计划名 |
- |
cost |
Double |
消耗,单位为元 |
- |
cpc |
Double |
点击均价,单位为元 |
- |
click |
Integer |
点击数 |
- |
endDate |
dateTime |
截止时间 |
- |
opt |
Opt |
可选字段 |
目前无效,用于扩展接口 |
接口描述
getAccountReport
方法说明:获取今日小时级账户数据,数据有一小时的延迟。
输入信息: GetAccountReportRequest
说明如下 :
属性名 |
类型 |
说明 |
限制 |
realTimeReportRequest |
RealTimeReportRequest |
- |
- |
返回信息: GetAccountReportResponse
属性名 |
类型 |
说明 |
限制 |
realTimeReportResponse |
RealTimeReportResponse |
- |
- |
getAccountSummaryData
方法说明:获取今日汇总账户数据
输入信息: GetAccountSummaryDataRequest
说明如下 :
属性名 |
类型 |
说明 |
限制 |
summaryDataRequestType |
SummaryDataRequestType |
- |
- |
返回信息: GetAccountSummaryDataResponse
属性名 |
类型 |
说明 |
限制 |
accountSummaryDataType |
AccountSummaryDataType |
- |
- |
getCpcPlanSummaryData
方法说明:获取今日汇总计划数据
输入信息: GetCpcPlanSummaryDataRequest
说明如下 :
属性名 |
类型 |
说明 |
限制 |
summaryDataRequestType |
SummaryDataRequestType |
- |
- |
返回信息: GetCpcPlanSummaryDataResponse
属性名 |
类型 |
说明 |
限制 |
cpcPlanSummaryDataType |
CpcPlanSummaryDataType[] |
- |
- |