Розробка реферальної системи під ключ: коди, атрибуція, виплати

Розробка реферальної системи під ключ

Уявіть: запускаєте реферальну програму, а за тиждень бачите в логах сотні реєстрацій з однієї IP-адреси з однаковим реферальним кодом. Без грамотної атрибуції та fraud-захисту такі накрутки з'їдають бюджет і демотивують реальних користувачів. Ми проєктуємо та впроваджуємо реферальні програми, які конвертують ваших клієнтів в агентів залучення — з генерацією унікальних реферальних посилань, надійною атрибуцією через cookie та багаторівневим захистом від фроду. Ми маємо понад 5 років досвіду та реалізували більше 30 успішних проєктів для e-commerce, SaaS та освітніх платформ.

Модель даних та генерація коду

Схема бази даних включає чотири ключові таблиці: referral_codes, referral_clicks, referrals і referral_rewards. Кожен унікальний код генерується для користувача один раз і залишається незмінним. Ми використовуємо читабельні коди на основі імені або поєднання літер та цифр — так користувачі легко запам'ятовують і передають їх. Для швидкого пошуку ми додаємо індекси за полями code та user_id.

CREATE TABLE referral_codes ( id BIGSERIAL PRIMARY KEY, user_id BIGINT REFERENCES users(id), code VARCHAR(32) UNIQUE NOT NULL, type VARCHAR(32) DEFAULT 'personal', created_at TIMESTAMPTZ DEFAULT NOW() ); CREATE TABLE referral_clicks ( id BIGSERIAL PRIMARY KEY, code_id BIGINT REFERENCES referral_codes(id), ip INET, user_agent TEXT, landed_at TIMESTAMPTZ DEFAULT NOW(), converted BOOLEAN DEFAULT FALSE ); CREATE TABLE referrals ( id BIGSERIAL PRIMARY KEY, referrer_id BIGINT REFERENCES users(id), referred_id BIGINT REFERENCES users(id), code_id BIGINT REFERENCES referral_codes(id), status VARCHAR(32) DEFAULT 'pending', qualified_at TIMESTAMPTZ, created_at TIMESTAMPTZ DEFAULT NOW() ); CREATE TABLE referral_rewards ( id BIGSERIAL PRIMARY KEY, referral_id BIGINT REFERENCES referrals(id), recipient_id BIGINT REFERENCES users(id), type VARCHAR(32), amount DECIMAL(14,2), currency CHAR(3) DEFAULT 'RUB', status VARCHAR(32) DEFAULT 'pending', paid_at TIMESTAMPTZ ); 

Як працює атрибуція реферала?

Атрибуція починається з middleware, який перехоплює GET-параметр ?ref=CODE та зберігає його в сесію. Навіть якщо користувач не зареєструвався одразу, код залишається прив'язаним до сесії протягом усього візиту. При реєстрації ми перевіряємо наявність коду та створюємо запис у referrals зі статусом pending. Потім логуємо клік і позначаємо його як сконвертований. Час життя сесії можна налаштувати — за замовчуванням 24 години, щоб атрибуція була точною.

// Middleware: ReferralTracker class ReferralTrackerMiddleware { public function handle(Request $request, Closure $next): Response { $code = $request->query('ref'); if ($code && !session()->has('referral_code')) { $referralCode = ReferralCode::where('code', $code)->first(); if ($referralCode) { session(['referral_code' => $code]); ReferralClick::create([ 'code_id' => $referralCode->id, 'ip' => $request->ip(), 'user_agent' => $request->userAgent(), ]); } } return $next($request); } } // В UserRegistrationService public function register(array $data): User { $user = User::create($data); $referralCode = session()->pull('referral_code'); if ($referralCode) { $code = ReferralCode::where('code', $referralCode)->first(); if ($code && $code->user_id !== $user->id) { Referral::create([ 'referrer_id' => $code->user_id, 'referred_id' => $user->id, 'code_id' => $code->id, 'status' => 'pending', ]); ReferralClick::where('code_id', $code->id) ->where('converted', false) ->latest('landed_at') ->first() ?->update(['converted' => true]); } } return $user; } 

Умови нарахування та типи винагород

Реферал вважається кваліфікованим лише після виконання цільової дії — наприклад, першої оплати або заповнення профілю. Ми реалізуємо це через систему подій. Порівняння типів винагород:

Фіксована винагорода простіша в реалізації, але процентна масштабується з ростом середнього чека. Двостороння програма (бонус і тому, хто запросив, і новому користувачеві) дає додатковий імпульс реєстраціям. На практиці процентна схема приваблює вдвічі більше активних реферерів, ніж фіксована.

Як вибрати тип винагороди за середнім чеком?

Усе залежить від середнього чека та моделі монетизації. Якщо продукт коштує недорого, фіксована сума від 300–500 грн працює чудово. Для підписок з високим LTV вигідніший відсоток — наприклад, 10% від першої оплати мотивує сильніше, ніж разовий бонус. Ми завжди аналізуємо економіку та пропонуємо оптимізовану схему. В одному з проєктів перехід з фіксованого бонусу в 200 грн на процентний 15% дозволив знизити CPA майже вдвічі за тієї ж мотивації реферерів.

Важливість захисту від фроду

Без захисту реферальна програма стає легкою здобиччю для накруток. Ми впроваджуємо базові перевірки: заборона саморефералів, обмеження за кількістю реєстрацій з однієї IP (не більше 3 за 7 днів), а також прапорці для ручної перевірки підозрілих ланцюжків винагород. Окремо налаштовується валідація терміну дії сесії — щоб атрибуція не працювала через місяць після кліка. За нашими даними, fraud-захист знижує втрати в 3–5 разів порівняно з відсутністю захисту.

Що входить у роботу

• Документація схеми даних та опис API-ендпоінтів для особистого кабінету реферера.
• Адміністративний інтерфейс для керування реферальними програмами та перегляду статистики.
• Написання unit-тестів для атрибуції та нарахування винагород.
• Розгортання на сервері або в контейнері (Docker).
• Інтеграція реферальної системи з CRM через REST API для синхронізації партнерської програми.
• Підключення до платіжної системи для batch-виплат.

Процес роботи

1. Аналітика — розбираємо цільову аудиторію, модель монетизації, умови кваліфікації.
2. Проєктування — обираємо топографію (однорівнева/MLM), малюємо ERD, узгоджуємо логіку атрибуції.
3. Реалізація — пишемо код на Laravel 11 / Next.js 14 (React), налаштовуємо черги для відкладених виплат.
4. Тестування — перевіряємо ланцюжки: клік → реєстрація → покупка → нарахування → виплата.
5. Деплой — викочуємо на staging, проводимо навантажувальне тестування (гарантуємо 10k concurrent clicks), потім запускаємо в production.

Терміни

Вартість розраховується індивідуально: залежить від складності схеми, необхідності інтеграції з CRM та вимог до fraud-захисту. Зв'яжіться з нами для обговорення вашої реферальної програми — підберемо оптимальне рішення. Отримайте консультацію щодо вибору схеми винагороди, спираючись на наш досвід із 30+ проєктами.