所有文档

          搜索推广API

          LiveReportService

          通过LiveReportService,您可以获取"账户实时数据""计划实时数据""关键词实时数据";

          详细说明:

          账户实时数据支持:当日账户累计消费、当日账户累计点击、同时区分投放设备(全部、计算机、移动)、数据更新时间

          计划实时数据支持:当日计划累计消费、当日计划累计点击、区分投放设备(全部、计算机、移动)、数据更新时间

          关键词实时数据支持:30分钟内关键词排名、展现、点击、消费、同时区分投放设备、地域

          接口描述

          getAccountLiveData(账户和计划实时数据)

          • 方法说明

          请求账户和计划实时数据报告,请求时可选择获取账户数据或计划数据,返回本次请求数据

          • 输入信息:getAccountLiveDataRequest
          属性名 类型 说明 限制
          dataType Integer 账户/计划实时数据查询 (选填),默认值:1
          取值范围:
          1:账户数据
          2:计划数据
          device Integer 投放设备 (选填),默认值:0
          取值范围:
          0:全部设备
          1:仅计算机
          2:仅移动
          说明:仅在dataType = 2时有效

          返回信息:getAccountLiveDataResponse

          属性名 类型 说明 限制
          updataeTime String 数据更新时间 默认返回:
          日期类型,格式示例 "2017-08-23 15:00:00"
          userId Long 用户ID 默认返回
          campaignId Long 计划ID 请求计划时返回
          todayTotalClick Integer 今日累计点击 根据请求数据类型不同,分别返回账户累计点击或计划累计点击
          todayTotalCost Double 今日累计消费 根据请求数据类型不同,分别返回账户累计消费或计划累计消费

          getKeywordLiveData(关键词实时数据)

          • 方法说明

          请求关键词实时数据报告,通过上传关键词id、选取投放设备、选取区域信息,获取指定关键词的排名、展现、点击、消费

          • 输入信息:getKeywordLiveData Request
          属性名 类型 说明 限制
          dataType Integer 账户/计划实时数据查询 (选填),默认值:1 取值范围:
          1:账户数据
          2:计划数据
          keywordIds Long[] 关键词id,该集合为请求关键词实时数据的集合 必填
          数组内关键词个数上限为200
          device Integer 投放设备 (选填),默认值:0
          取值范围:
          0:全部设备
          1:仅计算机
          2:仅移动
          startTime datetime 起始时间 (选填)
          默认值:当前请求时间之前30分钟时间点(详情见下方举例)
          说明1: 请求时间即为当前起始时间
          说明2:起始时间仅支持当前时间之前的30分钟内数据
          说明3:时间格式支持两种:毫秒级时间戳(1505964544000)、标准时间格式(2017-09-21T10:40:05.671+08:00);
          举例:当前时间为2017-08-01 14:00:00,则startTime不能早于2017-08-01 13:31:00,不能晚于2017-08-01 14:00:00;默认值为当前时间30分钟之前的时间
          endTime datetime 结束时间 同起始时间,且不能早于startTime
          regionTarget Integer[] 地域 (选填)默认全部区域
          取值范围参考地域代码,地域代码个数上限为10

          参数特殊说明:

          限制条件除上述针对每个字段的限制,还有一个总体限制条件:

          keyword个数 device类别 区域个数 * 时间段 <= 10000

          其中:

          • device选择0时,则计算时device类别取值为2;
          • 时间段是指起始时间到结束时间之间的分钟个数;

          返回信息:getKeywordLiveData Response

          属性名 类型 说明 限制
          keywordId Long 关键词Id 默认返回
          regionId Integer 地域代码
          device Integer 投放设备类型
          minute datetime 数据时间 日期类型,格式示例"2017-08-23 15:00"
          leftRank Double 关键词在minute指定的分钟内左侧平均排名(计算机) 当返回排名信息时:"-1",代表无排名信息
          rightRank Double 关键词在minute指定的分钟内右侧平均排名(计算机) 当返回排名信息时:"-1",代表无排名信息
          topRank Double 关键词在minute指定的分钟内上方平均排名(移动设备) 当返回排名信息时:"-1",代表无排名信息
          bottomRank Double 关键词在minute指定的分钟内下方平均排名(移动设备) 当返回排名信息时:"-1"值,代表无排名信息
          leftShows Integer 关键词在minute指定的分钟内左侧展现次数(计算机) 当返回排名展现次数时:"0",代表无展现次数
          rightShows Integer 关键词在minute指定的分钟内右侧展现次数(计算机) 当返回排名展现次数时:"0",代表无展现次数
          topShows Integer 关键词在minute指定的分钟内上方展现次数(移动设备) 当返回排名展现次数时:"0";,代表无展现次数
          bottomShows Integer 关键词在minute指定的分钟内下方展现次数(移动设备) 当返回排名展现次数时:"0",代表无展现次数
          click Long 关键词在minute指定的分钟内的点击次数 当返回排名点击次数时:"0",代表无点击次数
          cost Double 关键词在minute指定的分钟内的消费 当返回排名点击次数时:"0",代表无点击次数
          上一篇
          SearchService
          下一篇
          KeywordService