摘要：京东联盟平台为了提升服务的数据安全和管理能力，优化用户体验，计划对平台的商品ID进行升级。升级后的联盟商品ID将不同于京东主站商品ID，具有动态变化的特点，在联盟业务场景内使用，并通过特定规则生成不超过50个字符的字符串形式。从2024年3月6日起，开放平台API接口将同时支持京东主站商品ID和新联盟商品ID，并引入“场景ID”概念以适应不同业务场景需求。联盟商品ID切换将在2024年4月1日开始分阶段实施，首先影响非企业认证媒体及部分调用量订单转化率低的企业认证媒体。在2024年4月18日，部分旧查询接口将被替换为新接口，并预计于当年618前完成全部媒体的切换工作。京东联盟提醒各会员关注相应变更并及时调整线上系统，可通过查阅《联盟商品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日