Adapty'yi Flutter uygulamanıza yapay zeka yardımıyla entegre etme

Bu rehber, bir yapay zeka kodlama aracıyla Adapty’yi Flutter uygulamanıza adım adım entegre etme sürecini anlatır — doğru Adapty dokümanlarını doğru sırada besleyerek ilerlersiniz.

Otomatik entegrasyon · Beta
✦ Adapty SDK entegrasyon skill'i, tüm entegrasyonu AI kodlama aracınızda tek komutla gerçekleştirir.
Skill'i kullan

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce biraz kontrol paneli yapılandırması gerektirir. Bunu etkileşimli bir LLM becerisini kullanarak ya da Kontrol Paneli üzerinden manuel olarak yapabilirsiniz.

Adapty CLI becerisi, LLM’inizin uygulamanızı, ürünlerinizi, access level’larınızı, paywall’larınızı ve placement’larınızı doğrudan — her adım için Kontrol Paneli’ni açmadan — kurmasına olanak tanır. Yalnızca Kontrol Paneli’nde mağazalarınızı bağlamanız gerekir.

npx skills add adaptyteam/adapty-cli --skill adapty-cli

Beceri eklendikten sonra, ajanınızda /adapty-cli komutunu çalıştırın. Mağazalarınızı bağlamak için Kontrol Paneli’ni ne zaman açacağınız dahil her adımda sizi yönlendirecektir.

Kontrol Paneli Yaklaşımı

Her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, herhangi bir kod yazmadan önce şunlara ihtiyacınız var. LLM’iniz kontrol paneli değerlerini sizin için arayamaz; bunları kendiniz sağlamanız gerekir.

  1. Uygulama mağazalarınızı bağlayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin. Flutter uygulamanız her iki platformu da hedefliyorsa hem App Store hem de Google Play’i bağlayın. Bu, satın almaların çalışması için zorunludur. Uygulama mağazalarını bağlayın

  2. Public SDK anahtarınızı kopyalayın: Adapty Kontrol Paneli’nde App settings → General sayfasına gidin ve API keys bölümünü bulun. Kodda bu, Adapty yapılandırmasına geçtiğiniz dizedir.

  3. En az bir ürün oluşturun: Adapty Kontrol Paneli’nde Products sayfasına gidin. Ürünlere kodda doğrudan başvurmazsınız — Adapty onları paywall’lar aracılığıyla iletir. Ürün ekleyin

  4. Paywall ve placement oluşturun: Adapty Kontrol Paneli’nde Paywalls sayfasında bir paywall oluşturun, ardından Placements sayfasında bunu bir placement’a atayın. Kodda, placement ID, Adapty().getPaywall() fonksiyonuna geçirdiğiniz string değerdir. Paywall oluştur

  5. Access level’ları ayarlayın: Adapty Kontrol Paneli’nde, Products sayfasında her ürün için yapılandırın. Kodda, profile.accessLevels['premium']?.isActive içinde kontrol edilen string’dir. Varsayılan premium access level çoğu uygulama için yeterlidir. Ödeme yapan kullanıcılar ürüne bağlı olarak farklı özelliklere erişiyorsa (örneğin basic plan ile pro plan), kodlamaya başlamadan önce ek access level’lar oluşturun.

Beş bilgiye de sahip olduğunuzda kod yazmaya hazırsınız. LLM’inize şunu söyleyin: “Public SDK anahtarım X, placement ID’im Y” — böylece doğru başlatma ve paywall çekme kodunu üretebilir.

Hazır olduğunuzda ayarlayın

Kodlamaya başlamak için bunlar zorunlu değildir, ancak entegrasyonunuz olgunlaştıkça ihtiyaç duyacaksınız:

  • A/B testleri: Placements sayfasından yapılandırın. Kod değişikliğine gerek yoktur. A/B testleri
  • Ek paywall’lar ve placement’lar: Farklı placement ID’leriyle daha fazla getPaywall çağrısı ekleyin.
  • Analitik entegrasyonları: Integrations sayfasından yapılandırın. Kurulum, entegrasyona göre değişir. Bkz. analitik entegrasyonları ve attribution entegrasyonları.

LLM’nize Adapty Dokümanlarını Besleyin

Context7’yi Kullanın (önerilir)

Context7, LLM’inize güncel Adapty belgelerine doğrudan erişim sağlayan bir MCP sunucusudur. LLM’iniz, ne sorduğunuza göre doğru belgeleri otomatik olarak getirir — manuel URL yapıştırmaya gerek yok.

Context7; Cursor, Claude Code, Windsurf ve diğer MCP uyumlu araçlarla çalışır. Kurulum için şunu çalıştırın:

npx ctx7 setup

Bu komut, editörünüzü algılayarak Context7 sunucusunu yapılandırır. Manuel kurulum için Context7 GitHub deposuna bakın. Yapılandırdıktan sonra, Adapty kütüphanesini prompt’larınızda referans alın:

Use the adaptyteam/adapty-docs library to look up how to install the Flutter SDK

Context7, belge bağlantılarını manuel olarak yapıştırma ihtiyacını ortadan kaldırsa da uygulama sırası önemlidir. Her şeyin düzgün çalıştığından emin olmak için aşağıdaki uygulama adımlarını sırayla takip edin.

Düz metin dokümanlara erişin

Her Adapty dokümanına düz metin Markdown olarak erişebilirsiniz. URL’nin sonuna .md ekleyin ya da makale başlığının altındaki Copy for LLM düğmesine tıklayın. Örneğin: adapty-cursor-flutter.md.

Aşağıdaki uygulama adım adım rehberi’nin her aşaması, yapıştırabileceğiniz .md bağlantılarıyla birlikte “Bunu LLM’nize gönderin” bloğu içerir.

Aynı anda daha fazla doküman için aşağıdaki dizin dosyalarına ve platforma özgü alt kümelere bakın.

Uygulama adım adım rehberi

Bu rehberin geri kalanı, Adapty entegrasyonunu uygulama sırasına göre ele alır. Her aşamada LLM’inize göndereceğiniz belgeler, tamamlandığında ne görmeniz gerektiği ve sık karşılaşılan sorunlar açıklanmaktadır.

Entegrasyonunuzu Planlayın

Koda geçmeden önce, LLM’inize projenizi analiz etmesini ve bir uygulama planı oluşturmasını söyleyin. AI aracınız bir planlama modunu destekliyorsa (Cursor’ın veya Claude Code’un plan modu gibi), bunu kullanın; böylece LLM herhangi bir kod yazmadan önce hem proje yapınızı hem de Adapty dokümanlarını okuyabilir.

LLM’inize satın almalar için hangi yaklaşımı kullandığınızı söyleyin — bu, takip etmesi gereken kılavuzları etkiler:

  • Adapty Paywall Builder: Adapty’nin no-code editöründe paywall’lar oluşturursunuz; SDK bunları otomatik olarak render eder.
  • Manuel oluşturulan paywall’lar: Kendi paywall arayüzünüzü kod ile oluşturursunuz, ancak ürünleri çekmek ve satın almaları yönetmek için yine Adapty’yi kullanırsınız.
  • Observer mode: Mevcut satın alma altyapınızı korursunuz ve Adapty’yi yalnızca analitik ve entegrasyonlar için kullanırsınız.

Hangisini seçeceğinizden emin değil misiniz? Quickstart’taki karşılaştırma tablosuna göz atın.

SDK’yı Yükleyin ve Yapılandırın

flutter pub add komutunu kullanarak Adapty SDK bağımlılığını ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temel adımdır — geri kalan her şey buna bağlıdır.

Kılavuz: Adapty SDK’yı Yükleyin ve Yapılandırın

Bunu LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/sdk-installation-flutter.md

Kontrol Noktası

  • Beklenen: Uygulama hem iOS hem Android’de derlenir ve çalışır. Hata ayıklama konsolu Adapty aktivasyon logunu gösterir.
  • Dikkat: “Public API key is missing” → yer tutucuyu App settings bölümündeki gerçek anahtarınızla değiştirdiğinizi kontrol edin.

Paywall’ları göster ve satın almaları yönet

Placement ID’ye göre bir paywall getir, görüntüle ve satın alma olaylarını yönet. İhtiyacınız olan kılavuzlar, satın almaları nasıl yönettiğinize bağlıdır.

Her satın almayı ilerledikçe sandbox’ta test et — sona kadar bekleme. Kurulum talimatları için Sandbox’ta satın almaları test et bölümüne bakın.

Abonelik durumunu kontrol etme

Satın alımın ardından, premium içeriğe erişimi kısıtlamak için kullanıcı profilindeki aktif access level’ı kontrol edin.

Kılavuz: Abonelik durumunu kontrol etme

Bunu LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/flutter-check-subscription-status.md

Kontrol Noktası

  • Beklenen: Sandbox satın alımının ardından profile.accessLevels['premium']?.isActive değeri true döner.
  • Dikkat: Satın alımdan sonra accessLevels boş geliyor → ürüne kontrol panelinde bir access level atandığını kontrol edin.

Kullanıcıları tanımlayın

Uygulama kullanıcı hesaplarını Adapty profillerine bağlayarak satın alımların cihazlar arasında kalıcı olmasını sağlayın.

Uygulamanızda kimlik doğrulama yoksa bu adımı atlayın.

Kılavuz: Kullanıcıları tanımlayın

Bunu LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/flutter-quickstart-identify.md

Checkpoint

  • Beklenen: Adapty().identify() çağrısından sonra, kontrol panelindeki Profiles bölümünde özel kullanıcı kimliğiniz görünür.
  • Dikkat: Anonim profil attribution sorunlarından kaçınmak için identify fonksiyonunu aktivasyondan sonra, paywall’ları çekmeden önce çağırın.

Yayına hazırlanma

Entegrasyonunuz sandbox ortamında çalışır hale geldikten sonra, her şeyin production’a hazır olduğundan emin olmak için yayın kontrol listesini gözden geçirin.

Rehber: Yayın kontrol listesi

Bunu LLM’inize gönderin:

Read these Adapty docs before releasing:
- https://adapty.io/docs/tr/release-checklist.md

Checkpoint

  • Beklenen: Tüm kontrol listesi maddeleri onaylandı: mağaza bağlantıları, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri.
  • Dikkat: Sunucu bildirimleri eksikse → App settings → iOS SDK bölümünden App Store Server Notifications’ı ve App settings → Android SDK bölümünden Google Play Real-Time Developer Notifications’ı yapılandırın.

Düz metin belge indeks dosyaları

LLM’nize tek tek sayfaların ötesinde daha geniş bir bağlam sağlamanız gerekiyorsa, tüm Adapty belgelerini listeleyen veya bir araya getiren indeks dosyaları sunuyoruz:

  • llms.txt: Tüm sayfaları .md bağlantılarıyla listeler. Web sitelerini LLM’lere erişilebilir kılmak için gelişmekte olan bir standart. Bazı yapay zeka ajanlarının (örneğin ChatGPT) llms.txt dosyasını indirip sohbete yüklemeniz gerekebileceğini unutmayın.
  • llms-full.txt: Tüm Adapty dokümantasyon sitesi tek bir dosyada birleştirilmiş hâlde. Çok büyük — yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
  • Flutter’a özel flutter-llms.txt ve flutter-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.