【“淘礼金”（推广者）新手指南之】淘礼金创建、效果报表api接口

本帖包含五个部分：

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

2.淘礼金创建api的使用方法--PART2

3.淘礼金数据报表api的使用方法--PART3

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

5.如何转成淘口令？

PART1：规则公告

阅读此贴，请确保已经阅读并认可淘礼金相关业务规则，请确认明确知晓。

淘礼金推广卖家端规范：点此查看

淘礼金消费者规则：点此查看

淘礼金推广功能媒体端规范：点此查看

此外，在使用api 前，请确保已经成功申请到appkey并获取了淘礼金【推广者】相关的所有权限。

申请规则（申请前务必阅读！）点此了解

申请入口：点此申请

不知道什么是appkey？API基础知识传送门，点此

PART2：淘礼金创建api的使用方法

1、如何创建并投放淘礼金？

【step1】：请先确保已经充值相关资金到玩法钱包，点击查看使用方式

【step2】：淘礼金推广者创建接，点击查看文档接口

【API关键入参说明】

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

（1）当不写入这个参数时，默认先转营销链接，如没有，再转通用计划链接。即当商品有营销计划时，转营销计划链接；当商品没有营销计划时，转通用计划链接。

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

参数说明：

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

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

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

2.security_switch：安全开关---建议启动安全开关，降低安全风险。

• 
• 3.per_face：单个红包面额，单位元

  由创建者自行设置，现阶段单个红包面额必须大于或等于1元，小于49999元，可支持2位小数点。

• 4.定制红包的有效领取时间和有效使用时间
• 
  
• 
  

PART3：淘礼金数据报表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：对淘礼金投放链接转成短链接or淘口令

     1.淘口令转链接接口：点此查看文档

       2.长链接转短链接接口：点此查看文档
• 
  

F&Q

如何知道我已经获取到了权限？

step1：打开淘宝联盟APP-我的，查看是否有我的玩法钱包入口，并可以充值，如果有，说明已经获取了“玩法钱包和淘礼金创建”权限。

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

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

找到淘礼金相关api的名称，如有，说明获取了api 权限。

什么是api?

如需了解更多API的基础常识，请点击查看

本文链接：http://news.tky.com/post-193.html