升级介绍:
商品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/8(item_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月底公布解决方案