Keitaro 后台操作教程

从登录、添加域名、上传落地页，到创建 Campaign、FB 投流、像素渠道配置。配合真实后台截图，适合投放与运营培训。

后台：https://kt345.net/admin 线上：https://keitaro-tutorial.pages.dev

1. 登录后台

  1. 浏览器打开 https://kt345.net/admin
  2. 输入用户名、密码（向管理员索取）
  3. 点击 Sign in
Keitaro 登录页
图 1 · 登录页
若提示 Incorrect password：检查密码是否完整（注意末尾可能是 Unicode 省略号 …，不是三个英文点）。
Keitaro 仪表盘
图 2 · 登录后仪表盘

2. 添加域名

域名是 Campaign 链接的根地址。须先在 DNS 配好 A 记录指向 149.129.221.161，再在 Keitaro 添加。

必需走 Cloudflare，并开启 CDN 代理（橙色云朵 Proxied）。
投放域不要裸解析到 Keitaro 源站 IP。经 CF CDN 隐藏真实 IP 后，单个投放域被平台标记或封禁时，不会牵连同服务器上的 Tracker 主域（如 kt345.net）及其他 Campaign 域名。

当前已有域名

域名分组用途
kt345.net管理Tracker 主域，可开 /admin
kt.clashtorm.comfacebook投放用，Campaign 绑此域

DNS 配置（必需 Cloudflare + CDN）

  1. 域名 NS 接入 Cloudflare（投放域统一走 CF，不要只在注册商裸配 A）
  2. 在 CF DNS 添加 A 记录，解析到 Keitaro 服务器：149.129.221.161
  3. 必须开启代理：云朵图标为橙色（Proxied / CDN 开），不能是灰色（DNS only）
类型主机值CF 代理
A@（根域）149.129.221.161Proxied（橙云）
Atrack（子域示例）149.129.221.161Proxied（橙云）
Keitaro 后台「网域」页顶部也会显示该 IP（149.129.221.161），与 CF A 记录保持一致即可。
只保留一条 A 记录，删除冲突的 CNAME、多余 A/AAAA。DNS 生效可能需要几分钟到 24 小时。
Keitaro 可集成 Cloudflare（Maintenance → Integrations → Cloudflare）自动管理 DNS；添加域名时勾选 Cloudflare Proxy。

Keitaro 后台操作

  1. 左侧 → 网域（Domains）
  2. 点击 添加
  3. 域名：填自己的投放域，如 test.com（提示：输入自己域名如 test.com）
  4. 群组：选对应投放平台的分组（下拉可搜索或新建），便于后台按平台筛选、管理域名
  5. 管理面板：投放域选 否定（只有主域如 kt345.net 才允许）
  6. HTTPS-only：选 开
  7. 勾选 添加更多 后，确认 Cloudflare Proxy 开启（与 CF 橙云 CDN 一致）
  8. 点击 添加，等待 SSL = issued、Status = active
群组（示例）适用场景
facebookFacebook / Meta 广告投放域名
tiktokTikTok 广告投放域名
googleGoogle 广告投放域名（按团队命名）
短信SMS / 短信渠道域名
管理Tracker 主域（如 kt345.net），非投放用
群组名称与平台一一对应，新建域名时不要混用：FB 投就用 facebook，TikTok 投就用 tiktok，方便报表和后续换域。
域名列表
图 3 · 域名列表
添加域名
图 4 · 添加域名：域名填投放域（如 test.com）；群组选对应平台（facebook / tiktok 等）

3. 落地页（Landing pages）

HTML 托管在 Keitaro（Local Landing），在 Campaign 的 Stream 里选用。

落地页上传仅由开发负责，投放/运营不需要在后台手动上传 ZIP。 你们只需在列表里查看、Preview 预览，确认模板已在对应分组；需要上新或更新页面时，联系开发执行命令上传。

投放/运营：后台查看即可

分组数量源码目录
红包6public/红包落地/（黑金、金色等）
tokopedia5public/过审白页/tokopedia/
googleplay5public/过审白页/googleplay/
  1. 左侧 → 落地页
  2. 按分组筛选，点击名称 → Preview 预览
落地页列表
图 5 · 落地页列表（按分组筛选）

开发上传（命令行，仅开发操作）

make deploy-keitaro-landing

python3 .cursor/skills/keitaro/scripts/upload_landings.py \
  --dir public/过审白页/tokopedia --group tokopedia

4. 创建活动 Campaign

Campaign = 一条可投放的追踪链接 + 流量分发规则。

推荐：克隆已有活动（最快）

日常新建投放活动，优先克隆模板（如 facebook投流模板），会一并复制来源、参数、流，比从零创建省时间。

  1. 左侧 → 活动
  2. 勾选要复制的活动行左侧 复选框
  3. 列表上方批量操作 → 点击 克隆
  4. 弹窗点 确认，Keitaro 会生成一条新活动（名称带 Copy 后缀）
  5. 打开新活动 → 改 名称、标识符（路径须唯一）、必要时改 域
  6. 标签 设置 → 参数 表 → fb像素id 行的 占位符 填入本次投放的 Facebook 像素 ID
  7. 保存
勾选活动后点击克隆
图 6 · 勾选活动 → 顶部「克隆」
克隆确认弹窗
图 7 · 确认克隆
克隆后填写 fb像素id
图 8 · 克隆后：设置 → 参数 → fb像素id 占位符填像素 ID（左侧表格）
克隆后务必改 标识符；fb像素id 换成本次账户的真实像素 ID。右侧 流 / AB 分流（如 FB过审白页、真流量）会随克隆一并复制，克隆后不需要再配流，除非投放负责人要求改落地页或国家规则。

从零创建（可选）

  1. 活动列表 → 点击 创建
活动列表
图 9 · 活动列表
创建活动
图 10 · 创建活动表单

必填字段

字段说明示例
名称后台识别facebook投流模板
域已 active 的投放域kt.clashtorm.com
标识符URL 路径shop → /shop
来源流量来源模板Facebook
状态启用启用

参数

打开活动 → 顶部标签 设置 → 下方 参数 表格，把 URL 里的 query 映射到 sub_id，便于报表与像素归因。

  1. 找到名称为 fb像素id 的行（参数列 = fbpixid）
  2. 在 占位符（Placeholder）列填入你的 Facebook 像素 ID
  3. 保存活动；投放链接可继续带 fbpixid= 覆盖或补充该值
名称参数占位符
fb像素idfbpixid你的 FB 像素 ID（示例 1234545）
活动设置-参数表填写 fb像素id
图 11 · 设置 → 参数：fb像素id 占位符填像素 ID

完整投放链接示例：

https://kt.clashtorm.com/shop?fbpixid=你的像素ID&channel=fb01&ns=2015
Facebook 投放：不要在网址参数里写 fbclid={fbclid}，Facebook 会自动追加 fbclid。
编辑活动
图 12 · 活动编辑总览（facebook投流模板）

5. 配置流（AB 分流）

克隆活动不用看本节。克隆模板时，右侧「流」会一并复制（过滤器、着陆页、权重等），日常新建投放只需改 §4 里的名称、标识符、fb像素id 即可。

仅 从零创建活动 或投放负责人要求调整分流时，才需配置。活动编辑页右侧为 流 / AB 分流：不同线对应不同落地页与过滤规则（如 FB过审白页 → tokopedia，真流量 → 红包）。

  1. 打开活动 → 右侧 流 区域（或 Schema 视图）
  2. 点击 创建线 或编辑已有线
  3. Action 选 着陆页（Local landing）→ 选分组下的 landing
  4. 按需加 过滤器（国家、语言、机器人等）
  5. 保存，复制顶部活动链接
活动右侧流 AB 分流配置
图 13 · 右侧「流」AB 分流（克隆时自动复制，无需运营配置）
流编辑详情
图 14 · 单条流的编辑界面（参考）
当前示例活动链接：https://kt.clashtorm.com/shop
备注：FB 过审阶段展示购物平台白页；过审后按国家切换红包/白页（与投放负责人确认）。

6. FB 投流

克隆并完成 §4 修改后，按以下步骤取链接、控制过审期只走白页。

6.1 复制广告活动 URL

  1. 左侧 → 活动
  2. 点击 活动名称（如 facebook投流模板）进入活动设置页
  3. 顶部标签切换到 Tracking
  4. 在 广告活动URL 一栏，点右侧 复制 按钮，粘贴到 Facebook 广告「网站 URL」
活动列表点击名称
图 15 · 活动列表 → 点击活动名称
Tracking 复制广告活动URL
图 16 · Tracking → 复制广告活动URL
URL 已含 fbpixid= 等参数时，直接整链复制即可；不要在 FB 广告里额外写 fbclid={fbclid}。

6.2 过审期：关闭「真流量」

同一活动设置页，右侧 流 区域：

  1. 找到 真流量 这一行
  2. 点击名称旁的 绿色闪电图标 → 变为 红色（该流暂停）
  3. 点击右上角 保存 — 切记一定要保存才生效
  4. 此时审核流量只走 FB过审白页（tokopedia 等白页）
送审 / 审核期间务必保持「真流量」为红色。 只点闪电不保存不会生效；审核人员若看到红包落地页，会导致拒审。

6.3 审核通过后：开启「真流量」

  1. 再次进入该活动设置页
  2. 点击 真流量 旁的 红色闪电 → 变回 绿色（启用分流）
  3. 点击 保存 使变更生效
  4. 按模板规则：印尼等真流量 → 红包落地页，其余 → 白页（与投放负责人确认）

7. 像素渠道 · 三方游戏配置

Keitaro 里填的 fbpixid 必须在红包管理后台登记，并配置各三方平台的 H5 / APK 落地页，App 下载页才能按像素正确跳转。

后台地址：https://admin.hb5679.com/landing/channel_ads

7.1 新增像素台账

  1. 登录红包管理后台（账号向管理员索取）
  2. 左侧 → 落地页管理
  3. 顶部 Tab → channel_ads（像素台账）
  4. 点击 + 新增像素
  5. 填写上方表单（与 Keitaro §4 的 fbpixid 保持一致）：
字段说明示例
像素 ID与 Keitaro 参数 fbpixid 相同2323232
广告来源FB 投流选 FacebookFacebook
名称投放名称（可选）—
账户 ID广告账户 ID（可选）—
CAPI 凭证Facebook Conversions API Token（可选，需 CAPI 回传时填）access_token
状态启用正常
备注备注（可选）—

7.2 配置 16 个三方游戏平台

弹窗下方 像素和三方游戏 表格（顶部显示「已配置 x / 16」），为每个平台填写：

列说明
平台三方游戏名称（如 DAN777、DNA777、8278、Ketua 等）
H5 游戏页该平台 H5 落地页 URL；留空 = 不配置 / 删除
APK 下载该平台 APK 下载页 URL；留空 = 不配置
  1. 先填好 像素 ID，下方矩阵才会加载平台列表
  2. 按投放需求逐行填写 H5 / APK（不必 16 个全填，但常用平台建议配齐）
  3. 点击弹窗 确定 保存像素 + 三方游戏配置
像素台账新增与三方游戏配置
图 17 · 落地页管理 → channel_ads → 新增像素 + 像素和三方游戏
像素 ID 必须与 Keitaro 活动里 fbpixid 完全一致，否则落地页无法关联到正确下载配置。
已创建的像素可在列表行点击 三方游戏 单独编辑 H5/APK 矩阵，无需重开新建弹窗。

8. 环境速查

项值
Trackerhttps://kt345.net
管理后台https://kt345.net/admin
投放域名https://kt.clashtorm.com
示例活动facebook投流模板 / 标识符 shop
示例链接https://kt.clashtorm.com/shop
红包管理后台admin.hb5679.com/landing/channel_ads
落地页分组（Keitaro）红包、tokopedia、googleplay