注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 基础技术

新版旺铺无线详情描述--原神笔

更新时间:2019/08/22 访问次数:4965

升级原因

  • 旺铺详情编辑器(原神笔)和天猫商品发布的无线详情组件,长期以来存在数据相互覆盖切不兼容的问题,影响卖家体验和效率。商品发布(web网页和TOP)中无线详情升级为旺铺详情编辑器。
  • 升级过程以卖家维度灰度,灰度卖家TOP接口升级为新版。新版的wireless_desc字段的中文名称为:旺铺无线详情描述。

不升级的后果&升级的方法

  • 对于店铺活动、掌柜推荐、优惠券、搭配、文字说明这几个原支持选择模板的几个模块,现新增字段,支持直接填写模块内容(如店铺活动除了原shop_discount_id选择模板,新增了图片shop_discount_image和链接shop_discount_url字段)。
  • 防止数据丢失,请不修改详情的情况下,将模块中模板数据和新增加的字段都能识别,不要丢失,都原样提交过来。
  • 为了兼容新旧两种逻辑,填写的时候,新旧两种逻辑都设置,否则修改不生效(如店铺活动除了原shop_discount_id选择模板,新增了图片shop_discount_image和链接shop_discount_url字段)。模板字段将在未来下线。

过程

  • 10月8号开始,按照用户灰度逐步切量

测试

  • 线上已经全部生效,不生效的请咨询自己行业同学小二

1、模块顺序&图文模块

  • 原来的模块顺序是以卖家在后台:https://sell.tmall.com/auction/extend/wap_desc_template_sequence.htm 设置的,按照类目对应的模板来设置的
  • 新版的旺铺详情模块顺序来自旺铺后台装修,已装修的模块排在上方,未装修的模块排在下方。
  • 营销类的模块必须装在顶部或者底部,其他模块在营销模块中间区域。
  • 其中部分在网页后台可见的模块在Top接口中不支持编辑:群聊、直播、视频、动图,网页中设置了,在Top接口中不透出,但修改其他模块时不会影响这些模块的数据。
  • 图文模块是旺铺支持添加的图文类模块,不限制模块个数和模块中的图片个数。图文模块在TOP接口中会透出,但是不支持修改和添加,只识别enable=false的删除逻辑。
  • 读接口返回如下:
  • 模块的id为image_text_0,最后一个数字是模块的顺序,从0开始,卖家装修了几个有几个。每个模块的图片数据image_text_0_image_0,这个是第一个图文模块的第一图,每个模块的图片数据也是不固定的。

    <field id="image_text_0" name="图文模块(旺铺详情)" type="complex">
    <rules>
     <rule name="devTipRule" value="该模块为旺铺后台的添加的图文模块,由于数据格式复杂,暂不支持使用TOP修改,可以设置enable为false,以删除该模块。"/>
    </rules>
    <fields>
     <field id="image_text_0_enable" name="是否启用" type="singleCheck">
      <options>
       <option displayName="启用" value="true"/>
       <option displayName="不启用" value="false"/>
      </options>
     </field>
     <field id="image_text_0_image_0" name="展示图片(只读,不支持修改)" type="input">
      <rules>
       <rule name="disableRule" value="true">
        <depend-group operator="and">
         <depend-express fieldId="image_text_0_enable" value="true" symbol="!="/>
        </depend-group>
       </rule>
       <rule name="readOnlyRule" value="true"/>
      </rules>
     </field>
    </fields>
       </field>
  • 修改时设置对应的图片为enable=false即可删除,不支持新增,图片地址也不支持修改。

    <field id="image_text_2" type="complex">
            <complex-values>
                <field id="image_text_2_image_0" type="input">
                    <value>https://img.alicdn.com/imgextra/i3/88591187/O1CN011KdgceN0PcSy33K_!!88591187.jpg</value>
                </field>
                <field id="image_text_2_image_1" type="input">
                    <value>https://img.alicdn.com/imgextra/i1/88591187/O1CN011Kdgcc8R3o8TIA9_!!88591187.jpg</value>
                </field>
                <field id="image_text_2_enable" type="singleCheck">
                    <value>true</value>
                </field>
            </complex-values>
        </field>

    2、旺铺后台,批量投放模块不支持top修改

  • 读接口的返回如下:
  • 提交过来不会识别
  • 示例rule

    <field id="coupon" name="批量投放模块-优惠" type="complex">
      <rules>
    <rule name="devTipRule" value="该模块为旺铺后台批量投放模块,不支持使用TOP修改"/>
      </rules>
      <fields/>
    </field>

    3、店铺活动

  • 新增图片shop_discount_image和链接shop_discount_url字段,直接修改数据内容。
  • 注意: shop_discount_image和shop_discount_url需要同时填写才会生效,设置shop_discount_image和shop_discount_url之后,请不要设置shop_discount_id选择模板。shop_discount_id的设置将不生效。
  • 示例rule

    <field id="shop_discount" name="店铺活动" type="complex">
      <rules>
    <rule name="devTipRule"                      value="您可以选择下方已经设置好的店铺活动模板,也可以去&lt;a href='modularManager.htm?type=home' target='_blank'&gt;设置店铺活动&lt;/a&gt;。"/>
      </rules>
      <fields>
    <field id="shop_discount_enable" name="是否启用" type="singleCheck">
      <options>
        <option displayName="启用" value="true"/>
        <option displayName="不启用" value="false"/>
      </options>
    </field>
    <field id="shop_discount_id" name="选择模板" type="singleCheck">
      <rules>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="shop_discount_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
      <options>
        <option displayName="aaaaa" value="124"/>
        <option displayName="这是店铺活动" value="125"/>
      </options>
    </field>
    <field id="shop_discount_image" name="活动图片" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="shop_discount_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="shop_discount_url" name="跳转链接" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="shop_discount_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
      </fields>
    </field>
  • 拼接入参示例

    <field id="shop_discount" type="complex">
      <complex-values>
    <field id="shop_discount_enable" type="singleCheck">
      <value>true</value>
    </field>
    <field id="shop_discount_url" type="input">
      <value>//wuxian.taobao.com/spark/customPageList.htm?spm=a219s.7437505.0.0.4lopOB</value>
    </field>
    <field id="shop_discount_image" type="input">
      <value>//img.alicdn.com/imgextra/i4/263674894/O1CN011m1Un8czupgEmy2_!!263674894.jpg</value>
    </field>
      </complex-values>
    </field>

    4、优惠券

  • 新增优惠券选择字段,支持最多填写六个优惠券地址coupon_url_0~coupon_url_5。(领取地址,例如:https://taoquan.taobao.com/coupon/unify_apply.htm?sellerId=263671308&activityId=cef1eb933dc14f1e936b57f8044a36a4)
  • 注意:设置优惠券地址之后,请不要设置coupon_id选择模板数据。coupon_id的设置将不生效。
  • 如果没有设置优惠券的模板和优惠券的地址,同时coupon_enable为true,则会使用默认的系统优惠券展示(公开渠道的优惠券,前6个)
  • 示例rule

    <field id="coupon" name="优惠" type="complex">
      <rules>
    <rule name="devTipRule"                      value="您可以选择下方设置好的优惠券模板,也可以去&lt;a href='modularManager.htm?type=home' target='_blank'&gt;设置优惠券模板&lt;/a&gt;。"/>
      </rules>
      <fields>
    <field id="coupon_enable" name="是否启用" type="singleCheck">
      <options>
        <option displayName="启用" value="true"/>
        <option displayName="不启用" value="false"/>
      </options>
    </field>
    <field id="coupon_id" name="选择模板" type="singleCheck">
      <rules>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
      <options>
        <option displayName="异天测试优惠券模板" value="140"/>
        <option displayName="xxxxxxxx" value="146"/>
        <option displayName="bruce" value="147"/>
        <option displayName="不是系统推荐" value="151"/>
        <option displayName="dadadad" value="152"/>
        <option displayName="一个两个三个四个五个" value="154"/>
        <option displayName="自定义1" value="179"/>
        <option displayName="系统推荐33" value="184"/>
      </options>
    </field>
    <field id="coupon_url_0" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="coupon_url_1" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="coupon_url_2" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="coupon_url_3" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="coupon_url_4" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="coupon_url_5" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="coupon_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
      </fields>
    </field>
  • 拼接入参示例

    <field id="coupon" type="complex">
      <complex-values>
    <field id="coupon_enable" type="singleCheck">
      <value>true</value>
    </field>
    <field id="coupon_url_0" type="input">
      <value>https://taoquan.taobao.com/coupon/unify_apply.htm?sellerId=2049872296&amp;activityId=816270b4f92f4514a3074d3799651a0b</value>
    </field>
    <field id="coupon_url_1" type="input">
      <value>https://taoquan.taobao.com/coupon/unify_apply.htm?sellerId=2049872296&amp;activityId=                        6b643e5987574369a38e2b91506cfb31                    </value>
    </field>
    <field id="coupon_url_2" type="input">
      <value>https://taoquan.taobao.com/coupon/unify_apply.htm?sellerId=2049872296&amp;activityId=                        f9336d4a84754ea1b6377a4a3177c0eb                    </value>
    </field>
      </complex-values>
    </field>

5、卖家推荐(升级为掌柜推荐)

  • 新增推荐类型hot_recommanded_smart_sort,商品列表hot_recommanded_item_ids两个字段。
  • hot_recommanded_smart_sort是是否进行算法排序方式,有两个选择,算法排序为true,手动为false。
  • hot_recommanded_item_ids是需要设置的商品,最多设置50个。对于手动排序至少要设置3个宝贝,如果是智能排序,可以不设置宝贝,则为默认全店范围内算法推荐。数据为宝贝id排序,宝贝之间用英文,隔开。例如:569532974622,569325328246,566769711593
  • 注意: 设置hot_recommanded_smart_sort之后,请不要设置hot_recommanded_id选择模板。hot_recommanded_id的设置将不生效。
  • 示例rule

    <field id="hot_recommanded" name="同店推荐" type="complex">
      <rules>
    <rule name="devTipRule"                      value="您可以选择下方已经设置好的同店推荐模板,也可以去&lt;a href='modularManager.htm?type=home' target='_blank'&gt;设置同店推荐模板&lt;/a&gt;。"/>
      </rules>
      <fields>
    <field id="hot_recommanded_enable" name="是否启用" type="singleCheck">
      <options>
        <option displayName="启用" value="true"/>
        <option displayName="不启用" value="false"/>
      </options>
    </field>
    <field id="hot_recommanded_id" name="选择模板" type="singleCheck">
      <rules>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="hot_recommanded_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
      <options>
        <option displayName="吃" value="117"/>
        <option displayName="新增模板" value="119"/>
        <option displayName="aaaaa" value="145"/>
        <option displayName="aaaaaa" value="148"/>
        <option displayName="2100718931616" value="172"/>
        <option displayName="测试2" value="173"/>
        <option displayName="智能卖家推荐1474184258054" value="374"/>
        <option displayName="34535345" value="465"/>
      </options>
    </field>
    <field id="hot_recommanded_smart_sort" name="推荐方式" type="singleCheck">
      <rules>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="hot_recommanded_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
      <options>
        <option displayName="智能" value="true"/>
        <option displayName="手动" value="false"/>
      </options>
    </field>
    <field id="hot_recommanded_item_ids" name="设置宝贝" type="input">
      <rules>
        <rule name="valueTypeRule" value="text"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="hot_recommanded_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
      </fields>
    </field>
  • 拼接入参示例

    <field id="hot_recommanded" type="complex">
      <complex-values>
    <field id="hot_recommanded_item_ids" type="input">
      <value>569532974622,569325328246,566769711593</value>
    </field>
    <field id="hot_recommanded_enable" type="singleCheck">
      <value>true</value>
    </field>
    <field id="hot_recommanded_smart_sort" type="singleCheck">
      <value>false</value>
    </field>
      </complex-values>
    </field>

6、搭配推荐

  • 新增搭配背景图片dapei_image,商品列表dapei_item_ids两个字段。
  • dapei_image和dapei_item_ids需要都设置的时候才生效。
  • dapei_item_ids是需要设置的商品,最少设置两个,最多设置10个。数据为宝贝id排序,宝贝之间用英文,隔开。例如:569532974622,569325328246,566769711593
  • 注意: 设置dapei_image和dapei_item_id之后,请不要设置dapei_id选择模板。dapei_id的设置将不生效。
  • 示例rule

    <field id="dapei" name="搭配推荐" type="complex">
      <rules>
    <rule name="devTipRule" value="新发商品不能使用搭配模块。编辑商品时,您可以选择下方已经设置好的搭配模板,也可以去&lt;a href='modularManager.htm?type=fit' target='_blank'&gt;设置搭配模板&lt;/a&gt;。已创建的模板不展示?&lt;a href='//maowo.tmall.com/discussion.htm?id=56164&amp;circleId=45' target='_blank'&gt;查看原因&lt;/a&gt;"/>
      </rules>
      <fields>
    <field id="dapei_enable" name="是否启用" type="singleCheck">
      <options>
        <option displayName="启用" value="true"/>
        <option displayName="不启用" value="false"/>
      </options>
    </field>
    <field id="dapei_id" name="选择模板" type="singleCheck">
      <rules>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="dapei_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
      <options>
        <option displayName="测试下怎么不展示" value="1347904"/>
      </options>
    </field>
    <field id="dapei_image" name="搭配背景图片" type="input">
      <rules>
        <rule name="valueTypeRule" value="url"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="dapei_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
    <field id="dapei_item_ids" name="设置宝贝" type="input">
      <rules>
        <rule name="valueTypeRule" value="text"/>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="dapei_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
    </field>
      </fields>
    </field>
  • 拼接入参示例

    <field id="dapei" type="complex">
      <complex-values>
    <field id="dapei_item_ids" type="input">
      <value>575378664087</value>
    </field>
    <field id="dapei_enable" type="singleCheck">
      <value>true</value>
    </field>
    <field id="dapei_image" type="input">
      <value>//img.alicdn.com/imgextra/i2/263671308/O1CN011LX6W4g0KIiUiXY_!!263671308.jpeg</value>
    </field>
      </complex-values>
    </field>

7、文本模块

  • 新增item_text_text字段,支持直接修改数据内容。
  • 注意:设置item_text_text之后,请不要设置item_text_id选择模板。item_text_id的设置将不生效。
  • 示例rule

    <field id="item_text" name="文字说明" type="complex">
      <rules>
    <rule name="devTipRule"                      value="您可以选择下方设置好的文字说明模板,也可以去&lt;a href='modularManager.htm?type=home' target='_blank'&gt;设置文字说明模板&lt;/a&gt;。"/>
      </rules>
      <fields>
    <field id="item_text_enable" name="是否启用" type="singleCheck">
      <options>
        <option displayName="启用" value="true"/>
        <option displayName="不启用" value="false"/>
      </options>
    </field>
    <field id="item_text_id" name="选择模板" type="singleCheck">
      <rules>
        <rule name="disableRule" value="true">
          <depend-group operator="and">
            <depend-express fieldId="item_text_enable" value="true" symbol="!="/>
          </depend-group>
        </rule>
      </rules>
      <options>
        <option displayName="565" value="213"/>
        <option displayName="1232122" value="214"/>
        <option displayName="1212123213" value="215"/>
      </options>
    </field>
    <field id="item_text_text" name="文字说明" type="input">
      <rules>
        <rule name="maxLengthRule" value="500" exProperty="include"/>
      </rules>
    </field>
      </fields>
    </field>
  • 拼接入参示例

    <field id="item_text" type="complex">
      <complex-values>
    <field id="item_text_text" type="input">
      <value>            xczxczxczxc       czczxczczx                        czxcz哈哈哈哈                        发大幅度发大幅度发大幅度发大幅度发大幅度发大幅度发大幅度发大幅度发大幅度发大幅度发大幅度发大幅</value>
    </field>
    <field id="item_text_enable" type="singleCheck">
      <value>true</value>
    </field>
      </complex-values>
    </field>

FAQ

关于此文档暂时还没有FAQ
返回
顶部