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

Bu kılavuz, bir AI kodlama aracıyla Adapty’yi Capacitor uygulamanıza adım adım entegre etmeyi anlatır — doğru Adapty dokümanlarını doğru sırayla besleyerek ilerlersiniz.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce bazı kontrol paneli ayarlarının yapılmasını gerektirir. Bunu etkileşimli bir LLM aracıyla veya Kontrol Paneli üzerinden manuel olarak gerçekleştirebilirsiniz.

Beceri yaklaşımı (önerilir)

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

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

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

Kontrol paneli yaklaşımı

Her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, kod yazmadan önce ihtiyacınız olanlar bunlar. LLM’iniz kontrol paneli değerlerini sizin için bulamaz — 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. 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 ve API keys kısmını bulun. Kodda bu, adapty.activate() fonksiyonuna geçirdiğiniz string değerdir.

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

4. Bir 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şturun

5. Access level’ları yapılandırın: Adapty Kontrol Paneli’nde Products sayfasında her ürün için yapılandırın. Kodda profile.accessLevels['premium']?.isActive ile kontrol edilir. Varsayılan premium access level çoğu uygulama için yeterlidir. Ödeme yapan 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.

Hazır olduğunuzda yapılandırın

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

• A/B testleri: Placements sayfasından 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ı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 (önerilir)

Context7, LLM’nize güncel Adapty belgelerine doğrudan erişim sağlayan bir MCP sunucusudur. LLM’niz, sorduğunuz şeye göre doğru belgeleri otomatik olarak getirir — manuel URL yapıştırmaya gerek yoktur.

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ılar ve Context7 sunucusunu yapılandırır. Manuel kurulum için Context7 GitHub deposuna bakın. Yapılandırıldıktan sonra, Adapty kütüphanesini promptlarınızda referans alın:

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

Düz metin dokümanları kullanın

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

Aşağıdaki uygulama adım adım kılavuzundaki her aşama, yapıştırabileceğiniz .md bağlantılarını içeren bir “Bunu LLM’inize gönderin” bloğu içerir.

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

Uygulama adım adım

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

Entegrasyonu Planlayın

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

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: Paywallları Adapty’nin no-code editöründe oluşturursunuz, SDK bunları otomatik olarak render eder.
• Manuel oluşturulan paywalllar: Kendi paywall arayüzünüzü kodla oluşturursunuz ama ürünleri almak 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? Hızlı başlangıçtaki karşılaştırma tablosunu okuyun.

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

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

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

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

Bir paywall’ı placement ID’siyle çek, görüntüle ve satın alma olaylarını yönet. İhtiyacınız olan kılavuzlar, satın almaları nasıl ele aldığınıza bağlıdır.

Her satın almayı ilerlerken sandbox’ta test edin — sona bırakmayın. Kurulum talimatları için Sandbox’ta satın almaları test edin sayfasına bakın.

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/observer-vs-full-mode.md
- https://adapty.io/docs/tr/implement-observer-mode-capacitor.md
- https://adapty.io/docs/tr/report-transactions-observer-mode-capacitor.md

Abonelik durumunu kontrol et

Satın alma işleminin ardından, premium içeriğe erişimi kısıtlamak için kullanıcı profilinde aktif bir access level olup olmadığını kontrol et.

Rehber: Abonelik durumunu kontrol et

Bunu LLM’ine gönder:

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

Kullanıcıları tanımlayın

Uygulama kullanıcı hesaplarınızı Adapty profillerine bağlayarak satın alımların cihazlar arasında kalıcı olmasını sağlayı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/capacitor-quickstart-identify.md

Yayına hazırlık

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

Kılavuz: Yayın kontrol listesi

Bunu LLM’inize gönderin:

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

Düz metin belge indeks dosyaları

LLM’inize 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 (örn. ChatGPT) llms.txt dosyasını indirip sohbete dosya olarak 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.
• Capacitor’a özel capacitor-llms.txt ve capacitor-llms-full.txt: Tam siteyle karşılaştırıldığında token tasarrufu sağlayan platforma özgü alt kümeler.