【非常重要】淘宝联盟关于商品id升级.....持续更新中


升级介绍:

商品ID将由纯数字变为动态变化的字符串,淘宝客每次转链、获取物料等交互行为商品ID均会发生变化。升级后的商品ID整体长度最长为50位,示例:fjdashkhie-r89juoiu,前半段为每次交互都会变化的字符串,后半段为对单个Member账号同商品在特定范围内不变(范围可能有周期等因素)的字符串。


本次升级完成后的商品ID和原始商品ID的变化包括:

1、商品ID由静态数字变为动态变化的字符串:升级后的商品ID将变为动态变化的字符串,淘宝客每次转链、获取物料等接口交互行为出参的商品ID均会发生变化;

2、商品ID长度变化:升级后的商品ID整体长度最长为50位,升级后的商品ID示例:fjdashkhie-r89juoiu,前段和后段间由“-”相连接;

3、商品ID规则变化:升级后的商品ID(示例:fjdashkhie-r89juoiu)中“-”的前半段为每次交互都会变化的字符串,“-”的后半段为对单个Member账号同商品在特定范围内不变(范围可能有周期等因素)的字符串;

4、淘宝客订单明细变化:订单明细里商品ID将升级为同member+同商品的商品ID在特定范围内不变(范围可能有周期等因素);

      温馨提醒:商品ID完成整体升级后,未来联盟各个接口都仅支持升级后的完整商品ID入参。

 

调用API的淘宝客针对本次商品ID升级的改造要求:

1、商品ID需兼容number和string类型:为保障您调用联盟API服务不受影响,您需要在2022年7月18日前对您内部系统的字段类型进行调整,调整后的字段类型需要同时兼容number和string类型的商品ID。逾期未完成调整,调用联盟接口时将可能会出现异常;

2、业务系统需兼容动态的商品ID流通及数据分析:从2022年9月1日起,联盟以下接口的商品ID字段类型将全部变为string类型,陆续会有升级后的动态商品ID开始流通进入生态;


涉及接口:

淘宝客高佣转链api(商品id版):

https://www.dingdanxia.com/doc/2/8 (id入参字符串)

淘宝联盟商品库-超级搜索api接口:


https://www.dingdanxia.com/doc/15/8(item_id出参字符串)

淘宝客官方推荐商品库物料精选/猜你喜欢/相似推荐接口:https://www.dingdanxia.com/doc/41/8 item_id出参字符串

淘宝联盟/饿了么订单查询api接口,淘宝客订单查询api接口:https://www.dingdanxia.com/doc/60/8item_id出参字符串

淘宝客商品详情api接口/是否是营销商品库查询(简版):https://www.dingdanxia.com/doc/12/118

num_iids入参字符串、num_iid 出参字符串

请大家注意调整,以免影响线上业务

【常见问题】

一、商品ID升级相关

1、商品ID变动规律有详细介绍吗,如何判定两个商品ID是否指向同一个商品?

    针对同一个member+同一个商品,新商品ID后段保持不变

2、新商品ID如fjdashkhie-r89juoiu的-前后两段都确定是英文和数字串吧,是否有其它字符 ?

    没有其他字符 ,前段和后端都是英文和数字串,中间用 “-” 连接

3、新商品ID的后半段的变化周期时间能否具体到天数?后段特定范围内不变指的是?

    新商品ID后半段正常情况不会变,但如果有数据泄露或安全风控事件,必须要遵循集团安全策略;若有变动,会提前通知

4、商品字符串有有效期吗,今天生成的串,一年后还能用来转链吗?

    失效规则遵循现有商品ID的生效规则,后续如果有调整我们会提前通知

5、相关商品ID的入参接口,什么时候能兼容新版的字符串商品ID

    服务商相关的接口7.18开始切流(被切到的流量字段类型调整为string),推广者相关的接口8.8开始切流;所有接口8月中下旬将全部切换为string类型,9月开始会有新的字符串类型的商品ID进行流通

6、SDK调用API的服务,也是会在8.8同步切流+更新SDK么?

    更新版SDK预估将于8月中下旬在开放平台发布;请开发者需在字符类型开始切换前(服务商7月18日;推广者8月8日),基于目前使用的SDK做协议适配。具体适配方案详见《商品ID升级》白皮书 - 3.2部分

7、新的动态商品id,在原有接口是通过原item id字段透出?还是会有新字段透出?

    在原有itemid 字段透出,不会新增字段

二、获取物料相关:

1、联盟是否会提供 新商品ID 反查 原始商品ID的接口?

    未来所有淘宝联盟接口都以新商品ID流通,将不会有相关接口提供反查能力

2、淘客B拿到淘客A的新商品ID之后,怎么才能录入到淘客B的商品库里?

    淘客B可以拿到A的新商品ID进行一次转链,获得的新商品ID后段就是淘客B账号唯一的,可以和自己的历史商品库做对比

3、我能不能在物料搜索接口搜索别人的新商品ID链接?

    可以

4、我有商品库,存量的商品ID有没有办法批量更新?

    如果有商品库维护需求, 可反馈至对口商务/运营小二,我们会在一段时间内提供批量更新服务

5、我们的业务链是从招商到推广整个链路的,招商需要带着淘宝主站的商品裸连(数字ID)来提交商品信息,然后再通过我们提供的服务给推广用户做导购推广 ,这块会不会有影响?

    后续商家报名团长的商品,团长把裸链和券链接 提供给渠道推广时 ,裸链里也会是新的商品id

三、转链相关:

1、新的商品ID实施后,要想解析别的商品ID并转成自己的淘口令,升级是否有增加新的商品ID解析接口?

    淘口令解析接口也会支持新的商品ID

2、相同商品,相同Member账号,但使用不同的工具服务商转链,得到的商品ID是否一样?

    一样,针对同一个member+同一个商品,新商品ID后段保持不变,不受appkey影响

3、商品id变成字符串,那商品链接的拼接方式保持不变吗?

    保持不变

4、如果淘宝那边仍然使用的是商品ID,而联盟使用的是新的字符型ID,那么会存在要把淘宝ID转换成联盟的新商品ID再传参转链,这转换如何解决?

    针对消费者返利场景:后续会提供单独的解决方案

    针对选品场景:可通过联盟APP和pub.alimama.com的专属区块进行转链

四、订单相关:

1、怎么解决商品入库 和 商品效果统计问题,根据标题的话不准?

    在订单明细内,针对同一个member+同一个商品,新商品ID保持不变,可用于同一memberId下的同一个商品的判断

2、转链后的出参商品ID, 和订单数据里面的商品ID是一致的吗?

    针对同一个member+同一个商品,新商品ID后段保持不变,前段会随着每次交互发生变化。订单明细里的新商品ID将升级为同member+同商品的商品ID在特定范围内不变

3、如果有多个联盟账号,是否同一个商品,在不同的member账号下的后缀都不一样?能否认证统一?

    针对归属于同一个淘客的多个账号处理情况,我们预计将在7月底公布解决方案