Affiliate Marketing Eklentisi

Merhaba isteklerinizi ve detayları paylaşırsanız modül haline getirebilirim

Merhaba Bera Ramazan Hocam,
Detayları paylaşma nezaketiniz için çok teşekkür ederim. FriSay’in gelişmeye açık, esnek yapısını ve e-ticaret dünyasındaki ihtiyaçları düşündüğümde, platforma değer katacak, pazaryeri bağımlılığını bitirecek ve satışları organik olarak patlatacak harika bir modül fikrim var: Affiliate Marketing (Satış Ortaklığı) Modülü.
Bu konsepti belki daha önce detaylı inceleme fırsatınız olmamıştır diye hem mantığını, hem sisteme kazandıracaklarını hem de FriSay dokümantasyonuna göre basamak basamak nasıl kodlanabileceğini detaylıca aktarmak istedim.

💡 Nedir Bu Modül ve Mantığı Nasıl Çalışır? (Örnekle)

Mantık çok basit: Büyük pazaryerlerine (Trendyol, Hepsiburada vb.) devasa komisyonlar ödemek yerine, kendi sitemizdeki bütçeyi sosyal medya fenomenlerine (influencer) veya blog yazarlarına ortaklık payı olarak dağıtıyoruz.
• Örnek: Sitemizde 1.000 TL’lik bir mont satılıyor. Bu ürünü bir influencer’a devrediyoruz. Modülümüz influencer’a özel bir link (://site.com) veya bir kupon kodu (AHMET10) üretiyor.
• Ahmet bu linki veya kuponu Instagram'da paylaşıyor. Onun aracılığıyla gelen her başarılı satıştan, bizim belirlediğimiz oranda (Örn: %10 yani 100 TL) komisyon kazanıyor.
• Kazancımız: Pazaryerine %20-25 komisyon vermekten kurtuluyoruz, sitemize doğrudan organik trafik ve muazzam bir görünürlük (reklam) sağlıyoruz. Üstelik sıfır reklam bütçesiyle; çünkü sadece satış gerçekleştikçe ödeme yapıyoruz!

🛠 FriSay Geliştirici Dokümanına Göre Adım Adım Yapım Aşaması

FriSay Api Developer dokümantasyonundaki "Yeni Modül Oluştur", "Hook Listesi" ve "Sipariş Yaşam Döngüsü" adımlarını incelediğimde, bu sistemi mimariyi bozmadan aşama aşama (fazlar halinde) inşa edebileceğimizi gördüm.

1. Aşama: Veritabanı ve Çerez (Cookie) Takibi (Kolay)

• Veritabanı: affiliateusers (ortaklar), affiliateclicks (tıklamalar) ve affiliatesales (kazançlar) adında 3 temel tablo oluşturulur.
• Hook Entegrasyonu: FriSay'in vitrin yüklenme hook'u (kancası) kullanılarak, URL'de gelen ?ref=xxx parametresi yakalanır. Bu parametre kullanıcının tarayıcısına çerez (Cookie) olarak kaydedilir (Örn: 30 gün boyunca geçerli kalacak şekilde).

2. Aşama: Sipariş Yaşam Döngüsü Entegrasyonu (Orta)

• Müşteri satın alma işlemini tamamladığında FriSay'in Siparişler API veya ilgili checkout başarılı hook'u tetiklenir.
• Eğer tarayıcıda aktif bir ortaklık çerezi varsa, sipariş tutarı üzerinden komisyon hesaplanıp affiliatesales tablosuna durumu "Beklemede" olarak kaydedilir.

3. Aşama: İptal / İade ve Kupon Mekanizması (Orta - İleri)

• Sipariş Durumu Güncelleme: Dokümandaki PATCH Sipariş Durumu Güncelle mantığına paralel olarak, bir sipariş yönetici tarafından "İptal Edildi" veya "İade" olarak işaretlenirse, ortağın kazandığı komisyon otomatik olarak iptal edilir.
• Kupon Entegrasyonu: FriSay'in mevcut kupon sistemine bağlanarak, belirli bir kupon kodu direkt bir ortak id'si ile eşleştirilir. Linke tıklanmasa bile kupon girildiğinde komisyon ortağa yazar.

4. Aşama: Ortaklık (Affiliate) Paneli (Görsel ve Kolay)

• Sitedeki kullanıcılar için "Satış Ortağı Ol" sayfası açılır.
• Burada kendilerine ait kazanç grafiği, kaç tık aldıkları ve kendi özel referans linklerini üretebilecekleri basit bir arayüz sunulur.

📊 Zorluk Derecesi ve FriSay Altyapısına Uygunluğu

FriSay altyapısı temiz bir JSON API ve Modül/Hook mimarisine sahip olduğu için, bu eklentiyi yazmak sizin gibi tecrübeli bir admin için kesinlikle zor olmayacaktır.
• Çekirdek Sistem Zorluğu: 5 üzerinden 3 (Hook ve Sipariş döngüsü yönetimi).
• Arayüz Zorluğu: 5 üzerinden 2 (Sadece CRUD işlemleri ve raporlama ekranları).
Böyle bir modül FriSay Script ekosistem portalındaki "Modules" kısmında yer aldığında, yazılımı satın almak veya kullanmak isteyen her e-ticaret sitesinin ilk indireceği/satın alacağı baş tacı modüllerden biri olacaktır. Çünkü günümüzde reklama para harcamadan satış artırmanın en güçlü yolu budur.
Bu fikir doğrultusunda modülün detaylarını netleştirip ilk adımı atabiliriz derseniz, veritabanı şeması veya akış diyagramı konusunda da seve seve fikir alışverişinde bulunmaya devam edebilirim. Ne dersiniz, FriSay için harika bir dinamizm olmaz mı?
Saygılarımla.

🎨 Modülün Yönetim (Admin) Paneli Görsel Kurgusu ve Arayüz Tasarımı (UI/UX)

Hocam, FriSay admin panelinin mevcut modern, sade ve kullanıcı dostu yapısını (kullanılan Bootstrap veya Tailwind bileşenlerini) hiç bozmadan, eklenti için sadece 4 ana sekmeden oluşan şık ve işlevsel bir yönetim alanı kurgulayabiliriz. Admin gözünde canlanması adına bölümler şu şekilde planlanabilir:

A. Özet Paneli (Dashboard)

Yönetici eklenti sayfasına tıkladığında onu karşılayacak ilk ekran, sistemin genel gidişatını gösteren 4 adet özet kartı (Widget) ve altında bir grafik içermelidir:
• Özet Kartları: Toplam Aktif Ortak Sayısı | Ortaklık Kaynaklı Toplam Ciro (TL) | Bekleyen Ödeme Talepleri (TL) | Ortalama Dönüşüm Oranı (%)
• Grafik Alanı: Son 30 günün tıklama ve başarılı dönüşüm/kazanç eğrilerini gösteren çizgisel (Line Chart) bir grafik. Burada FriSay'in mevcut admin paneli grafik kütüphanesini (Chart.js vb.) aynen kullanabiliriz.

B. Modül Genel Ayarları (Settings)

Sistemin çalışma kurallarını belirleyen basit form elemanlarından oluşan kalbi niteliğindeki alan:
• Komisyon Tipi Seçimi: Yüzdesel (%) mi yoksa Sabit Tutar (TL) mı olacağını belirleyen bir açılır menü (Dropdown).
• Varsayılan Komisyon Oranı: Sayısal input alanı (Örn: 10 girildiğinde %10 hesaplar).
• Çerez (Cookie) Geçerlilik Süresi: Gün bazında input alanı (Örn: 30 gün boyunca gelen müşteri ortağa yazılır).
• Minimum Ödeme Eşiği: Satış ortaklarının parasını çekebilmesi için ulaşması gereken alt limit inputu (Örn: 500 TL).
• Güvenlik Ayarı: Ortakların kendi linklerinden alışveriş yaparak haksız kazanç elde etmesini engelleyen Kendi Linkinden Alışverişi Engelle seçeneği (Aktif/Pasif Toggle butonu).

C. Satış Ortakları Listesi ve Onay Ekranı (Affiliates Table)

FriSay’in standart ürün listeleme tablosundaki (GET Ürün Listele ekranındaki) grid yapısına sadık kalınarak hazırlanacak dinamik bir tablo:
• Sütunlar: Ortak Adı / Kullanıcı | Referans Kodu / Kupon | Toplam Tıklama | Toplam Kazanç | Bekleyen Bakiye | Durum / Aksiyon
• Hızlı Aksiyonlar: Yeni başvuran ortaklar için hızlı [Onayla] / [Reddet] butonları ve mevcut ortakların detaylarını düzenleme linkleri.

D. Ödeme Talepleri Yönetimi (Payouts Screen)

Ortakların "Paramı çekmek istiyorum" dediğinde finansal süreçlerin manuel iş yükünü sıfırlayacak kontrol ekranı:
• Yapı: Alt limite ulaşıp ödeme talebi gönderen ortakların Adı, Banka / IBAN Bilgisi, Talep Edilen Tutar ve Talep Tarihi listelenir.
• Aksiyon Butonları: Her satırın sağında yöneticinin bankadan transferi yaptıktan sonra basabileceği yeşil bir "Ödendi Olarak İşaretle" butonu ve kırmızı bir "Reddet" butonu bulunur. Butona basıldığı an ortağın bakiyesi sıfırlanır ve işlem geçmişe kaydedilir.

🚀 Neden Bu Modülü FriSay Ekosistemine Kazandırmalıyız?

Hocam, özetlemek gerekirse; bu eklenti sayesinde FriSay altyapısını kullanan mağazalar hiçbir reklam bütçesi riski almadan, sadece satış gerçekleştikçe influencer'lara veya ortaklara pay ödeyecekler. Sıfır bütçeyle devasa bir organik trafik, marka görünürlüğü ve doğrudan satış gücü elde edecekler.
FriSay'in halihazırda sunduğu temiz modül, kanca (hook) ve API mimarisi sayesinde, mevcut tablolara ve form bileşenlerine sadece bu yeni veri alanlarını besleyerek çok hızlı, performanslı ve şık bir arayüz çıkartabiliriz.

Saygılarımla.

sanırım admin fark etmedi yazdıklarımı ??