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

Bu sayfa, Adapty’yi Capacitor uygulamanıza entegre etmenin iki yolunu ele alı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 kılavuzu takip edin.

SDK entegrasyon skill’ini kullanın (beta)

adapty-sdk-integration skill, kontrol paneli kurulumu, SDK yüklemesi, paywall ve aşama bazlı doğrulama dahil olmak üzere entegrasyonun tamamını uçtan uca otomatikleştirir. Aracınız Claude Skills formatını desteklemiyorsa, aşağıdaki manuel adımları yedek olarak kullanabilirsiniz.

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

Yükle

Aracınıza uygun formu seçin. Tam liste skill README sayfasındadır.

• 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ır

Projenizde /adapty-sdk-integration komutunu çalıştırın. Skill, platformunuzu otomatik olarak algılar ve birkaç kurulum sorusu sorar. Ardından kontrol paneli kurulumu, SDK yükleme, paywall ve doğrulama adımlarını tek tek ilerler — her aşamada ilgili Adapty dokümanlarını çeker.

Başlamadan önce: kontrol paneli kurulumu

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

Skill yaklaşımı (önerilir)

Adapty CLI skill’i, LLM’inizin uygulamanızı, ürünlerinizi, access level’larınızı, paywall’larınızı ve placement’larınızı doğrudan kurmasına olanak tanır — 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 gerekir.

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 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 bunlara ihtiyacınız var. LLM’niz kontrol paneli değerlerini sizin için arayamaz — bunları kendiniz sağlamanız gerekecek.

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. 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 bölümüne gidin ve API keys kısmını bulun. Kod içinde bu, adapty.activate() fonksiyonuna geçirdiğiniz string değeridir.

3. En az bir ürün oluşturun: Adapty Kontrol Paneli’nde Products sayfasına gidin. Ürünlere kod içinde doğrudan referans vermezsiniz — Adapty onları 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 string değerdir. 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 string. 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 yapılandırın

Bunlar kodlamaya başlamak için 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’inize Adapty Dokümanlarını Aktarın

Context7’yi Kullanın (önerilir)

Context7, LLM’inize güncel Adapty dokümanlarına doğrudan erişim sağlayan bir MCP sunucusudur. LLM, ne sorduğunuza göre ilgili dokümanları otomatik olarak getirir — URL yapıştırmanıza gerek kalmaz.

Context7; Cursor, Claude Code, Windsurf ve MCP uyumlu diğer 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 bakabilirsiniz. Yapılandırdıktan sonra, istemlerinizde Adapty kütüphanesine başvurun:

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 butonuna tıklayın. Örnek: adapty-cursor-capacitor.md.

Aşağıdaki uygulama adımları bölümündeki her adımda, yapıştırabileceğiniz .md bağlantılarını içeren bir “Send this to your LLM” bloğu bulunur.

Daha fazla dokümanı aynı anda görmek için aşağıdaki index dosyaları ve platforma özel 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 ele alır. Her aşamada LLM’inize göndereceğiniz dokümanlar, tamamlandığında görmeniz gerekenler ve sık karşılaşılan sorunlar yer alı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 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, izlemesi gereken kılavuzları etkiler:

• Adapty Paywall Builder: Paywallları Adapty’nin kodsuz oluşturucusunda tasarlarsınız; SDK bunları otomatik olarak render eder.
• Manuel olarak oluşturulan paywalllar: Kendi paywall arayüzünüzü kod ile oluşturursunuz, ancak ürünleri getirmek ve satın alma işlemlerini 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

Adapty SDK bağımlılığını npm ile 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-capacitor.md

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

Placement ID ile paywall’ı getir, göster 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 edin — sona kadar beklemeyin. Kurulum talimatları için bkz. Sandbox’ta satın almaları test etme.

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/capacitor-quickstart-manual.md
- https://adapty.io/docs/tr/fetch-paywalls-and-products-capacitor.md
- https://adapty.io/docs/tr/present-remote-config-paywalls-capacitor.md
- https://adapty.io/docs/tr/capacitor-making-purchases.md
- https://adapty.io/docs/tr/capacitor-restore-purchase.md

Abonelik durumunu kontrol etme

Satın alma işleminin ardından, premium içeriğe erişimi yönetmek 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/capacitor-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’inize gönderin:

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

Yayına hazırlanma

Entegrasyonunuz sandbox ortamında düzgün çalışıyorsa, 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 bireysel 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. LLM’lerin web sitelerine erişimini kolaylaştırmak için kullanılan gelişmekte olan bir standarttır. Bazı AI ajanları (ör. ChatGPT) için llms.txt dosyasını indirip sohbete dosya olarak yüklemeniz gerekebilir.
• llms-full.txt: Tüm Adapty dokümantasyon sitesini tek bir dosyada birleştirir. Çok büyük bir dosyadır — yalnızca tüm içeriğe 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 özel alt kümeler.