ops: set up affiliate accounts for shopping list integration #74

New issue

Open

opened 2026-04-12 11:45:41 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-04-12 11:45:41 -07:00

Owner

Kiwi shopping list will surface retailer affiliate links on gap items (ingredients the user needs to buy). Affiliate IDs wire into core.affiliates -- resolution order: opt-out check → BYOK ID (Premium) → CF ID → plain URL.

Design: circuitforge-plans/shared/2026-04-04-affiliate-links-design.md

Accounts to Set Up

Amazon Associates -- https://affiliate-program.amazon.com/ -- grocery + pantry staples, broad coverage
Instacart Affiliate (via Impact) -- https://www.instacart.com/affiliates -- same-day grocery delivery, high intent
Walmart Affiliate (via Impact) -- https://affiliates.walmart.com/ -- grocery + household, wide availability
Target Affiliates (via Impact) -- https://partners.target.com/ -- grocery + household, urban reach
Thrive Market -- https://thrivemarket.com/affiliates -- organic/health focus, good match for Kiwi audience
Misfits Market / Imperfect Foods -- https://www.misfitsmarket.com/affiliate -- reduced-waste produce, strong brand alignment with Kiwi values

After Each Account is Approved

Add affiliate ID to .env / .env.example (e.g. AMAZON_AFFILIATE_ID, INSTACART_AFFILIATE_ID)
Wire ID into core.affiliates retailer config for Kiwi
Test link generation end-to-end in dev

Notes

Premium users can supply their own affiliate IDs and keep the commission (BYOK affiliate)
Anonymous cloud users get a disclosure banner once per session
Opt-out is global across CF products, stored in user_preferences on Heimdall (tracked in heimdall#5)
Links only appear on gap items -- nothing shown for ingredients already in pantry

Kiwi shopping list will surface retailer affiliate links on gap items (ingredients the user needs to buy). Affiliate IDs wire into `core.affiliates` -- resolution order: opt-out check → BYOK ID (Premium) → CF ID → plain URL. Design: `circuitforge-plans/shared/2026-04-04-affiliate-links-design.md` ## Accounts to Set Up - [ ] **Amazon Associates** -- https://affiliate-program.amazon.com/ -- grocery + pantry staples, broad coverage - [ ] **Instacart Affiliate** (via Impact) -- https://www.instacart.com/affiliates -- same-day grocery delivery, high intent - [ ] **Walmart Affiliate** (via Impact) -- https://affiliates.walmart.com/ -- grocery + household, wide availability - [ ] **Target Affiliates** (via Impact) -- https://partners.target.com/ -- grocery + household, urban reach - [ ] **Thrive Market** -- https://thrivemarket.com/affiliates -- organic/health focus, good match for Kiwi audience - [ ] **Misfits Market / Imperfect Foods** -- https://www.misfitsmarket.com/affiliate -- reduced-waste produce, strong brand alignment with Kiwi values ## After Each Account is Approved 1. Add affiliate ID to `.env` / `.env.example` (e.g. `AMAZON_AFFILIATE_ID`, `INSTACART_AFFILIATE_ID`) 2. Wire ID into `core.affiliates` retailer config for Kiwi 3. Test link generation end-to-end in dev ## Notes - Premium users can supply their own affiliate IDs and keep the commission (BYOK affiliate) - Anonymous cloud users get a disclosure banner once per session - Opt-out is global across CF products, stored in `user_preferences` on Heimdall (tracked in heimdall#5) - Links only appear on gap items -- nothing shown for ingredients already in pantry