京东联盟商品ID切换通知

尊敬的京东联盟平台会员，您好！

为了提升京东联盟平台相关服务的数据安全、管理能力，优化体验，京东联盟平台近期将对平台商品ID进行升级（以下简称“联盟商品ID”）。本次商品ID升级仅为京东联盟侧升级，京东主站的商品ID暂不受本次升级影响（京东APP 12.3.2版本及以后，京东APP复制商品链接，均为“https://3.cn/XXXXX”形式）。

一、 品ID核心变动

1.联盟商品ID将区别于京东主站商品ID，仅在京东联盟业务场景内流通：由静态数字变为动态变化的字符串，推客每次进行转链、获取物料等交互行为商品ID均会发生变化。

2.联盟商品ID长度变化：分为A段和B段，用 “_” 链接，不超过50个字符，示例：VgDXlT9hVVVmDDiCbofTFhV7_VIfTFhV7VVyGGPNs

3.联盟商品ID规则变化：A段为每次请求都会变更，B段为对同unionid（招商团长则为团长ID）和商品在特定范围内不变（范围可能有周期等因素）。（注：特定范围内不变目前不需要关注，正常情况不会变，但如果有数据泄露或安全风控事件，必须要遵循京东联盟相关安全策略）

4.商品链接变化：升级后商品链接：https://jingfen.jd.com/detail/{联盟商品ID}.html（该链接支持搜索商品信息、转链）

二、联盟商品ID升级说明

调用开放平台API的媒体针对联盟商品ID升级的改造要求：

1.从2024年3月6日起，京东联盟开放平台API接口，均会支持京东主站商品ID（skuid）和联盟商品ID（itemId）的出入参

2.联盟商品ID需结合不同业务场景使用，根据不同业务场景引入“场景ID”概念，涉及推广物料、转链、订单查询等核心接口的出入参变动，并且场景ID的使用需要符合对应的场景使用规范。

3.联盟商品ID字段兼容（新字段，string类型）：为保障您调用开发平台API服务不受影响，您需要对您内部系统的字段类型进行调整，根据实际业务场景兼容京东主站商品ID和联盟商品ID。逾期未完成调整，调用开放平台API接口时将可能会出现异常；

4.业务系统需兼容联盟商品ID流通及数据分析：从2024年3月起，联盟商品ID升级陆续灰度，京东联盟陆续会有升级后的商品ID开始流通进入生态；

5.京东联盟PC端、京粉APP不受本次升级影响

三、联盟商品ID切换节奏计划

时间节点一：2024年4月1日

1.2024年4月1日前，所有媒体、所有开发平台API均可正常使用，不受影响。

2.从2024年4月1日起，非企业认证的媒体，京东联盟所有开放平台API接口都仅支持完整的全新的联盟商品ID出入参

3.从2024年4月1日起，部分接口调用量订单转化率低的企业认证媒体，京东联盟所有开放平台API接口都仅支持完整的全新的联盟商品ID出入参。

调用量订单转化率低条件：2023年7月1日-2024年1月31日日，’jd.union.open.goods.query’,’jd.union.open.goods.jingfen.query’,’jd.union.open.goods.material.query’3个接口累计日均调用量＞10万，且媒体日均订单量＜100。

符合条件的媒体请注意查看联盟站内信，同时联盟商务会单独沟通。

时间节点二：2024年4月18日

推广商品查询接口下线，替换成新接口：关键词商品查询接口

秒杀商品查询接口下线，替换成新接口：京粉精选商品查询接口

时间节点三：预计2024年618前

全部媒体完成切换，具体时间节奏请随时关注本文档最新通知或者联盟公告

温馨提醒：联盟推广商品ID升级涉及推广物料、转链、订单查询等核心接口的出入参变动，务必关注相应变更并作线上调整，您可以点击《联盟商品ID切换白皮书（持续更新中）》 https://joyspace.jd.com/pages/DHWZWdQ4fwgxc5DCMuSb 查看详细改造说明文档。

京东联盟平台

2024年03月05日