Yapay zeka yardımıyla Adapty'yi Android uygulamanıza entegre edin

Bu sayfa, Adapty’yi Android uygulamanıza entegre etmenin iki yolunu ele almaktadır. Otomatik uçtan uca akış için aşağıdaki SDK entegrasyon becerisini kullanın ya da daha aşağıda yer alan adım adım manuel kılavuzu takip edin.

SDK entegrasyon becerisini kullanın (beta)

adapty-sdk-integration becerisi, entegrasyonu uçtan uca otomatikleştirir: kontrol paneli kurulumu, SDK yüklemesi, paywall ve aşama bazlı 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

Araçınıza uygun formu seçin. Tam liste skill README içinde yer almaktadı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ırma

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

Skill beta aşamasındadır. Takılıp kalır ya da beklenmedik şekilde davranırsa, aşağıdaki manuel adım adım kılavuz her aşamayı kapsamaktadır.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce bazı kontrol paneli yapılandırmaları gerektirir. Bunu etkileşimli bir LLM becerisiyle veya 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 ayarlamasına olanak tanır — her adım için kontrol panelini açmanıza gerek kalmaz. Yalnızca kontrol panelinde mağazanı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ğazanızı bağlamak için kontrol panelini 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, kod yazmadan önce bunlara ihtiyacınız var. LLM’iniz kontrol paneli değerlerini sizin için arayamaz — bunları kendiniz sağlamanız gerekir.

Uygulama mağazanızı bağlayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin. Bu, satın almaların çalışması için zorunludur. Google Play’i Bağlayın
Public SDK anahtarınızı kopyalayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidip API keys kısmını bulun. Kod içinde bu, Adapty yapılandırma oluşturucusuna geçirdiğiniz string değerdir.
En az bir ürün oluşturun: Adapty Kontrol Paneli’nde Products sayfasına gidin. Ürünlere kod içinde doğrudan başvurmazsınız — Adapty onları paywall’lar aracılığıyla iletir. Ürün ekle
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. Kod içinde placement ID, Adapty.getPaywall("YOUR_PLACEMENT_ID") fonksiyonuna ilettiğiniz string değerdir. Paywall oluştur
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çindeki string kontrol edilir. 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.

Beşine de sahip olduğunuzda 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 paywall çekme kodunu üretebilir.

Hazır olduğunuzda yapılandırın

Kodlamaya başlamak için zorunlu 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ı.

LLM’inize Adapty Belgelerini Besleyin

Context7’yi Kullan (önerilen)

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 — 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, promptlarınızda Adapty kütüphanesine şu şekilde başvurun:

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

Context7, doküman bağlantılarını manuel olarak yapıştırma ihtiyacını ortadan kaldırsa da uygulama sırası önemlidir. Her şeyin düzgün çalışması için aşağıdaki uygulama kılavuzunu adım adım 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 butonuna tıklayın. Örnek: adapty-cursor-android.md.

Aşağıdaki uygulama adımları bölümündeki her aşamada yapıştırabileceğiniz .md bağlantılarıyla birlikte “Send this to your LLM” bloğu yer alır.

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

Uygulama adım adım anlatı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 dokümantasyon, tamamlandığında görmeniz gerekenler ve yaygın sorunlar yer almaktadı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’in 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 alımlar 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 inşa edersiniz, ancak ürünleri getirmek ve satın almaları yönetmek için yine 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ı Yükleyin ve Yapılandırın

Adapty SDK bağımlılığını Android Studio’da Gradle aracılığıyla ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temel adımdır — diğer 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-android.md

Checkpoint

Beklenen: Uygulama derlenir ve çalışır. Logcat, Adapty aktivasyon günlüğünü gösterir.
Dikkat: “Public API key is missing” → yer tutucuyu App settings sayfasındaki gerçek anahtarınızla değiştirdiğinizi kontrol edin.

Paywall’ları göster ve satın alma işlemlerini yönet

Placement ID’ye göre bir paywall getir, göster ve satın alma olaylarını yönet. İhtiyacınız olan kılavuzlar, satın alma işlemlerini 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 Sandbox’ta satın alma testleri bölümüne bakın.

Kılavuzlar:

Paywall’lar ile satın almayı etkinleştirin (hızlı başlangıç)
Paywall Builder paywall’larını ve yapılandırmalarını çekin
Paywall’ları gösterin
Paywall olaylarını yönetin
Düğme aksiyonlarına yanıt verin Bu bir kod yazma görevi için LLM’e gönderilecek bir komut istemi (prompt), teknik dokümantasyon değil. Yine de talimatlara uygun şekilde çevireceğim:

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

Checkpoint

Beklenen: Paywall, yapılandırdığınız ürünlerle birlikte görünür. Bir ürüne dokunmak sandbox satın alma diyaloğunu tetikler.
Dikkat: Boş paywall veya getPaywall hatası → placement ID’nin kontrol panelindekiyle tam olarak eşleştiğini ve placement’a bir kitle atandığını doğrulayın.

Kılavuzlar:

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

Checkpoint

Beklenen: Özel paywall’ınız, Adapty’den getirilen ürünleri gösteriyor. Bir ürüne dokunmak, sandbox satın alma iletişim kutusunu tetikliyor.
Dikkat: Boş ürünler dizisi → paywallın kontrol panelinde ürünler atanmış olduğunu ve placement’ın bir kitleye sahip olduğunu doğrulayın.

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

Kontrol Noktası

Beklenen: Sandbox satın almasının ardından profile.accessLevels["premium"]?.isActive değeri true döner.
Dikkat: Satın alma sonrası accessLevels boş geliyorsa → ürüne kontrol panelinde bir access level atandığını kontrol edin.

Kullanıcıları tanımla

Uygulama kullanıcı hesaplarını Adapty profilleriyle ilişkilendirerek satın alımların cihazlar arasında kalıcı olmasını sağla.

Uygulamanızda kimlik doğrulama yoksa bu adımı atlayın.

Kılavuz: Kullanıcıları tanımla

Bunu LLM’inize gönderin:

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

Checkpoint

Beklenen: Adapty.identify("your-user-id") ç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 sorununu önlemek için identify fonksiyonunu aktivasyondan sonra, paywall’ları çekmeden önce çağırın.

Yayına hazırlanın

Entegrasyonunuz sandbox ortamında düzgün çalışınca, her şeyin üretime hazır olduğundan emin olmak için yayın kontrol listesini gözden geçirin.

Rehber: Yayın kontrol listesi

Bunu LLM’inize gönderin:

Read these Adapty docs before releasing:
- https://adapty.io/docs/tr/release-checklist.md

Kontrol Noktası

Beklenen: Tüm kontrol listesi maddeleri onaylandı: mağaza bağlantısı, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri.
Dikkat: Google Play Gerçek Zamanlı Geliştirici Bildirimleri eksik → bunları App settings → Android SDK bölümünden yapılandırın, aksi takdirde olaylar kontrol panelinde görünmez.

Düz metin dokümantasyon indeks dosyaları

LLM’inize tek tek sayfaların ötesinde daha geniş bir bağlam sağlamanız gerekiyorsa, tüm Adapty dokümantasyonunu listeleyen veya birleştiren indeks 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 (örn. 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.
Android’e özel android-llms.txt ve android-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.