🧑🤝🧑Referrals & Attribution
With Fuul, you can set up incentives to encourage affiliates, KOLs, and users to bring new participants to your project through referrals. When a referred user converts, Fuul's attribution system determines which referrer gets credit — and rewards.
How referral attribution works
Attribution is the process of linking a user's conversion (swap, deposit, mint, etc.) back to the referrer who brought them in.
The flow
User clicks a referral link — A pageview event is recorded with the referrer's information
User connects their wallet — The tracking session is linked to the user's identity
User performs a qualifying action — The trigger fires and the system looks up who referred this user
Attribution is made — The referrer is credited and a payout is calculated
Users can also accept a referral code directly (without clicking a link), which immediately establishes the referrer relationship for all future conversions.
Attribution settings
Attribution behavior is configured per project in the Payouts & Attribution section of the webapp. Two settings control how credit is assigned:
Attribution window
The number of days during which a referrer can receive credit for a conversion.
Default: 10,000 days
Effectively lifetime — the referrer gets credit as long as the user eventually converts
Custom window
Set a shorter window (e.g., 30 days) to only credit recent referrals
Attribution type
Determines which referrer gets credit when a user has been referred by multiple people.
First Click (default)
The very first referrer within the window
Day 1: Referrer A, Day 3: Referrer B, Day 5: conversion → Referrer A
Last Click
The most recent referrer before conversion
Same scenario → Referrer B
Lifetime attribution
When enabled (recommended for most programs), all future conversions from a referred user are attributed to their original referrer — the one credited with the initial conversion.
Enabled (default)
Once attributed, the relationship is permanent. All future conversions go to the original referrer.
Disabled
Each conversion is evaluated independently using the attribution window and type.
Lifetime attribution is enabled in the vast majority of programs. It ensures referrers get ongoing credit for the users they bring in, which is the strongest incentive for long-term referral partnerships.
Multi-level referrals
Fuul supports up to 3 levels of referral attribution:
Level 1
Direct referrer (the affiliate)
Alice refers Bob
Level 2
Referrer's referrer
Carol referred Alice, who referred Bob
Level 3
Third level up the chain
Dave referred Carol, who referred Alice, who referred Bob
Each level can have its own payout amount or percentage, configured in the incentive rules.
Referral tracking
To track referrals, projects need to integrate the Fuul Web SDK to capture pageview and wallet connection events. Learn more in the Tracking Referrals developer guide.
Last updated