/install affiliate-kol-roi-monitor
Affiliate & KOL ROI Monitor
You replace manual commission runs, order-to-creator matching, and influencer performance reporting with a repeatable workflow: attribution data → net of refunds → profit-aware economics → tiered renewals.
Core workflow (always follow in order)
- Extract attribution data — Map each order (or session) to a creator: discount codes, UTM (
utm_source,utm_medium,utm_campaign), affiliate platform IDs, first-touch / last-touch rules. State the rule you use. - Exclude refund / chargeback orders — Remove or weight down refunded revenue and reversed commissions for the reporting window. Call out partial refunds.
- Compute actual profit (where inputs allow) — Revenue net of refunds × margin (or COGS) minus creator cost (fixed fee + variable commission) = contribution per creator. If margin unknown, show revenue net of refunds and CAC using payout as cost.
- Tiered renewal proposals — Rate each creator; propose continue / renegotiate / pause with concrete terms (rate, cap, exclusivity, content minimums).
When NOT to use
- No order or payout data — only branding or follower counts.
- Single creator, no reconciliation — simple contract review only.
- Paid ads (Meta/Google) without affiliate linkage — use ads ROAS skills.
Gather context (infer first; ask gaps)
- Platform: Shopify, WooCommerce, Impact, ShareASale, custom spreadsheet?
- Attribution: code-only, UTM-only, or hybrid; window (e.g. 7-day click).
- Commission model: % of sale, flat per order, hybrid, tiered by volume.
- Refund policy: full window for affiliate eligibility; chargebacks.
- Gross margin or COGS % (or confirm "use payout as CAC proxy").
- Renewal date or campaign end.
For fraud heuristics and renewal rubric detail, read references/affiliate_playbook.md when needed.
Mandatory success output: master table
Every full affiliate reconciliation or ROI report must include this table (one row per creator; use Influencer ID as the stable key — handle, platform ID, or internal code):
| Influencer ID | Orders attributed | Actual revenue | CAC | Renewal rating |
|---|---|---|---|---|
| … | … | … | … | … |
Column definitions
- Influencer ID: Stable identifier (agree with merchant).
- Orders attributed: Count of orders matched to this creator in the window, after refund/chargeback exclusion (state rule).
- Actual revenue: Net revenue attributable to that creator (gross order value minus refunds for attributed orders), same currency.
- CAC: Customer acquisition cost for that creator’s attributed sales — typically
(fixed fees + variable commissions + product/samples allocated)divided by new customers or by attributed orders; if only payout is known, define CAC as total creator cost / attributed orders and label it clearly. - Renewal rating: Tier such as A (renew strong), B (renew with caps), C (renegotiate or shorten), D (pause / investigate fraud) — always tie to numbers (conversion, refund rate, traffic quality).
Below the table, add: ROAS proxy (revenue / creator cost), fraud or quality flags if any, and renewal terms per tier.
Pushy deliverables (when user asks vaguely)
If they ask "who should we keep" or "affiliate ROI" without structure, still output: the master table, attribution rule summary, refund-adjusted figures, and at least two renewal scenarios (e.g. same rate vs reduced rate + cap).
Report outline (full run)
- Scope — date range, attribution rule, currency.
- Master table — required columns above.
- Refund / chargeback impact — table or bullets per creator if material.
- Profit or contribution — formula stated; margin assumptions if used.
- Fraud / low-quality signals — spikes, refund rate, session quality (if data exists).
- Renewal playbook — A/B/C/D actions and suggested contract language bullets.
Split with other skills
- Paid social ads without affiliates → not this skill.
- Legal contracts → flag for counsel; you provide economic summary only.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install affiliate-kol-roi-monitor - 安装完成后,直接呼叫该 Skill 的名称或使用
/affiliate-kol-roi-monitor触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Affiliate Kol Roi Monitor 是什么?
Automate affiliate and KOL reconciliation, attribution, true ROAS, commission math, and renewal strategy. Use when the user has more than ~5 KOL or affiliate... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 269 次。
如何安装 Affiliate Kol Roi Monitor?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install affiliate-kol-roi-monitor」即可一键安装,无需额外配置。
Affiliate Kol Roi Monitor 是免费的吗?
是的,Affiliate Kol Roi Monitor 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Affiliate Kol Roi Monitor 支持哪些平台?
Affiliate Kol Roi Monitor 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Affiliate Kol Roi Monitor?
由 RIJOY-AI(@rijoyai)开发并维护,当前版本 v0.1.0。