淘宝客APP源码开发文档

淘宝客源码开发文档（开源）

一、管理后台 

1、技术架构    4
2、 修改服务器配置    4
3、 目录结构    5
4、 修改短信类    6
5、 替换支付宝支付账号    6
6、 管理后台地址    7
7、 注意事项    7

二、 淘宝客   

1、 申请淘宝客网站应用    8
①上传PC淘宝客网站    8
②创建网站媒体    8
③获取淘宝客基础API接口及权限    10
2、 创建默认推广位    10
①创建选品库    10
②创建推广位    11
3、 申请淘宝渠道    14
4、 修改淘宝客账号配置    15
5、设置CURL自动拉取任务    17
6、淘宝遗漏、无归属用户订单排查    18
7、计算淘宝佣金    19
8、关于为什么不能立刻同步淘宝失效订单？    20
9、为什么淘宝商品佣金不一致？    20
10、淘宝客相关文档资料    21

三、拼多多应用  

1、 申请    21
2、 创建拼多多应用    22
3、 修改后台拼多多配置    24

四、京东应用

1、申请京东联盟    27
2、 创建京东联盟APP应用    27
①创建应用    27
②创建推广位    30
3、获取授权key    31
4、申请京东高级权限    33
5、常见问题    35
6、成为开发者，创建应用    36
①成为开发者    36
②创建开发应用    39
6、JOS授权    42
7、后台程序配置参数    45
8、处理京东遗漏订单    46

五、后台操作手册

1、banner广告图设置    50
①首页广告轮播图    50
②首页广告    51
③首页弹框    52
④推荐链接    52
⑤广告图类型说明    53
2、营销中心    54
①爆款商品推送    54
②文章推送    55
③ 淘宝推荐商品管理    56
④热门搜索设置    58
⑤拉新活动    59
⑥淘宝0元购商品管理    60
3、系统设置    61
①站点设置    61
②应用账号配置    61
③会员升级规则配置    63
4、 样式DIY设置    63
①功能模块管理    63

(图：淘客APP开发)

一、管理后台

技术架构：

开发语言：php5.5以上
语言框架：thinkphp3.2
服务器：apache2.2/2.4
数据库：mysql5.5以上
    •    修改服务器配置
    •    文件位置：\Application\Common\Conf\confog.php，修改config.php文件里的数据库配置
    •    目录结构
    •    Application：应用
    •    Public：公用文件
    •    tbk：用于申请淘宝客网站媒体的模板
    •    ThinkPHP：tp框架核心库，无需修改 
    •    Application下细分几个版块： 
    •    Admin：后台
    •    App：app接口
    •    Common：通用文件
    •    Common目录结构：
    •    Model：所有的数据表类，对应每张数据表，也包含了一些通用类
    •    修改短信类
    •    文件位置：\Application\Common\Model\SmsModel.class.php，修改SmsModel.class.php文件里的配置参数
    •    短信用的是美圣融云短信，如果是同一家的短信，直接替换账号密码模板等即可，如果是其他家短信，需要重新开发。
    •    替换支付宝支付账号
    •    文件位置：\ThinkPHP\Library\Vendor\pay\alipay_app\aop\AopClient.php
    •    需要修改里面的支付宝appid、私钥、支付宝公钥
    •    管理后台地址
    •    后台登录地址：网址/IP地址+/dmooo.php
    •    账号：dmooo
    •    密码：12332

注意事项：

    •    文件夹权限问题：如果使用的是linux系统，需要将个别文件夹改成777权限，分别为如下文件夹：
    •    Application\Runtime
    •    Public\db
    •    Public\FileBackup
    •    Public\inc
    •    Public\logs
    •    Public\tpl
    •    Public\ueditor
    •    Public\Upload

二、 淘宝客

申请淘宝客网站应用
在淘宝联盟申请淘宝客账号：https://pub.alimama.com/
账号申请好之后，准备好备案好的域名和服务器，申请淘宝客应用

步骤①、上传PC淘宝客网站

将根目录下的tbk文件夹上传到正式服务器上，会自动生成一个PC淘宝客网站，不用修改内容，只用来申请媒体

步骤②、创建网站媒体

打开淘宝联盟=>我的联盟=>推广管理=>媒体管理=>网站媒体=>创建网站媒体
网站类型一定要申请“导购分享”。
注意验证文件要放到配置域名的根目录下面，并且要保证有访问权限（linux等系统注意文件夹权限）。

步骤③、获取淘宝客基础API接口及权限

    •    一般半天就可以审核通过，审核通过后点击查看权限并申请，可以立即获取到淘宝客的基础API接口及权限
    •    点击查看权限，会打开阿里百川，看到该应用，拿到应用的appkey和secret
    •    创建默认推广位

1、创建选品库

选择我的联盟=》我的选品库=》新建分组，新增一个推广位为“默认推广位”

2、创建推广位

点击我要推广=》选择商品添加到选品库中
    •    新建推广位：点击批量，推广
    •    设置推广位：
    •    推广类型：选择网站推广，保持默认不用变
    •    网站名称：选择创建好的网站媒体，保持默认不用变
    •    投放推广位：选择新建推广位
    •    推广位名称：填写默认推广位1-10即可，创建10次，产生10个
    •    创建成功后，在淘宝联盟=》推广管理=》推广位管理=》网站推广位，可以看到创建好的默认推广位1-10，将这个推广位的pid复制粘贴到程序中
    •    修改如下文件：\Public\inc\status.php
    •    修改如下内容：
    •    pid的mm_xx_xx_xx，第一段的数值就是淘宝客的AppID，复制粘贴到后台配置中，
    •    后台管理=》系统配置=》应用账号配置=》淘宝客AppID

3、申请淘宝渠道

    •    申请好淘宝客网站媒体应用，创建好默认推广位之后，可以申请淘宝渠道权限。
    •    打开网址=》渠道申请：https://survey.taobao.com/apps/zhiliao/0JpI9eizU
    •    注意点：
    •    必须要使用同一个淘宝客账号登录并打开渠道申请网址，不要使用其他淘宝账号扫扫登录
    •    申请表格第10项，申请的权限选择第3条，并且输入框中的值填写的申请的网站媒体应用的appkey的值
    •    淘宝渠道本周申请，下周三申请通过，api权限接口还会延迟，一般下周五前会给到
    •    
    •    淘宝客私域用户管理能力：https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9073346
    •    《淘宝客私域用户管理》-新手指南：https://mo.m.taobao.com/pdum

4、修改淘宝客账号配置

         打开后台=》系统设置=》应用账号配置，修改对应的淘宝客账号
    •    最后一个是维易淘客第三方的接口，上面的都是淘宝客联盟的
    ①如何查看淘宝客App的key和secret：
    •    打开淘宝联盟=》推广管理=》媒体管理=》网站媒体，找到创建好的网站媒体，先申请该媒体的权限，点击申请即可，立即获取无需淘宝审核，申请权限后点击查看详情，会跳转到淘宝的阿里百川开放平台，可   以查看到淘宝客App的key和secret，复制粘贴到后台配置中。
    ②如何填写淘宝客PID：
    •    在网站媒体下创建好的10个默认推广位1-10，复制第一个推广位的pid值即可。
    •    pid的mm_xx_xx_xx，第一段的数值xx就是淘宝客的AppID，第三段的数值xx就是淘宝客的广告位ID，复制粘贴到后台配置中。
    ③如何查看淘宝客渠道专属PID：
    •    打开淘宝联盟=》推广管理=》渠道管理=》专属推广位

 5、设置CURL自动拉取任务

    •    文件路径：\Application\App\Controller\TaskController.class.php
    •    使用服务器的curl和crontab功能，设置自动抓取任务
    •    任务说明：
    •    treatOrder：每5分钟拉取淘宝付款订单-常规订单
    •    treatOrder2：每7分钟拉取淘宝结算订单-常规订单
    •    treatOrderR：每5分钟拉取淘宝付款订单-渠道订单
    •    treatOrderR2：每7分钟拉取淘宝结算订单-渠道订单
    •    treatOrderYesterday：拉取淘宝昨天一整天订单的功能，在半夜12点10分的时候，这样可以避免下单后超过10分钟后付款的订单不显示的问题，淘宝规定超过1天的订单未付款就会自动删除掉
    •    treatPddOrder：每9分钟拉取拼多多订单
    •    treatJdOrder：每9分钟拉取京东订单 

6、淘宝遗漏、无归属用户订单排查

    •    1、先确定是否在本平台/App中转链购买的商品，在淘宝联盟后台查找该订单，不存在则代表本订单没有经过本平台购买
    •    2、排查无归属用户淘宝订单：
    •    确定在本平台/App中转链购买后，却没有给购买的用户，可能是如下几个原因：
    •    ①用户没有绑定淘宝账号授权
    •    ②用户购买的时候没有绑定淘宝账号授权，购买之后去绑定的，会造成推广位不正确
    •    ③用户同意了淘宝账号授权，但是实际在淘宝购物下单的时候，付款的淘宝账号和在平台/APP上所绑定的不是一个淘宝账号，导致淘宝账号对应不上，无法归属给对应用户
    •    ④核对订单推广位和用户推广位是否一致，如果推广位一致，排查订单号后6位和用户所绑定的淘宝账号是否一致
    •    推广位也正确的情况下却没有在用户的订单中显示，代表用户下单后超过了10分钟才去付款，导致无法立刻拉取到订单，这时候在管理后台进行处理遗漏订单操作

7、计算淘宝佣金

          淘客佣金计算方法：

7-1、结算前：commission_rate * alipay_total_price * income_rate
7-2、结算后：commission_rate * pay_price * income_rate
订单接口返回的几个佣金和比例含义：

8、关于为什么不能立刻同步淘宝失效订单？

①淘宝的订单不会主动推送给淘宝客App开发者，要求App端主动去拉取淘宝订单
②淘宝订单的拉取只支持根据下单时间、付款时间、结算时间拉取，不能根据退款的失效时间拉取，每次拉取一段时间内的所有订单（最长3小时，一般获取20分钟内）
③我们现在做的是每5-10分钟自动拉取淘宝订单，每天都在执行的，是拉取20分钟前到当前时间内的订单，所以淘宝订单刚付款和刚确认收货，能立刻同步到App中。而不能根据退款取消订单时间去拉取，所以不能同步失效订单，除非用户刚买淘宝商品发现买错了，在20分钟内立刻退货，这个时候根据付款时间能拉取到这个订单，所以只有极个别的订单失效状态能同步。
④因为无法确定客户是从付款后多长时间退款，可能是1小时，也可能是1天、2天，甚至是收到货之后的5天、7天，所以无法去根据下单/付款/结算时间拉取。
⑤目前的补救措施就是后台淘宝管理系统=》处理遗漏淘宝订单，根据订单时间去拉取下，会同步订单状态。

9、为什么淘宝商品佣金不一致？
    •    App中商品列表上的佣金为什么会比淘宝详情页面的高，因为淘宝客账号分为高佣、中佣、低佣三种级别，新申请的淘宝客账号是低佣账号，低佣账号同样的商品佣金比例要比高佣的低，而商品列表上的佣金是默认高佣状态的，商品详情页面上的佣金是淘宝客账号的实际佣金级别，如果是新申请的低佣账号则比列表上的佣金低，如果做完淘宝客升级任务后成为高佣账号，则是相同的。
     
10、淘宝客相关文档资料
    •    淘宝客API接口文档：https://open.taobao.com/api.htm?docId=24515&docType=2
    •    淘宝客订单查询接口文档：https://open.taobao.com/api.htm?docId=24527&docType=2
    •    淘宝联盟的api权限说明：https://baichuan.bbs.taobao.com/detail.html?spm=a3c0d.7971500.0.0.641fed6eNTj0l8&postId=7921792
    •    淘宝客API介绍总帖：https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8127005

 三、拼多多应用

 申请
拼多多联盟 https://jinbao.pinduoduo.com
拼多多开发平台：https://open.pinduoduo.com/#/index
先申请拼多多联盟，再申请拼多多开发平台的
 创建拼多多应用
两个平台的账号申请好之后，需要创建拼多多应用
选择创建多多客联盟应用
需要上传产品需求说明书模板和市场需求说明书模板，转换为PDF格式
下载上面的2个模板文件，将文档中的app和公司相关信息全部修改为自己公司的实际信息。
创建好多多客联盟应用之后，可以得到应用的client_id和client_secret
    •    修改后台拼多多配置
从在拼多多开放平台创建好的多多客联盟应用中复制client_id，填写到拼多多联盟api权限中，如图：
获取推广位：
进入汇客熊淘宝客管理后台，找到系统设置=>应用账号配置，修改拼多多的3个配置参数即可：

四、京东应用

1、申请京东联盟
注册京东联盟账号： http://union.jd.com
京东联盟API：http://jos.jd.com/api/list.htm?id=117
接入文档：https://union.jd.com/helpcenter/12188-12384-46301
宙斯接入文档：https://union.jd.com/helpcenter/13246-13312-57749
    •    创建京东联盟APP应用
①创建应用
京东联盟APP应用创建，必须是要APP正式上架应用市场后方可申请
创建步骤：
打开推广管理=》APP管理=》创建APP
等待审核通过后使用，拿到App应用的APP ID、appkey和secretkey：
②创建推广位
创建步骤：
打开推广管理=》APP管理=》推广位管理=》创建推广位
拿到推广位ID和对于PID
3、获取授权key
      1、如第三方开通接口查询权限后，则可通过您提供的授权KEY，查询您的明细数据，且授权后无法解除授权
      2、授权key有效期默认60天（记得到期之前领取新的key），点击【领取授权key】则自动终止当前生效中的key，并增加一个新key，则原来的key将立即失效，第三方再通过原key将无法做任何操作。
            查看授权key：京东联盟=》我的工具=》我的api

获取还在有效期的授权key，如果都已失效，可以领取新的授权key。

4、申请京东高级权限
邮箱：
cps-qxsq@jd.com
jingfenhezuo@jd.com
高级权限接口权限面向联盟企业账号开放申请，申请所需条件如下：
a) 流量稳定且具备一定推广规模的企业会员，无违规行为，接受业绩考核。
b) 会员申请标准：月订单量>3万单
c) 如开通后2个自然月内如无返回数据，或月订单量达不到要求的，将关闭权限。
如您为有推广能力的新会员，请填写申请表，并附上流量证明、引流能力证明，提供数据等发送到“cps-qxsq@jd.com”邮箱申请权限开通；

在满足会员的基本运营前提下，针对每个appkey的调用次数设置30万次/天封顶（联盟所有接口调用量总和），建议您对转链结果进行几分钟的缓存，以减少产生不必要的调用量。如您的联盟接口总调用量超过上限，将会返回以下信息提示：
 code: 3066
 msg: APP GLOBAL LIMITER ACTIVE, REQUEST TIMES LIMITED
如果您的业务量庞大，需要提高接口调用量，可按以下格式发送邮件进行申请，审核通过即可开通：
 发送邮件至：cps-qxsq@jd.com；
 邮件标题：接口调用量申请-个人/企业名称-联盟ID；
 邮件内容：联盟ID、appkey、个人/企业名称、推广模式、流量类型、推广渠道、预估单日调用量等
结算模式选择一，申请通过之后会得到unionId以及高级权限应用的appkey、secretkey。
5、常见问题
Q:京东联盟开放平台和京东宙斯平台有什么区别？
A:京东联盟API服务从原宙斯平台迁移至新的开放平台，数据源不变，调整、优化了接口功能，联盟用户可在新平台一站接入，无需再到宙斯平台创建应用；新平台的appkey和secretkey与宙斯平台不通用，如您曾在宙斯平台申请过，需在新平台重新申请。
Q:接口权限说明
A:京东联盟API有接口级别权限和出入参的白名单控制，统一发邮件至cps-qxsq@jd.com开通。
Q: 非必填的入参字段注意事项
A:当非必填输入参数没有值时，不传该参数即可，不需要入参空值。
6、成为开发者，创建应用
①成为开发者
打开京东宙斯开放平台：http://open.jd.com/home/home#/index
点击控制中心，提交开发者信息完成入驻，按要求完成信息提交后，通过审核即可成为开发者。
打开应用管理：
②创建开发应用
开发者首先需要申请符合自己业务所需的应用类型，以保证后续接口调用与用户授权流程的正常运行；
打开应用管理=》创建应用=》创建商品导购=》京东联盟应用
点击创建应用后，按要求完善信息：
信息完善点击提交，运营会在3个工作日内完成应用创建的审核。
通过应用管理，完善应用信息、管理应用及查看数据报表等
测试状态应用每日接口调用量限制在5000次，完成开发的应用点击发布应用后应用可以完成上线操作，上线后应用切换为上线状态流控，接口调用量变为每日30万次。
6、JOS授权
京东用户登录授权（新）说明：http://open.jd.com/home/home#/doc/common?listId=717
京东授权流程是基于OAuth2.0授权让京东用户使用京东身份安全登录第三方应用或服务, 在京东用户授权登录已接入京东Oauth2.0的第三方应用后, 第三方可以获取到用户的接口调用凭证(access_token), 通过access_token可以进行京东开放平台授权关系接口调用, 从而实现获取京东用户基本开放信息和帮助用户实现基础开放功能等.京东Oauth2.0授权目前支持authorization_code模式, 该模式整体流程为:
1.第三方发起京东授权请求, 京东用户允许授权第三方应用后,京东会拉起应用或重定向到第三方应用网站, 并且带上授权临时票据code参数
2.通过code参数加上AppID和AppSecret等, 通过API换取access_token
3.通过access_token进行接口调用, 获取用户基本数据资源或帮助用户实现基本操作
1.请求code
https://open-oauth.jd.com/oauth2/to_login?app_key=XXXXX&response_type=code&redirect_uri=XXXXX&state=20180416&scope=snsapi_base

生成的网址粘贴到浏览器中访问，使用京东联盟账号登录授权，会得到code并跳转到回调页面
返回说明：
用户允许授权后,会跳转到指定的redirect_uri并多添加两个参数code和state参数
redirect_uri?code=CODE&state=STATE
若用户禁止授权,则会重定向后不会带上code参数, 仅会带上state参数
redirect_uri?state=STATE
2.通过code获取access_token
https://open-oauth.jd.com/oauth2/access_token?app_key=XXXXX&app_secret=XXXXX&grant_type=authorization_code&code=XXXXX

返回参数说明：
参数

7、后台程序配置参数
打开京东联盟配置文件，文件位置：ThinkPHP\Library\Vendor\JingDong\JingDong.class.php，将上面申请好的账号参数填入。
8、处理京东遗漏订单
管理后台=》京东订单管理 » 处理遗漏京东订单

注意点：

拉取京东订单，需要填写订单时间，订单时间是以订单的最后更新时间为准，比如下单时最后更新时间为创建时间，付款后是付款时间，确认收货后最后更新时间是完成时间，只填写创建时间无法不同状态的订单。
确认收货后订单状态为已完成，结算时间为下个月的20号，结算后订单状态为已结算。
查看下载京东订单：
京东联盟=》效果报表=》订单明细=》导出数据

五、后台操作手册

1、banner广告图设置

位置：管理后台=》内容管理=》Banner/广告管理
分类已经设置好了，分为：首页banner、首页广告分类、推荐链接、首页弹框，不同的类别对应如下功能块：
①首页广告轮播图
对应的是App首页最上方的轮播广告图
②首页广告
③首页弹框
④推荐链接
推荐链接指的是分享自己的二维码图片给好友，让好友注册下载App，成为自己的团队成员，后面自己可以得到团队成员相应的返利收入
⑤广告图类型说明
类型
1网页（跳转指定网址）
2淘宝（复制淘口令，打开淘宝）
3京东（根据商品ID，打开对应商品详情页）
4拼多多（根据商品ID，打开对应商品详情页）
5支付宝（跳转到支付宝领红包页面）
6淘宝年货节（跳转到淘宝年货节页面）
7春节红包（跳转到春节红包页面）
8新人红包（跳转到新人红包页面）
9淘宝商品（根据商品ID，打开对应商品详情页）

2、营销中心

①爆款商品推送
    •    位置：管理后台=》营销中心=》爆款商品推送 
    •    可以推送淘宝、拼多多、京东三大平台的商品，填写正确的商品ID，推送后用户会收到消息通知，点击查看跳转到对应的App中商品详情页
    •    注意事项：
    •    请确保所填写的商品ID正确
    •    不填写自定义标题和内容的情况下，推送的是商品原名称，填写自定义内容后推送消息根据填写的来
    •    营销中心=》淘宝商品超级搜索，会跳转到淘宝联盟官方，便于筛选商品
②文章推送
位置：管理后台=》营销中心=》文章推送
和爆款商品推送功能类似，也是消息推送功能，这里推送的是一篇文章，填写上文章标题和网址，用户查看会跳转到对应的文章网页
③ 淘宝推荐商品管理
位置：管理后台=》营销中心=》淘宝推荐商品管理
该栏目可手动录入淘宝商品，比如和商家合作的商品，收取广告费用的商品等，以区别于app端自动获取的淘宝商品，做到商品可控，请尽量录入带有优惠券的商品，便于售卖
④热门搜索设置
位置：管理后台=》营销中心=》热门搜索设置
该栏目设置的是搜索时候的热门关键词，可以分为淘宝、拼多多、京东、自营商城类型，按照搜索总次数排序，默认是统计的用户搜索累计结果，后台可以进行设置，人为控制热门关键词
⑤拉新活动
位置：管理后台=》营销中心=》拉新活动
该栏目设置拉新活动，作为营销推广手段，引流用户。
活动可设置主题、活动时间、兑现奖励时间、配置奖项规则，可以给现金和积分2种方式的奖励
⑥淘宝0元购商品管理
位置：管理后台=》营销中心=》淘宝0元购商品管理
该栏目设置淘宝0元购商品，作为营销推广手段，引流用户，主要是手段筛选录入一些淘宝商品，设置补贴金额，购物流程还是和淘宝客一样，保证用户在领券和得到佣金返利之后，再给予平台补贴的金额，以达到基本不花一分钱或者只花几元钱，以达到免费购物的效果，给予用户粉丝福利和促进平台用户增长。
具体的操作可以参考“③ 淘宝推荐商品管理”，多填入一个补贴金额，注意计算用户实际花费的钱，补贴金额不要填写过高，甚至超出用户实际花费的钱。

3、系统设置

①站点设置
位置：管理后台=》系统设置=》站点设置
可设置网站名称和App名称
②应用账号配置
位置：管理后台=》系统设置=》应用账号配置
可设置淘宝客、拼多多、极光推送、支付宝等平台账号相关参数
友情提示：该页面账号配置参数由专业技术人员配置，请勿随意修改！请妥善保管，请勿泄露！
③会员升级规则配置
    •    位置：管理后台=》系统设置=》会员升级配置
    •    样式DIY设置
①功能模块管理
    •    位置：管理后台=》样式DIY设置=》功能模块管理
    •    该栏目显示的所有功能模块是对应App端软件的功能，是显示在App首页最上方的功能块导航，后台可以编辑功能模块的名称、图标，选择控制是否需要显示在App端首页上方，以及按照优先级排序。 
    •    点击左下角的“统一排序”按钮可以进行排序，点击右上角的“更新设置功能模块”按钮可以更新App端的显示。