一、商品ID升级背景

　　为了提升淘宝客软件服务及相关工具服务的数据安全保障、服务管理能力，优化体验，淘宝联盟将不断升级平台能力，特推出“淘宝客新商品ID”。该新商品id用于淘宝联盟全推广链路，为后续平台能力的升级打好基础。

　　二、淘宝客新商品ID简介

　　1、新商品id定义&样式

　　定义：淘宝客新商品id，作为淘宝联盟业务场景内流通的商品id，为动态变化的字符串，淘宝客每次转链、获取物料等接口交互行为出参的商品ID均会发生变化。

　　样式：淘宝客新商品id，整体长度最长为50位，共分为A段与B段，中间用“-”连接，其中A段为每次交互都会变化的字符串，B段为对单个member账号而言同一个商品在特定范围内保持不变的字符串(范围可能有周期等因素，正常情况不会变，但如果有数据泄露或安全风控事件，必须要遵循淘宝联盟相关安全策略)。示例：fjdashkhie-r89juoiu

　　2、新商品id升级说明

　　升级说明 升级前 升级后

　　淘宝数字商品ID 淘宝客新商品ID

　　示例 678220217983 fjdashkhie-r89juoiu

　　变化 数字串

　　(API字段类型：number) 动态变化的字符串

　　(API字段类型：string)

　　升级改造关键：

　　① 2022年9月1日起，淘宝联盟业务内流通的商品id，已逐步切换为淘宝客新商品id，自2022年12月29日起，所有商品全部切换完毕，订单明细报表的商品id字段随着货盘节奏切换而一并升级;

　　② 2022年9月1日起，API接口内凡原商品id字段，均已从原number类型改成string类型，该string类型已经兼容纯数字串或字符串的能力，具体涉及API列表，详细参见《附录1、本次升级所涉及的API及字段改造说明》;

　　③ 新商品id需结合不同业务场景使用，即需与“场景id/代理模式id”联动，涉及物料、转链、订单查询等核心接口的出入参变动，场景id/代理模式id的使用需符合对应的场景使用规范，详细参见下文《三、业务场景介绍与场景id使用说明》、《四、代理模式(自购省/推广赚)与代理模式id使用说明》。

　　(备注：正常情况下，新商品ID的B段参数，仅对单个member账号而言是同一个商品在特定范围内保持不变的字符串，若有特殊情况如存在同一家公司，有多个淘宝客账号，需要在订单中聚合统计多member下同一个商品的推广效果，可支持在多个member账号内，识别同一个商品，该能力需申请“虚拟member组”提报能力，详细参见《附录3、多member账号对同一个商品需聚合统计数据说明》。)

　　1、【普通转链场景】规范使用说明

　　前言：若无其他特殊业务场景，常规新商品id推广转链，比如导购转链、采集群商品获取后转链的业务场景。该场景id使用规范，可见本部分介绍。

　　本场景id的api参数，即biz_scene_id=1(本场景无需申请权限)

　　● 使用API查询商品信息时：商品id字段仅支持入参完整的淘宝客新商品id进行信息查询，此时biz_scene_id=默认1，无需主动入参。

　　● 使用物料精选获取商品列表时：获取到的商品列表的商品id即为新商品id。

　　● 物料搜索接口获取批量商品列表时：

　　○ 默认biz_scene_id=1，无需主动入参，获取到的商品列表的商品id即为新商品id;

　　○ q参数，使用标题精准搜索时，若搜索结果只有一个商品，因无消费者比价场景权限，则出参时不再提供商品推广链接和商品id字段，若搜索结果仍有多个商品，则会正常出参。

　　● 使用API转链时：商品id字段仅支持入参完整的淘宝客新商品id转链，此时biz_scene_id=默认1，无需主动入参。

　　● 使用淘口令解析API时：若为淘宝客淘口令，则出参告知biz_scene_id=1，对应商品id为新商品id、并有商品推广链接;若为淘宝复制的淘口令，则出参告知biz_scene_id=2，对应商品id为淘宝数字商品id，因无消费者比价场景权限，则不再提供推广链接。

　　● 链接解析API时：淘宝客推广链接，则出参告知biz_scene_id=1，对应商品id为新商品id。

　　(具体所涉及的API及字段使用说明，详细参见《附录1、本次升级所涉及的API及字段改造说明》)

　　2、【消费者比价场景】规范使用说明

　　前言：针对消费者精准返利，即需支持消费者复制淘宝链接/淘口令查询是否存在返利的业务场景。该场景id使用规范，可见本部分介绍。

　　本场景id的api参数，即biz_scene_id=2(本场景权限需要申请)

　　● 使用API查询商品信息时：商品id字段可支持入参淘宝数字商品id，此时需入参biz_scene_id=2，否则淘宝数字商品id无法查询出信息。

　　● 物料搜索接口获取批量商品列表时：q参数，支持标题精准搜索，即若搜索结果只有一个商品，也可正常出参。

　　● 使用API转链商品：商品id字段可支持入参淘宝数字商品id，此时需入参biz_scene_id=2，否则淘宝数字商品id无法转链。

　　● 使用淘口令解析API时：若为淘宝客淘口令，则出参告知biz_scene_id=1，对应商品id为新商品id、并有商品推广链接;若为淘宝复制的淘口令，则出参告知biz_scene_id=2，对应商品id为淘宝数字商品id，也会提供推广链接。

　　(具体所涉及的API及字段使用说明，详细参见《附录1、本次升级所涉及的API及字段改造说明》)

　　本场景id权限申请：【消费者比价场景】查看申请条件并填写问卷申请

　　3、【商品库导购场景】规范使用说明

　　前言：针对部分淘宝客有建立自己独立的小规模商品库，需对商品库进行管理，并对商品库内商品进行直接导购推广需要的业务场景。该场景id使用规范，可见本部分介绍。

　　本场景id的api参数，即biz_scene_id=3(本场景权限需要申请)

　　● 对已有管理的小规模商品库，需要将原淘宝数字商品id，升级为淘宝客新商品id：可向联盟小二申请快速刷库API(仅限短期支持)，可支持商品库内的淘宝数字商品id，批量转换出淘宝客新商品id的B段参数，即可替换保存管理。

　　● 商品库内商品，需要查询商品信息时：商品id字段可支持入参新商品id的B段参数(请用自己库内管理的商品B端参数)，此时需入参biz_scene_id=3，否则该B段参数无法查询出信息。

　　● 商品库内商品，需要用于导购推广转链：使用转链API时，商品id字段可支持新商品id的B段参数直接入参(请用自己库内管理的商品B端参数)，此时需入参biz_scene_id=3，否则无法生成推广链接。

　　(具体所涉及的API及字段使用说明，详细参见《附录1、本次升级所涉及的API及字段改造说明》)

　　本场景id权限申请：【商品库导购场景】查看申请条件并填写问卷申请

　　四、代理模式(自购省/推广赚)与代理模式id使用说明

　　代理模式概念：针对使用渠道管理能力的淘宝客，存在代理拓展(对代理提供“推广赚”服务)和消费导购(对用户购买提供“自购省”服务)的两种业务形态。针对代理模式，本次升级，新增细分模式id，在转链时，需主动区分自购省和推广赚的业务形态，带上对应模式id进行转链。有代理模式的淘宝客，代理模式id使用规范，可见本部分介绍。

　　代理模式id的api参数，即promotion_type=1为自购省，promotion_type=2为推广赚

　　● 使用API转链时：针对代理推广的“推广赚”功能，触发转链时必须入参promotion_type=2和relation_id;针对用户消费的“自购省”功能，触发转链时必须入参promotion_type=1。商品id字段支持入参完整的淘宝客新商品id转链，商品id字段如有特殊需要，看如下说明：

　　○ 若存在自建的小规模商品库，希望对库内商品进行直接转链，即拥有“商品库导购场景权限”的媒体，入参biz_scene_id=3，商品id字段即可支持入参新商品id的B段参数直接转链;

　　○ 若“自购省”业务形态中，若存在消费者比价场景，即商品id字段需支持淘宝数字商品id转链，则需要申请拥有“消费者比价场景权限”，此时入参promotion_type=1的前提下，再入参biz_scene_id=2，即可实现淘宝数字商品id转链

　　○ 若“推广赚”业务形态中，存在代理小B们的选品识别需要，即代理在淘宝选品，直接复制淘宝数字商品id进行推广转链，也需申请“消费者比价场景权限”，则此时入参promotion_type=2和relation_id的前提下，再入参biz_scene_id=2，即可实现淘宝数字商品id转链

　　● 使用淘口令解析API时：若为淘宝客淘口令，则出参告知biz_scene_id=1，对应商品id为新商品id，并有商品推广链接;若为淘宝复制的淘口令，则出参告知biz_scene_id=2，对应商品id为淘宝数字商品id，若有消费者比价场景权限，则还会提供推广链接，否则无。(对代理媒体而言，建议该接口仅用于解析，最终该批商品是用于推广赚还是自购省，以最终的转链API接口判断为准。)

　　● 链接解析API时：淘宝客推广链接，则出参告知biz_scene_id=1，对应商品id为新商品id。

　　● 使用API查询商品信息时：商品id字段支持入参完整的淘宝客新商品id进行信息查询，此时biz_scene_id默认=1，无需主动入参。

　　○ 若有“消费者比价场景权限”，入参biz_scene_id=2，商品id字段即可支持入参淘宝数字商品id进行信息查询;

　　○ 若有“商品库导购场景权限”，入参biz_scene_id=3，商品id字段即可支持入参新商品id的B段参数进行信息查询。

　　● 物料搜索接口获取批量商品列表时：针对代理推广的“推广赚”功能，触发转链时必须入参promotion_type=2和relation_id;针对用户消费的“自购省”功能，触发转链时必须入参promotion_type=1。q参数，当使用标题精准入参搜索，搜索结果只有一个商品时，如有消费者比价场景权限，则出参正常，否则不提供商品推广链接和商品id字段。(对代理媒体而言，建议该接口仅用于解析，最终该批商品是用于推广赚还是自购省，以最终的转链API接口判断为准。)

　　● 物料精选接口获取批量商品列表时：获取到的商品列表的商品id即为新商品id。(对代理媒体而言，建议该接口仅用于商品获取，最终该批商品是用于推广赚还是自购省，以最终的转链API接口判断为准。)

　　(具体所涉及的API及字段使用说明，详细参见《附录1、本次升级所涉及的API及字段改造说明》)

　　五、订单明细与商品推广效果查询说明

　　淘宝客新商品id(示例：fjdashkhie-r89juoiu)，共分为A段与B段，中间用“-”连接，在推广链路中，其中A段为每次因转链交互都会变化的字符串，B段为对单个member账号而言同一个商品在特定范围内保持不变的字符串。

　　但请注意：

　　1、在订单明细报表中，商品id字段，由原来的淘宝数字商品id变更为新商品id，且同时，同一个member账号下同一个商品，订单明细中的AB两段都是固定不变的，即为一个固定的新商品id，此A段，与推广链路中的A段并不相同，故若需与推广商品id查询匹配，建议用B段参数查询;

　　2、商品维度的推广效果报表，也为新商品id，与订单明细中的固定不变的新商品id保持一致。

　　报表查询包括：联盟PC电脑端报表、联盟APP报表、订单明细API。

　　(特别说明：若有特殊情况如存在同一家公司，有多个淘宝客账号，需要聚合统计多member下同一个商品的推广效果，可支持在多个member账号内，识别同一个商品，该能力需申请“虚拟member组”提报能力，详细参见《附录3、多member账号对同一个商品需聚合统计数据说明》)