查询推广计划分时报表
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 计划名称 | 计划名称 |
promotionDate | String | Y | 计划时间 | 计划时间 |
promotionId | String | Y | 777777 | 计划Id |
reportType | String | Y | 默认值:2 | 报告类型 |
dayType | String | Y | 范围:_3day:3天,_7day:7天,_15day:15天 | 订单统计范围 |
orderBy | String | N | 可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum); | 排序字段 |
pagerNumber | String | Y | 1 | 当前页数 |
pagerSize | String | Y | 11 | 每页条数 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | String | 0:成功,1:失败 | 状态 |
msg | String | 成功 | 状态说明 |
data | String | ||
dataList | String | ||
avgCost | String | 0.45 | 平均点击成本(单位:元) |
clickNum | String | 55 | 点击量 |
clickRate | String | 55.00% | 点击率 |
clickRateSort | String | 55 | 55 |
conversionRate | String | 896.00% | 下单转化率 |
conversionRateSort | String | 896 | 896 |
cost | String | 25 | 花费(单位:元) |
countHour | String | 12 | 小时 |
directAddshoppingcartNum | String | 154 | 直接加购数 |
directDealAmount | String | 300 | 直接成交金额 |
directDealNum | String | 500 | 直接成交订单数 |
directSubmitAmount | String | 333 | 直接下单金额 |
directSubmitOrder | String | 22 | 直接下单量 |
goodsFocusNum | String | 504 | 商品关注数 |
indirectAddshoppingcartNum | String | 22 | 间接加购数 |
indirectDealAmount | String | 22 | 间接成交金额 |
indirectDealOrder | String | 222 | 间接成交订单数 |
indirectSubmitAmount | String | 11 | 间接下单金额 |
indirectSubmitOrder | String | 321 | 间接下单量 |
promotionDate | String | 2020-02-28 | 推广日期 |
promotionId | String | 40000000 | 推广计划ID |
roi | String | 9.88 | 下单ROI |
showNum | String | 111 | 展现量 |
throwSource | String | 全部 | 投放终端 |
totalDealAmount | String | 500 | 总成交金额 |
totalSubmitAmount | String | 222 | 下单金额 |
userLimitAmount | String | 11 | 日预算(单位:元) |
overViewData | String | ||
avgCost | String | 0.72 | 平均点击成本(单位:元) |
clickNum | String | 69 | 点击量 |
clickRate | String | 34.50% | 点击率 |
conversionRate | String | 1428.99% | 下单转化率 |
cost | String | 22 | 花费(单位:元) |
countHour | String | 12 | 小时 |
directAddshoppingcartNum | String | 308 | 直接加购数 |
directDealAmount | String | 22 | 直接成交金额 |
directDealNum | String | 111 | 直接成交量 |
directSubmitAmount | String | 2222 | 直接下单金额 |
directSubmitOrder | String | 2112 | 直接下单量 |
goodsFocusNum | String | 222 | 商品关注数 |
indirectAddshoppingcartNum | String | 490 | 间接加购数 |
indirectDealAmount | String | 400 | 间接成交金额 |
indirectDealOrder | String | 22 | 间接成交订单数 |
indirectSubmitAmount | String | 490 | 间接下单金额 |
indirectSubmitOrder | String | 482 | 间接下单量 |
promotionDate | String | 推广日期 | 推广日期 |
roi | String | 4.7 | 下单ROI |
showNum | String | 200 | 展现量200 |
throwSource | String | 全部 | 投放终端 |
totalAddShoppingcartNum | String | 798 | 总加购数 |
totalDealAmount | String | 1000 | 总成交金额 |
totalSubmitAmount | String | 494 | 下单金额 |
pagerNumber | String | 1 | 当前页数 |
totalCount | String | 2 | 记录总是 |
<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" } } } }
<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:失败" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.advertise.querygetpromotionrephourbypage.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位 |