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

Bu sayfa, Adapty’yi React Native uygulamanıza entegre etmenin iki yolunu ele almaktadır. Otomatik uçtan uca bir akış için aşağıdaki SDK entegrasyon rehberini kullanın ya da daha aşağıdaki adım adım manuel kurulumu takip edin.

SDK entegrasyon skill’ini kullanın (beta)

adapty-sdk-integration skill, entegrasyonu uçtan uca otomatikleştirir: kontrol paneli kurulumu, SDK kurulumu, paywall ve aşama bazlı doğrulama. Aracınız Claude Skills formatını desteklemiyorsa, aşağıdaki manuel adımlar yedek olarak kullanılabilir.

Desteklenen araçlar: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Kur

Araçınıza uygun formu seçin. Tam liste skill README içinde yer alıyor.

• Claude Code: Kabuğunuzdan claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill ardından claude plugin install adapty-sdk-integration@adapty komutunu çalıştırın.
• GitHub Copilot CLI: gh skill install adaptyteam/adapty-sdk-integration-skill komutunu çalıştırın.
• Gemini CLI: gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill komutunu çalıştırın.
• OpenAI Codex veya başka bir araç: Repoyu klonlayın ve plugins/adapty-sdk-integration/skills/adapty-sdk-integration/ dizinini aracınızın skills klasörüne kopyalayın.

Çalıştırma

Projenizde /adapty-sdk-integration komutunu çalıştırın. Skill, platformunuzu algılar ve birkaç kurulum sorusu sorar. Ardından kontrol paneli kurulumu, SDK kurulumu, paywall ve doğrulama aşamalarında sizi yönlendirerek her adımda ilgili Adapty dokümanlarını getirir.

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 ya da Kontrol Paneli üzerinden manuel olarak yapabilirsiniz.

Beceri yaklaşımı (önerilir)

Adapty CLI becerisi, LLM’inizin uygulamanızı, ürünleri, access level’ları, paywall’ları ve placement’ları doğrudan kurmasını sağlar — her adım için kontrol panelini açmanıza gerek kalmaz. Yalnızca kontrol panelinde 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. Her adımda sizi yönlendirecektir — mağazalarınızı bağlamak için kontrol panelini ne zaman açmanız gerektiği dahil.

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. 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 gereklidir. 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.activate("YOUR_PUBLIC_SDK_KEY") çağrısına 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ından bir paywall oluşturun, ardından Placements sayfasından bunu bir placement’a atayın. Kodda, placement ID’si adapty.getPaywall("YOUR_PLACEMENT_ID") fonksiyonuna geçirdiğiniz string’dir. 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.

Hazır olduğunuzda kurun

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

• 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 değişir. Bkz. analitik entegrasyonlar ve attribution entegrasyonları.

Adapty Dokümanlarını LLM’inize Besleyin

Context7’yi Kullanın (önerilir)

Context7, LLM’inizin güncel Adapty belgelerine doğrudan erişmesini sağlayan bir MCP sunucusudur. LLM, ne sorduğunuza göre doğru belgeleri otomatik olarak getirir — URL yapıştırmanıza gerek kalmaz.

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ü otomatik 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 kütüphanesine referans verin:

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

Düz metin dokümanlarını kullan

Herhangi bir Adapty dokümanına düz metin Markdown olarak erişebilirsin. URL’nin sonuna .md ekle ya da makale başlığının altındaki Copy for LLM butonuna tıkla. Örneğin: adapty-cursor-react-native.md.

Aşağıdaki uygulama adım adım kılavuzundaki her aşama, yapıştırmak için .md bağlantıları içeren bir “LLM’ine gönder” bloğu içerir.

Aynı anda daha fazla dokümana ulaşmak için aşağıdaki dizin dosyalarına ve platforma özel alt kümelere bakabilirsin.

Uygulama adım adım

Bu kılavuzun geri kalanı, Adapty entegrasyonunu uygulama sırasına göre ele alır. Her aşamada LLM’inize göndereceğiniz belgeler, tamamlandığında görmeniz gerekenler ve sık karşılaşılan sorunlar yer alı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 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 alma işlemleri için hangi yaklaşımı kullandığınızı söyleyin — bu, takip etmesi gereken kılavuzları etkiler:

• Adapty Paywall Builder: Adapty’nin kodsuz builder’ında paywall’lar oluşturursunuz, SDK bunları otomatik olarak render eder.
• Manuel oluşturulan paywall’lar: Kendi paywall arayüzünüzü kodla oluşturursunuz, ancak ürünleri almak ve satın alma işlemlerini yönetmek için yine de Adapty’yi kullanırsınız.
• Observer mode: 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 tablosuna göz atın.

SDK’yı Yükle ve Yapılandır

Adapty SDK bağımlılığını npm (veya yarn) ile ekle ve Public SDK anahtarınla etkinleştir. Bu, her şeyin temeli — bunu yapmadan hiçbir şey çalışmaz.

Expo ve bare React Native projeleri için ayrı kurulum kılavuzlarımız var — kurulumuna uyan kılavuzu seç.

Kılavuzlar:

• Expo ile Kur
• Bare React Native ile Kur

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 ele aldığınıza bağlıdır.

Her satın almayı ilerlerken sandbox ortamında test edin — sona kadar beklemeyin. Kurulum talimatları için Sandbox’ta satın alma testi bölümüne bakın.

Kod yazmadan önce şu Adapty dokümanlarını okuyun:
- https://adapty.io/docs/tr/react-native-quickstart-manual.md
- https://adapty.io/docs/tr/fetch-paywalls-and-products-react-native.md
- https://adapty.io/docs/tr/present-remote-config-paywalls-react-native.md
- https://adapty.io/docs/tr/react-native-making-purchases.md
- https://adapty.io/docs/tr/react-native-restore-purchase.md

Abonelik durumunu kontrol etme

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 edin.

Kılavuz: Abonelik durumunu kontrol etme

Bunu LLM’inize gönderin:

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

Kullanıcıları tanımlayın

Uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirin; böylece satın almalar cihazlar arasında korunur.

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

Bunu LLM’nize gönderin:

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

Yayına hazırlanın

Entegrasyonunuz sandbox ortamında çalışır hale geldiğinde, 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 dizin dosyaları

LLM’inize tek tek sayfaların ötesinde daha geniş bir bağlam sağlamanız gerekiyorsa, tüm Adapty belgelerini listeleyen veya birleştiren dizin dosyaları sunuyoruz:

• llms.txt: .md bağlantılarıyla tüm sayfaları listeler. Web sitelerini LLM’lere erişilebilir kılmak için gelişmekte olan bir standart. Bazı yapay zeka ajanlarında (ör. ChatGPT) llms.txt dosyasını indirip sohbete yüklemeniz gerekebilir.
• 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.
• React Native’e özel react-native-llms.txt ve react-native-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.