1. 发表帖子
淘宝联盟论坛
联盟通告
+发表新贴
  • 回复
  • 助威
  • 收藏
楼层直达
返回顶部
  • 淘礼金导购API及淘礼金领取页面推广攻略(11.06更新)
  • 联盟委员会发表于2018-09-30 01:09浏览(21701)回复(0)


本帖包含五个部分:

1.淘礼金整体的规则--PART1

2.淘礼金API权限的获取方式--PART2

3.淘礼金API的入参、出参方法--PART3

4.淘礼金领取页面的其他参数配置--PART4

5.如何转成淘口令?



PART1:规则公告

使用淘礼金推广功能,视为认可淘礼金相关业务规则,请确认明确知晓。

规则传送门:

淘礼金推广卖家端规范:

https://rule.alimama.com/#!/product/index?type=detail&id=403&knowledgeId=8915

淘礼金消费者规则:

https://rule.alimama.com/#!/product/index?type=detail&id=403&knowledgeId=8916

淘礼金推广功能媒体端规范:

https://rule.alimama.com/#!/product/index?type=detail&id=403&knowledgeId=8917

 

PART2:API 权限获取

在试运行期,此权限为基础权限。获取需满足如下要求:

  • 1)有已审核通过的网站或APP备案渠道
  • 2)site扣分<18分(注明:site扣分超过18分会无法成功调用)
  • 3)成功申请到appkey

(不知道什么是appkey?API基础知识传送门:

https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576944)

满足以上条件后直接进入开放平台申请淘礼金API权限。如下为操作步骤:

Step1:电脑端淘宝联盟--推广管理--网站管理-appkey-查看详情


Step2:登录阿里·开放平台,进入该应用管理


Step3:找到如下图所示的API名称,去申请权限

Step3:找到如下图所示的API名称,去申请权限

Step4:获得权限,可使用API,具体使用发放关注PART3.



PART3:入参出参

导购API接口地址:http://open.taobao.com/api.htm?docId=40173&docType=2

重点再度提示:site扣分超过18分不符合权限标准,会无法成功调用

一、API关键入参说明:

  • 1.campaign_type:淘礼金推广转链接的CPS佣金计划类型,可选参数。

    (1)当不写入这个参数时,默认先转营销链接,如没有,再转通用计划链接。即当商品有营销计划时,转营销计划链接;当商品没有营销计划时,转通用计划链接。

    (2)当写入Campaign_type对应的字段时,先判断该商品是否存在该计划,如果存在,则API将转出转相应计划链接,如果不存在,API则直接转通用计划链接。

    参数说明:

    Dx:定向计划,在写入这个计划类型的时候,请确保该商品存在定向计划,且推广者已经获得了该定向计划的推广资质。

    Link_event:活动计划佣金,在写入这个计划类型的时候,请确保该商品存在活动计划。

    MKT:营销计划佣金,在写入这个计划类型的时候,请确保该商品存在营销计划。

    2.security_switch:安全开关---建议启动安全开关,降低安全风险。
  • 3.per_face:单个红包面额,单位元

    由创建者自行设置,现阶段单个红包面额必须大于或等于1元,小于49999元,且只能设置整数面额。

  • 4.单个宝贝在可创建的淘礼金数量总和不可超过6万/周;单个店铺可创建的淘礼金数量总和不可超过30万/周。
  • 如超过上述限制,API接口会提示错误信息并且无法创建成功。


PART4:淘礼金领取页面相关参数说明

1.淘礼金领取页面主要有三个核心关键信息:

  • 淘礼金:显示淘礼金面额
  • 优惠券:
  • (1)如推广商品有优惠券,系统会自动读取当前时间面额最大的优惠券。
  • (2)如果该商品不存在优惠券,则页面不展示优惠券模块。
  • (3)推广者无法自行设置不展示优惠券模块,但可通过拼链接的方式自行替换其他券,操作方式见下文。
  • 福利价:福利价=现价-淘礼金-优惠券,但最终的成交价格以消费者实际支付价格为准。


  • 2.页面参数配置:

    Activityid:券的标识,仅支持“阿里妈妈推广券”,不支持“自主推广券”;拼接了Activityid参数后,领取页面的优惠券替换为拼接的优惠券。

    Me:也可拼接me参数。拼接了me参数后,领取页面的优惠券替换为me中的优惠券


    说明:me就是商家在商家后台生成的优惠卷,然后在URL地址栏中会有一个me   

    类似于:

    https://uland.taobao.com/coupon/edetail?me=qXg3XtWCOSkGQASttHIRqe62AiBkZ4pvWY6tJg2JrUXcQLm7dJTvUGkZZ27JIlbwm50QiBUMH4bbLaGB9uZG%2BjKPu%2B%2B9tyZI8QkTzUh9LV2awXylEe5JjWPOg98pwnpN&st=1_11111111&pid=mm_0_0_0,%E7%82%B9%E5%BC%80%E4%B9%8B%E5%90%8E%E6%9C%89me


    拼接方式:

  • 拼接券id:在链接的最后拼接&Activityid=XXXX(券id)


    拼接me:在链接的最后拼接&me=XXXX(券id)



  • PART5:如需要可以将链接转化为淘口令

    1.API文档:http://open.taobao.com/api.htm?docId=31127&docType=2&source=search


  • 如需了解更多API的基础常识,请点击传送门:

    https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576944