API接口目录

广告业务

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

宝洁CPM推广报表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
companyCodeStringY70019291商家编码(商家在苏宁云台的编码,长度:8位)
queryDateStringY2017-09-30查询时间(yyyy-MM-dd)
响应参数
名称 类型 示例值 描述
promotionIdString2017092911推广计划ID
promotionDateString20180225推广日期
promotionNameString宝洁推广计划推广计划名称
positionNameString宝洁广告位广告位名称
showNumString100展示量
clickNumString20点击量
costString34花费(单位:元)
dayLimitAmountString30日限额(单位:元)
subOrderString100提交订单数
subOrderAmountString100提交订单金额(单位:元)
dealOrderString10成交订单数
dealOrderAmountString3000成交订单金额(单位:元)
throwModeString0推广方式 0:聚客宝竞价 1:包段
throwTypeString移动端投放终端: PC端 移动端
unitIdString15023652聚客宝推广计划单元ID,包段为空字符串
unitNameString单元名称聚客宝推广计划单元单元名称
subRoiString0.12下单ROI
subConvertRateString20%下单转化率(百分比)
dealRoiString1.1成交ROI
dealConvertRateString30%成交转化率(百分比)
clickRateString30%点击率(百分比)
avgClickPriceString20平均点击成本(元)
thousandShowCostString30千次展现成本(元)
cartNumString44总购物车数
visitorNumString111访客数
visitPageNumString12访问页面数
visitTimeString60访问时长(秒)
goodsConcernNumString123商品关注数
appointmentNumString123预约数
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryBjcpm>
      <companyCode>70019291</companyCode>
      <queryDate>2017-09-30</queryDate>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
    </queryBjcpm>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryBjcpm": {
        "companyCode": "70019291",
        "queryDate": "2017-09-30",
        "pageNo": "1",
        "pageSize": "10"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <queryBjcpm>
      <subConvertRate>20%</subConvertRate>
      <dayLimitAmount>30</dayLimitAmount>
      <subOrder>100</subOrder>
      <cartNum>44</cartNum>
      <promotionId>2017092911</promotionId>
      <thousandShowCost>30</thousandShowCost>
      <positionName>宝洁广告位</positionName>
      <dealRoi>1.1</dealRoi>
      <promotionName>宝洁推广计划</promotionName>
      <appointmentNum>123</appointmentNum>
      <clickRate>30%</clickRate>
      <goodsConcernNum>123</goodsConcernNum>
      <clickNum>20</clickNum>
      <unitId>15023652</unitId>
      <throwType>移动端</throwType>
      <subOrderAmount>100</subOrderAmount>
      <cost>34</cost>
      <unitName>单元名称</unitName>
      <promotionDate>20180225</promotionDate>
      <avgClickPrice>20</avgClickPrice>
      <dealOrder>10</dealOrder>
      <showNum>100</showNum>
      <visitTime>60</visitTime>
      <dealOrderAmount>3000</dealOrderAmount>
      <visitPageNum>12</visitPageNum>
      <throwMode>0</throwMode>
      <subRoi>0.12</subRoi>
      <visitorNum>111</visitorNum>
      <dealConvertRate>30%</dealConvertRate>
    </queryBjcpm>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryBjcpm": [
        {
          "subConvertRate": "20%",
          "dayLimitAmount": "30",
          "subOrder": "100",
          "cartNum": "44",
          "promotionId": "2017092911",
          "thousandShowCost": "30",
          "positionName": "宝洁广告位",
          "dealRoi": "1.1",
          "promotionName": "宝洁推广计划",
          "appointmentNum": "123",
          "clickRate": "30%",
          "goodsConcernNum": "123",
          "clickNum": "20",
          "unitId": "15023652",
          "throwType": "移动端",
          "subOrderAmount": "100",
          "cost": "34",
          "unitName": "单元名称",
          "promotionDate": "20180225",
          "avgClickPrice": "20",
          "dealOrder": "10",
          "showNum": "100",
          "visitTime": "60",
          "dealOrderAmount": "3000",
          "visitPageNum": "12",
          "throwMode": "0",
          "subRoi": "0.12",
          "visitorNum": "111",
          "dealConvertRate": "30%"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.advertise.querybjcpm.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.advertise.querybjcpm.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.aps 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ