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

Bu rehber, bir LLM yardımıyla Adapty’yi Android uygulamanıza entegre etmenize yardımcı olur. Önce Adapty kontrol panelinizi hazırlayacak, ardından her uygulama aşamasında LLM’inize odaklanmış dokümantasyon bağlantıları göndererek ilerleyeceksiniz. Sonunda, Adapty dokümantasyonuyla AI araçlarınızı kurmanın en iyi pratiklerini bulacaksınız.

Başlamak için bu sayfanın tamamını Markdown olarak kopyalayıp LLM’inize yapıştırın — sayfanın üstündeki Copy for LLM butonuna tıklayın ya da .md sürümünü açın. LLM, her aşamada sizi yönlendirmek için rehberdeki bağlantıları ve kontrol noktalarını kullanacaktır.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce kontrol panelinde bazı yapılandırmalar gerektirir. Bunu etkileşimli bir LLM becerisini kullanarak ya da 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 Kontrol Panelini açmadan ayarlamasını sağlar. Yalnızca mağazanızı bağlamanız Kontrol Paneli üzerinden yapılması gerekir.

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

Beceri eklendikten sonra, agent’ınızda /adapty-cli komutunu çalıştırın. Her adımda — mağazanızı bağlamak için Kontrol Panelini açmanız gereken anlar dahil — sizi yönlendirecektir.

Kontrol paneli yaklaşımı

Her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, kod yazmadan önce şunlara ihtiyacınız var. LLM’iniz kontrol paneli değerlerini sizin yerinize bulamaz — bunları kendiniz sağlamanız gerekir.

App store bağlantısı kurun: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin. Satın almaların çalışması için bu 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 gidin ve API keys bölümünü bulun. Kodda bu, Adapty yapılandırma builder’ına geçirdiğiniz string’dir.
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
Bir paywall ve placement oluşturun: Adapty Kontrol Paneli’nde Paywalls sayfasından bir paywall oluşturun, ardından Placements sayfasında bir placement’a atayın. Kodda, placement ID’si Adapty.getPaywall("YOUR_PLACEMENT_ID") çağrısına geçirdiğiniz string’dir. Paywall oluşturun
Access level’ları ayarlayın: Adapty Kontrol Paneli’nde her ürün için Products sayfasından yapılandırın. Kodda bu, profile.accessLevels["premium"]?.isActive içinde kontrol edilen string’dir. Varsayılan premium access level çoğu uygulama için uygundur. Ödeme yapan kullanıcılar ürüne bağlı olarak farklı özelliklere erişiyorsa (örneğin basic plan ile pro plan), koda başlamadan önce ek access level’lar oluşturun.

Bu beşine 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 kodu üretebilir.

Hazır olduğunuzda kurun

Bunlar kod yazmaya başlamak için zorunlu değil, ancak entegrasyon 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ı.

Adapty dokümanlarını LLM’inize gönderin

Context7’yi kullanın (önerilen)

Context7, LLM’inize güncel Adapty dokümantasyonuna doğrudan erişim sağlayan bir MCP sunucusudur. LLM’iniz, sorduklarınıza göre doğru dokümanları otomatik olarak çeker — manuel URL yapıştırmanıza 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ırıldıktan sonra, prompt’larınızda Adapty kütüphanesine 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ıştığından emin olmak için aşağıdaki uygulama adım adım rehberini sırayla takip edin.

Düz metin dokümanları kullanın

Herhangi bir 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. Örneğin: adapty-cursor-android.md.

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

Aynı anda daha fazla dokümantasyon için aşağıdaki index dosyaları ve platforma özgü alt kümeler bölümüne bakın.

Uygulama adım adım rehberi

Bu rehberin geri kalanı, uygulama sırasına göre Adapty entegrasyonunu ele alır. Her aşamada LLM’inize gönderilecek 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’ın veya Claude Code’un plan modu gibi), herhangi bir kod yazmadan önce LLM’in hem proje yapınızı hem de Adapty dokümanlarını okuyabilmesi için bunu kullanın.

LLM’inize hangi satın alma yaklaşımını kullandığınızı söyleyin — bu, takip etmesi gereken rehberleri etkiler:

Adapty Paywall Builder: Adapty’nin kodsuz builder’ında paywall’lar oluşturursunuz ve SDK bunları otomatik olarak gösterir.
Manuel olarak oluşturulan paywall’lar: Kendi paywall arayüzünüzü kodla oluşturursunuz, ancak ürünleri çekmek ve satın almaları yönetmek için yine de Adapty 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

Android Studio’da Gradle aracılığıyla Adapty SDK bağımlılığını ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temeldir — bu olmadan hiçbir şey çalışmaz.

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

LLM’inize gönderin:

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

Kontrol Noktası

Beklenen: Uygulama derlenir ve çalışır. Logcat’te Adapty etkinleştirme logu görünür.
Dikkat: “Public API key is missing” → App settings’den gerçek anahtarınızla yer tutucuyu değiştirdiğinizi kontrol edin.

Paywall’ları gösterin ve satın almaları yönetin

Placement ID’ye göre bir paywall çekin, gösterin ve satın alma olaylarını yönetin. İhtiyacınız olan rehberler, satın almaları nasıl yönettiğinize bağlıdır.

Her satın almayı ilerlerken sandbox’ta test edin — sonuna kadar beklemeyin. Kurulum talimatları için Sandbox’ta satın almaları test etme sayfasına bakın.

Rehberler:

LLM’inize gönderin:

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

Kontrol Noktası

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

Rehberler:

LLM’inize gönderin:

Read these Adapty docs before writing code:
- 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

Kontrol Noktası

Beklenen: Özel paywall’ınız, Adapty’den çekilen ürünleri gösterir. Bir ürüne dokunmak sandbox satın alma diyalogunu açar.
Dikkat: Boş ürün dizisi → paywall’a kontrol panelinde ürün atandığını ve placement’ın bir kitlesi olduğunu doğrulayın.

Rehberler:

LLM’inize gönderin:

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

Kontrol Noktası

Beklenen: Mevcut satın alma akışınızla sandbox satın alması yapıldıktan sonra işlem, Adapty kontrol panelindeki Event Feed’de görünür.
Dikkat: Olay yok → Adapty’ye işlem bildirdiğinizi ve Google Play Real-Time Developer Notifications’ın yapılandırıldığını doğrulayın.

Abonelik durumunu kontrol edin

Satın alma sonrasında, premium içeriği kilitlemek için kullanıcı profilinde aktif bir access level olup olmadığını kontrol edin.

Rehber: Abonelik durumunu kontrol edin

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ı sonrasında profile.accessLevels["premium"]?.isActive değeri true döner.
Dikkat: Satın alma sonrası accessLevels boş → ürünün kontrol panelinde bir access level’a atandığını kontrol edin.

Kullanıcıları tanımlayın

Satın almaların cihazlar arasında kalıcı olması için uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirin.

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

Rehber: Kullanıcıları tanımlayın

LLM’inize gönderin:

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

Kontrol Noktası

Beklenen: Adapty.identify("your-user-id") çağrısından sonra, kontrol panelinin Profiles bölümünde özel kullanıcı ID’niz görünür.
Dikkat: Anonim profil atıfını önlemek için identify’ı, aktivasyondan sonra ancak paywall’ları çekmeden önce çağırın.

Yayın için hazırlanın

Entegrasyonunuz sandbox’ta çalışır hale geldikten sonra, her şeyin canlı ortama hazır olduğundan emin olmak için yayın kontrol listesini inceleyin.

Rehber: Yayın kontrol listesi

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 öğeleri onaylandı: mağaza bağlantısı, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri.
Dikkat: Google Play Real-Time Developer Notifications eksik → 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 index 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 index dosyalarına sahibiz:

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ı AI agent’ları için (ö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ş hali. Çok büyük — yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
Android’e özgü android-llms.txt ve android-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.