PHP对接淘宝客api完成APP引流优惠券

系统管理员 2022-12-19 00:52 153阅读 0赞

淘宝客现在对多数人来说已经耳熟能详了，属于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需要在某应用市场上架，最后就是新建推广填写表单提交审核即可。

![831f41d856769d390164f63db4bd2a15.png][]

## **记录key和Secret和下载SDK** ##

提交完成大概一到三个工作日会有结果，成功后点击“查看权限”这时候就可以把App key记录下来，安卓和苹果是分开的，也就是后面调用接口要按系统传入不同的key和secret了。然后点击“查看”就会进入到淘宝开放平台指定的应用详情，一般是展示key和secret和接口使用的权限等信息。最后就选择下载SDK，按自己使用的服务器语言。

![38f21490d7ffbeeff8e3b368a8ab6934.png][]

![016c42560f3420df0afef477fbe0614b.png][]![27300349c3c4d768eac68f21fb7b6180.png][]

## **编码前准备** ##

编码前，需要先创建推广位，安卓和苹果最好分开建立推广位，后面的一些商品推广在是在对应的推广位上，能很好统计点击率和佣金等信息

**创建推广位方法:**

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

前面已经建好了推广位和选品库，这里就既可以测试一些淘宝联盟自动推广的商品接口，还可以测试选品库内自己选择收集的商品。选择商品可以按高佣金或者高销售量采集。

![5ca5fb1f81821a3a7d1af0d5ad656dbb.png][]

**避坑注意事项: **

1.获取淘宝联盟选品库列表需要注意的就是请求这个接口时需要传adzone\_id(推广位id)，所以前面就做好准备建好了推广位，进入推广管理->推广资源管理->推广位管理，下面列表的pid中类似是mm\_260870060\_224000411\_63877050230的字符串，adzone\_id就是在\_最后的那个，260870060淘宝联盟账户id，224000411推广媒体id（是网站还是app，是安卓亦是苹果），63877050230推广位id。

![ac63f473a771e33b05d5edbcb1e5fa88.png][]

2.选品库id除了在获取选品库列表接口返回的favorites\_id，另一种方法就是进入淘宝联盟的我的选品库选择其中一个库，查看地址栏上的链接，get方法拼接的groupId就是选品库id了。

![80979c9c52465fe6004909a591ee5aa2.png][]

其他的一些接口就要主要用户授权和收费标准了。

## **开始编码** ##

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上就可以了。

[831f41d856769d390164f63db4bd2a15.png]: /images/20221120/4413e51f209b4caf9d49ddab6a7aae1c.png
[38f21490d7ffbeeff8e3b368a8ab6934.png]: https://img-blog.csdnimg.cn/img_convert/38f21490d7ffbeeff8e3b368a8ab6934.png
[016c42560f3420df0afef477fbe0614b.png]: https://img-blog.csdnimg.cn/img_convert/016c42560f3420df0afef477fbe0614b.png
[27300349c3c4d768eac68f21fb7b6180.png]: https://img-blog.csdnimg.cn/img_convert/27300349c3c4d768eac68f21fb7b6180.png
[5ca5fb1f81821a3a7d1af0d5ad656dbb.png]: https://img-blog.csdnimg.cn/img_convert/5ca5fb1f81821a3a7d1af0d5ad656dbb.png
[ac63f473a771e33b05d5edbcb1e5fa88.png]: https://img-blog.csdnimg.cn/img_convert/ac63f473a771e33b05d5edbcb1e5fa88.png
[80979c9c52465fe6004909a591ee5aa2.png]: https://img-blog.csdnimg.cn/img_convert/80979c9c52465fe6004909a591ee5aa2.png