--- title: "Adapty'yi Android uygulamanıza AI yardımıyla entegre edin" description: "Cursor, Context7, ChatGPT, Claude veya diğer AI araçlarını kullanarak Adapty'yi Android uygulamanıza adım adım entegre etme rehberi." --- 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. :::tip 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ü](https://adapty.io/docs/tr/adapty-cursor-android.md) 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 \{#before-you-start-dashboard-setup\} 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) \{#skill-approach-recommended\} 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](integrate-payments) 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ı \{#dashboard-approach\} 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. 1. **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](integrate-payments) 2. **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. 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](quickstart-products) 4. **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](quickstart-paywalls) 5. **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](assigning-access-level-to-a-product). :::tip 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 \{#set-up-when-ready\} 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](ab-tests) - **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ı](analytics-integration) ve [attribution entegrasyonları](attribution-integration). ## Adapty dokümanlarını LLM'inize gönderin \{#feed-adapty-docs-to-your-llm\} ### Context7'yi kullanın (önerilen) \{#use-context7-recommended\} [Context7](https://context7.com), 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](https://github.com/upstash/context7) 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 ``` :::warning 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](#implementation-walkthrough) sırayla takip edin. ::: ### Düz metin dokümanları kullanın \{#use-plain-text-docs\} 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](https://adapty.io/docs/tr/adapty-cursor-android.md). Aşağıdaki [uygulama adım adım rehberindeki](#implementation-walkthrough) 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](#plain-text-doc-index-files) bölümüne bakın. ## Uygulama adım adım rehberi \{#implementation-walkthrough\} 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 \{#plan-your-integration\} 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-paywall-builder): Adapty'nin kodsuz builder'ında paywall'lar oluşturursunuz ve SDK bunları otomatik olarak gösterir. - [**Manuel olarak oluşturulan paywall'lar**](android-making-purchases): 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**](observer-vs-full-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](android-quickstart-paywalls) okuyun. ### SDK'yı yükleyin ve yapılandırın \{#install-and-configure-the-sdk\} 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](sdk-installation-android) LLM'inize gönderin: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/sdk-installation-android.md ``` :::tip[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 \{#show-paywalls-and-handle-purchases\} 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](test-purchases-in-sandbox) sayfasına bakın. **Rehberler:** - [Paywall'ları kullanarak satın almaları etkinleştirin (hızlı başlangıç)](android-quickstart-paywalls) - [Paywall Builder paywall'larını ve yapılandırmalarını çekin](android-get-pb-paywalls) - [Paywall'ları gösterin](android-present-paywalls) - [Paywall olaylarını yönetin](android-handling-events) - [Buton eylemlerine yanıt verin](android-handle-paywall-actions) 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 ``` :::tip[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:** - [Özel paywall'ınızda satın almaları etkinleştirin (hızlı başlangıç)](android-quickstart-manual) - [Paywall'ları ve ürünleri çekin](fetch-paywalls-and-products-android) - [Remote config ile tasarlanmış paywall'ı gösterin](present-remote-config-paywalls-android) - [Satın alma yapın](android-making-purchases) - [Satın almaları geri yükleyin](android-restore-purchase) 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 ``` :::tip[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:** - [Observer mode genel bakış](observer-vs-full-mode) - [Observer mode'u uygulayın](implement-observer-mode-android) - [Observer mode'da işlemleri bildirin](report-transactions-observer-mode-android) 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 ``` :::tip[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 \{#check-subscription-status\} 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](android-check-subscription-status) LLM'inize gönderin: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/android-check-subscription-status.md ``` :::tip[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 \{#identify-users\} Satın almaların cihazlar arasında kalıcı olması için uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirin. :::important Uygulamanızda kimlik doğrulama yoksa bu adımı atlayın. ::: **Rehber:** [Kullanıcıları tanımlayın](android-quickstart-identify) LLM'inize gönderin: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/android-quickstart-identify.md ``` :::tip[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 \{#prepare-for-release\} 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](release-checklist) LLM'inize gönderin: ``` Read these Adapty docs before releasing: - https://adapty.io/docs/tr/release-checklist.md ``` :::tip[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ı \{#plain-text-doc-index-files\} 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`](https://adapty.io/docs/tr/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](https://llmstxt.org/). Bazı AI agent'ları için (ör. ChatGPT) `llms.txt` dosyasını indirip sohbete dosya olarak yüklemeniz gerekebilir. - [`llms-full.txt`](https://adapty.io/docs/tr/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`](https://adapty.io/docs/tr/android-llms.txt) ve [`android-llms-full.txt`](https://adapty.io/docs/tr/android-llms-full.txt): Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.