Affiliate app on Vareons: install, links, and tracking
The affiliate app is the id affiliate marketplace card opening /dashboard/affiliate: it builds referral links with generated codes appended as ?ref=CODE, tracks clicks and signups, attributes orders, and adds advanced tabs for analytics, security, and tools.
Last verified: 2026-09-19
The app installs from the /dashboard/apps marketplace with an Install button on the "Affiliate Program" card described as a marketer commission system with referral tracking, after which an Open button leads to /dashboard/affiliate. The card carries a Free badge.
The page has a Simple/Advanced toggle: Simple shows a "Simple Interface" title with an easy-referral-links description plus click, signup, conversion, and order stats, and a "Create New Referral Link" button opening a dialog with link-name and referral-code fields, a six-character generate-code button, and a create-link button; after creation it displays the link with copy and copied states plus the three referral steps. Advanced has six tabs (Overview, Analytics, Management, Security, Tools, Resources) with sub-sidebars, currently covered by a "coming soon" maintenance overlay with an urgent-fix request button.
The simple create flow generates the code, then posts the name, code, and URL in {subdomain}.vareons.com/?ref=CODE form to create-link, after which it is copied and shared. The tracking flow starts when the link opens by recording the click, links the user at registration through the signup route, then aggregates orders per code from data.affiliateCode with data.totals.grandTotal.
Links are stored in the SimpleReferralLink model (user, code, name, clicks, signups, conversions) and clicks in ReferralClick, with the tenant domain from User. The advanced routes (overview, analytics, commissions, payouts, leaderboard, campaigns, fraud, geo, achievements) currently read mock data from dataStructure/affiliate/mockData.
Setup steps in Vareons
Install the app from the marketplace
Open /dashboard/apps, press Install on the affiliate card, then press Open to reach /dashboard/affiliate.
Create a referral link
From Simple mode press create new referral link, enter the name, generate the code, then create the link as ?ref=CODE.
Copy and share
Copy the link with the copy button and share it with marketers; clicks and signups record automatically on open and registration.
Follow the stats
Review total clicks, signups, conversions, and orders per link from the simple list.
Explore Advanced cautiously
The Advanced analytics and security tabs currently show mock data; rely on Simple for real operations.
Frequently asked questions
Is the affiliate app free?
Yes, the card carries a Free badge, and simple creation and tracking work with no purchase.
How is the referral link built?
A six-character generated code appended as a ?ref=CODE parameter to your store domain URL, then copied and shared.
How are orders attributed to the marketer?
Through the order's data.affiliateCode field with data.totals.grandTotal, aggregated per code automatically.
Are the Advanced tabs real?
Not currently; they show mock data under a maintenance overlay. Real operations live in Simple mode only.
Does tracking work with social signup?
Yes, both the standard register and complete-google-signup routes forward the code to track-signup.
Troubleshooting
1) Code rejected: generate a new one; codes are unique up to 20 characters and duplicates return 409. 2) No stats: confirm the public link was opened, not the preview; tracking starts at the real visit. 3) Empty advanced tab: expected for now; it is a mock-data maintenance layer. 4) Link not working: confirm it is enabled in the simple links list.
Important limitations
• Real operations live in Simple mode only; Advanced is mock data. • Codes are unique up to 20 characters and never reused. • Attribution depends on registration and orders passing through tracking routes. • No automatic commission payouts; settlement happens outside the system for now.