本章接口是专用于双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.veapi.cn/tbk/activityinfo?vekey=xxx&pid=您的PID&activity_material_id=活动ID&relation_id=xxx

1、参数：

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

    activity_material_id：必选，活动物料ID，

【常用活动ID】：

一元购活动ID：20150318020003158

以下是常用的本地生活物料ID：

口碑主会场活动ID：1583739244161，

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

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

饿了么活动ID：1571715733668

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

饿了么聚合页CPS推广活动ID：20150318019998877，

饿了么微信推广：20150318020002192   (2020双12)

先用后付会场id：20150318020003621

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

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

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

    relationId：可选，渠道关系ID

    union_id：可选，自定义输入串，英文和数字组成，长度不能大于12个字符，区分不同的推广渠道

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

    needtkl：可选，值1或0，当您需要把生成的推广链接封装成淘口令，就传本参数。

    shorturl：可选，值1或0，此时多一个字段click_url_short，是返回值长链click_url的短链接。方便保存入库。

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

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

2、返回值：

下例是调用API：http://api.veapi.cn/tbk/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