API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.unit.create 新建单元
¥免费

新建单元

公共参数
请求参数
名称 类型 是否必须 示例值 描述
promotionUnitDtoStringN
custnumStringY6001849930操作者用户ID
promotionIdStringY40000008计划ID
recommendPriceStringY200推荐出价
ocpcStringY1005OCPC
matchModeStringY1001匹配模式
rankingsOrderStringY1002top3
rankingsDiscountStringY1003溢价系数
rankingsButtonStringY1004一键抢排名
searchCrowdStringN2001搜索人群定向
commendCrowdStringN2002推荐人群定向
goodsStringN
goodsCodeStringY11346320883商品编码
goodsNameStringYApple iPhone 11 128G 黑色 移动联通电信4G全网通手机商品名称
flowPackListStringN
flowTypeNameStringY购物前流量包
premiumStringY100溢价系数
flowTypeExplainStringY我的大促:把握大促会场流量,借力巨人肩膀流量包说明
flowTypeIdStringY01021属性编码
extFieldStringN
zncbPricePCStringN100智能词包pc出价
zncbPriceWAPStringN100智能词包无线出价
operateAppliCodeStringN上架商家编码
operateUserTypeStringN0用户类型
cityIdStringY投放地区
operateSupplierTypeStringN商家类型
promotionTypeStringY2计划类型
响应参数
名称 类型 示例值 描述
statusString1-成功 0-失败成功失败标志
msgString没有值返回null返回信息
dataString
promotionUnitIdString0第一个单元ID,失败时无该参数
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createCreateunit>
      <promotionType>2</promotionType>
      <operateAppliCode>null</operateAppliCode>
      <operateUserType>0</operateUserType>
      <cityId>null</cityId>
      <promotionUnitDto>
        <rankingsButton>1004</rankingsButton>
        <rankingsDiscount>1003</rankingsDiscount>
        <custnum>6001849930</custnum>
        <goods>
          <goodsCode>11346320883</goodsCode>
          <goodsName>Apple iPhone 11 128G 黑色 移动联通电信4G全网通手机</goodsName>
        </goods>
        <commendCrowd>2002</commendCrowd>
        <promotionId>40000008</promotionId>
        <rankingsOrder>1002</rankingsOrder>
        <recommendPrice>200</recommendPrice>
        <ocpc>1005</ocpc>
        <searchCrowd>2001</searchCrowd>
        <flowPackList>
          <flowTypeName>购物前</flowTypeName>
          <premium>100</premium>
          <flowTypeExplain>我的大促:把握大促会场流量,借力巨人肩膀</flowTypeExplain>
          <flowTypeId>01021</flowTypeId>
        </flowPackList>
        <extField>
          <zncbPriceWAP>100</zncbPriceWAP>
          <zncbPricePC>100</zncbPricePC>
        </extField>
        <matchMode>1001</matchMode>
      </promotionUnitDto>
      <operateSupplierType>null</operateSupplierType>
    </createCreateunit>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createCreateunit": {
        "promotionType": "2",
        "operateAppliCode": "null",
        "operateUserType": "0",
        "cityId": "null",
        "promotionUnitDto": {
          "rankingsButton": "1004",
          "rankingsDiscount": "1003",
          "custnum": "6001849930",
          "goods": [
            {
              "goodsCode": "11346320883",
              "goodsName": "Apple iPhone 11 128G 黑色 移动联通电信4G全网通手机"
            }
          ],
          "commendCrowd": "2002",
          "promotionId": "40000008",
          "rankingsOrder": "1002",
          "recommendPrice": "200",
          "ocpc": "1005",
          "searchCrowd": "2001",
          "flowPackList": [
            {
              "flowTypeName": "购物前",
              "premium": "100",
              "flowTypeExplain": "我的大促:把握大促会场流量,借力巨人肩膀",
              "flowTypeId": "01021"
            }
          ],
          "extField": [
            {
              "zncbPriceWAP": "100",
              "zncbPricePC": "100"
            }
          ],
          "matchMode": "1001"
        },
        "operateSupplierType": "null"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createCreateunit>
      <msg>没有值返回null</msg>
      <data>
        <promotionUnitId>0</promotionUnitId>
      </data>
      <status>1-成功 0-失败</status>
    </createCreateunit>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createCreateunit": {
        "msg": "没有值返回null",
        "data": [
          {
            "promotionUnitId": "0"
          }
        ],
        "status": "1-成功 0-失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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