API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.promkeywordreports.query 关键词推广报表
¥免费

通过此接口查询搜索推广的报表相关数据

公共参数
请求参数
名称 类型 是否必须 示例值 描述
promotionStartDateStringY2016-05-26查询开始时间(yyyy-MM-dd)
promotionEndDateStringY2016-06-26查询结束时间(yyyy-MM-dd )
pageNoStringN1页码 【每页数量,1到100之间,当前页码或者每页数量其中一个不填则当前页码默认1,每页数量默认为10】
pageSizeStringN10每页条数【每页数量,1到100之间,当前页码或者每页数量其中一个不填则当前页码默认1,每页数量默认为10】
响应参数
名称 类型 示例值 描述
keywordString手机关键词
pvString100展现量
clickString10点击量
clickPercentString0.8点击率
costString10花费
costPerClickString1平均点击花费
totalTransAmountString10总成交金额
directTransAmountString2直接成交金额
directTransNumberString2直接成交笔数
inputOutRatioString1.2投入产出比
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryPromKeywordReports>
      <promotionEndDate>2016-06-26</promotionEndDate>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <promotionStartDate>2016-05-26</promotionStartDate>
    </queryPromKeywordReports>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryPromKeywordReports": {
        "promotionEndDate": "2016-06-26",
        "pageNo": "1",
        "pageSize": "10",
        "promotionStartDate": "2016-05-26"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryPromKeywordReports>
      <costPerClick>1</costPerClick>
      <clickPercent>0.8</clickPercent>
      <totalTransAmount>10</totalTransAmount>
      <keyword>手机</keyword>
      <click>10</click>
      <inputOutRatio>1.2</inputOutRatio>
      <directTransAmount>2</directTransAmount>
      <pv>100</pv>
      <directTransNumber>2</directTransNumber>
      <cost>10</cost>
    </queryPromKeywordReports>
  </sn_body>
  <sn_head>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <totalSize>1</totalSize>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "1",
      "pageNo": "1",
      "totalSize": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryPromKeywordReports": [
        {
          "costPerClick": "1",
          "clickPercent": "0.8",
          "totalTransAmount": "10",
          "keyword": "手机",
          "click": "10",
          "pv": "100",
          "directTransAmount": "2",
          "inputOutRatio": "1.2",
          "directTransNumber": "2",
          "cost": "10"
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.aps 服务不可用 请联系苏宁技术人员
biz.advertise.querypromkeywordreports.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
biz.advertise.querypromkeywordreports.format-error:* 格式错误,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.apsop 服务不可用(系统异常) 请联系苏宁技术人员。
biz.advertise.querypromkeywordreports.invalid-biz:100 输入参数格式不正确 请输入正确参数。
biz.advertise.querypromkeywordreports.invalid-biz:101 商家编码不存在 请联系苏宁技术人员。
公共异常码
API工具
FAQ

Q:什么是推广计划日限额?

A:日限额为推广计划当日花费限额,推广计划当日消耗大于等于推广计划日限额时,推广计划将被下线。