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

Bu kılavuz, bir yapay zeka kodlama aracıyla React Native uygulamanıza Adapty’yi adım adım entegre etmenizi anlatıyor — doğru Adapty dokümanlarını doğru sırayla besleyerek ilerleyebilirsiniz.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce kontrol panelinde bazı yapılandırmalar yapılmasını gerektirir. Bunu etkileşimli bir LLM aracıyla ya da Kontrol Paneli üzerinden manuel olarak yapabilirsiniz.

Skill yaklaşımı (önerilen)

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

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

Skill eklendikten sonra agent’ı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, herhangi bir kod yazmadan önce bunlara ihtiyacınız var. 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 App Store ve Google Play’i bağlayın. Satın almaların çalışması için bu gereklidir. Uygulama mağazalarını bağla

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 string’dir.

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

4. 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’si adapty.getPaywall("YOUR_PLACEMENT_ID") fonksiyonuna geçirdiğiniz string değerdir. Paywall oluştur

5. Access level’ları ayarlayın: Adapty Kontrol Paneli’nde, Products sayfasından 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 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 kurulum

Kodlamaya başlamak için bunlar gerekli değildir, ancak entegrasyonunuz olgunlaştıkça bunlara 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’inize Adapty Dokümanlarını Besleyin

Context7’yi Kullanın (önerilen)

Context7, LLM’inizin güncel Adapty belgelerine doğrudan erişmesini sağlayan bir MCP sunucusudur. LLM’iniz, sorduğunuz şeye 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. Kurulum için şunu çalıştırın:

npx ctx7 setup

Bu komut, kullandığınız editörü 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üphanesine prompt’larınızda şu şekilde referans verin:

Use the adaptyteam/adapty-docs library to look up how to install the React Native 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 butonuna tıklayın. Örnek: adapty-cursor-react-native.md.

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

Daha fazla dokümanı aynı anda görüntülemek için aşağıdaki indeks dosyaları ve platforma özgü alt kümeler bölümüne bakın.

Uygulama adım adım rehberi

Bu rehberin 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 ne görmeniz gerektiği ve sık karşılaşılan sorunlar açıklanmaktadır.

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’ın veya Claude Code’un plan modu gibi), LLM’nin 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, izlemesi gereken kılavuzları etkiler:

• Adapty Paywall Builder: Adapty’nin no-code builder’ında paywall’lar oluşturursunuz ve 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 almaları 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 tablosunu okuyun.

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

Adapty SDK bağımlılığını npm (veya yarn) ile ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temel adımdır — geri kalan her şey buna bağlıdır.

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

Kılavuzlar:

• Expo ile kurulum
• Saf React Native ile kurulum

Paywallları göster ve satın almaları yönet

Placement ID ile bir paywall getir, göster ve satın alma olaylarını yönet. İhtiyacın olan kılavuzlar, satın almaları nasıl yönettiğine göre değişir.

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/react-native-quickstart-paywalls.md
- https://adapty.io/docs/tr/react-native-get-pb-paywalls.md
- https://adapty.io/docs/tr/react-native-present-paywalls.md
- https://adapty.io/docs/tr/react-native-handling-events-1.md
- https://adapty.io/docs/tr/react-native-handle-paywall-actions.md

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-react-native.md
- https://adapty.io/docs/tr/report-transactions-observer-mode-react-native.md

Abonelik durumunu kontrol etme

Bir satın alma işleminden sonra, 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

Satın almaların cihazlar arasında korunması için uygulama kullanıcı hesaplarını Adapty profillerine bağ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/react-native-quickstart-identify.md

Yayına hazırlık

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 doküman indeks 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 indeks dosyaları barındırıyoruz:

• 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ı (ör. ChatGPT) için llms.txt dosyasını indirip sohbete dosya olarak yüklemeniz gerekebilir.
• llms-full.txt: Adapty dokümantasyon sitesinin tamamı tek bir dosyada birleştirilmiş hali. Çok büyük — yalnızca tüm içeriğe 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.