Genel Bakış
0:02:00RevenueCat IntelliJ Plugin Codelab'ine hos geldiniz!
RevenueCat IntelliJ Plugin, abonelik metriklerini, SDK araclarini ve webhook bildirimlerini Android Studio ve IntelliJ IDEA gibi JetBrains IDE'lerine dogrudan getirir. Artik kod ile RevenueCat paneli arasinda baglam degistirmenize gerek yok. Ihtiyaciniz olan her sey calistiginiz yerde.
Bu codelab'de eklentiyi yukleme ve yapilandirma, gercek zamanli abonelik metriklerini izleme, offering ve package'lari kesfetme, is kilometre taslarini takip etme, yerlesik sihirbazi kullanarak SDK entegrasyonu kurma, webhook bildirimleri alma ve akilli abonelik sorgulari icin AI asistanini yapilandirmayi ogreneceksiniz.
Plugin yükle
0:02:00RevenueCat Dashboard eklentisini JetBrains Marketplace'den kolayca yukleyebilirsiniz.
- Settings/Preferences'i acin (macOS'de Command virgul veya Windows/Linux'de Ctrl+Alt+S)
- Plugins'e gidin
- Marketplace sekmesine tiklayin
- "RevenueCat Dashboard"'i arayin
- Install'a tiklayin
- IDE'yi yeniden baslatin
Positive : Eklenti IntelliJ IDEA 2023.1 ve uzeri ile Android Studio Hedgehog ve uzerini destekler.
API Key kurulum
0:03:00Kurulumdan sonra eklentiyi panelinize baglamak icin RevenueCat kimlik bilgilerinizi yapilandirmaniz gerekir. Settings/Preferences'i acin ve Tools > RevenueCat'e gidip kimlik bilgilerinizi girin.
API Key (Secret Key)
API Secret Key, sk_ ile baslayan RevenueCat v2 API gizli anahtaridir. Bu anahtar sayesinde eklenti, RevenueCat API ile guvenli bir sekilde iletisim kurarak abonelik verilerini alabilir. Bu anahtari RevenueCat panelinin Project Settings > API Keys bolumunde bulabilirsiniz.
Negative : API Secret Key'i guvenli bir sekilde saklayin. Asla surum kontrolune commit etmeyin veya herkese acik olarak paylaşmayin.
SDK API Key
SDK API Key, platforma ozel genel bir anahtardir. Uygulamanizda RevenueCat SDK'yi baslatirken kullandiginiz anahtarin aynisidir. Platforma bagli olarak bu anahtar farkli on eklere sahiptir: Google Play icin goog_, App Store icin appl_, Amazon icin amzn_, Stripe icin stripe_. Bu anahtar, eklentinin hangi platform baglaminda calistiginizi anlamasina yardimci olur.
Project ID
RevenueCat project ID, belirli projenizi tanimlar ve panel URL'sinde veya Proje Kurulumu'nda bulunabilir. Uc kimlik bilgisini de girdikten sonra ayarlari kaydetmek icin Apply'a tiklayin. Eklenti kimlik bilgilerini dogrulayacak ve RevenueCat paneline baglanti kuracaktir.
Metrik panelini kontrol edin
0:03:00Kimlik bilgileri yapilandirildiktan sonra artik RevenueCat arac penceresine eriserek abonelik isinizi gercek zamanli olarak izleyebilirsiniz. Metrikleri bir bakista kontrol etmek icin View > Tool Windows > RevenueCat'ten arac penceresini acin.
Genel Bakis Metrikleri
Panel, abonelik saglik durumunuzun kapsamli bir anlık goruntusunu saglar. En ustte, tum aktif aboneliklerden normallestirilmis aylik geliri temsil eden MRR (Monthly Recurring Revenue) goruntulenir. Bu, abonelik isinizin kalp atisidir.
MRR'in yaninda son 28 gunde olusturulan geliri gosteren Total Revenue metrigi bulunur, boylece son performansi kavrayabilirsiniz. Active Subscriptions sayisi su anda aktif aboneligi olan musteri sayisini gosterir, Active Trials ise satin almadan once urunu deneyen kullanicilari gosterir.
Active Users metrigi son 28 gundeki toplam etkilesimi takip eder ve New Customers son kazanilan yeni odeme yapan musteri sayisini gostererek musteri edinme basarisini vurgular. Bu metrikler birlikte, IDE'den ayrilmadan abonelik isinizin tam resmini sunar.
Positive : Open in RevenueCat Dashboard'a tikladiginizda daha derin analizler ve gecmis grafikleri kontrol etmek icin tarayicinizda tam panele dogrudan erisebilirsiniz.
Offering ve Package'lari Kesfedin
0:03:00Satin alma akisi veya paywall uygularken yapilandirilmis offering ve package'lara hizli erismeniz gerekir. Eklentinin Offerings sekmesini kullanarak tarayiciya gecmeden tum urun katalogunuzu kesfedebilirsiniz.
RevenueCat arac penceresinde yapilandirilmis tum offering'lari kontrol etmek icin Offerings sekmesine tiklayin:
Offering'leri Anlama
Her offering, uygulamanizin belirli noktalarinda kullanicilara sunulan package koleksiyonunu temsil eder. Eklenti, offering adini ve mevcut durumunu gosterir. Acikca belirtilmediginde kullanicilara gosterilen varsayilan offering'i tanimlamak icin [Current] rozetini arayin.
Her offering icinde dahil edilen tum package'lari gorebilirsiniz. Her package, satin alma kodu yazarken ihtiyaciniz olan tanimlayiciyi (ornegin: $rc_monthly, $rc_annual veya $rc_lifetime) gosterir. Bu, kod ile panel arasinda gecis yaparken olusan tahmin ve kopyala-yapistir hatalarini ortadan kaldirir.
Hizli Islemler
Her offering'de iki islem butonu vardir. Paywall butonunu kullanarak bu offering ile baglantili paywall'i onizleyebilir ve kullanicilarin tam olarak ne gorecegini gorebilirsiniz. Manage butonu, RevenueCat panelinde ilgili offering'e dogrudan giderek package'lari duzenleyebilir, fiyatlari ayarlayabilir veya paywall tasarimini degistirebilirsiniz.
Kilometre Taslarini Takip Edin
0:02:00Abonelik isi kurmak bir yolculuktur ve bu surecte kilometre taslarini kutlamak motivasyonunuzu korumaya yardimci olur. RevenueCat onemli is hedeflerine dogru ilerlemenizi takip eder ve eklenti bu basarilari dogrudan IDE'nize getirir.
Ilerlemenizi Kutlayin
Milestones gorunumu, abonelik isinizin uc temel boyutundaki ilerlemenizi gosterir. Ilk olarak, Monthly Recurring Revenue (MRR) kilometre taslari gelir hedeflerinize dogru yolculugunuzu takip eder. Isiniz buyudukce cubugun dolmasini gormek son derece tatmin edicidir.
Ikinci olarak, Active Users kilometre taslari kullanici buyumesini izlemenize yardimci olur. Daha fazla insan uygulamanizla etkilestikce genisleyen erisim alanini yansitan kilometre taslarina ulasirsiniz. Ucuncu olarak, New Customers kilometre taslari musteri edinme basarinizi kutlar ve musteri tabaninizin yeni yukseklere ulastigi anlari gosterir.
Bir kilometre tasina ulastiginizda eklenti confetti ile birlikte kutlama bildirimi gosterir! Kucuk bir dokunustur ama kodlama sirasinda bu basarilari gormek, gelistirme calismalariniz ile is basariniz arasinda somut bir baglanti kurar.
SDK Entegrasyon Sihirbazi
0:04:00Eklentinin en guclu ozelliklerinden biri SDK Integration Wizard'dir. Bagimliliklari manuel olarak eklemek ve tekrarlayan kod yazmak yerine, sihirbaz birkac tiklamayla tum kurulum surecinde size rehberlik eder.
Platform Secimi
RevenueCat menusunden sihirbaza eristiginizde cesitli platformlar ve kullanim durumlari icin secenekler goruntulenir:
Tam SDK entegrasyonu icin Google Play Billing ve Compose entegrasyonu iceren yerel Android uygulamalari icin Android (Kotlin), paylasilmis Is Mantigi'na sahip platformlar arasi iOS ve Android uygulamalari icin Kotlin Multiplatform veya Dart kullanan platformlar arasi gelistirme icin Flutter secebilirsiniz.
SDK zaten yuklu ise ve sadece paywall ozelligi eklemek istiyorsaniz, Android Paywall, KMP Paywall ve Flutter Paywall icin ayri secenekleri kullanabilirsiniz. Bu basitlestirilmis yollar, cekirdek SDK'yi yeniden yuklemeden sadece paywall UI yapilandirma ogelerini ekler.
Otomatik Kurulum
Platformunuzu sectikten sonra sihirbaz sikici kurulum gorevlerini halleder:
Sihirbaz, en son kararli surumu kullanarak build.gradle veya pubspec.yaml dosyaniza gerekli bagimliliklari otomatik olarak ekler. Ardindan satin almalari dogru sekilde islemek icin gereken composable function ve listener'lari iceren paywall uygulamasi icin kod sablonlari olusturur.
Degisiklikleri uygulamadan once sihirbaz olusturulan kodun onizlemesini gosterir. Projenize tam olarak nelerin eklenecegini inceleyebilir ve mimarinize uygun olup olmadigini kontrol ettikten sonra degisiklikleri guvenle uygulayabilirsiniz. Olusturulan kod, uygun hata isleme ve Satin alma tamamlandi callback'lerini icererek RevenueCat en iyi uygulamalarini takip eder.
SDK Surum Bildirimleri
0:02:00SDK'nizi guncel tutmak yeni ozellikler, hata duzeltmleri ve guvenlik yamalarina erismek icin onemlidir. Eklenti tum platformlarda RevenueCat SDK surumlerini izler ve guncelleme mevcut oldugunda sizi bilgilendirir.
Tum Platformlarda Guncel Kalin
Surum goruntuleyici, Android, iOS, Kotlin Multiplatform, Flutter ve React Native icin SDK guncellemelerinin entegre bir gorunumunu saglar. Ustteki sekmeleri kullanarak platformlar arasinda gecis yapabilir ve her ekosistemdeki yeni ozellikleri kontrol edebilirsiniz.
Her surum icin surum numarasini, yayin tarihini ve degisikliklerin ayrintili analizini gorebilirsiniz. Hata duzeltmeleri, uygulamanizi etkileyip etkilemeyecegini degerlendirmeniz icin acikca goruntulenir. Onemli degisiklikler ve Uyarilar belirgin sekilde vurgulanir ve goc calismalarina hazirlanmaniza yardimci olur. Goruntuleyici ayrica uygulamaniza yardimci olabilecek diger degisiklik ve iyilestirmeleri gosterir.
Her surumde tam surum notlarina dogrudan giden View on GitHub linki bulunur, boylece belirli degisiklikleri derinlemesine inceleyebilir veya commit gecmisini gozden gecirebilirsiniz.
RevenueCat SDK guncellendiginde otomatik masaustu bildirimi almak icin Notify me when a new version is available'i etkinlestirin. Boylece yukseltme zamanini her zaman bilirsiniz.
Webhook bildirim
0:02:00Gelistirme ve test sirasinda webhook olaylarinin ne zaman gerceklestigini bilmek, sunucu entegrasyonunuzu hata ayiklamak icin onemlidir. Eklenti, RevenueCat webhook olaylari icin gercek zamanli masaustu bildirimleri saglar, boylece bir sey oldugunda hemen kontrol edebilirsiniz.
Gercek Zamanli Olay Izleme
Bir webhook olayi gerceklestiginde (tetiklediginiz bir test olayi veya sandbox'ta gercek bir satin alma olsun) masaustu bildirimi hemen gorunur. Bildirim, olay turunu, basarili veya basarisiz durumu ve ne olduguna dair ilgili ayrintilari gosterir.
Bu, satin alma akislarinizi test ettiginiz gelistirme sirasinda ozellikle yararlidir. Sunucu gunluklerini kontrol etmek veya RevenueCat panelini yenilemek yerine masaustunuzde aninda geri bildirim alirsiniz. Webhook endpoint'inizin olaylari dogru sekilde alip almadigini dogrulayabilir, test satin almalarinin islenip islenmedigini kontrol edebilir ve produksiyona gitmeden once sorunlari tespit edebilirsiniz.
Positive : RevenueCat panelinde Send Test Webhook butonunu kullanarak webhook bildirimlerinin dogru calisip calismadigini kontrol edin. Bildirim birkac saniye icinde gorunmelidir.
AI Asistan (Istege Bagli)
0:04:00RevenueCat IntelliJ eklentisi, abonelik verilerinizle etkilesim seklinizi degistiren bir AI asistan icerir. Panellerde ve belgelerde gezinmek yerine dogal dilde soru sorabilir ve aninda yanit alabilirsiniz.
AI Asistani Etkinlestirme
AI asistanini baslatmak icin Settings/Preferences'i acin ve Tools > RevenueCat > AI Settings'e gidin. AI Assistant toggle'ini etkinlestirdikten sonra tercih ettiginiz AI saglayicisini secin. Eklenti OpenAI (GPT-4o ve GPT-4o Mini), Anthropic (Claude 3.5 Sonnet ve Claude 3 Haiku), Google (Gemini 2.5 Flash ve Gemini 2.5 Pro) destekler. Her saglayici farkli guclere sahiptir. GPT-4o ve Claude Sonnet karmasik akil yurutmede mukemmeldir, GPT-4o Mini ve Gemini Flash ise basit sorgular icin daha hizli yanitlar saglar.
Saglayiciyi sectikten sonra API anahtarinizi girin. Anahtar yerel bilgisayarinizin IntelliJ kimlik bilgisi deposunda guvenli bir sekilde saklanir ve RevenueCat'e gonderilmez.
Negative : AI API anahtari yerel bilgisayarinizin IntelliJ kimlik bilgisi deposunda guvenli bir sekilde saklanir ve RevenueCat'e gonderilmez.
Akilli Abonelik Sorgulari
Yapilandirma tamamlandiginda AI asistani kisisel abonelik uzmaniniz olur. Metrikler hakkinda soru sorabilirsiniz. "Su anki MRR nedir?" veya "Kac aktif deneme var?" diye sordugunuzda gercek verilere dayanan aninda yanitlar alirsiniz.
Yapilandirmanizi kontrol etmeniz mi gerekiyor? "Yapilandirilmis offering'ler nelerdir?" diye sordugunuzda asistan tum offering'lari package'lar ve tanimlayicilarla birlikte listeler. Trendleri merak mi ediyorsunuz? Is performansiniz hakkinda icgoruler elde etmek icin "Gelir buyumesini goster" veya "Deneme donusum orani nedir?" deneyin.
Asistan ayrica uygulama sorularinda da yardimci olur. "Kotlin kullanarak Android'de offering'leri nasil alirim?" diye sordugunuzda projenize ozellestirilmis kod ornekleri alirsiniz. RevenueCat verilerini ve belge bilgisini birlestirerek IDE'den ayrilmadan baglama uygun calistiriabilir yanitlar saglar.
Sonuç
0:01:00Tebrikler! Abonelik isinizi dogrudan IDE'den yonetmek icin RevenueCat IntelliJ Plugin'i kullanmayi ogrendiniz. Metrik izleme ve offering kesfetmeden SDK entegrasyonu kurma ve webhook bildirimleri almaya kadar, artik guclu araclar parmaklarinizin ucunda.
Eklenti, kod ile RevenueCat paneli arasindaki baglam degistirmeyi ortadan kaldirarak abonelik isinizin nabzini tutarken akis durumunda kalmaniza yardimci olur. Satin alma akislarini hata ayiklama, en son metrikleri kontrol etme veya yeni bir proje kurma - ihtiyaciniz olan her sey bir tik uzaginizda.
Sonraki Adimlar
RevenueCat yolculugunuza devam etmek icin tum ozellikler hakkinda kapsamli bir kilavuz icin RevenueCat Documentation'i kesfedin. Android uygulamasi olusturuyorsaniz, satin alma ve paywall'lari adim adim uygulamak icin Android SDK Codelab'a goz atin.
Simdi harika bir seyler insa edin ve metriklerinizin buyumesini izleyin!