1. 发表帖子
淘宝联盟论坛
联盟通告
+发表新贴
  • 回复
  • 助威
  • 收藏
楼层直达
返回顶部
  • 【“淘礼金”(推广者)新手指南之】淘礼金创建、效果报表api接口
  • 联盟委员会发表于2018-09-30 01:09浏览(83644)回复(0)


本帖包含五个部分:

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%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的基础常识,请点击查看