分享

淘宝联盟选品组&定向招商API开发指南|淘宝客交流

 吕小薇 2016-09-06
1. 概述


1.1 选品组
    淘宝联盟发布了功能强大的超级搜索和主题频道(下文简称频道);提供丰富的筛选项供淘宝客选择商品进行推广;淘宝联盟提供选品组的方式保存选品结果;每个选品组中包含了若干商品;淘宝客可以创建选品组,并为每个选品组选择合适的商品;选品组目前分为普通选品组和高佣金选品组;高佣金选品组里面的商品来自于高佣金频道,普通选品组里面的商品来自超级搜索选品和非高佣金频道选品;
超级搜索相关产品介绍, club.alimama.com/read-htm-tid-6631717.html
超级搜索培训视频, http://shuyuan.taobao.com/?spm=a231i.6693221.0.0.cm4uue#!/selftutorial/detail?id=479
1.2 定向招商
    淘宝客进行选品后得到了选品组,为了进一步达成淘宝客和卖家之间的合作,获取更高的收益,淘宝联盟推出了定向招商产品;让淘宝客可以针对选品组里面的商品的卖家发起定向招商;定向招商的数据具有时效性,所以使用API同步定向招商数据的时候要注意定向招商是否过期,或者尚未开始;目前API只支持读取正在进行中的招商;特殊注意当天开始的定向招商凌晨2点左右生效,过早不能拿到数据;定向招商中的淘宝客商品在卖家参与报名的情况下是用报名的佣金进行结算;如果卖家未报名,活动开始后自动采用通用佣金或定向计划佣金(如果和卖家达成过定向计划)结算;
定向招商产品介绍,club.alimama.com/read-htm-tid-6658372.html


2. 功能说明
   从技术的角度来说,选品组相当于淘宝客在创建的商品数据库;每个数据库里面包含了若干用于推广的商品;定向招商类似,只是有效期限制,有效期内, 按照淘宝客和卖家协商的佣金进行结算;选品组和定向招商中的商品API输出结果中已经包含了淘宝客推广链接(s.click)。
选品组&定向招商API主要包含了4个API
枚举选品组列表, taobao.tbk.uatm.favorites.get
http://open.taobao.com/doc2/apiDetail.htm?spm=a219a.7395905.0.0.vjXQiX&apiId=26620
指定选品组id读取该选品组内部的商品信息,taobao.tbk.uatm.favorites.item.get
http://open.taobao.com/doc2/apiDetail.htm?spm=a219a.7395905.0.0.MELO98&apiId=26619
枚举定向招商列表,taobao.tbk.uatm.event.get
http://open.taobao.com/doc2/apiDetail.htm?spm=a219a.7395905.0.0.xyzraZ&apiId=26449
指定定向招商id读取该招商内部的商品信息,taobao.tbk.uatm.event.item.get
http://open.taobao.com/doc2/apiDetail.htm?spm=a219a.7395905.0.0.mbiEBf&apiId=26616


2.1 使用方式
    在超级搜索/频道中制作选品组或者招商活动开始后,就可以使用API进行自动化数据同步了;由于选品组和招商API主要是让淘宝客在选品后进行高效的数据读取工作;比如API读取商品数据入库到入库淘宝客开发者的数据库中,用于最终的展现推广, 如下所示:




3. 常见问题
①这套的API的可以帮助淘宝客从哪些方面提高效率?
目前淘宝联盟后台提供选品组或者招商中的商品批量excel下载;对于有开发能力的淘宝客,一般维护有自己的淘宝客商品数据库,如存储在MySQL中用于支持网站展现推广或者导购app应用,人工下载文件,入库管理不方便;
首先,淘宝客在超级搜索或者频道进行人工的选品工作,得到选品组或者发起定向招商之后, 基于API开发者可以程序化的遍历淘宝客的自己的选品库或者招商,即将内部的淘宝客商品程序化的读取到自己的应用数据库当中,进行进一步的管理,再加工(如ps图片后再进行展现推广)或者直接进行展现推广;
选品和定向招商的API输出的商品都是带淘客推广链接的,可以直接进行推广;


②有什么使用模式可以推荐吗?
一种可能的模式为,如果您是团队化运作,可以先让你资深的编辑运营人员来联盟后台使用超级搜索和各类特色频道发现适合推广的商品后,最终生成选品组或者招商,然后您的工程师开发自动化程序会每天定期读取编辑生成的最新数据;亦或者,您的编辑人员在选品完成之后,就可以进入到一个选品组和招商互动的详情页查看选品组id或者活动id; 利用这个id作为输入,可以立即使用API将选品组和活动中的商品信息立即同步到您的系统后台;


③选品组的id或者定向招商的id如何获得?
可以通过taobao.tbk.uatm.favorites.get,或taobao.tbk.uatm.event.get枚举选品组和招商的列表,其中包含了每个选品组或者招商的id。也可以在淘宝联盟后台点击打开一个选品组和招商活动查看详情,浏览器中的url中也包含了选品组或招商的id;
指定选品组id或者定向招商id读取商品信息的时候,为什么需要填入推广位id(adonzeid)?
因为选品组或者定向招商的API输出的商品信息中包含淘宝客推广链接,推广链接的生成需要用户指定自己的推广位id;特别要注意的是,推广位id是需要先在淘宝联盟后台创建的,如何找到一个自己合法的推广位id,请参考club.alimama.com/read-htm-tid-6333967.html?spm=0.0.0.0.bcmp9y,关于”API推广如何获取adzoneId”部分内容;


④选品组的最多能读取多少个商品?
这个取决于您在联盟超级搜索中生成了多少个选品组和每个选品组里面保存了多少个商品,目前支持100个选品组,每个选品组里面最多200个商品;即您一次性可以获得商品上限为20000个,这些商品都是包含淘宝客推广链接的,可以直接用于推广;对于很多导购促销类应用来说,已经完全足够。而且如果你需要更多,只要您清空现有的选品组,重新选品保存后,使用API拿到新的数据;


⑤API读取的商品如果发生状态变化,为了保证用户体验,如价格发生变动,商品下架等,技术上有什么方式可以建议吗?
有一种方式是您可以定期通过淘宝客基础API中的taobao.tbk.item.info.get接口,指定商品id尝试读取商品的图片,价格,等信息,如果商品在淘宝已经下架(接口无信息返回),或者将最新的宝贝字段更新到你的后台商品数据库,并在推广展现的时候读取商品数据库中的最新的信息;


⑥选品和招商的API调用量什么限制吗?
我们不建议您使用过高的频率的调用选品和招商的API,由于这套API主要是同步数据,而不是支持内容实时展现;特别注意, 不要在推广时候直接调用,过于频繁的调用会被系统拒绝(如在网页或者APP内容展现的时候直接使用API直接读取选品组或者招商的商品信息);


⑦选品组中的商品类型会发生类型变化吗? 定向招商中的商品也可能是普通类型吗?
商品的type字段可以识别商品的类型,(1普通,2高佣金,3定向招商); 选品组中的商品类型可能会发生变化,主要出现在高佣金选品组中的商品所属的高佣金活动结束之后,如果这个商品没有再参与任何鹊桥高佣金活动,商品的类型将恢复到为普通1; 定向招商中的一个商品其卖家报名后,活动开始到结束之前,通过API拿到的商品类型为3(定向招商), 活动结束后,或者卖家没有报名就开始的招商,商品的类型为1(普通类型,佣金结算按照通用佣金结算)。
特别要提醒广大淘宝客注意的是,高佣金选品组API在前后两次调用中的获得的淘宝客推广链接可能不一样, 佣金计算可能也不一样。考虑这样一种情况,一个商品参加了高佣金活动A,活动A5.2号0点结束,5.1号调用API拿到的推广链接SA, 如果当天推广成功SA完成结算,将按照A活动的佣金结算;5.2号0点开始这个商品参加了活动B, 5.2号调用API拿到的推广链接SB, 在B活动有效期通过链接SB推广成功,将按照B活动佣金结算; 所以您拿到淘宝客推广链接最终按照什么佣金结算,决定于调用API的当时该商品在高佣金活动中所属的活动。

更多API相关文档请参考:http://open.alimama.com/api/doc.php


    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多