API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.channel.add 批量外部资源
¥免费

批量外部资源

公共参数
请求参数
名称 类型 是否必须 示例值 描述
mediaInputsStringN
storeTypesStringY19新潮传媒
mediaIdStringY98N7媒体点位编码:渠道管理媒体的唯一标识
operateStringY0操作 :新增/编辑-0;删除-1
shopNameStringY紫金嘉悦网点名称:广告位所在的POI点信息,社区名称、楼宇名称等
provinceNameStringY江苏省省份名称(需填写省)
cityNameStringY南京市市名称(需填写市)
areaNameStringY玄武区区名称(需填写区)
addressStringY玄武大道1号详细地址,描述至街道门牌号
longitudeStringY119.292912经度(百度坐标系)
latitudeStringY26.068504纬度(百度坐标系)
senceIdStringY1001网点所属场景编码,详情见码表值
unitNumberStringN3单元数量(个)
buildingNumberStringN50楼栋数量(栋)
mediaNumberStringN50网点广告位数量(个)
coverNumberStringN10000网点覆盖人数(人)
passengerNumberStringN1000000客流量(人/天)
floorSpaceStringN40.15占地面积,单位平方米
propertyCostsStringN100.98物业费,单位每平方米
businessHoursStringN12营业时长,单位小时
parkingSpaceStringN110停车场车位数(个)
shopNumberStringN5店铺数量(个)
shopPropertyStringN性质属性小区或商场等场景的性质属性,如高档型、经济型、高科技型小区等
remarksStringN这是电子屏备注,限制200字符内
categoryCodeStringYAdPosition_SmallShop_Type_video2媒体点位类型,请联系星云屏运营人员提供类型编码值
lengthStringN10.11长度 单位cm
heightStringN10.11高度 单位cm
widthStringN10.11宽度 单位cm
resolutionStringN1920X1080分辨率:接入设备屏幕的分辨率,分辨率和长宽高中,必须填其中之一,具体见码表值
showPositionStringY1点位所在位置:室内-1;室外-0
floorStringN3F3楼
detailedLocationStringY紫金嘉悦东大门门口详细安装位置
priceStringY150.66CPT刊例价(元):最小售卖周期对应的刊例价
durationStringYday点位最小售卖周期:天-day,周-week,月-month,年-year
mediaPictureStringYhttp://www.suning.com/1,jpg点位图片外网url:单张不超过1M,图片大小建议为200*135
isVerticalStringN1屏幕方向:横屏-0;竖屏-1
screenPositionStringN1|2|3|4|5分屏方式:1-全屏、2-左右、3-左中右、4-上下、5-上中下
contractNumberStringYSN12239991价格合同编码:渠道对接内部价,具体和星云屏商务人员联系
isVoiceStringY1广告位是否有声音:无-0;有-1
materialTimeStringN15素材时长(s):5;15;30;60
prohibitedContentStringN医药类禁止播放内容,详情见码表值
materialSizeStringN100*100*100广告位素材尺寸单位cm
salesTypeStringY1售卖方式:CPT-1;CPM-2
cptMediaModeStringN1广告播出方式:15秒轮播-1;触屏后跳出-2;开机广告-3;购物支付-4
mediaPlayDurationStringN5|15|30|60素材时长(s):5;15;30;60
cptMaxPlayTimesStringN100CPT单日最大播放次数(次)
cptPublishDatesStringN1,2,3,4,5周一到周五播放,CPT必填
cptPriceStringN100.01CPT单日价格(元)CPT必填
cptSalesTimesStringN300CPT单日可售次数(次)CPT必填
cptPlayTimesStringN200CPT单日播放次数 CPT必填
cpmPriceStringN100.01CPM 价格(元)CPM必填
unitCountStringY10多屏售卖次数,不涉及填1
storeTypeStringY19外部媒体渠道编码:请联系星云屏运营人员提供
响应参数
名称 类型 示例值 描述
resultString
resultCodeStringT成功
resultMsgString省份不存在错误提示信息
successListString[1,2,3]成功的点位ID
failedListString
mediaIdString1错误的点位ID
errorTipsString分类不存在错误提示
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <addChannel>
      <storeType>19</storeType>
      <mediaInputs>
        <cptSalesTimes>300</cptSalesTimes>
        <unitNumber>3</unitNumber>
        <mediaId>98N7</mediaId>
        <showPosition>1</showPosition>
        <resolution>1920X1080</resolution>
        <coverNumber>10000</coverNumber>
        <cptPublishDates>1,2,3,4,5</cptPublishDates>
        <mediaPlayDuration>5|15|30|60</mediaPlayDuration>
        <areaName>玄武区</areaName>
        <price>150.66</price>
        <buildingNumber>50</buildingNumber>
        <cptMaxPlayTimes>100</cptMaxPlayTimes>
        <passengerNumber>1000000</passengerNumber>
        <height>10.11</height>
        <longitude>119.292912</longitude>
        <mediaNumber>50</mediaNumber>
        <unitCount>10</unitCount>
        <contractNumber>SN12239991</contractNumber>
        <materialSize>100*100*100</materialSize>
        <parkingSpace>110</parkingSpace>
        <isVoice>1</isVoice>
        <operate>0</operate>
        <isVertical>1</isVertical>
        <shopNumber>5</shopNumber>
        <provinceName>江苏省</provinceName>
        <floorSpace>40.15</floorSpace>
        <cptPrice>100.01</cptPrice>
        <mediaPicture>http://www.suning.com/1,jpg</mediaPicture>
        <propertyCosts>100.98</propertyCosts>
        <storeTypes>19</storeTypes>
        <screenPosition>1|2|3|4|5</screenPosition>
        <latitude>26.068504</latitude>
        <shopName>紫金嘉悦</shopName>
        <cptMediaMode>1</cptMediaMode>
        <shopProperty>性质属性</shopProperty>
        <duration>day</duration>
        <cityName>南京市</cityName>
        <floor>3F</floor>
        <prohibitedContent>医药类</prohibitedContent>
        <salesType>1</salesType>
        <cpmPrice>100.01</cpmPrice>
        <detailedLocation>紫金嘉悦东大门门口</detailedLocation>
        <address>玄武大道1号</address>
        <businessHours>12</businessHours>
        <length>10.11</length>
        <categoryCode>AdPosition_SmallShop_Type_video2</categoryCode>
        <materialTime>15</materialTime>
        <width>10.11</width>
        <cptPlayTimes>200</cptPlayTimes>
        <senceId>1001</senceId>
        <remarks>这是电子屏</remarks>
      </mediaInputs>
    </addChannel>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addChannel": {
        "storeType": "19",
        "mediaInputs": [
          {
            "cptSalesTimes": "300",
            "unitNumber": "3",
            "mediaId": "98N7",
            "showPosition": "1",
            "resolution": "1920X1080",
            "coverNumber": "10000",
            "cptPublishDates": "1,2,3,4,5",
            "mediaPlayDuration": "5|15|30|60",
            "areaName": "玄武区",
            "price": "150.66",
            "buildingNumber": "50",
            "cptMaxPlayTimes": "100",
            "passengerNumber": "1000000",
            "height": "10.11",
            "longitude": "119.292912",
            "mediaNumber": "50",
            "unitCount": "10",
            "contractNumber": "SN12239991",
            "materialSize": "100*100*100",
            "parkingSpace": "110",
            "isVoice": "1",
            "operate": "0",
            "isVertical": "1",
            "shopNumber": "5",
            "provinceName": "江苏省",
            "floorSpace": "40.15",
            "cptPrice": "100.01",
            "mediaPicture": "http://www.suning.com/1,jpg",
            "propertyCosts": "100.98",
            "storeTypes": "19",
            "screenPosition": "1|2|3|4|5",
            "latitude": "26.068504",
            "shopName": "紫金嘉悦",
            "cptMediaMode": "1",
            "shopProperty": "性质属性",
            "duration": "day",
            "cityName": "南京市",
            "floor": "3F",
            "prohibitedContent": "医药类",
            "salesType": "1",
            "cpmPrice": "100.01",
            "detailedLocation": "紫金嘉悦东大门门口",
            "address": "玄武大道1号",
            "businessHours": "12",
            "length": "10.11",
            "categoryCode": "AdPosition_SmallShop_Type_video2",
            "materialTime": "15",
            "width": "10.11",
            "cptPlayTimes": "200",
            "senceId": "1001",
            "remarks": "这是电子屏"
          }
        ]
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <addChannel>
      <result>
        <successList>[1,2,3]</successList>
        <failedList>
          <errorTips>分类不存在</errorTips>
          <mediaId>1</mediaId>
        </failedList>
        <resultCode>T</resultCode>
        <resultMsg>省份不存在</resultMsg>
      </result>
    </addChannel>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addChannel": {
        "result": [
          {
            "successList": "[1,2,3]",
            "failedList": [
              {
                "errorTips": "分类不存在",
                "mediaId": "1"
              }
            ],
            "resultCode": "T",
            "resultMsg": "省份不存在"
          }
        ]
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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