Playvoi/Assets/ShiroginSDK

📦 Shirogin SDK

Shirogin SDK, Unity projeleri için geliştirilen kapsamlı bir oyun içi servis paketidir. Tek bir yapı altında Reklam, Satın Alma (IAP), Analitik, Facebook, Remote Config ve Veri Yönetimi sistemlerini entegre eder. Ayrıca özel Editor araçları sayesinde geliştirme süreçlerini hızlandırır ve yönetimi kolaylaştırır.

---

🚀 Temel Özellikler

Kategori	Açıklama	Versiyon / SDK
🎯 Reklam Sistemi	AppLovin destekli ödüllü, banner ve interstitial reklam yönetimi	AppLovin SDK 8.4.2
💳 Satın Alma (IAP)	Unity IAP üzerinden ürün yönetimi, ödül tanımları ve event tabanlı izleme	Unity IAP 4.13.0
📊 Analitik (Analytics)	Firebase, AppsFlyer ve Facebook event sistemi ShiroginEvents yapısıyla birleştirilir	Event-based Analytics Core
🔥 Firebase Service	Analytics + Remote Config desteği, local cache fallback sistemiyle birlikte	Firebase SDK 12.8.0
📱 Facebook SDK	App Events, reklam kampanyası izleme ve kullanıcı giriş desteği	Facebook SDK 18.0.0
🧠 AppsFlyer SDK	Kurulum ve kullanıcı edinme (UA) analizleri	AppsFlyer SDK 6.16.2
⚙️ Data System	JSON tabanlı kayıt sistemi (BaseData) ile kalıcı veri yönetimi (Economy, Player, Settings...)	Dahili Sistem
🧩 Popup & UI Framework	DOTween tabanlı popup animasyon sistemi, temalı UI desteği	DOTween Pro 1.2.632
🧰 Editor Tools	PlayerPrefs Editor, SDK Configurator, Theme Manager, RemoteConfig Importer	PlayerPrefs Editor 1.2.4

---

🧠 Teknik Yapı

• Modüler mimari: Her sistem ayrı servis sınıfları üzerinden yönetilir (IAPService, AdService, FirebaseService, AnalyticsService vs).
• Event-driven yapı: Tüm servisler ShiroginEvents üzerinden haberleşir.
• Scriptable Object tabanlı konfigürasyon: SDKConfig, StoreRepository, RemoteConfigDefinition gibi varlıklar editor içinde yönetilir.

---

🧾 Klasör Yapısı

Assets/
 └── ShiroginSDK/
      ├── Runtime/
      │    ├── Core/
      │    ├── Data/
      │    ├── Events/
      │    ├── IAP/
      │    ├── Services/
      │    ├── UI/
      ├── Editor/
      │    ├── Tools/
      │    └── Toolbar/
      └── Documents/
           └── (README, Kurulum Rehberleri, SDKConfig örnekleri)

---

📚 Dokümantasyon

Her modülün kurulum ve kullanım dökümanları ShiroginSDK/Documents klasörü altındadır:

• 📊 AnalyticsService.md → Analitik sistemlerinin genel yapısı (Firebase, AppsFlyer, Facebook)
• 💳 IAPService.md → Satın alma sistemi ve ödül yönetimi
• 🔥 RemoteConfigService.md → Firebase Remote Config entegrasyonu
• 📱 FacebookService.md → Facebook SDK kurulumu ve event takibi
• 🎯 PopupService.md → Popup & UI animasyon sistemi
• 🎨 ThemeService.md → Tema yönetimi ve dinamik UI renk sistemi
• 🧰 Editor Tools → SDK Configurator, PlayerPrefs Editor ve diğer editör araçları

---

🧩 Desteklenen Unity Sürümü

Unity 6000.0.58f1(test edilmiş).

---

Hazırlayan: Emir Han MAMAK

Sürüm: 2025.10

---