为更好的服务淘宝客,提供更多推广物料给淘宝客,现开放淘客媒体内容输出接口为淘宝客基础接口。有需要的淘宝客媒体可通过备案在联盟后台的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(淘宝客物料下行-导购)
接口详细说明
接口使用:
调用频率:每15分钟调用一次,读取更新内容;
避免重复读取已获取的内容,获取内容后根据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 |
接口名称:taobao.tbk.dg.optimus.material (淘宝客物料下行-导购 )
文档地址:http://open.taobao.com/api.htm?docId=33947&docType=2
接口使用:
在内容获取接口获取图集内容id后,在此接口入参content_id、content_source,获取对应内容id下的商品信息;
调用频率:每15分钟调用一次,读取更新内容;
避免重复读取已获取的内容,获取内容后根据content_id进行比对,若遇到已读取过的内容,则停止进一步读取。
接口:taobao_tbk_ContentMsgGet (媒体内容消息接收API)
地址:http://open.taobao.com/docs/topicDetail.htm?spm=a219a.7629065.0.0.SIgayX&apiId=1186
使用场景:
- 黄赌毒反动等违法内容紧急下线;
- 业务逻辑和版权要求的内容下线;
- 404 内容下线。
接入方式和流程:
媒体使用淘宝开放平台消息服务,消息服务使用介绍:http://open.taobao.com/doc2/detail.htm?articleId=101663&docType=1&treeId=2;
媒体订阅异常流消息服务:taobao_tbk_ContentMsgGet (媒体内容消息接收API)
联盟收到下线需求后,通过消息接口实时向媒体发送下线通知;
媒体进行实时下线处理,并返回处理状态。
下线通知入参:
名称 |
类型 |
示例值 |
说明 |
content_id |
Num |
100 |
内容id |
extend |
String |
a=1 |
扩展字段 |
status |
String |
1 |
内容状态:1 下线 |
timestamp |
String |
1233343 |
下线通知的发布时间,单位毫秒 |
媒体回参:
名称 |
类型 |
示例值 |
说明 |
results |
String |
delete_success |
返回状态说明,下线成功 |