淘宝客新商品ID升级 白皮书-2023年版

摘要: 为了提升淘宝客软件服务及相关工具服务的数据安全保障、服务管理能力,优化体验,淘宝联盟将不断升级平台能力,特推出“淘宝客新商品ID”。该新商品id用于淘宝联盟全推广链路,为后续平台能力的升级打好基础。
天猫开学季主会场,活动时间:2.5-2.9!38¥ CZ3457 sby7d6ZNhLd¥打开手淘。

  一、商品ID升级背景

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

淘宝客新商品ID升级 白皮书-2023年版

  二、淘宝客新商品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升级 白皮书-2023年版

  四、代理模式(自购省/推广赚)与代理模式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账号对同一个商品需聚合统计数据说明》)