商品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版):
淘宝联盟商品库-超级搜索api接口:
(num_iids入参字符串、num_iid出参字符串)
请大家注意调整,以免影响线上业务
【常见问题】
1、商品ID变动规律有详细介绍吗,如何判定两个商品ID是否指向同一个商品?
针对同一个member+同一个商品,新商品ID后段保持不变
2、新商品ID如fjdashkhie-r89juoiu的-前后两段都确定是英文和数字串吧,是否有其它字符?
没有其他字符,前段和后端都是英文和数字串,中间用“-”连接
新商品ID后半段正常情况不会变,但如果有数据泄露或安全风控事件,必须要遵循集团安全策略;若有变动,会提前通知
4、商品字符串有有效期吗,今天生成的串,一年后还能用来转链吗?
失效规则遵循现有商品ID的生效规则,后续如果有调整我们会提前通知
6、SDK调用API的服务,也是会在8.8同步切流+更新SDK么?
更新版SDK预估将于8月中下旬在开放平台发布;请开发者需在字符类型开始切换前(服务商7月18日;推广者8月8日),基于目前使用的SDK做协议适配。具体适配方案详见《商品ID升级》白皮书-3.2部分
7、新的动态商品id,在原有接口是通过原itemid字段透出?还是会有新字段透出?
在原有itemid字段透出,不会新增字段
1、联盟是否会提供新商品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月底公布解决方案