以下转官方通知:
亲爱的淘宝客,您好!
为了提升淘宝客软件服务及相关工具服务的数据安全保障、服务管理能力,优化体验,淘宝联盟在近期将对平台产品进行多轮升级,第一轮升级内容包括商品ID升级以及工具Appkey相关业务升级,后续升级内容还将包括SID、RID、比价订单预判定API等现有产品能力统一升级为「高级渠道运营管理工具」 等。各项升级我们将分批进行通知。
商品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开始流通进入生态;
商品ID升级后的影响的接口:
(一)影响的喵有券接口:
以下接口,当入参或出参有商品ID时,将会影响。
1.转链接口:
万能转链接口地址:https://www.ecapi.cn/index/index/openapi/id/72.shtml?ptype=1
高佣转链接口地址:https://www.ecapi.cn/index/index/openapi/id/1.shtml?ptype=1
淘口令转链接口地址:https://www.ecapi.cn/index/index/openapi/id/6.shtml?ptype=1
2.商品接口:
全网淘客商品查询接口地址:https://www.ecapi.cn/index/index/openapi/id/9.shtml?ptype=1
简板商品信息接口地址:https://www.ecapi.cn/index/index/openapi/id/11.shtml?ptype=1
物料精选接口地址:https://www.ecapi.cn/index/index/openapi/id/97.shtml?ptype=1
sclick链接解析商品ID接口:https://www.ecapi.cn/index/index/openapi/id/45.shtml?ptype=1
3.订单接口:
接口地址:https://www.ecapi.cn/index/index/openapi/id/83.shtml?ptype=1
(二)影响的官方接口:
如果您有官方基础API,那么要检查以下接口,这些接口将受影响:
场景 | 相关接口 | 新商品ID差异 |
物料场景 | 物料精选: taobao.tbk.sc.optimus.material taobao.tbk.dg.optimus.material 物料搜索: taobao.tbk.dg.material.optional taobao.tbk.sc.material.optional 单品详情: taobao.tbk.item.info.get | 前段动态变化,后段特定范围内不变 |
转链场景 | 高效转链: taobao.tbk.privilege.get taobao.tbk.coupon.convert 淘口令解析: taobao.tbk.sc.tpwd.convert taobao.tbk.tpwd.convert 解析商品id taobao.tbk.item.click.extract | |
订单场景 | 订单明细: taobao.tbk.order.details.get taobao.tbk.sc.order.details.get | 特定范围内不变 |
【商品ID升级】Q&A
一、商品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月底公布解决方案