API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.getpromotionrephourbypage.query 查询推广计划分时报表
¥增值

查询推广计划分时报表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY777777操作用户id
throwTypeStringN0:pc,1:mobile,其他:全部投放终端
promotionNameStringN计划名称计划名称
promotionDateStringY计划时间计划时间
promotionIdStringY777777计划Id
reportTypeStringY默认值:2报告类型
dayTypeStringY范围:_3day:3天,_7day:7天,_15day:15天订单统计范围
orderByStringN可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);排序字段
pagerNumberStringY1当前页数
pagerSizeStringY11每页条数
响应参数
名称 类型 示例值 描述
statusString0:成功,1:失败状态
msgString成功状态说明
dataString
dataListString
avgCostString0.45平均点击成本(单位:元)
clickNumString 55点击量
clickRateString 55.00%点击率
clickRateSortString5555
conversionRateString 896.00%下单转化率
conversionRateSortString896896
costString25花费(单位:元)
countHourString12小时
directAddshoppingcartNumString 154直接加购数
directDealAmountString300直接成交金额
directDealNumString500直接成交订单数
directSubmitAmountString333直接下单金额
directSubmitOrderString22直接下单量
goodsFocusNumString504商品关注数
indirectAddshoppingcartNumString22间接加购数
indirectDealAmountString22间接成交金额
indirectDealOrderString222间接成交订单数
indirectSubmitAmountString11间接下单金额
indirectSubmitOrderString321间接下单量
promotionDateString 2020-02-28推广日期
promotionIdString 40000000推广计划ID
roiString9.88下单ROI
showNumString111展现量
throwSourceString 全部投放终端
totalDealAmountString500总成交金额
totalSubmitAmountString222下单金额
userLimitAmountString11日预算(单位:元)
overViewDataString
avgCostString0.72平均点击成本(单位:元)
clickNumString 69点击量
clickRateString 34.50%点击率
conversionRateString 1428.99%下单转化率
costString22花费(单位:元)
countHourString12小时
directAddshoppingcartNumString308直接加购数
directDealAmountString22直接成交金额
directDealNumString111直接成交量
directSubmitAmountString2222直接下单金额
directSubmitOrderString2112直接下单量
goodsFocusNumString222商品关注数
indirectAddshoppingcartNumString490间接加购数
indirectDealAmountString400间接成交金额
indirectDealOrderString22间接成交订单数
indirectSubmitAmountString490间接下单金额
indirectSubmitOrderString482间接下单量
promotionDateString推广日期推广日期
roiString4.7下单ROI
showNumString200展现量200
throwSourceString 全部投放终端
totalAddShoppingcartNumString798总加购数
totalDealAmountString1000总成交金额
totalSubmitAmountString 494下单金额
pagerNumberString1当前页数
totalCountString2记录总是
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryGetpromotionrephourbypage>
      <reportType>默认值:2</reportType>
      <dayType>范围:_3day:3天,_7day:7天,_15day:15天</dayType>
      <throwType>0:pc,1:mobile,其他:全部</throwType>
      <promotionName>计划名称</promotionName>
      <custnum>777777</custnum>
      <promotionDate>计划时间</promotionDate>
      <orderBy>可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);</orderBy>
      <pagerNumber>1</pagerNumber>
      <promotionId>777777</promotionId>
      <pagerSize>11</pagerSize>
    </queryGetpromotionrephourbypage>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryGetpromotionrephourbypage": {
        "reportType": "默认值:2",
        "dayType": "范围:_3day:3天,_7day:7天,_15day:15天",
        "throwType": "0:pc,1:mobile,其他:全部",
        "promotionName": "计划名称",
        "custnum": "777777",
        "promotionDate": "计划时间",
        "orderBy": "可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);",
        "pagerNumber": "1",
        "promotionId": "777777",
        "pagerSize": "11"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryGetpromotionrephourbypage>
      <msg>成功</msg>
      <data>
        <dataList>
          <userLimitAmount>11</userLimitAmount>
          <roi>9.88</roi>
          <promotionId> 40000000</promotionId>
          <conversionRateSort>896</conversionRateSort>
          <totalSubmitAmount>222</totalSubmitAmount>
          <goodsFocusNum>504</goodsFocusNum>
          <clickRate> 55.00%</clickRate>
          <directAddshoppingcartNum> 154</directAddshoppingcartNum>
          <clickNum> 55</clickNum>
          <avgCost>0.45</avgCost>
          <indirectDealOrder>222</indirectDealOrder>
          <totalDealAmount>500</totalDealAmount>
          <countHour>12</countHour>
          <indirectAddshoppingcartNum>22</indirectAddshoppingcartNum>
          <cost>25</cost>
          <directSubmitAmount>333</directSubmitAmount>
          <promotionDate> 2020-02-28</promotionDate>
          <directSubmitOrder>22</directSubmitOrder>
          <indirectSubmitAmount>11</indirectSubmitAmount>
          <throwSource> 全部</throwSource>
          <conversionRate> 896.00%</conversionRate>
          <indirectSubmitOrder>321</indirectSubmitOrder>
          <showNum>111</showNum>
          <clickRateSort>55</clickRateSort>
          <directDealNum>500</directDealNum>
          <directDealAmount>300</directDealAmount>
          <indirectDealAmount>22</indirectDealAmount>
        </dataList>
        <pagerNumber>1</pagerNumber>
        <totalCount>2</totalCount>
        <overViewData>
          <cost>22</cost>
          <directSubmitAmount>2222</directSubmitAmount>
          <promotionDate>推广日期</promotionDate>
          <directSubmitOrder>2112</directSubmitOrder>
          <indirectSubmitAmount>490</indirectSubmitAmount>
          <throwSource> 全部</throwSource>
          <conversionRate> 1428.99%</conversionRate>
          <roi>4.7</roi>
          <indirectSubmitOrder>482</indirectSubmitOrder>
          <showNum>200</showNum>
          <totalSubmitAmount> 494</totalSubmitAmount>
          <goodsFocusNum>222</goodsFocusNum>
          <clickRate> 34.50%</clickRate>
          <directAddshoppingcartNum>308</directAddshoppingcartNum>
          <totalAddShoppingcartNum>798</totalAddShoppingcartNum>
          <directDealNum>111</directDealNum>
          <clickNum> 69</clickNum>
          <directDealAmount>22</directDealAmount>
          <indirectDealAmount>400</indirectDealAmount>
          <avgCost>0.72</avgCost>
          <indirectDealOrder>22</indirectDealOrder>
          <totalDealAmount>1000</totalDealAmount>
          <countHour>12</countHour>
          <indirectAddshoppingcartNum>490</indirectAddshoppingcartNum>
        </overViewData>
      </data>
      <status>0:成功,1:失败</status>
    </queryGetpromotionrephourbypage>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryGetpromotionrephourbypage": {
        "msg": "成功",
        "data": [
          {
            "dataList": [
              {
                "userLimitAmount": "11",
                "roi": "9.88",
                "promotionId": " 40000000",
                "conversionRateSort": "896",
                "totalSubmitAmount": "222",
                "goodsFocusNum": "504",
                "clickRate": " 55.00%",
                "directAddshoppingcartNum": " 154",
                "clickNum": " 55",
                "avgCost": "0.45",
                "indirectDealOrder": "222",
                "totalDealAmount": "500",
                "countHour": "12",
                "indirectAddshoppingcartNum": "22",
                "cost": "25",
                "directSubmitAmount": "333",
                "promotionDate": " 2020-02-28",
                "directSubmitOrder": "22",
                "indirectSubmitAmount": "11",
                "throwSource": " 全部",
                "conversionRate": " 896.00%",
                "indirectSubmitOrder": "321",
                "showNum": "111",
                "clickRateSort": "55",
                "directDealNum": "500",
                "directDealAmount": "300",
                "indirectDealAmount": "22"
              }
            ],
            "pagerNumber": "1",
            "totalCount": "2",
            "overViewData": [
              {
                "cost": "22",
                "directSubmitAmount": "2222",
                "promotionDate": "推广日期",
                "directSubmitOrder": "2112",
                "indirectSubmitAmount": "490",
                "throwSource": " 全部",
                "conversionRate": " 1428.99%",
                "roi": "4.7",
                "indirectSubmitOrder": "482",
                "showNum": "200",
                "totalSubmitAmount": " 494",
                "goodsFocusNum": "222",
                "clickRate": " 34.50%",
                "directAddshoppingcartNum": "308",
                "totalAddShoppingcartNum": "798",
                "directDealNum": "111",
                "clickNum": " 69",
                "directDealAmount": "22",
                "indirectDealAmount": "400",
                "avgCost": "0.72",
                "indirectDealOrder": "22",
                "totalDealAmount": "1000",
                "countHour": "12",
                "indirectAddshoppingcartNum": "490"
              }
            ]
          }
        ],
        "status": "0:成功,1:失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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