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

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[] - -