介绍基于GitHub开源项目Kuma Tracker自建追踪器的方法：用VPS或共享主机加域名和Agent即可安装，支持campaign、lander、offer三层分流与Meta、Google花费API同步，可接postback和REST API，免费无点击与域名限制，适合愿意自托管、有自定义需求的affiliate从业者，文内含安装、跑通首个点击和加功能的操作提醒。
Tags:Kuma Tracker
Hi，我是 Peter。
之前聊过我自己搭了套简易版追踪，有圈友留言，有现成的开源的底座，装上、换皮、加功能就行。
我照着做了一遍。换过来之后，追踪器这一项月费基本没了。
花5分钟看完，你也能搭一套自己的。
01 Simple Kuma 是什么
一个做 affiliate 的开发者自己写的 tracker，仓库在 GitHub 的 kumatrk/initialrelease，AGPL-3.0 开源。
仓库页。star 以页面为准
免费，没有点击上限，没有域名数限制
官网首页，Free forever
功能基本齐全
campaign、lander、offer 三层，带权重分流；
流量源模板，Meta、Google、TikTok、Zeropark、Taboola、MGID、RollerAds、RichAds 这些直接选，也能自定义；
Meta 和 Google 的花费能通过 API 自动同步进来；
postback 接收和日志、点击查询、redirectless 模式；
报表按日期、国家、设备下钻，GeoIP 库自带；
REST API，能让 Agent 直接读数据。
技术栈是 PHP 加 MySQL，最新版本 release 是 1.1.5.21，7 月底发的，一直在更。
Release 下载入口。版本以页面为准
在 Github 上它很不起眼，星标只有几十个，主要是作者在维护，很新，用的人不算多。
好处是不用从 0 开始，安装之后交给 Agent 负责监控维护。
02 开工前要准备的三样
一台机器
VPS 或者共享主机都行，10刀左右一个月的够用。要能跑 PHP 8.2 以上和 MySQL，没装的话后面 Agent 会一起装。
一个域名
专门给追踪用，别跟落地页共用一个。追踪域名被标记，落地页跟着遭殃，这是坑。
一个 Agent
CC、Codex、Cursor 这类，能在你的机器上跑命令的就行。下面每一步都是一段话丢给它。
这三样加起来，一个月的开销大概是几杯咖啡。
03 第一步，装：交给 Agent
安装按官方 release 走，下 zip、放到服务器、指好目录、跑向导。这一步不神秘，卡的多半是域名、SSL、数据库权限。
所以别自己点。丢给 Agent，它去 clone、建库、跑向导，你只看结果。
开口
把仓库地址和要求丢过去，原话：
给 AGENT 的话
把 github.com/kumatrk/initialrelease 装到这台机器上。
要求是 MySQL 建一个库，Web root 指向 public 目录，跑完 install.php 的向导，管理员账号叫 XXX，装完把后台地址和登录信息给我。
中间报错自己解决，解决不了再来问。
等
它会 clone 仓库、建库、起服务，然后像人一样打开 install.php 一步步填。中间有个坑，向导要求追踪域名必须是 https，所以域名的 SSL 要先弄好，或者让它先用临时域名装，之后再改。
登录
装完登进去，长这样。
装完登进去页面
从拿到仓库地址到登进后台，十分钟。
04 第二步，跑通第一个点击
装好只是空壳。要让它跑起来，得把流量源、offer、campaign 三样串起来，顺序别乱。
流量源
Traffic Sources 里点 Create from Template，选你跑的那家。
token 已经预填好，zone、cost、click id 这些占位符跟平台那边对上就行。
没有你那家的，选自定义，照平台文档把 token 填或者让 Agent 给你完善。
流量源模板，选一家，token 自动填好。
Offer
填网盟给的链接，把 click id 的占位符塞进去。payout 填固定值或者留给 postback 回传。
Campaign
有个五步向导。起名、选流量源、挂 lander 和 offer、设权重、确认，出一条 campaign URL。这条 URL 放进流量平台的广告里。
Campaign 向导，五步走完出链接
Postback
Postback URLs 页面有一条现成的，复制到网盟后台。网盟有转化就往这条 URL 打一下，Kuma 那边就多一行。
Postback URL，复制给网盟。
点一下
自己点一次 campaign URL，回后台看 Visitor Log。
IP、国家、设备、来源、落到了哪个 offer，一行一条。再手动打一条 postback，Conversion Log 多一行，链路就通了。
Visitor Log，每个点击一行
到这一步，一个开源的 tracker 已经在跑了。跟 SaaS 的区别是数据在自己手上，没人再按展示量、域数量找你收钱。
05 第三步，往上加自己的东西
这才是选开源而不是买 SaaS 的全部理由。
SaaS 适合花钱买省心，开源适合喜欢折腾，对数据和自定义功能看重的朋友。
先换皮，试试水
Kuma 的主题做得很规矩，一套主题就是一个 CSS 变量包加一行注册加一张 logo，不用改页面。拿它试手最合适，改坏了也不影响记账。
给 AGENT 的话
给这个 tracker 加一套主题叫 Flux。
背景 #0E0F13，主色 #FF6B35，正文浅灰。按它现有的 dark 主题格式写变量包，注册到 ThemeRegistry，logo 换成我的。
别动其它页面的代码。
右上角下拉一切，整站变色。十分钟不到
再加一个功能
Kuma 不做决定。它知道每个 zone 花了多少、转了几个，但不会替你停掉烧钱的那些。这个功能它没有，正好拿来练。
需求怎么说，决定做出来的东西能不能用。
边界条件比功能本身重要，最少多少点击才算数、同一个 zone 别重复报、命中之后干什么。
给 AGENT 的话
给 tracker 加一个 Auto Rules 页面。
一条规则 = 按某个 token（zone、subid 都行）聚合最近 N 小时的点击、花费、转化，设一个阈值，再设最少点击数避免小样本误判。
命中之后两种动作，只标记，或者标记加 POST 一个 webhook，payload 带 campaign、zone、点击、转化、花费。
评估逻辑写成 cron 脚本，同一个 zone 在同一个窗口内不重复报。
页面风格跟现有页面一致，带命中记录列表。
Agent 动了五处，一个建表的迁移文件、一个页面、一个 cron 脚本、路由和侧栏各加一行，三百来行代码。做出来是这样。
规则列表，下面是命中记录
命中之后 webhook 发出去一段 JSON，接收端去调流量源的 API 停 zone。tracker 负责判断，脚本负责执行，链路就闭上了。
往后想加什么都是类似方式。把需求说明白，就像在堆积一个物品，看着它从基础逐步拼凑完成。
06 一点思考
数据库定期备份。
让 Agent 加一条每天导出的 cron，扔到对象存储去。数据在自己手上的代价，是丢了没人赔。
Agent 改代码快，不等于可以放松对账。
回传、花费、利润，还是要自己看清楚。钱路径上的东西，别一股脑交给自动化。
适合愿意自托管、真有自定义需求的人。不想维护的，继续用成熟商业 tracker 更省心。
最后，希望这篇文章对你有帮助！
更多 Affiliate Marketing 干货，请前往星球/飞书获取
没有评论:
发表评论