搜索推广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