פיתוח מערכת הפניות: קודים, ייחוס, תשלומים

פיתוח מערכת הפניות: קודים, ייחוס, תשלומים

תארו לעצמכם: אתם משיקים תוכנית הפניות, ושבוע לאחר מכן אתם רואים מאות הרשמות מכתובת IP אחת עם אותו קוד הפניה. ללא ייחוס נכון והגנה מפני הונאות, ניצול כזה אוכל את התקציב שלכם ומדכא משתמשים אמיתיים. אנו מתכננים ומיישמים תוכניות הפניות שהופכות את הלקוחות שלכם לסוכני רכישה — עם יצירת קודים ייחודיים, ייחוס אמין מבוסס עוגיות, והגנה רב-שכבתית מפני הונאות. במשך חמש שנים בנינו יותר מ-30 פתרונות כאלה למסחר אלקטרוני, 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 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 ); ומאחסן אותו בסשן. גם אם המשתמש לא נרשם מיד, הקוד נשאר מקושר לסשן לאורך כל הביקור. בעת ההרשמה אנו בודקים את הקוד ויוצרים רשומה ב-?ref=CODE עם סטטוס referrals. לאחר מכן, אנו מתעדים את הקליק ומסמנים אותו כמומר. משך חיי הסשן ניתן להגדרה — כברירת מחדל 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; } 

תנאי הסמכה וסוגי תגמולים

הפניה נחשבת למוסמכת רק לאחר ביצוע פעולת מטרה — לדוגמה, תשלום ראשון או השלמת פרופיל. אנו מיישמים זאת באמצעות מערכת אירועים. השוואה בין סוגי תגמולים:

תגמולים קבועים פשוטים יותר ליישום, אך תגמולים באחוזים מתאימים לערך הזמנה ממוצע. תוכנית דו-צדדית (בונוס גם למפנה וגם למשתמש החדש) נותנת דחיפה נוספת להרשמות. בפועל, תוכניות אחוזים טובות פי 2 מתגמולים קבועים למשיכת מפנים פעילים.

כיצד לבחור סוג תגמול?

הכל תלוי בערך ההזמנה הממוצע ובמודל המונטיזציה. אם המוצר זול, סכום קבוע של כמה מאות עובד היטב. עבור מנויים עם LTV גבוה, אחוז עדיף יותר — לדוגמה, 10% מהתשלום הראשון מניע יותר מבונוס חד-פעמי. אנו תמיד מנתחים את הכלכלה ומציעים תוכנית אופטימלית. בפרויקט אחד, מעבר מבונוס קבוע לאחוז הוריד את ה-CPA כמעט בחצי (מ-$15 ל-$8) תוך שמירה על מוטיבציית המפנים.

מדוע הגנה מפני הונאות חשובה

ללא הגנה, תוכנית ההפניות הופכת למטרה קלה לניצול. אנו מיישמים בדיקות בסיסיות: איסור הפניה עצמית, הגבלת הרשמות מכתובת IP אחת (לא יותר משלוש בשבעה ימים), וסימונים לבדיקה ידנית של שרשראות חשודות. תוקף הסשן מוגדר גם הוא כדי למנוע ייחוס חודשים לאחר קליק. לפי הנתונים שלנו, הגנה מפני הונאות מפחיתה הפסדים ב-80% בהשוואה להיעדרה, וחוסכת ללקוחות $5,000–$15,000 בשנה.

מה כלול בעבודה

• תיעוד סכימת הנתונים ותיאור נקודות קצה של API ללוח המפנים.
• ממשק ניהול לניהול תוכניות הפניות וצפייה בסטטיסטיקות.
• בדיקות יחידה לייחוס ולצבירת תגמולים.
• פריסה על שרת או במכולה (Docker).
• אינטגרציה עם מערכת תשלומים לתשלומים בכמות.
• חיבור ל-CRM דרך REST API לסנכרון נתוני שותפים.

סקירת תהליך

1. ניתוח — אנו בוחנים את קהל היעד, מודל המונטיזציה, תנאי ההסמכה.
2. עיצוב — בוחרים טופוגרפיה (חד-רמתית/MLM), מציירים ERD, מסכימים על לוגיקת הייחוס.
3. יישום — כותבים קוד ב-Laravel 11 / Next.js 14 (React), מגדירים תורים לתשלומים דחויים.
4. בדיקות — מאמתים שרשראות: קליק → הרשמה → רכישה → צבירה → תשלום.
5. פריסה — דוחפים לסטייג'ינג, מבצעים בדיקות עומס (הבטחה ל-10k קליקים במקביל), ואז משיקים לפרודקשן.

ציר זמן

העלות מחושבת באופן אישי: היא תלויה במורכבות התוכנית, בצרכי אינטגרציית ה-CRM ובדרישות ההגנה מפני הונאות. תקציבים טיפוסיים נעים בין $5,000 ל-$20,000. צרו קשר כדי לדון בתוכנית ההפניות שלכם — נמצא את הפתרון האופטימלי. קבלו ייעוץ על בחירת תוכנית תגמולים, בהתבסס על הניסיון שלנו עם שלושים פרויקטים. מקור: מחקר יעילות שיווק הפניות, 2023.