感谢您的反馈!
为了进一步丰富服饰、鞋子等相关类目的尺码导购信息精准性,让用户更快选出适合自己的尺码,提升转化效率,降低尺码拍错带来的退款率,平台对尺码表采集功能进行升级,包含尺码表因子规范填写、尺码表灰度必填、模特试穿信息组件升级、以及增加尺码偏大偏小建议组件。
商家录入后,将在商品详情中的尺码助手向消费者展示,帮助用户选择合适自己的尺码。demo示意:
尺码表 |
模特试穿报告 |
尺码偏大偏小建议 |
|
|
接口描述 |
接口名称 |
获取商品发布规则信息 |
|
商品发布 |
|
商品编辑获取schema信息 |
|
商品编辑提交schema信息 |
若您在填写尺码数据时,存在如下情况,会提示报错,请根据要求修改:
1)明显不合理的参数范围(如:身高300cm)
2)错误的填写数据(如:S码体重大于L码体重)
3)多个因子重复
商品新发和编辑提交接口,增加对尺码表数据的校验规则。若提交数据与规则不符,则返回报错。例如当两个尺码的整行数据完全重复时报错文案和报错码:
影响提交接口:
alibaba.item.publish.omnichannel.submit / alibaba.item.publish.distribute.submit
报错文案:【商品尺寸表】尺码145/80A与尺码150/80A信息完全一致,请修改后重新提交 报错码:isv.parameter-parse-error:sizeMapping
需要接入尺码表组件,且部分类目尺码表必填
已经支持尺码表组件的服务商可忽略组件接入部分.
历史文档:https://www.yuque.com/wanqing-90giv/kb/znec1l?#lMJQU
天猫/淘宝接口:
(1)商品发布:alibaba.item.publish.omnichannel.submit / alibaba.item.publish.distribute.submit
(2)商品编辑提交schema信息:alibaba.item.edit.submit
(3)获取商品发布规则信息: alibaba.item.publish.schema.omnichannel.get / alibaba.item.publish.schema.distribute.get
(4)商品编辑获取schema信息:alibaba.item.edit.schema.get
改造前 |
改造后 |
调整内容说明 |
1、尺码属性跟普通属性透出格式保持一致。比如: |
1、新版尺码支持尺码分组和尺码表,并且两个都需要商家填写。 1)在sku field中会透出所有尺码分组下尺码值填写规范: 2)透出当前类目下所有的尺码分组列表,以及当前选中的分组。 3)尺码表扩展 尺码表中所有的字段信息,以及每个字段的规则(是否必填、区间等) |
尺码值是挂在分组下的,所有分组信息必须要填写。并且在sku、std_size_group(尺码分组)、 std_size_group(尺码扩展)中,分组信息填写的需要保持一致。 |
影响渲染接口
alibaba.item.publish.schema.get
规则如图
规则如图,某些字段根据业务规则会增加必填
一级类目 |
叶子类目 |
必填参数和范围 |
男装 |
Polo衫 |
肩宽(cm),[30,100] 身高(cm),[120,220] 体重(kg),[30,160] 胸围(cm),[50,200] |
男装 |
夹克 |
肩宽(cm),[30,100] 身高(cm),[120,220] 体重(kg),[30,160] 胸围(cm),[50,200] |
男装 |
西裤 |
身高(cm),[120,220] 体重(kg),[30,160] 臀围(cm),[50,200] 腰围(cm),[50,200] |
男装 |
卫裤 |
身高(cm),[120,220] 体重(kg),[30,160] 臀围(cm),[50,200] 腰围(cm),[50,200] |
女装/女士精品 |
POLO衫 |
肩宽(cm),[30,100] 身高(cm),[120,220] 体重(kg),[30,160] 胸围(cm),[50,200] |
女装/女士精品 |
毛呢外套 |
肩宽(cm),[30,100] 身高(cm),[120,220] 体重(kg),[30,160] 胸围(cm),[50,200] |
女装/女士精品 |
卫裤 |
身高(cm),[120,220] 体重(kg),[30,160] 臀围(cm),[50,200] 腰围(cm),[50,200] |
女装/女士精品 |
半身裙 |
身高(cm),[120,220] 体重(kg),[30,160] 腰围(cm),[50,200] |
女鞋 |
帆布鞋 |
脚长(cm),[20,32] |
女鞋 |
切尔西靴 |
脚长(cm),[20,32] |
流行男鞋 |
帆布鞋 |
脚长(cm),[20,32] |
流行男鞋 |
切尔西靴 |
脚长(cm),[20,32] |
女士内衣/男士内衣/家居服 |
文胸 |
上胸围(cm),[50,150] 下胸围(cm),[50,150] 上下胸围差(cm),/ |
女士内衣/男士内衣/家居服 |
睡裙 |
身高(cm),[120,220] 体重(kg),[30,160] 胸围(cm),[50,200] |
流行男鞋 |
帆布鞋 |
脚长(cm),[20,32] |
女装 |
T恤 |
肩宽(cm),[30,100] 身高(cm),[120,220] 体重(kg),[30,160] 胸围(cm),[50,200] |
影响提交接口
商品新发和编辑提交接口,增加尺码表数据必填校验,包括文案和报错如下:
① 尺码表必填:
报错文案:设置尺码表为必填项,不能为空
报错码:isv.missing-parameter:sizeMapping
② 尺码表因子(列)必填报错
isv.missing-parameter:sizeMapping
sizeMapping:【商品尺寸表】中的必填尺码'S'尚未填写
核心优化点包含:
增加各类目下模特试穿信息的必填项和选填项建议;增加审核链路,审核通过后将展示于商品详情页中的尺码模块,帮助用户选购尺码,更有机会进入买家秀模块。模块示意:
本次改造涉及淘宝和天猫两个市场。具体如下:
① 天猫在本次改造之前支持模特试穿表,但随着千牛WEB端新版组件灰度,天猫旧版组件在TOP端会逐步下线(渲染不返回、提交修改不生效)。需要服务商重新对接新版组件后按照appkey开放支持。
② 淘宝新增支持模特试穿表。
<field id="size_model_try" name="尺码模特试穿表" type="multiComplex"> <complex-values> <field id="sizeModelTry_result" name="试穿心得" type="input"> <value>123</value> </field> <field id="sizeModelTry_image" name="上身素材" type="complex"> <complex-value> <field id="images" type="multiComplex"> <complex-values> <field id="url" type="input"> <value>//img.alicdn.com/imgextra/i4/2211925640408/O1CN01PYGZHq1EsucOXmXrd_!!2211925640408.jpg</value> </field> </complex-values> </field> <field id="videos" type="multiComplex"> <complex-values> <field id="videoId" type="input"> <value>504998464733</value> </field> </complex-values> <complex-values> <field id="videoId" type="input"> <value>504998464732</value> </field> </complex-values> </field> </complex-value> </field> <field id="sizeModelTry_rowId" name="id" type="input"> <value>4</value> </field> <field id="sizeModelTry_tixing" name="体型" type="input"/> <field id="sizeModelTry_size" name="试穿尺码" type="input"> <value>S</value> </field> <field id="sizeModelTry_tunwei" name="臀围(cm)" type="input"/> <field id="sizeModelTry_modelName" name="模特名称" type="input"> <value>模特1</value> </field> <field id="sizeModelTry_tizhong" name="体重(kg)" type="input"> <value>67.0</value> </field> <field id="sizeModelTry_reviewStatus" name="状态" type="complex"> <complex-value> <field id="message" type="input"/> <field id="status" type="input"> <value>成功</value> </field> </complex-value> </field> <field id="sizeModelTry_jiankuan" name="肩宽" type="input"/> <field id="sizeModelTry_shengao" name="身高(cm)" type="input"> <value>123.0</value> </field> <field id="sizeModelTry_xiongwei" name="胸围(cm)" type="input"/> <field id="sizeModelTry_yaowei" name="腰围(cm)" type="input"/> </complex-values> <complex-values> <field id="sizeModelTry_result" name="试穿心得" type="input"> <value>123</value> </field> <field id="sizeModelTry_image" name="上身素材" type="complex"> <complex-value> <field id="images" type="multiComplex"> <complex-values> <field id="url" type="input"> <value>//img.alicdn.com/imgextra/i3/2211925640408/O1CN01BX6xed1EsucPFMys4_!!2211925640408.jpg</value> </field> </complex-values> <complex-values> <field id="url" type="input"> <value>//img.alicdn.com/imgextra/i4/2211925640408/O1CN01PYGZHq1EsucOXmXrd_!!2211925640408.jpg</value> </field> </complex-values> </field> <field id="videos" type="multiComplex"> <complex-values> <field id="videoId" type="input"> <value>504998464732</value> </field> </complex-values> </field> </complex-value> </field> <field id="sizeModelTry_rowId" name="id" type="input"> <value>5</value> </field> <field id="sizeModelTry_tixing" name="体型" type="input"/> <field id="sizeModelTry_size" name="试穿尺码" type="input"> <value>M</value> </field> <field id="sizeModelTry_tunwei" name="臀围(cm)" type="input"/> <field id="sizeModelTry_modelName" name="模特名称" type="input"> <value>模特2</value> </field> <field id="sizeModelTry_tizhong" name="体重(kg)" type="input"> <value>68.0</value> </field> <field id="sizeModelTry_reviewStatus" name="状态" type="complex"> <complex-value> <field id="message" type="input"> <value>模特图片尺寸不符合要求请重新上传</value> </field> <field id="status" type="input"> <value>失败</value> </field> </complex-value> </field> <field id="sizeModelTry_jiankuan" name="肩宽" type="input"/> <field id="sizeModelTry_shengao" name="身高(cm)" type="input"> <value>123.0</value> </field> <field id="sizeModelTry_xiongwei" name="胸围(cm)" type="input"/> <field id="sizeModelTry_yaowei" name="腰围(cm)" type="input"/> </complex-values> <complex-values> <field id="sizeModelTry_result" name="试穿心得" type="input"> <value>123</value> </field> <field id="sizeModelTry_image" name="上身素材" type="complex"> <complex-value> <field id="images" type="multiComplex"> <complex-values> <field id="url" type="input"> <value>//img.alicdn.com/imgextra/i4/2211925640408/O1CN01pYBEjm1EsucNbRKhK_!!2211925640408.jpg</value> </field> </complex-values> <complex-values> <field id="url" type="input"> <value>//img.alicdn.com/imgextra/i3/2211925640408/O1CN01BX6xed1EsucPFMys4_!!2211925640408.jpg</value> </field> </complex-values> </field> </complex-value> </field> <field id="sizeModelTry_rowId" name="id" type="input"> <value>6</value> </field> <field id="sizeModelTry_tixing" name="体型" type="input"/> <field id="sizeModelTry_size" name="试穿尺码" type="input"> <value>L</value> </field> <field id="sizeModelTry_tunwei" name="臀围(cm)" type="input"/> <field id="sizeModelTry_modelName" name="模特名称" type="input"> <value>模特3</value> </field> <field id="sizeModelTry_tizhong" name="体重(kg)" type="input"> <value>68.0</value> </field> <field id="sizeModelTry_reviewStatus" name="状态" type="complex"> <complex-value> <field id="message" type="input"/> <field id="status" type="input"> <value>待审核</value> </field> </complex-value> </field> <field id="sizeModelTry_jiankuan" name="肩宽" type="input"/> <field id="sizeModelTry_shengao" name="身高(cm)" type="input"> <value>123.0</value> </field> <field id="sizeModelTry_xiongwei" name="胸围(cm)" type="input"/> <field id="sizeModelTry_yaowei" name="腰围(cm)" type="input"/> </complex-values> <fields> <field id="sizeModelTry_rowId" name="id" type="input"> <rules> <rule name="valueTypeRule" value="text"/> </rules> </field> <field id="sizeModelTry_reviewStatus" name="状态" type="complex"> <rules> <rule name="readOnlyRule" value="true"/> </rules> <fields/> </field> <field id="sizeModelTry_image" name="上身素材" type="complex"> <rules> <rule name="tipRule" value="上身素材图片和视频可累计上传6个"/> </rules> <fields> <field id="images" name="上传图片" type="multiComplex"> <rules> <rule name="requiredRule" value="true"/> </rules> <fields> <field id="url" name="图片地址" type="input"/> </fields> </field> <field id="videos" name="上传视频" type="multiComplex"> <rules> <rule name="requiredRule" value="true"/> </rules> <fields> <field id="id" name="视频地址" type="input"/> </fields> </field> </fields> </field> <field id="sizeModelTry_modelName" name="模特名称" type="input"> <rules> <rule name="requiredRule" value="true"/> <rule name="maxLengthRule" value="20" exProperty="include" unit="byte"/> <rule name="valueTypeRule" value="text"/> </rules> </field> <field id="sizeModelTry_size" name="试穿尺码" type="input"> <rules> <rule name="requiredRule" value="true"/> <rule name="maxLengthRule" value="10" exProperty="include" unit="byte"/> <rule name="valueTypeRule" value="text"/> </rules> </field> <field id="sizeModelTry_shengao" name="身高(cm)" type="input"> <rules> <rule name="requiredRule" value="true"/> <rule name="maxValueRule" value="220" exProperty="not include"/> <rule name="minValueRule" value="120" exProperty="not include"/> <rule name="regexRule" value="([0-9]{0,3})(\.[0-9]{0,1})?"/> <rule name="valueTypeRule" value="double"/> </rules> </field> <field id="sizeModelTry_tizhong" name="体重(kg)" type="input"> <rules> <rule name="requiredRule" value="true"/> <rule name="maxValueRule" value="160" exProperty="not include"/> <rule name="minValueRule" value="30" exProperty="not include"/> <rule name="regexRule" value="([0-9]{0,3})(\.[0-9]{0,1})?"/> <rule name="valueTypeRule" value="double"/> </rules> </field> <field id="sizeModelTry_result" name="试穿心得" type="input"> <rules> <rule name="requiredRule" value="true"/> <rule name="maxLengthRule" value="32" exProperty="include" unit="byte"/> <rule name="valueTypeRule" value="text"/> </rules> </field> <field id="sizeModelTry_jiankuan" name="肩宽" type="input"> <rules> <rule name="maxValueRule" value="70" exProperty="not include"/> <rule name="minValueRule" value="30" exProperty="not include"/> <rule name="regexRule" value="([0-9]{0,3})(\.[0-9]{0,1})?"/> <rule name="valueTypeRule" value="double"/> </rules> </field> <field id="sizeModelTry_xiongwei" name="胸围(cm)" type="input"> <rules> <rule name="maxValueRule" value="150" exProperty="not include"/> <rule name="minValueRule" value="50" exProperty="not include"/> <rule name="regexRule" value="([0-9]{0,3})(\.[0-9]{0,1})?"/> <rule name="valueTypeRule" value="double"/> </rules> </field> <field id="sizeModelTry_yaowei" name="腰围(cm)" type="input"> <rules> <rule name="maxValueRule" value="150" exProperty="not include"/> <rule name="minValueRule" value="40" exProperty="not include"/> <rule name="regexRule" value="([0-9]{0,3})(\.[0-9]{0,1})?"/> <rule name="valueTypeRule" value="double"/> </rules> </field> <field id="sizeModelTry_tunwei" name="臀围(cm)" type="input"> <rules> <rule name="maxValueRule" value="150" exProperty="not include"/> <rule name="minValueRule" value="50" exProperty="not include"/> <rule name="regexRule" value="([0-9]{0,3})(\.[0-9]{0,1})?"/> <rule name="valueTypeRule" value="double"/> </rules> </field> <field id="sizeModelTry_tixing" name="体型" type="input"> <rules> <rule name="maxLengthRule" value="10" exProperty="include" unit="byte"/> <rule name="valueTypeRule" value="text"/> </rules> </field> </fields> </field>
字段id |
名称 |
说明 |
sizeModelTry_rowId |
模特信息行ID |
服务端自动生成和更新。新增一行模特信息时不用传,编辑商品上已经存在的模特行时回传原本ID即可 |
sizeModelTry_reviewStatus |
审核状态 |
平台需要对商家填写的模特素材、信息作审核。审核通过后才会在C端展示。状态分为三种:通过、审核中、审核拒绝,其中审核拒绝时需要展示原因(message字段),告知商家原因。 |
sizeModelTry_image |
上身素材 |
支持图片、视频两种素材,两种素材总数最多3个。图片使用url,视频videoId。 |
其他字段sizeModelTry_xxx参考字段rules说明即可。
模块示意:
字段名 |
内部字段 |
字段类型 |
字段描述 |
参考格式 |
sizeSellerRecommend |
/ |
complex |
商家建议尺码组件。复杂组件类型 |
|
/ |
indx |
singleCheck |
偏大偏小选项 |
|
/ |
config |
singleCheck |
偏大、偏小所对应 的内层码数选项 |
对应的尺码建议的top端数据如下
<field id="sizeSellerRecommend" name="商家建议尺码" type="complex"> <complex-value> <field id="indx" type="singleCheck"> <value>1</value> </field> </complex-value> <fields> <field id="indx" name="偏大偏小选项" type="singleCheck"> <options> <option displayName="尺码标准,可按常穿尺码选购" value="1"/> <option displayName="码数偏大,选小${config.input1_2}码" value="2"/> <option displayName="码数偏小,选大${config.input1_3}码" value="3"/> </options> </field> <field id="config" name="码数选项" type="singleCheck"> <options> <option displayName="1" value="1"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="2" value="2"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="3" value="3"> <depend-group operator="or"> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="4" value="4"> <depend-group operator="or"> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> </options> </field> </fields> </field>
对应的尺码建议的top端数据如下
<field id="sizeSellerRecommend" name="商家建议尺码" type="complex"> <complex-value> <field id="indx" type="singleCheck"> <value>2</value> </field> <field id="config" type="singleCheck"> <value>1</value> </field> </complex-value> <fields> <field id="indx" name="偏大偏小选项" type="singleCheck"> <options> <option displayName="尺码标准,可按常穿尺码选购" value="1"/> <option displayName="码数偏大,选小${config.input1_2}码" value="2"/> <option displayName="码数偏小,选大${config.input1_3}码" value="3"/> </options> </field> <field id="config" name="码数选项" type="singleCheck"> <options> <option displayName="1" value="1"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="2" value="2"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="3" value="3"> <depend-group operator="or"> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="4" value="4"> <depend-group operator="or"> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> </options> </field> </fields> </field>
偏大或偏小选项对应的可选尺码值与web端可选尺码值保持一致,by类目配置
此处需注意鞋类商品组件较其他类目需要增加两行选项,且偏大偏小的尺码最小单位值为半码。具体如下:
<field id="sizeSellerRecommend" name="商家尺码建议" type="complex"> <rules> <rule name="tipRule" value="请根据商品的尺码特征(标准码/偏大/偏小...)在以下选项中选择相应的尺码建议供消费者参考,该建议后续将在前台(包括商品详情尺码主图及消费者SKU选择界面)进行展示。<a href='https://img.alicdn.com/imgextra/i1/O1CN01SzpJY11zQm4ICG7a7_!!6000000006709-0-tps-976-815.jpg' target='_blank'>消费者前台效果</a>"/> </rules> <complex-value> <field id="indx" type="singleCheck"> <value>4</value> </field> <field id="config" type="singleCheck"> <value>小半</value> </field> </complex-value> <fields> <field id="indx" name="偏大偏小选项" type="singleCheck"> <options> <option displayName="尺码标准,可按常穿尺码选购" value="1"/> <option displayName="码数偏大,选小${config.input1_2}码" value="2"/> <option displayName="码数偏小,选大${config.input1_3}码" value="3"/> <option displayName="偏宽、偏胖或脚背偏高选${config.input1_4}码" value="4"/> <option displayName="不设置商家尺码建议" value="6"/> </options> </field> <field id="config" name="码数选项" type="singleCheck"> <options> <option displayName="大1" value="大1"> <depend-group operator="or"> <depend-express fieldId="indx" value="4" symbol="=="/> </depend-group> </option> <option displayName="小1" value="小1"> <depend-group operator="or"> <depend-express fieldId="indx" value="4" symbol="=="/> </depend-group> </option> <option displayName="大半" value="大半"> <depend-group operator="or"> <depend-express fieldId="indx" value="4" symbol="=="/> </depend-group> </option> <option displayName="小半" value="小半"> <depend-group operator="or"> <depend-express fieldId="indx" value="4" symbol="=="/> </depend-group> </option> <option displayName="大2" value="大2"> <depend-group operator="or"> <depend-express fieldId="indx" value="4" symbol="=="/> </depend-group> </option> <option displayName="小2" value="小2"> <depend-group operator="or"> <depend-express fieldId="indx" value="4" symbol="=="/> </depend-group> </option> <option displayName="半" value="半"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="1" value="1"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> <option displayName="2" value="2"> <depend-group operator="or"> <depend-express fieldId="indx" value="2" symbol="=="/> <depend-express fieldId="indx" value="3" symbol="=="/> </depend-group> </option> </options> </field> </fields> </field>
数据结构与淘宝、天猫服饰类相同,仅可选项与可选尺码枚举值有差异
服务商可通过群“【ISV】服饰尺码相关组件改造对接2025”(群号:107850006050)联系 @默宁@卫洲 沟通灰度和对接。
提供服务商的appkey和测试账号的userId,可以by userId维度配置上述单个组件或两个组件的白名单,ISV可线上环境对接和测试。
服务商可通过群“【ISV】服饰尺码相关组件改造对接2025”(群号:107850006050)联系 @默宁@卫洲 沟通灰度和对接。
服务商对接完成后,线上课根据服务商的appkey启用新组件。此外,组件本身根据业务切流策略,按照类目灰度,灰度类目如下测试类目。 请在“【ISV】服饰尺码相关组件改造对接2025”群(钉钉群号: 107850006050)联系【默宁】进行配置。
目前官方发品,两个组件的灰度类目如下。服务商对接阶段,可以使用如下类目联调测试。预计3月初上线全部类目。
一级类目id |
一级类目名称 |
二级类目id |
二级类目名称 |
叶子类目id |
叶子类目名称 |
30 |
男装 |
50010402 |
Polo衫 |
50010402 |
Polo衫 |
30 |
男装 |
50010158 |
夹克 |
50010158 |
夹克 |
30 |
男装 |
50011129 |
西裤 |
50011129 |
西裤 |
30 |
男装 |
201310125 |
卫裤 |
201310125 |
卫裤 |
16 |
女装/女士精品 |
201241307 |
POLO衫 |
201241307 |
POLO衫 |
16 |
女装/女士精品 |
50013194 |
毛呢外套 |
50013194 |
毛呢外套 |
16 |
女装/女士精品 |
201412701 |
卫裤 |
201412701 |
卫裤 |
16 |
女装/女士精品 |
1623 |
半身裙 |
1623 |
半身裙 |
50006843 |
女鞋 |
50012042 |
帆布鞋 |
50012042 |
帆布鞋 |
50006843 |
女鞋 |
201301735 |
靴子 |
201312504 |
切尔西靴 |
50011740 |
流行男鞋 |
50011744 |
帆布鞋 |
50011744 |
帆布鞋 |
50011740 |
流行男鞋 |
201313101 |
靴子 |
201302933 |
切尔西靴 |
1625 |
女士内衣/男士内衣/家居服 |
50008881 |
文胸 |
50008881 |
文胸 |
1625 |
女士内衣/男士内衣/家居服 |
50012771 |
睡裙 |
50012771 |
睡裙 |