PHP對接淘寶客api完成APP引流優惠券

淘寶客現在對多數人來說已經耳熟能詳了，屬於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上就可以了，如果有遇到什么問題可以關注下面公眾號提問。

​