淘宝客现在对多数人来说已经耳熟能详了,属于CPS(Cost Per Sale),一种网络广告收费标准,以实际销售产品数量来换算广告刊登金额。其他收费标准还有常见的CPC(Cost Per Click 按点击次数收费),和按周期展示收费,周期过后下架等。以前接触这方面也比较少,这里就不详细介绍了,下面开始进入如何从懵圈到把接口对接到APP通过应用的流量实现佣金收入。
注册账号
首先在没有对接api前需要去注册一个阿里几个平台的账号,也可以直接用个人/企业 淘宝账号直接登录。
1.淘宝联盟: https://pub.alimama.com/
2.淘宝开放平台: http://open.taobao.com/
申请推广位
登录进淘宝联盟,点击“活动推广”,然后选择“推广管理”,这里看你要做的是什么,是web就选择网站管理,app就选择APP管理。不过不管是网站还是APP都是要有雏形已经上线,网站需要内容足够丰富且有备案,APP需要在某应用市场上架,最后就是新建推广填写表单提交审核即可。
记录key和Secret和下载SDK
提交完成大概一到三个工作日会有结果,成功后点击“查看权限”这时候就可以把App key记录下来,安卓和苹果是分开的,也就是后面调用接口要按系统传入不同的key和secret了。然后点击“查看”就会进入到淘宝开放平台指定的应用详情,一般是展示key和secret和接口使用的权限等信息。最后就选择下载SDK,按自己使用的服务器语言。
编码前准备
编码前,需要先创建推广位,安卓和苹果最好分开建立推广位,后面的一些商品推广在是在对应的推广位上,能很好统计点击率和佣金等信息
创建推广位方法:
1. 进入联盟产品,随便点击栏目,任意找一件商品,点击“立即推广”。
2.推广类型选择“app推广”,投放推广位选择新建推广位
但是,一般我们看别人的优惠券应用都有一些9块9,20元封顶或者一些新品优惠之类的类目。这里我们可以使用淘宝客的选品库接口,因为淘宝联盟一般会专门开一些9块9,20元封顶之类的栏目,我们就需要在自己的账号下创建几个选品库
创建选品库方法:
1.淘宝联盟首页左上角退出右边的"我的联盟"->我的选品库
2.https://pub.alimama.com/manage/selection/list.htm?spm=a219t.7900221/1.a214tr8.5.649075a5NMye6j 进入选品库管理页面点击“新建分组”。
文档查看和接口测试
文档地址: http://open.taobao.com/api.htm?docId=24515&docType=2
测试工具: http://open.taobao.com/doc.htm?spm=a219a.7386653.0.0.7c29669aKwHQ9X&docId=1&docType=15&apiName=taobao.tbk.item.get
前面已经建好了推广位和选品库,这里就既可以测试一些淘宝联盟自动推广的商品接口,还可以测试选品库内自己选择收集的商品。选择商品可以按高佣金或者高销售量采集。
避坑注意事项:
1.获取淘宝联盟选品库列表需要注意的就是请求这个接口时需要传adzone_id(推广位id),所以前面就做好准备建好了推广位,进入推广管理->推广资源管理->推广位管理,下面列表的pid中类似是mm_260870060_224000411_63877050230的字符串,adzone_id就是在_最后的那个,260870060淘宝联盟账户id,224000411推广媒体id(是网站还是app,是安卓亦是苹果),63877050230推广位id。
2.选品库id除了在获取选品库列表接口返回的favorites_id,另一种方法就是进入淘宝联盟的我的选品库选择其中一个库,查看地址栏上的链接,get方法拼接的groupId就是选品库id了。
其他的一些接口就要主要用户授权和收费标准了。
开始编码
1. 在tp5框架的vendor中放入淘宝客的sdk
2. 参数配置
'tbk' => [
'android' => [
'app_key' => '253x9410',
'app_secret' => '4a0d9xxxxxx1068fc46e33dce56a76c8', // 淘宝开放平台获取
'adzone_id' => '6387xx50230', // 推广位
],
'ios' => [
'app_key' => '253xx617',
'app_secret' => 'fe8472xxxxxxx6e8d041513beca3b9f', // 淘宝开放平台获取
'adzone_id' => '643092xx050', // 推广位
],
],
3. 封装请求类
<?php
/**
* Taobaoke.php
* @author : 小谜弟
* @date : 2018.11.28
* @desc:淘宝客API
* @version : v1.0.0.0
*/
namespace app\v1\service\Ebusiness;
use \think\Session as Session;
use think\Request;
use \think\Db;
use \think\Log;
class Taobaoke
{
public $term_id = "";
public $top_client = null;
function __construct($term_id) {
$this->term_id = $term_id;
$this->init();
}
/**
* 初始化服务类,添加公共请求参数
*/
public function init() {
vendor("taobaoSdk.TopSdk");
//请求淘宝客API,实例化类 **注意使用\命名空间**
$this->top_client = new \TopClient;
$term_id = $this->term_id;
($this->top_client)->appkey = config("tbk.$term_id")['app_key'];
($this->top_client)->secretKey = config("tbk.$term_id")['app_secret'];
}
/**
* 获取我的选品库列表
* @param [string] $[term_id] [无线端标识: android,ios]
* @param [string] $[base_url] [H5跳转基本地址]
* @return [选品库类表]
*/
public function TbkUatmFavoritesGetRequest($page=1,$pagesize=20) {
$req = new \TbkUatmFavoritesGetRequest;
// 选择需要查询的字段信息
$req->setPageNo($page);
$req->setPageSize($pagesize);
$req->setFields("favorites_title,favorites_id,type");
$req->setType("-1");// 默认值-1;选品库类型,1:普通选品组,2:高佣选品组,-1,同时输出所有类型的选品组
$resp = ($this->top_client)->execute($req);
$json_str = json_encode($resp);
$json_arr = json_decode($json_str,true);
if(empty($json_arr['results'])) {
return [];
}else {
return $json_arr['results'];
}
}
/**
* 获取指定选品库的商品列表
* @param [int] $[favoritesId] [选品库id]
* @param [int] $[page] [页码]
* @param [int] $[pagesize] [页数]
* @return [选品库类表]
*/
public function TbkUatmFavoritesItemGetRequest($favoritesId,$page=1,$pagesize=20) {
if(empty($favoritesId)) {
return false;
}
$adzone_id = config("tbk.$this->term_id")['adzone_id'];// APP设备对应的广告推广位pid
$req = new \TbkUatmFavoritesItemGetRequest;
$req->setPlatform("2"); // 1.PC 2.无线
$req->setPageSize($pagesize);
$req->setAdzoneId($adzone_id);
$req->setUnid("3456"); //
$req->setFavoritesId($favoritesId);
$req->setPageNo($page);
$req->setFields("num_iid,title,pict_url,small_images,reserve_price,zk_final_price,user_type,provcity,item_url,seller_id,click_url,volume,nick,shop_title,zk_final_price_wap,event_start_time,event_end_time,tk_rate,status,type,category,coupon_click_url,coupon_end_time,coupon_info,coupon_start_time,coupon_total_count,coupon_remain_count");
$resp = ($this->top_client)->execute($req);
$json_str = json_encode($resp);
$json_arr = json_decode($json_str,true);
if(empty($json_arr['results'])) {
return [];
}else {
return $json_arr['results'];
}
}
/**
* 根据商品id获取商品详情【精简,无宝贝详情】
* @param [int] $[num_iid] [淘宝商品唯一id]
* @param [string] $[ip] [客户端ip]
* @return [商品详情数组]
*/
public function TbkItemInfoGetRequest($num_iid,$ip) {
if(empty($num_iid)) {
return false;
}
$req = new \TbkItemInfoGetRequest;
$req->setNumIids($num_iid);
$req->setPlatform("2"); // 1.pc 2.无线
$req->setIp($ip); // 客户端请求ip
$resp = ($this->top_client)->execute($req);
$json_str = json_encode($resp);
$json_arr = json_decode($json_str,true);
if(empty($json_arr['results'])) {
return [];
}else {
return $json_arr['results'];
}
}
/**
* 好券清单列表数据
* @param [string] $[query_str] [好券搜索]
* @param [int] $[page] [页码]
* @param [int] $[pagesize] [页数]
* @return [好券清单数据列表]
*/
public function TbkDgItemCouponGetRequest($query_str,$page=1,$pagesize=20) {
$adzone_id = config("tbk.$this->term_id")['adzone_id']; // APP设备对应的广告推广位pid
$req = new \TbkDgItemCouponGetRequest;
$req->setAdzoneId($adzone_id);
$req->setPlatform("2"); // 1.pc 2.无线
//$req->setCat("11");
$req->setPageSize($pagesize);
if(!empty($query_str)) {
$req->setQ($query_str);
}
$req->setPageNo($page);
$resp = ($this->top_client)->execute($req);
$json_str = json_encode($resp);
$json_arr = json_decode($json_str,true);
if(empty($json_arr['results'])) {
return [];
}else {
return $json_arr['results'];
}
}
}
小结: 淘宝客接口的请求限制是100,000次/天,所以看你应用的流量,小的可以直接通过客户端请求接口,服务器只使用SDK做一个桥接即可,大的话可以通过定时请求淘宝客接口保存到数据库,客户端在请求自己的接口。其他的拼多多,京东,唯品会也都有推广联盟平台,对接方式也类似,后面就不做演示了,不过拼多多有提供h5的推广方式,只需要建好推广位就可以生成一个推广h5,然后把链接放到app上就可以了,如果有遇到什么问题可以关注下面公众号提问。