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

Bu sayfa, Adapty’yi Kotlin Multiplatform 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 manuel kurulumu takip edin.

SDK entegrasyon becerisini kullanın (beta)

adapty-sdk-integration skill, entegrasyonu baştan sona otomatikleştirir: kontrol paneli kurulumu, SDK yükleme, paywall ve her aşama için doğrulama. Araçı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.

Yükle

Aracınıza uygun formu seçin. Tam liste skill README dosyasında bulunmaktadı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/ klasörünü aracınızın skills dizinine kopyalayın.

Çalıştırın

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 kurulumu, paywall ve doğrulama aşamalarını adım adım yürütürken her aşamada ilgili Adapty dokümanlarını getirir.

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 aracıyla veya Kontrol Paneli üzerinden manuel olarak yapabilirsiniz.

Beceri yaklaşımı (önerilen)

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

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

Beceri eklendikten sonra, agent’ınızda /adapty-cli komutunu çalıştırın. Mağazalarınızı bağlamak için kontrol panelini 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 aşağıdakilere ihtiyacınız var. LLM’iniz kontrol paneli değerlerini sizin yerinize arayamaz — 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. KMP uygulamanız her iki platformu da hedefliyorsa hem App Store hem de Google Play’i bağlayın. Bu adım, 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 sayfasına gidin ve API keys bölümünü bulun. Kodda bu, Adapty yapılandırma oluşturucusuna 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ı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ğeridir. 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. 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 kurulum

Kodlamaya başlamak için gerekli değiller, 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ı.

Adapty Dokümanlarını LLM’inize Aktarın

Context7 Kullanımı (önerilen)

Context7, LLM’inize güncel Adapty belgelerine doğrudan erişim sağlayan bir MCP sunucusudur. LLM, 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. Kurmak 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ırdıktan sonra, promptlarınızda Adapty kütüphanesine şu şekilde başvurun:

Use the adaptyteam/adapty-docs library to look up how to install the Kotlin Multiplatform 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-kmp.md.

Aşağıdaki uygulama kılavuzundaki her adım, yapıştırmanız için .md bağlantılarını içeren bir “Send this to your LLM” bloğu içerir.

Daha fazla dokümanı aynı anda görmek için aşağıdaki index 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 ele alır. Her aşamada LLM’inize gönderilecek belgeler, tamamlandığında görmeniz gerekenler ve yaygın sorunlar açıklanmaktadır.

Entegrasyonu Planlayın

Koda geçmeden önce, LLM’inize projenizi analiz etmesini ve bir uygulama planı oluşturmasını isteyin. Yapay zeka aracınız bir planlama modunu destekliyorsa (Cursor 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 bu modu 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: Adapty’nin kodsuz oluşturucusunda paywall’lar oluşturursunuz ve SDK bunları otomatik olarak render eder.
• Manuel olarak 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 kullanmaya devam edersiniz.
• Gözlemci modu: 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 inceleyin.

SDK’yı Yükleyin ve Yapılandırın

Adapty SDK bağımlılığını Gradle üzerinden 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ı 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-kotlin-multiplatform.md

Paywall’ları 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ız olan kılavuzlar, satın almaları nasıl yönettiğinize göre değişir.

Her satın almayı ilerledikçe sandbox ortamında test edin — sona bırakmayın. Kurulum talimatları için Sandbox’ta satın almaları test etme bölümüne bakın.

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

Abonelik durumunu kontrol et

Bir 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/kmp-check-subscription-status.md

Kullanıcıları tanımlayın

Satın alımların cihazlar arasında korunması için uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirin.

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/kmp-quickstart-identify.md

Yayına hazırlanma

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 bireysel sayfaların ötesinde daha geniş bir bağlam sağlamak istiyorsanız, tüm Adapty belgelerini listeleyen veya bir araya getiren indeks dosyaları sunuyoruz:

• llms.txt: .md bağlantılarıyla tüm sayfaları listeler. LLM’lerin web sitelerine erişimini kolaylaştırmak için ortaya çıkan bir standart. Bazı yapay zeka ajanları (örn. ChatGPT) için 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ştir. Çok büyüktür — yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
• Kotlin Multiplatform’a özel kmp-llms.txt ve kmp-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.