退出
热词搜索：
API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.baojieapi.query 宝洁api接口
￥免费

查询关键词的展现量、点击量、花费等数据报表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
companyCodeStringY70000123商家编码(商家在苏宁云台的编码，长度：8位)
countDateStringY2017-09-30查询时间(yyyy-MM-dd)
pageNoStringN1页码
pageSizeStringN10每页条数
响应参数
名称 类型 示例值 描述
countDateString20170929日期
userIdString429004445商户ID
keyWordString手机关键词
promotionNameString宝洁推广计划推广计划名称
posiotionNameString宝洁广告位广告位名称
goodsNameString宝洁商品商品名称
brandNameString宝洁品牌名称
showPvString1展现PV
showUvString1展现UV
clickPvString34点击PV
clickUvString30点击UV
bidPriceString100出价(单位：分)
avgCostString100平均点击消耗(单位：分)
curDealRateString1.2当日成交转化率
fifDealRateString0.215日成交转化率
directSubOrdString1直接提交订单数
directSubAmoString200直接提交订单金额(单位：分)
directDealOrdString4直接成交订单数
directDealAmoString5000直接成交订单金额(单位：分)
indirectSubOrdString23间接提交订单数
indirectSubAmoString400间接提交订单金额(单位：分)
indirectDealOrdString20间接成交订单数
indirectDealAmoString6000间接成交订单金额(单位：分)
materialUrlString//image2.suning.cn/uimg/b2c/newcatentries/0000000000-000000000101822318_1_220x220.jpg?ver=2009素材Url
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryBaojieapi>
      <countDate>2017-09-30</countDate>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <companyCode>70000123</companyCode>
    </queryBaojieapi>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryBaojieapi": {
        "countDate": "2017-09-30",
        "pageNo": "1",
        "pageSize": "10",
        "companyCode": "70000123"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryBaojieapi>
      <showPv>1</showPv>
      <countDate>20170929</countDate>
      <showUv>1</showUv>
      <directDealAmo>5000</directDealAmo>
      <clickPv>34</clickPv>
      <materialUrl>//image2.suning.cn/uimg/b2c/newcatentries/0000000000-000000000101822318_1_220x220.jpg?ver=2009</materialUrl>
      <indirectDealAmo>6000</indirectDealAmo>
      <directSubOrd>1</directSubOrd>
      <indirectSubAmo>400</indirectSubAmo>
      <brandName>宝洁</brandName>
      <keyWord>手机</keyWord>
      <directSubAmo>200</directSubAmo>
      <bidPrice>100</bidPrice>
      <curDealRate>1.2</curDealRate>
      <promotionName>宝洁推广计划</promotionName>
      <indirectSubOrd>23</indirectSubOrd>
      <userId>429004445</userId>
      <posiotionName>宝洁广告位</posiotionName>
      <avgCost>100</avgCost>
      <clickUv>30</clickUv>
      <indirectDealOrd>20</indirectDealOrd>
      <goodsName>宝洁商品</goodsName>
      <directDealOrd>4</directDealOrd>
      <fifDealRate>0.2</fifDealRate>
    </queryBaojieapi>
  </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": {
      "queryBaojieapi": [
        {
          "showPv": "1",
          "countDate": "20170929",
          "showUv": "1",
          "directDealAmo": "5000",
          "clickPv": "34",
          "materialUrl": "//image2.suning.cn/uimg/b2c/newcatentries/0000000000-000000000101822318_1_220x220.jpg?ver\u003d2009",
          "indirectDealAmo": "6000",
          "directSubOrd": "1",
          "indirectSubAmo": "400",
          "brandName": "宝洁",
          "keyWord": "手机",
          "directSubAmo": "200",
          "bidPrice": "100",
          "curDealRate": "1.2",
          "promotionName": "宝洁推广计划",
          "posiotionName": "宝洁广告位",
          "userId": "429004445",
          "indirectSubOrd": "23",
          "avgCost": "100",
          "clickUv": "30",
          "goodsName": "宝洁商品",
          "indirectDealOrd": "20",
          "fifDealRate": "0.2",
          "directDealOrd": "4"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.advertise.querybaojieapi.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.advertise.querybaojieapi.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.advertise.getbaojieapi.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.advertise.getbaojieapi.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.aps 服务不可用 请联系苏宁技术人员
biz.advertise.getbaojieapi.invalid-biz:100 输入参数格式不正确 检查输入参数
biz.advertise.getbaojieapi.invalid-biz:101 商家编码不存在 传入正确的商家编码
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ