淘礼金推广者新手指南之淘礼金创建、效果报表api接口

    2019-11-09 22:22 作者:淘口令-医生

    本帖包含五个部分:

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

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

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

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

    5.如何转成淘口令?

    PART1:规则公告

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

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

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

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

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

    申请规则(申请前务必阅读!)淘礼金生成权限等问题

    申请入口:点此申请

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

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

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

    【step1】:请先确保已经充值相关资金到玩法钱包,玩法钱包使用教程

    【step2】:淘礼金推广者创建接官方文档,点击查看文档接口

    【step3】:淘口令网淘礼金创建工具:http://www.taokouling.com/tool/taolijin

    【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淘口令

    F&Q

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

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

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


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


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


    什么是api?

    如需了解更多API的基础常识请点击,淘宝联盟API申请及使用教程