Levanta 邀约助手使用指南

Workspace

七个独立模块

总览

8 个 KPI 同时展示当前值、上一等长周期变化和迷你趋势；图表支持提示、图例开关、缩放和点击下钻。

邀约记录

按日期、状态、操作人和创作者筛选，每页 50 条。顶部导出按钮会按当前筛选导出完整 CSV。

合作转化

显示活跃合作伙伴、名称匹配数量、品牌分布和伙伴明细。匹配只是名称精确匹配，不代表 API 能证明合作来源。

效果分析

查看销售、佣金、流量漏斗、创作者排名，以及订单转化率、加购率、客单价和佣金率。

商品健康

检查正常、缺货、停用、价格变化和佣金变化。点击环图可直接筛选表格。

活动与同步

查看 Creator Connections 活动、最近同步结果、同步历史和错误信息，并可手动同步 Levanta。

使用指南

当前页面。返回仪表盘后，URL Hash 会保留最后打开的业务模块。

Outreach Rules

插件执行规则

• 弹窗顶部显示 Directory 连接、Levanta 剩余额度、今日和累计邀约；额度读取失败时可点刷新图标重试。
• “试运行 / 正式发送”采用分段控制。正式发送会显示红色警示带和“开始正式邀约”按钮，不再依赖容易遗漏的复选框。
• 每批数量与随机间隔会实时校验；数量超过剩余额度、间隔不在 30-3600 秒或最小值大于最大值时不能开始。
• 邀约消息和日志默认折叠；运行、停止清理或错误时日志自动展开。运行中主按钮会切换为“停止运行”。
• 只在当前 Creator Directory 页面运行，不自动跳转；保留搜索、排序和其他筛选，并自动追加 Not partnered。
• 自动跳过页面上已显示 Active、Invited 或 Applied 的创作者，并通过团队历史记录减少重复发送。Not partnered 可能同时包含可新邀约和已申请对象，不能只按筛选后的总人数判断。
• 真实发送使用 Bulk actions > Send partnership invite，可以跨页累计勾选。
• 每批数量最高为页面显示的 Levanta 今日剩余额度，不再使用固定 100 上限。
• 找到 1 个以上但不足目标数量时，按实际数量试运行或发送；只有 0 个时才停止。
• 插件会在每批扫描前把当前 Directory URL 调整为 size=100 并返回第一页，保留搜索、筛选和排序；页面重新加载后再确认 Not partnered 与每页 100 条，不再只依赖下拉框点击。
• 0.3.10 直接按复选框和创作者详情链接识别卡片，不再因简介较长或缺少右侧操作按钮而漏选；逐卡滚动等待也已移除。
• 0.3.11 在批次报错时自动清除已累计的跨页勾选，避免残留勾选被并入下一批；团队去重名单全量读取，超过 1000 条历史依然生效。
• 0.3.12 只有最终发送点击成功返回后才把批次标记为已提交；发送前报错会在日志中明确显示是否已自动清除选择。团队去重和部分成功统计采用稳定全量分页，避免大批同时间记录在分页边界遗漏。
• 0.3.13 登录仪表盘后自动检查并同步官方数据；插件使用 Creator UUID 原子认领，避免同名误判和多设备并发重复发送。
• 发送后最多等待 60 秒确认额度；达到目标立即成功，只有额度连续 20 秒不再增加时才按最终增量记录为部分成功并停止。
• 点击“停止运行”后会中断后续勾选和翻页，并清除累计选择；等待“正在停止并清理”结束后再开始。
• 若最终 Send invites 已经点击，请求无法撤回；插件会完成结果确认和记录，但不会继续下一批。
• 运行中可以关闭再重新打开插件查看额度和日志；0.3.10 会恢复运行状态，不会重复注入页面脚本或切断当前批次。
• 日志会显示扫描页数、检查的可邀约数量、状态跳过数量、勾选失败数量与停止原因。部分成功（例如 14/17）表示 Levanta 只确认了部分额度，插件会停止以避免重复邀约。
• 发送弹窗超时后会比较 Levanta 已用额度。部分成功数量计入实际邀约，未确认部分仍保留待复核。

Metrics

核心指标口径

实际邀约

sent + 部分成功校正数量。因此它可能高于逐条显示为“已邀约”的记录数。

邀约确认率

实际邀约 ÷（实际邀约 + 失败 + 未确认），试运行不进入分母。

合作匹配率

名称精确匹配的活跃合作伙伴 ÷ 唯一已邀约创作者。名称不同或原有伙伴会显示未匹配。

订单转化率

订单 ÷ 点击。

加购率

加购 ÷ 详情页访问。

客单价

销售额 ÷ 订单。

佣金率

佣金 ÷ 销售额。

商品佣金

Levanta API 返回的是小数比例，例如 0.2 代表 20%；仪表盘会自动换算为百分比显示。

增幅

对比紧邻的上一等长周期。历史数据覆盖不到上一周期开始日或上一周期为 0 时显示“数据不足”，不会把缺失值当成零。

Data Sync

Levanta API 同步

1. 管理员在 Supabase 项目 Edge Functions 的 Secrets 中配置 LEVANTA_API_KEY，值来自 Levanta Settings → API。
2. API 密钥只保存在 Supabase Secret 中，不写入插件文件，也不发给普通使用者。
3. 当前版本采用手动同步。在仪表盘选择今天、7、30、90 或 180 天，再点击“同步 Levanta”；时间范围会决定同步的效果报告范围。
4. 插件邀约记录会在每次运行后实时写入 Supabase，不需要点击同步。同步按钮只负责 Levanta API 数据。
5. 首次同步后可看到当前合作伙伴和商品；商品价格/佣金变化需要至少两个不同日期的同步快照。
6. 同步失败时到“活动与同步”查看错误。每日邀约额度不来自 API，仍以 Directory 页面顶部数字为准。
7. 公开 Seller API 暂未提供 Applications、Pending 或 Rejected 名单接口，因此同步按钮不能用 API Key 精确回填部分成功批次的具体姓名。插件不会调用官网未公开的内部接口。

Reconciliation

数量不一致时怎么看

Levanta 显示已用 300，逐条已邀约少于 300

通常是部分成功批次造成。仪表盘“实际邀约”会读取 PARTIAL_SENT_COUNT 校正总量；这类表格行显示“部分成功·名单待核对”，表示批次总数已校正，但无法安全推断每个成功的创作者姓名。

仪表盘与 Levanta 今日额度不同

Levanta 页面是当天额度的最终依据；仪表盘是团队操作记录。人工发送、其他工具发送或未确认批次都会造成差异。

销售指标显示数据不足

当前 Supabase 中的效果报告尚未覆盖完整上一周期。完成更多历史同步后会自动出现可比较的增幅。

Troubleshooting

常见问题

提示不在 Directory 页面

先手动进入 https://app.levanta.io/seller/partners/discover/directory，完成筛选后再开始。

找不到 Bulk actions 或复选框

保持 Levanta 为桌面宽度，并关闭仍覆盖在列表上的 Filters 面板。

更新插件后页面没变化

在 chrome://extensions 重新加载扩展，再刷新 Levanta 页面和仪表盘。

开始按钮不可用

先确认 Directory 已连接，再按输入框下方提示修正每批数量或随机间隔。运行中的停止按钮不受这些校验影响。

Mac 是否兼容

兼容 macOS Chrome 和常见 Chromium 浏览器。Safari 不能直接加载此 Manifest V3 扩展。