Quick-start in 10 minutes
Open Brands → Edit → Affiliate, flip "Enable", choose a commission %, cookie window, and tracking method, save. Influencers who apply to your campaign get a tracking link automatically.
Before you start
You need:
- A Company workspace with at least one brand inside (Brands → Add brand)
- A destination URL the affiliate links should send buyers to (your storefront, a landing page, or a category)
- An idea of your commission % — most brands start at 10% net. You can change it later.
You do NOT need a developer for the basic setup. Server-side postbacks (step 6) are recommended but optional.
The 6-step flow
1. Open the affiliate setup modal
Brands → Edit (on the brand row) → Affiliate tab.
You’ll see a 4-tab modal: Basics · Tiers & restrictions · Tracking · Public page.
2. Enable + set the basics (Basics tab)
- Enable affiliate program: flip on.
- Default commission %: the rate every conversion earns unless a tier or per-creator override kicks in. Start with 10%.
- Cookie window: how long a click is attributed. 30 days is the industry default.
- Holdback days: how long a conversion stays “pending” before auto-approval. 14 days lets you handle refunds before paying out.
- Code prefix: 2–8 letters that become the start of every influencer’s discount code (e.g.
NIKE→NIKE-ABCD1234). Leave blank to disable discount codes.
Save. You can come back and refine anytime — these are not one-shot decisions.
3. Tiers & restrictions (optional, Tiers tab)
Skip this on first pass. Open when you want:
- Tiers — bump the rate after a creator hits N sales. Example: 10% base, 15% after 5 sales, 20% after 20.
- Commission cap per sale — max dollar amount a single sale can earn (caps abuse on $10k items).
- Geo allow-list — only count conversions from these countries.
- Excluded SKUs / categories — products that don’t count toward commission.
- Fraud rules — IP velocity limits, self-purchase detection. Defaults are sensible; tune later from the admin panel.
4. Tracking method (Tracking tab)
Pick ONE to start. You can add the others later.
| Method | Best when | Effort |
|---|---|---|
| JS pixel | You have a Shopify/Woo/custom site and can paste a script | ~5 min |
| Server postback | You have a developer + want accurate refund handling | ~30 min |
| Shopify webhook | You’re on Shopify | ~10 min |
Recommendation: start with JS pixel, add server postback when you have your first 100 conversions and want bulletproof refund tracking.
For step-by-step JS pixel install, see JS pixel installation (it’s the same script for brand and influencer pages).
5. Public page (Public page tab, optional)
If you want creators to discover your program without you reaching out, fill in a public landing page (logo, description, commission promise). Otherwise leave blank.
6. Test with one campaign
- Create a campaign with compensation type = Affiliate (Campaigns → New → Compensation step → Affiliate platform: Keepface).
- Invite one creator (your test account, or a friendly creator who’ll click their link).
- After they accept, their tracking link appears in chat and on their
/influencer/affiliatedashboard. - Click their link from a different device/browser, complete a test purchase, check your Recent postback log in the admin Affiliate Ops surface to confirm the event arrived.
What “10 minutes” actually means
| Step | Time |
|---|---|
| 1. Open modal | 30 sec |
| 2. Basics tab | 3 min |
| 3. Tiers (skip first time) | 0 min |
| 4. Tracking — JS pixel paste | 4 min |
| 5. Public page (skip) | 0 min |
| 6. Test mint + click | 2 min |
If you also want server postbacks signed with HMAC, allocate another 30 min for the developer pass.
What to check the first week
The admin Affiliate Ops → Health tab shows you four numbers that matter:
- Conversions 24h — should grow as creators promote
- Open disputes — should be 0 (you raise these manually)
- Clawback failures — should be 0 (any number here is money you owe but couldn’t recover)
- Postback 401s — should be 0 once HMAC is set correctly
Set a Slack reminder to glance at this once a day for two weeks. After that the cron alerts handle it.
Common mistakes to avoid
- Commission too low — under 5% rarely motivates creators; 10–15% is the sweet spot for most consumer products.
- Cookie too short — 7 days kills mid-funnel buyers who need to compare before purchasing. Use 30 unless you sell impulse-purchase items.
- No code prefix — creators love sharing codes; an empty
code_prefixfield gives up half your attribution surface. - Forgetting Excluded SKUs on a sale — if you run a brand sale at 50% off, mark the sale SKUs excluded or you’ll pay commission on already-discounted items.
When you’re ready for advanced
See:
- Postback HMAC integration — server-side bulletproof tracking
- Discount-code attribution — capture sales where the buyer pasted a code but never clicked the link
- API reference — full endpoint spec for developers
Frequently asked questions
Do I need a developer to turn it on?
No. The setup modal in the brand workspace is point-and-click. You only need a developer when you want server-side postbacks (recommended for accurate refund handling). Most brands run the JS pixel for the first month and add postbacks later.
Can I change the commission after I've started?
Yes. Edits apply to conversions recorded AFTER the change. Existing conversions keep the rate they were minted with — fair to creators who already promoted.
What if I only want some products to be eligible?
Set "Excluded SKUs" in step 4. Orders that contain only excluded SKUs don't count; mixed orders count for the eligible portion.