API接口目录

广告业务

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

查询推广计划离线报表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY777777操作用户id
throwTypeStringN投放终端:0.pc,1.mobile,其他.全部投放终端
promotionNameStringN计划名称计划名称
startDateStringY2020-02-15开始时间 时间格式:yyyy-MM-dd
endDateStringY2020-02-15结束时间
productTypeStringN2产品线类型 1.聚客宝 2.生意通 3.大聚惠 4.生意通店铺推广
dayTypeStringN_3day订单统计范围 范围:_3day.3天,_7day.7天,_15day.15天
orderByStringNshowNum排序字段 可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);
pagerNumberStringY1当前页数
pagerSizeStringY11每页条数
响应参数
名称 类型 示例值 描述
statusString状态0:成功,1:失败
msgString成功状态说明
dataString
pagerNumberString推广计划名称推广计划名称
totalCountString开始日期开始日期
dataListString
avgCostString0.01平均点击成本
clickNumString22点击量
clickRateString1.98%点击率
clickRateSortString1.981.98
conversionRateString709.00%下单转化率
conversionRateSortString709709
costString0.22花费
directAddshoppingcartNumString65直接加购数
directDealAmountString2.22直接成交金额
directDealNumString333直接成交量
directSubmitAmountString0.23直接下单金额
directSubmitOrderString45直接下单量
goodsFocusNumString45商品关注数
indirectAddshoppingcartNumString56间接加购数
indirectDealAmountString0.98间接成交金额
indirectDealOrderString77间接成交订单
indirectSubmitAmountString0.77间接下单金额
indirectSubmitOrderString111间接下单量
isActiveString0 是,1 否是否删除
productTypeString1.聚客宝 2.生意通 3.大聚惠 4.生意通店铺推广产品线类型
promotionIdString50000107推广计划ID
promotionNameStringwap测试20200220_021计划名称
promotionStatusString等待推广推广状态
roiString3.55下单ROI
showNumString1111展示量
throwSourceString全部投放终端
totalAddshoppingcartNumString121总加购数
totalDealAmountString2.22总成交金额
totalSubmitAmountString0.78总提交金额
userLimitAmountString0日预算
overViewDataString
avgCostString0.01平均点击成本
clickNumString46点击量
clickRateString"1.48%"点击率
conversionRateString1104.00%下单转化率
costString0.46花费
directAddshoppingcartNumString195直接加购数
directDealAmountString4.66直接成交金额
directDealNumString777直接成交量
directSubmitAmountString221直接下单金额
directSubmitOrderString221直接下单量
goodsFocusNumString195商品关注数
indirectAddshoppingcartNumString168间接加购数
indirectDealAmountString2.94间接成交金额
indirectDealOrderString253间接成交订单
indirectSubmitAmountString2.75间接下单金额
indirectSubmitOrderString287间接下单量
nameString推广计划名称推广计划名称
promotionStatusString1推广状态
roiString5.09下单ROI
showNumString3111展示量
throwSourceString全部投放终端
totalAddshoppingcartNumString363总成交金额
totalDealAmountString4.44总提交金额
totalSubmitAmountString2.34下单金额
userLimitAmountString0日预算
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryGetpromotionrepdatalist>
      <dayType>_3day</dayType>
      <throwType>投放终端:0.pc,1.mobile,其他.全部</throwType>
      <promotionName>计划名称</promotionName>
      <endDate>2020-02-15</endDate>
      <custnum>777777</custnum>
      <orderBy>showNum</orderBy>
      <pagerNumber>1</pagerNumber>
      <startDate>2020-02-15</startDate>
      <productType>2</productType>
      <pagerSize>11</pagerSize>
    </queryGetpromotionrepdatalist>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryGetpromotionrepdatalist": {
        "dayType": "_3day",
        "throwType": "投放终端:0.pc,1.mobile,其他.全部",
        "promotionName": "计划名称",
        "endDate": "2020-02-15",
        "custnum": "777777",
        "orderBy": "showNum",
        "pagerNumber": "1",
        "startDate": "2020-02-15",
        "productType": "2",
        "pagerSize": "11"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryGetpromotionrepdatalist>
      <msg>成功</msg>
      <data>
        <dataList>
          <userLimitAmount>0</userLimitAmount>
          <totalAddshoppingcartNum>121</totalAddshoppingcartNum>
          <isActive>0 是,1 否</isActive>
          <roi>3.55</roi>
          <promotionId>50000107</promotionId>
          <conversionRateSort>709</conversionRateSort>
          <promotionStatus>等待推广</promotionStatus>
          <promotionName>wap测试20200220_021</promotionName>
          <totalSubmitAmount>0.78</totalSubmitAmount>
          <goodsFocusNum>45</goodsFocusNum>
          <clickRate>1.98%</clickRate>
          <directAddshoppingcartNum>65</directAddshoppingcartNum>
          <clickNum>22</clickNum>
          <avgCost>0.01</avgCost>
          <indirectDealOrder>77</indirectDealOrder>
          <totalDealAmount>2.22</totalDealAmount>
          <productType>1.聚客宝 2.生意通 3.大聚惠 4.生意通店铺推广</productType>
          <indirectAddshoppingcartNum>56</indirectAddshoppingcartNum>
          <cost>0.22</cost>
          <directSubmitAmount>0.23</directSubmitAmount>
          <directSubmitOrder>45</directSubmitOrder>
          <indirectSubmitAmount>0.77</indirectSubmitAmount>
          <throwSource>全部</throwSource>
          <conversionRate>709.00%</conversionRate>
          <indirectSubmitOrder>111</indirectSubmitOrder>
          <showNum>1111</showNum>
          <clickRateSort>1.98</clickRateSort>
          <directDealNum>333</directDealNum>
          <directDealAmount>2.22</directDealAmount>
          <indirectDealAmount>0.98</indirectDealAmount>
        </dataList>
        <pagerNumber>推广计划名称</pagerNumber>
        <totalCount>开始日期</totalCount>
        <overViewData>
          <userLimitAmount>0</userLimitAmount>
          <totalAddshoppingcartNum>363</totalAddshoppingcartNum>
          <roi>5.09</roi>
          <promotionStatus>1</promotionStatus>
          <totalSubmitAmount>2.34</totalSubmitAmount>
          <goodsFocusNum>195</goodsFocusNum>
          <clickRate>"1.48%"</clickRate>
          <directAddshoppingcartNum>195</directAddshoppingcartNum>
          <clickNum>46</clickNum>
          <avgCost>0.01</avgCost>
          <indirectDealOrder>253</indirectDealOrder>
          <totalDealAmount>4.44</totalDealAmount>
          <indirectAddshoppingcartNum>168</indirectAddshoppingcartNum>
          <cost>0.46</cost>
          <directSubmitAmount>221</directSubmitAmount>
          <directSubmitOrder>221</directSubmitOrder>
          <indirectSubmitAmount>2.75</indirectSubmitAmount>
          <throwSource>全部</throwSource>
          <conversionRate>1104.00%</conversionRate>
          <indirectSubmitOrder>287</indirectSubmitOrder>
          <showNum>3111</showNum>
          <directDealNum>777</directDealNum>
          <name>推广计划名称</name>
          <directDealAmount>4.66</directDealAmount>
          <indirectDealAmount>2.94</indirectDealAmount>
        </overViewData>
      </data>
      <status>状态</status>
    </queryGetpromotionrepdatalist>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryGetpromotionrepdatalist": {
        "msg": "成功",
        "data": [
          {
            "dataList": [
              {
                "userLimitAmount": "0",
                "totalAddshoppingcartNum": "121",
                "isActive": "0 是,1 否",
                "roi": "3.55",
                "promotionId": "50000107",
                "conversionRateSort": "709",
                "promotionStatus": "等待推广",
                "promotionName": "wap测试20200220_021",
                "totalSubmitAmount": "0.78",
                "goodsFocusNum": "45",
                "clickRate": "1.98%",
                "directAddshoppingcartNum": "65",
                "clickNum": "22",
                "avgCost": "0.01",
                "indirectDealOrder": "77",
                "totalDealAmount": "2.22",
                "productType": "1.聚客宝 2.生意通 3.大聚惠 4.生意通店铺推广",
                "indirectAddshoppingcartNum": "56",
                "cost": "0.22",
                "directSubmitAmount": "0.23",
                "directSubmitOrder": "45",
                "indirectSubmitAmount": "0.77",
                "throwSource": "全部",
                "conversionRate": "709.00%",
                "indirectSubmitOrder": "111",
                "showNum": "1111",
                "clickRateSort": "1.98",
                "directDealNum": "333",
                "directDealAmount": "2.22",
                "indirectDealAmount": "0.98"
              }
            ],
            "pagerNumber": "推广计划名称",
            "totalCount": "开始日期",
            "overViewData": [
              {
                "userLimitAmount": "0",
                "totalAddshoppingcartNum": "363",
                "roi": "5.09",
                "promotionStatus": "1",
                "totalSubmitAmount": "2.34",
                "goodsFocusNum": "195",
                "clickRate": "\"1.48%\"",
                "directAddshoppingcartNum": "195",
                "clickNum": "46",
                "avgCost": "0.01",
                "indirectDealOrder": "253",
                "totalDealAmount": "4.44",
                "indirectAddshoppingcartNum": "168",
                "cost": "0.46",
                "directSubmitAmount": "221",
                "directSubmitOrder": "221",
                "indirectSubmitAmount": "2.75",
                "throwSource": "全部",
                "conversionRate": "1104.00%",
                "indirectSubmitOrder": "287",
                "showNum": "3111",
                "directDealNum": "777",
                "name": "推广计划名称",
                "directDealAmount": "4.66",
                "indirectDealAmount": "2.94"
              }
            ]
          }
        ],
        "status": "状态"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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