查询推广计划离线报表
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
custnum | String | Y | 777777 | 操作用户id |
throwType | String | N | 投放终端:0.pc,1.mobile,其他.全部 | 投放终端 |
promotionName | String | N | 计划名称 | 计划名称 |
startDate | String | Y | 2020-02-15 | 开始时间 时间格式:yyyy-MM-dd |
endDate | String | Y | 2020-02-15 | 结束时间 |
productType | String | N | 2 | 产品线类型 1.聚客宝 2.生意通 3.大聚惠 4.生意通店铺推广 |
dayType | String | N | _3day | 订单统计范围 范围:_3day.3天,_7day.7天,_15day.15天 |
orderBy | String | N | showNum | 排序字段 可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum); |
pagerNumber | String | Y | 1 | 当前页数 |
pagerSize | String | Y | 11 | 每页条数 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | String | 状态 | 0:成功,1:失败 |
msg | String | 成功 | 状态说明 |
data | String | ||
pagerNumber | String | 推广计划名称 | 推广计划名称 |
totalCount | String | 开始日期 | 开始日期 |
dataList | String | ||
avgCost | String | 0.01 | 平均点击成本 |
clickNum | String | 22 | 点击量 |
clickRate | String | 1.98% | 点击率 |
clickRateSort | String | 1.98 | 1.98 |
conversionRate | String | 709.00% | 下单转化率 |
conversionRateSort | String | 709 | 709 |
cost | String | 0.22 | 花费 |
directAddshoppingcartNum | String | 65 | 直接加购数 |
directDealAmount | String | 2.22 | 直接成交金额 |
directDealNum | String | 333 | 直接成交量 |
directSubmitAmount | String | 0.23 | 直接下单金额 |
directSubmitOrder | String | 45 | 直接下单量 |
goodsFocusNum | String | 45 | 商品关注数 |
indirectAddshoppingcartNum | String | 56 | 间接加购数 |
indirectDealAmount | String | 0.98 | 间接成交金额 |
indirectDealOrder | String | 77 | 间接成交订单 |
indirectSubmitAmount | String | 0.77 | 间接下单金额 |
indirectSubmitOrder | String | 111 | 间接下单量 |
isActive | String | 0 是,1 否 | 是否删除 |
productType | String | 1.聚客宝 2.生意通 3.大聚惠 4.生意通店铺推广 | 产品线类型 |
promotionId | String | 50000107 | 推广计划ID |
promotionName | String | wap测试20200220_021 | 计划名称 |
promotionStatus | String | 等待推广 | 推广状态 |
roi | String | 3.55 | 下单ROI |
showNum | String | 1111 | 展示量 |
throwSource | String | 全部 | 投放终端 |
totalAddshoppingcartNum | String | 121 | 总加购数 |
totalDealAmount | String | 2.22 | 总成交金额 |
totalSubmitAmount | String | 0.78 | 总提交金额 |
userLimitAmount | String | 0 | 日预算 |
overViewData | String | ||
avgCost | String | 0.01 | 平均点击成本 |
clickNum | String | 46 | 点击量 |
clickRate | String | "1.48%" | 点击率 |
conversionRate | String | 1104.00% | 下单转化率 |
cost | String | 0.46 | 花费 |
directAddshoppingcartNum | String | 195 | 直接加购数 |
directDealAmount | String | 4.66 | 直接成交金额 |
directDealNum | String | 777 | 直接成交量 |
directSubmitAmount | String | 221 | 直接下单金额 |
directSubmitOrder | String | 221 | 直接下单量 |
goodsFocusNum | String | 195 | 商品关注数 |
indirectAddshoppingcartNum | String | 168 | 间接加购数 |
indirectDealAmount | String | 2.94 | 间接成交金额 |
indirectDealOrder | String | 253 | 间接成交订单 |
indirectSubmitAmount | String | 2.75 | 间接下单金额 |
indirectSubmitOrder | String | 287 | 间接下单量 |
name | String | 推广计划名称 | 推广计划名称 |
promotionStatus | String | 1 | 推广状态 |
roi | String | 5.09 | 下单ROI |
showNum | String | 3111 | 展示量 |
throwSource | String | 全部 | 投放终端 |
totalAddshoppingcartNum | String | 363 | 总成交金额 |
totalDealAmount | String | 4.44 | 总提交金额 |
totalSubmitAmount | String | 2.34 | 下单金额 |
userLimitAmount | String | 0 | 日预算 |
<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" } } } }
<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": "状态" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.advertise.querygetpromotionrepdatalist.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.adss | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |