维易淘客联盟接口开发文档:直播联盟转播API

淘宝直播联盟-直播间查询接口

2020年抖音不再接入淘宝链接,而淘宝为了弥补短板也大改版,短视频和直播是其主方向。做为淘客,要提高业绩,应主动参与淘客直播大潮流,提升成交量。

本接口帮助淘客接入天猫淘宝直播间并获得分成。让淘客参与到淘宝2020年改版大潮流中。


【注意】本接口需做memberID(即:联盟ID)备案后才能使用并有佣金。请会员把要接入直播的淘宝联盟帐号ID提供给本站帮你提交给联盟官方备案。

联盟ID即PID中的第一段。比如 mm_11111_22222_33333 中的11111,或查看淘宝联盟会员中心右上角帐号名后面一串数字


淘宝直播间推广适合人群

淘宝直播推广适合人群:

(1)有自己的APP或网站等自有平台。

(2)有自己的社群推广群或其它手动推广方式。


一、直播间接口作用——直播间API应用场景:

1、淘宝直播间列表获取:此淘宝直播联盟-直播间查询API,可以在你的APP上获得直播间列表详情,并引导用户跳到直播间,成交后可分成。通过直播间信息,将若干个直播间信息组合,快速搭建直播间跳转中间页

2、指定直播间ID和主播查询:重点直播间信息监控,如获得某个直播间开播/停播消息,将相关资源位投放/撤下

【说明】接口返回值中的“live_url”字段为带pid和rid的直播间链接

3、延伸用法:可以用在你的APP详情页,检测该卖家是否有在直播,如有则展示,促进成交。



二、直播间列表页链接生成的2种方式(唤端和不唤端):

直播间列表使用H5拼接即可,在下方链接附上rid和pid参数即可:

(1)唤端方式:https://mo.m.taobao.com/union/live?relationId=xxx&pid=mm_xxxxx

(2)不唤端方式:https://mo.m.taobao.com/union/live?visa=8f67da654a142076&relationId=xxx&pid=mm_xxxxx

其中的visa值是固定的8f67da654a142076。

注意:需做memberID(即:联盟ID)备案后才有佣金。请会员把要接入直播的淘宝联盟帐号ID提供给本站帮你提交给联盟官方备案。联盟ID即PID中的第一段。

直播间列表生成:详细参考http://wsd.591hufu.com/taokelianmeng/500.html

效果图:参考“高佣联盟”等APP的“每日直播”。如下图:


三、直播间接口使用方法:

【特别说明】要调用此直播接口,需要进行联盟帐号备案,每个调用接口所用的PID对应妈妈账号都要备案,没有备案的账户无法获得直播间信息。请提交memberID(即联盟ID,也是PID的第一段,如mm_1111_2222_3333中的1111)给本站,配置转播权限。

【接口权限】超级会员月卡和核心接口会员月卡均可调用。

【API地址】

http://api.vephp.com/tbliveinfo?vekey=xxx&pid=mm_111111_22222_33333&relation_id=....

入参:

onlyliveinfo可选值0或1,默认0,当您只需要获得直播间商品列表或信息,而不需要跳转直播获得佣金时,可使用本参数。

live_ids :可选,直播间ID列表:示例值:128849043,29033485,不可超过10个。以逗号分隔的直播间ID列表,注意:直播间ID不得与主播昵称(nicknames)同时使用,否则返回参数非法。

nicknames:可选,主播昵称列表:示例值:nick1,nick2,不可超过5个。以逗号分隔的主播昵称列表,注意:主播昵称不得与直播间id(live_ids)同时使用,否则返回参数非法。

【注意】live_ids 和 nicknames 不能同时使用。

pid必选,您的淘客PID,示例值:mm_1111_2222_3333,会员中心授权时可提供默认值PID。

relation_id:可选,渠道关系ID:具体用法参考渠道运营接口文档。

live_query_type,可选,默认值1(自播直播间),指定查询直播间类型: 1为自播直播间,此时不得填写主播昵称和直播间ID;2为转播直播间,此时主播昵称和直播间ID必须至少一个非空。注意必须与入参中的过滤条件对齐。默认为1(自播直播间)

【TIP】目前只支持live_query_type参数值为2,查询指定直播间

page_size:可选,默认值20,页面元素数量,从0开始,默认20,不得超过50

page_num:可选,默认值0,页码:从0开始。

check可选,用于测试你的memberId是否可用,如果你有多个memberId,可以配合sessionkey和pid参数检测对应联盟memberId是否通过审核。


【直播间接口调用示例】

1.查询“乱步大魔王”直播间:

http://api.vephp.com/tbliveinfo?vekey=xxx&page_num=0&live_query_type=2&nicknames=乱步大魔王


2.检查你的memberId备案是否通过审核:

http://api.vephp.com/tbliveinfo?vekey=xxx&live_query_type=2&nicknames=乱步大魔王&check=1&sessionkey=7001...&pid=mm_111_222_333


[注意] 如果你有多个memberId正在申请备案,那么要用这个接口检测是否通过,请授权得到sessionkey再调用本接口检测,授权地址: http://t.cn/Ai9QPut6 (如果要检测的帐号在维易会员中心已授权过并在30天有效期内,则不需要再授权)


四、直播间返回值:

total_count  列表中的直播间数量

result_list 直播间列表

        live_room_status 直播间状态 0=预告,1=直播中,2=已结束(回放)

        praise_count 点赞数

        column 栏目名称,目前暂时为空

        title 直播间标题

        live_id 直播间ID

        out_site_code 合作模式 isMediaSelf=自播,isMediaRelay=转播

        pv_count 观看数

        anchor 主播信息

               user_nick 主播昵称

               user_logo 主播头像

        live_url 直播间推广链接

        ItemList  直播间商品列表  

                item_id 商品ID

                item_name  商品标题

                promotion_price 商品价格

                pic 商品图像

        location 主播位置

        cover16x9_url 16:9封面链接

        cover1x1_url 1:1封面链接

        channel 频道名称,目前暂时为空

        anchor_type 主播身份 daren=达人,shop=商家,目前暂时为空

        tbk_pwd  淘口令

        ios_tbk_pwd  适用于IOS14的淘口令


如果使用了check参数,则返回值如下:

{

    "error": "0",

    "msg": "直播接口权限已通过审核,现在可使用直播接口",  //提示memberId备案状态

    "data": {

        "privilege": 1,  //权限,0表示没通过,1表示通过。

        "privilege_status": "success"   //成功success,失败fail

    }

}



五、直播链接处理方法

响应参数中的“live_url”字段为带pid和rid的直播间链接,

使用方法:直接唤起淘宝。

1、将获得的直播间链接如下链接:

https://huodong.m.taobao.com/act/talent/live.html?id=273846415638&livesource=union_share_union-topapi&live_ccb=%7B%22outMediaPid%22%3A%22mm_26381042_1429900207_110219950115%22%2C%22relationId%22%3A%221112222%22%2C%22sourceType%22%3A%221%22%2C%22outSiteCode%22%3A%22isMediaRelay%22%2C%22union_lens%22%3A%22lensId%3AMAPI%401595988655%400b588c08_1aed_17398563ed4_03e9%4001%22%7D

2、进行URLencode编码,生成编码直播间链接,如

https%3a%2f%2fhuodong.m.taobao.com%2fact%2ftalent%2flive.html%3....

3、编码直播间链接【前面】直接拼接唤端链接(唤端链接固定不变),

生成tbopen直播间唤端链接如下:

tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&module=h5&source=alimama&bc_fl_src=tunion_live&h5Url=https%3a%2f%2fhuodong.m.taobao.com%2fact%2ftalent%2flive.html%3fid%3d273846415638%26livesource%3dunion_share_union-topapi%26live_ccb%3d%257B%2522outMediaPid%2522%253A%2522mm_26381042_1429900207_110219950115%2522%252C%2522relationId%2522%253A%25221112222%2522%252C%2522sourceType%2522%253A%25221%2522%252C%2522outSiteCode%2522%253A%2522isMediaRelay%2522%252C%2522union_lens%2522%253A%2522lensId%253AMAPI%25401595988655%25400b588c08_1aed_17398563ed4_03e9%254001%2522%257D

即可直接唤起手机淘宝应用。

【注意】唤端链接固定不变

tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&module=h5&source=alimama&bc_fl_src=tunion_live&h5Url=

(建议在各自推广环境下先进行测试,部分环境会限制唤端)

使用方法:直播商品看点

通过在链接上拼接宝贝ID,实现若宝贝有直播看点回放,直接打开直播看点;(若无看点,正常打开直播间)

直播中和直播回放的拼接规则不同:

【直播中】在url最后拼接“&sjsdItemId=【宝贝Id】

【直播回放】在url最后拼接“&timeMovingItemId=【宝贝Id】


六、直播订单跟踪:

在订单接口(推广者、服务商)中,直播联盟订单在产品类型flow_source里透出“直播类型”。


七、直播联盟产品版本更新日志:

百川旗舰版SDK近期针对直播联盟媒体多次反馈问题做了统一升级和优化,优化版本SDK需媒体进行升级并发版,需媒体统一更新到:Android  5.0.0.5 、iOS 5.0.0.2,直播联盟涉及的更新信息如下

https://www.yuque.com/docs/share/0c23c311-b2f1-470b-834e-55df54c9f915?#   

《直播联盟产品版本更新日志》


直播接口常见问题:

https://www.yuque.com/docs/share/964a7744-e9e5-4f9f-94ed-38541481b351?#



Q&A:

  • 分享按钮无法点击?

需要在代码中实现下“电商能力协议”


Android:https://baichuan.taobao.com/docs/doc.htm?spm=0.0.0.0.33Vukd&docType=1&articleId=118885&previewCode=2546ADC09D1B87A219E6570BEFDA5B42#4.1


iOS: https://baichuan.taobao.com/docs/doc.htm?spm=0.0.0.0.8SM62R&docType=1&articleId=118886&previewCode=165299EE14713D615A853B8126BE5261#4.1

 

客服