Capacitor uygulamanıza Adapty'yi AI yardımıyla entegre edin

Bu rehber, bir LLM yardımıyla Capacitor uygulamanıza Adapty’yi entegre etmenize yardımcı olur. Önce Adapty kontrol panelinizi hazırlayacak, ardından her uygulama aşamasını LLM’inize odaklanmış doküman bağlantıları göndererek tamamlayacaksınız. Sonunda, AI araçlarınızı Adapty dokümantasyonuyla kurmanın en iyi yöntemlerini bulacaksınız.

Başlamak için bu sayfanın tamamını Markdown olarak kopyalayıp LLM’inize yapıştırın — sayfanın üstündeki Copy for LLM düğmesine tıklayın ya da .md sürümünü açın. LLM, rehber bağlantılarını ve kontrol noktalarını kullanarak her aşamada sizi yönlendirecektir.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce bazı kontrol paneli yapılandırmaları gerektirir. Bunu etkileşimli bir LLM becerisiyle ya da Dashboard üzerinden manuel olarak yapabilirsiniz.

Adapty CLI becerisi, LLM’inizin uygulamanızı, ürünleri, access level’ları, paywall’ları ve placement’ları doğrudan ayarlamasını sağlar; her adım için Dashboard’u açmanıza gerek kalmaz. Yalnızca Dashboard’da 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 Dashboard’u ne zaman açmanız gerektiği de dahil olmak üzere her adımda sizi yönlendirecektir.

Dashboard yaklaşımı

Her şeyi manuel olarak yapılandırmayı tercih ederseniz, kod yazmadan önce hazır olması gerekenler şunlardır. LLM’iniz kontrol paneli değerlerini sizin için bulamaz — bunları kendiniz sağlamanız gerekecektir.

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

  2. Public SDK anahtarınızı kopyalayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin, ardından API keys bölümünü bulun. Kodda bu, adapty.activate() fonksiyonuna geçirdiğ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 bunları paywall’lar aracılığıyla iletir. Ürün ekleyin

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

  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 dizedir. Varsayılan premium access level çoğu uygulama için yeterlidir. Ücretli kullanıcılar ürüne göre farklı özelliklere erişiyorsa (örneğin basic plan ile pro plan), kodlamaya başlamadan önce ek access level’lar oluşturun.

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

Hazır olduğunuzda kurun

Bunlar kodlamaya başlamak için zorunlu değildir, ancak entegrasyonunuz olgunlaştıkça işinize yarayacaktır:

  • A/B testleri: Placements sayfasında yapılandırın. Kod değişikliği gerekmez. A/B testleri
  • Ek paywall’lar ve placement’lar: Farklı placement ID’leriyle daha fazla getPaywall çağrısı ekleyin.
  • Analitik entegrasyonları: Integrations sayfasında yapılandırın. Kurulum entegrasyona göre farklılık gösterir. Bkz. analitik entegrasyonları ve attribution entegrasyonları.

Adapty dokümanlarını LLM’inize besleyin

Context7, LLM’inize güncel Adapty dokümantasyonuna doğrudan erişim sağlayan bir MCP sunucusudur. LLM’iniz, sorduğunuz şeye göre doğru dokümanları otomatik olarak çeker — manuel URL yapıştırmaya gerek yoktur.

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

npx ctx7 setup

Bu komut, editörünüzü algılar ve Context7 sunucusunu yapılandırır. Manuel kurulum için Context7 GitHub deposuna bakın.

Yapılandırıldıktan sonra, istemlerinizde Adapty kitaplığına başvurun:

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

Context7, doküman 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ışması için aşağıdaki uygulama adım adım kılavuzunu sırayla takip edin.

Düz metin dokümanları kullanın

Herhangi bir 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-capacitor.md.

Aşağıdaki uygulama adım adım kılavuzundaki her aşama, yapıştırmak için .md bağlantılarını içeren “LLM’inize bunu gönderin” bloğunu içermektedir.

Aynı anda daha fazla dokümantasyon için aşağıdaki indeks dosyaları ve platforma özel alt kümeler bölümüne bakın.

Uygulama adım adım kılavuzu

Bu rehberin geri kalanı, Adapty entegrasyonunu uygulama sırasına göre ele alır. Her aşama, LLM’inize gönderilecek dokümanları, tamamlandığında görmeniz gerekenleri ve sık karşılaşılan sorunları içerir.

Entegrasyonunuzu planlayın

Koda geçmeden önce, LLM’inizden projenizi analiz etmesini ve bir uygulama planı oluşturmasını isteyin. AI aracınız bir planlama modunu destekliyorsa (Cursor veya Claude Code’un plan modu gibi), LLM herhangi bir kod yazmadan önce hem proje yapınızı hem de Adapty dokümanlarını okuyabilmesi için bu modu kullanın.

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

  • Adapty Paywall Builder: Adapty’nin kodsuz oluşturucusunda paywall’lar oluşturursunuz; SDK bunları otomatik olarak render eder.
  • Manuel olarak oluşturulan paywall’lar: Kendi paywall arayüzünüzü kodla oluşturursunuz, ancak ürünleri çekmek ve satın alımları yönetmek için Adapty’yi kullanmaya devam edersiniz.
  • Observer modu: Mevcut satın alma altyapınızı korur ve Adapty’yi yalnızca analitik ve entegrasyonlar için kullanırsınız.

Hangisini seçeceğinizden emin değil misiniz? Hızlı başlangıçtaki karşılaştırma tablosunu okuyun.

SDK’yı yükleyin ve yapılandırın

Adapty SDK bağımlılığını npm ile ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temel adımdır — diğer hiçbir şey bu olmadan çalışmaz.

Rehber: Adapty SDK’yı yükleyin ve yapılandırın

LLM’inize bunu gönderin:

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

Kontrol noktası

  • Beklenen: Uygulama hem iOS hem de Android’de derlenir ve çalışır. Konsol, Adapty etkinleştirme günlüğünü gösterir.
  • Dikkat: “Public API key is missing” → anahtarı, App settings’teki gerçek anahtarınızla değiştirip değiştirmediğinizi kontrol edin.

Paywall’ları gösterin ve satın alımları yönetin

Bir paywall’ı placement ID’siyle çekin, görüntüleyin ve satın alma olaylarını yönetin. İhtiyacınız olan rehberler, satın alımları nasıl yönettiğinize bağlıdır.

Sona kadar beklemeyin — ilerledikçe her satın alımı sandbox ortamında test edin. Kurulum talimatları için Sandbox’ta satın alımları test edin bölümüne bakın.

Abonelik durumunu kontrol edin

Satın alımın ardından, premium içeriği kısıtlamak için kullanıcı profilinde aktif bir access level olup olmadığını kontrol edin.

Rehber: Abonelik durumunu kontrol edin

LLM’inize bunu gönderin:

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

Kontrol noktası

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

Kullanıcıları tanımlayın

Satın alımların cihazlar arasında kalıcı olması için uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirin.

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

Rehber: Kullanıcıları tanımlayın

LLM’inize bunu gönderin:

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

Kontrol noktası

  • Beklenen: adapty.identify() çağrısının ardından kontrol panelinin Profiles bölümünde özel kullanıcı ID’niz görünür.
  • Dikkat: Anonim profil attribution sorunlarını önlemek için identify’ı etkinleştirmeden sonra, paywall’ları çekmeden önce çağırın.

Yayına hazırlanın

Entegrasyonunuz sandbox’ta çalışır hale geldiğinde, her şeyin production’a hazır olduğundan emin olmak için yayın kontrol listesini adım adım inceleyin.

Rehber: Yayın kontrol listesi

LLM’inize bunu gönderin:

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

Kontrol noktası

  • 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: Eksik sunucu bildirimleri → App settings → iOS SDK bölümünde App Store Sunucu Bildirimlerini ve App settings → Android SDK bölümünde Google Play Gerçek Zamanlı Geliştirici Bildirimlerini yapılandırın.

Düz metin doküman indeks dosyaları

LLM’inize tek tek sayfaların ötesinde daha geniş bir bağlam sağlamanız gerekiyorsa, tüm Adapty dokümantasyonunu listeleyen veya birleştiren 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ı AI ajanları (örneğin ChatGPT) için llms.txt dosyasını indirip sohbete dosya olarak yüklemeniz gerekebileceğini unutmayın.
  • llms-full.txt: Tüm Adapty dokümantasyon sitesini tek bir dosyada birleştirir. Çok büyük — yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
  • Capacitor’a özgü capacitor-llms.txt ve capacitor-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özel alt kümeler.