本帖包含五个部分：

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的使用方法

淘礼金推广者报表接口，点击查看

【step1】通过taobao.tbk.dg.vegas.tlj.create创建淘礼金时，每创建成功一次淘礼金，API均会返回唯一标识rights_id，建议媒体在创建淘礼金时该参数进行存储，以便后期查询，存储字段建议包括：创建时间、rights_id、淘礼金面额、淘礼金个数、所属活动、发放对象等；

【step2】通过taobao.tbk.dg.vegas.tlj.instance.report，传入不同的rights_id，可以得到对应淘礼金迄今为止的数据情况，数据字段如下

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%2B9tyZI8QkTzUh9LV2awXylEe5JjWPOg98pwnpNst=1_11111111pid=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.长链接转短链接接口：点此查看文档

FQ

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

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

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

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

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