维易淘客联盟接口开发文档:官方活动链接生成

淘宝联盟官方活动推广链接生成API,口碑和饿了么活动信息获取

本章接口是专用于双11、双12、双旦、年货节等淘宝/天猫大促时的活动页面生成您的推广链接。

【调用权限】所有维易会员


一、官方活动推广链接生成API应用场景:

淘宝联盟官方活动推广链接生成接口,广泛应用于所有淘宝联盟的各种活动中,比如双11,618等大促活动封装成你的推广链接。

【例1】这里以“2019年双11大促”超级红包为例:

2019双11超级红包的活动ID为“1539329391766”,

2019双12超级红包无线活动ID“1574926757600”,PC活动ID“1575281726015”


官方活动包括2个接口:

  1. 官方活动推广链接生成接口:主要用于淘宝联盟后台活动,比如双11等活动。

  2. 官方活动信息获取接口:主要用于"口碑"和"饿了么"本地化物料等活动推广链接生成。


二、官方活动信息获取接口(新版)

本接口将取代上面的活动接口,不仅仅用于“口碑”和“饿了么”活动生成。

官方新版活动ID获取地址:https://pub.alimama.com/fourth/promo/activity.htm



接口:

http://api.vephp.com/activityinfo?vekey=xxx&pid=您的PID&activity_material_id=活动ID&relation_id=xxx

1、参数:

    pid 必选你要绑定这个活动的PID,如果传了渠道relationId,则这里的PID参数必须是“渠道专属PID”,具体参考渠道篇文档。

    activity_material_id必选,活动物料ID,

【常用活动ID】:以下是常用的本地生活物料ID:

口碑主会场活动ID:1583739244161

饿了么新零售页面活动ID:1585018034441

饿了么餐饮页面活动ID:1579491209717

饿了么活动ID:1571715733668

生活服务分会场活动ID:1583739244162


[tip] "新零售"和"餐饮订单"的区分:

【饿了么餐饮】快餐便当、特色菜系、全球美食、小吃夜宵、甜品饮品、香锅火锅

【饿了么新零售】商店超市、鲜花绿植、医药健康、水果、厨房生鲜


    relationId:可选,渠道关系ID

    sessionkey:可选,多用户版专用参数,用于指定不同的联盟号。

    needtkl:可选,当您需要把生成的推广链接封装成淘口令,就传本参数。

    appkey和secret:应急参数,可选,淘口令生成备用密钥:用于生成淘口令的联盟应用的appkey和secret。【使用场景】默认情况下生成淘口令是用维易自带的appkey生成,但极个别时侯,联盟可能会出错导致淘口令不弹,出现这种情况时,你可以通过这2个参数传递自己的appkey和secret,调用基础API中淘口令生成接口。

【重要】口令不弹应急处理:http://wsd.591hufu.com/taokelianmeng/491.html


2、返回值:

下例是调用API:http://api.vephp.com/activityinfo?vekey=xxx&activity_material_id=1583739244161&needtkl=1

返回:

{

    "error": "0",

    "msg": "官方活动信息获取成功!",

    "data": {

        "click_url": "https://s.click.koubei.com/t?&e=dngDVlqfukF...",   //推广链接

        "page_end_time": "2020-06-20",  //活动结束时间

        "page_name": "2020年天猫618—天猫主会场(5.29零点开始抢超级红包)",  //会场名称

        "page_start_time": "2020-05-25",  //活动开始时间

        "terminal_type": "2"  //投放平台, 1-PC 2-无线

        "tbk_pwd": "¥0RHw1S72xP1¥"  //只有传了参数needtkl,才返回该淘口令字段

    }

}


其它可能出现的字段含义:

material_oss_url:物料素材下载地址

wx_qrcode_url:微信推广二维码地址

wx_miniprogram_path:微信小程序推广路径


三、错误码:

具体错误码参考 http://wsd.591hufu.com/doc/taobaokeapijiekoucuowuma

 

客服