1. 发表帖子
淘宝联盟论坛
联盟通告
+发表新贴
  • 回复
  • 助威
  • 收藏
楼层直达
返回顶部
  • 淘客媒体内容输出接口开放为淘宝客基础接口的通知
  • 联盟委员会发表于2019-05-09 19:53浏览(6188)回复(0)

     为更好的服务淘宝客,提供更多推广物料给淘宝客,现开放淘客媒体内容输出接口为淘宝客基础接口。有需要的淘宝客媒体可通过备案在联盟后台的appkey自行调用。taobao.tbk.content.get( 淘客媒体内容输出 ):https://open.taobao.com/api.htm?docId=31137&docType=2&source=search


内容形式分图文与图集。

内容来源于淘宝主站内容,包含淘宝头条、必买清单等。该接口返回内容链接,图文图集内容里都已经匹配淘客商品宝贝,佣金收益的分成比例1:2:7.(阿里妈妈10%的技术服务费,内容的创作者达人20%,推广者淘客获得70%)。

图文:图集:

接入流程

1)    申请淘宝联盟帐号,在淘宝联盟后台推广管理-媒体管理的网站管理或app管理完成对应投放渠道的备案,并申请权限获取appkey。

2)    确定内容投放位,联盟后台生成对应adzoneid;推广位生成方式如下:

      选择任意商品立即推广,对应渠渠道下新建推广位,这里建立的推广位就是adzoneId, 获取代码到浏览器访问,地址栏上会有ali_trackid=2:mm_memberId_siteId_adzoneId,其中adzoneId就是使用API的时候传入的参数;



3)    确定内容投放展现形式,对接内容获取接口获取相关信息做展现。内容获取接口:taobao.tbk.content.get(淘客媒体内容输出),调用接口参见API调用方法详解。如不支持图集默认交互方式,则另外对接图集详情页商品信息接口,自行搭建交互页面,图集内容详情页商品获取接口:taobao.tbk.dg.optimus.material(淘宝客物料下行-导购)


接口详细说明

 接口使用:

  1. 调用频率:每15分钟调用一次,读取更新内容;
  2. 避免重复读取已获取的内容,获取内容后根据content_id进行比对,若遇到已读取过的内容,则停止进一步读取。


新增标签、摘要、内容效果分透出:

名称

类型

示例值

说明

content_id

Num

100

内容id

tags

String

裙子、女装、小清新

内容标签

activity_tags

String

双11

活动标签

summary

String


内容摘要

score

Num

10

内容效果分


接口中分类 id 对应关系

分类名称

cid 值

女装

1

美妆

2

家居用品

3

母婴

4

鞋包

5

运动户外

6

食品

7

内衣

8

家电

9

数码

10

图书音像

11

家装

12

汽车

13

珠宝配饰

14

游戏话费

15

生活服务

16

男装

17

其他

0



  1. 图集内容详情页商品信息获取接口

接口名称:taobao.tbk.dg.optimus.material (淘宝客物料下行-导购 )

文档地址:http://open.taobao.com/api.htm?docId=33947&docType=2


接口使用:

  1. 在内容获取接口获取图集内容id后,在此接口入参content_id、content_source,获取对应内容id下的商品信息;
  2. 调用频率:每15分钟调用一次,读取更新内容;
  3. 避免重复读取已获取的内容,获取内容后根据content_id进行比对,若遇到已读取过的内容,则停止进一步读取。



  1. 异常流处理接口说明


接口:taobao_tbk_ContentMsgGet (媒体内容消息接收API)

地址:http://open.taobao.com/docs/topicDetail.htm?spm=a219a.7629065.0.0.SIgayX&apiId=1186


使用场景:

-    黄赌毒反动等违法内容紧急下线;

-    业务逻辑和版权要求的内容下线;

-    404 内容下线。


接入方式和流程:

  1. 媒体使用淘宝开放平台消息服务,消息服务使用介绍:http://open.taobao.com/doc2/detail.htm?articleId=101663&docType=1&treeId=2
  2. 媒体订阅异常流消息服务:taobao_tbk_ContentMsgGet (媒体内容消息接收API)
  3. 联盟收到下线需求后,通过消息接口实时向媒体发送下线通知;
  4. 媒体进行实时下线处理,并返回处理状态。

下线通知入参:

名称

类型

示例值

说明

content_id

Num

100

内容id

extend

String

a=1

扩展字段

status

String

1

内容状态:1 下线

timestamp

String

1233343

下线通知的发布时间,单位毫秒


媒体回参:

名称

类型

示例值

说明

results

String

delete_success

返回状态说明,下线成功