English 中文TürkçeРусскийEspañol日本語Tiếng Việt

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

Bu kılavuz, bir yapay zeka kodlama aracıyla Adapty’yi Capacitor uygulamanıza adım adım entegre etmenizi sağlar; bunun için doğru Adapty dokümanlarını doğru sırayla beslemeniz yeterli.

Otomatik entegrasyon · Beta
✦ Adapty SDK entegrasyon skill'i, tüm entegrasyonu AI kodlama aracınızda tek komutla gerçekleştirir.
Skill'i kullan

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.

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ı

Eğer her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, herhangi bir kod yazmadan önce almanız gerekenler şunlardır. LLM’iniz 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 alma işlemlerinin çalışması için zorunludur. Uygulama mağazalarını bağla

  2. Public SDK anahtarınızı kopyalayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin, ardından API keys kısmını bulun. Kodda bu, adapty.activate() fonksiyonuna ilettiğiniz dizedir.

  3. En az bir ürün oluşturun: Adapty Kontrol Paneli’nde Products sayfasına gidin. Ürünlere kodda doğrudan erişmezsiniz — 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 bir placement’a atayın. Kodda, placement ID’si adapty.getFlow() 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 budur. 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.

Beşini de aldıktan sonra 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 flow çekme kodunu üretebilir.

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ın (önerilen)

Context7, LLM’inize güncel Adapty belgelerine doğrudan erişim sağlayan bir MCP sunucusudur. LLM’iniz, ne sorduğunuza 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üphanesine prompt’larınızda referans verin:

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

Context7, belge bağlantılarını manuel olarak yapıştırma ihtiyacını ortadan kaldırsa da uygulama sırası önemlidir. Her şeyin doğru çalıştığından emin olmak için aşağıdaki uygulama adımlarını sırayla takip edin.

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’inize projenizi analiz ettirin 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, takip etmesi gereken kılavuzları etkiler:

  • Adapty Flow Builder: Flow’ları Adapty’nin no-code builder’ında oluşturursunuz, SDK bunları otomatik olarak işler.
  • Manuel oluşturulan paywall’lar: Kendi paywall arayüzünüzü kodla oluşturursunuz, ancak ürünleri getirmek ve satın almaları yönetmek için Adapty’yi kullanırsınız.
  • Observer modu: 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ı kurun ve yapılandırın

npm ile Adapty SDK bağımlılığını ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temel adımdır — diğer her şey buna bağlıdır.

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

Bu rehber, Adapty Capacitor SDK v4 (beta) hedeflemektedir — API, hızlı başlangıç kılavuzu tarafından anlatılmaktadır. v4 bir ön sürümdür, bu nedenle LLM’inizin en son kararlı 3.x sürümünü yüklemek yerine tam sürümü (npm install @adapty/capacitor@4.0.0-beta.2) sabitlediğinden emin olun. SDK 4.0 kurulum bölümüne ve geçiş kılavuzuna bakın.

Bunu LLM’inize gönderin:

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

Checkpoint

  • Beklenen: Uygulama hem iOS hem Android’de derlenir ve çalışır. Konsol, Adapty aktivasyon logunu gösterir.
  • Dikkat: “Public API key is missing” → App settings sayfasından aldığınız gerçek anahtarla placeholder’ı değiştirdiğinizi kontrol edin.

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

Placement ID ile paywall çekip göster ve satın alma olaylarını yönet. İhtiyacın olan kılavuzlar, satın almaları nasıl yönettiğine bağlı.

Her satın almayı ilerlerken sandbox ortamında test et — sona bırakma. Kurulum talimatları için bkz. Sandbox’ta satın alma testi.

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

Kontrol Noktası

  • Beklenen: Sandbox satın almasından sonra profile.accessLevels['premium']?.isActive değeri true döner.
  • Dikkat: Satın alma sonrasında accessLevels boş geliyorsa → ürünün kontrol panelinde bir access level atanıp atanmadığını kontrol et.

Kullanıcıları tanımlayın

Uygulama kullanıcı hesaplarını Adapty profillerine bağlayarak satın alımların cihazlar arasında kalıcı olmasını sağlayın.

Uygulamanızda kimlik doğrulama yoksa bu adımı atlayı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

Checkpoint

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

Yayına hazırlanma

Entegrasyonunuz sandbox ortamında düzgün çalıştıktan sonra, her şeyin canlı ortama 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

Checkpoint

  • Beklenen: Tüm kontrol listesi öğeleri onaylandı: mağaza bağlantıları, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri.
  • Dikkat: Eksik sunucu bildirimleri → App Store Server Notifications’ı App settings → iOS SDK bölümünde, Google Play Real-Time Developer Notifications’ı ise App settings → Android SDK bölümünde yapılandırın.

Düz metin belge dizin dosyaları

Büyük dil modelinize tek tek sayfaların ötesinde daha geniş bir bağlam sağlamak istiyorsanız, tüm Adapty belgelerini listeleyen veya bir araya getiren dizin 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ında (ör. ChatGPT) llms.txt dosyasını indirip sohbete dosya olarak 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 tüm içeriğe 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 özgü alt kümeler.