--- title: "Adapty'yi Flutter uygulamanıza yapay zeka yardımıyla entegre edin" description: "Cursor, Context7, ChatGPT, Claude veya diğer yapay zeka araçlarını kullanarak Adapty'yi Flutter uygulamanıza adım adım entegre etme kılavuzu." --- Bu sayfa, Adapty'yi Flutter 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ğıdaki adım adım kılavuzu takip edin. ## SDK entegrasyon becerisini kullanın (beta) \{#use-the-sdk-integration-skill-beta\} [adapty-sdk-integration skill](https://github.com/adaptyteam/adapty-sdk-integration-skill), entegrasyon sürecini 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ım adım rehberi yedek olarak kullanabilirsiniz. **Desteklenen araçlar**: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI. ### Kurulum \{#install\} Aracınıza uygun formu seçin. Tam liste [skill README](https://github.com/adaptyteam/adapty-sdk-integration-skill) sayfasındadı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 \{#run\} 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 yüklemesi, paywall ve doğrulama aşamalarını tek tek ele alır; her aşamada ilgili Adapty dokümanlarını getirir. :::note Skill beta aşamasındadır. Takılı kalır ya da beklenmedik şekilde davranırsa, aşağıdaki manuel rehber her aşamayı adım adım kapsamaktadır. ::: ## Başlamadan önce: kontrol paneli kurulumu \{#before-you-start-dashboard-setup\} Adapty, herhangi bir SDK kodu yazmadan önce bazı kontrol paneli ayarlarının yapılmasını gerektirir. Bunu etkileşimli bir LLM aracıyla ya da Kontrol Paneli üzerinden manuel olarak yapabilirsiniz. ### Skill yaklaşımı (önerilen) \{#skill-approach-recommended\} 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 kurmasını sağlar — her adım için kontrol panelini açmanıza gerek kalmaz. Yalnızca kontrol panelinde [mağazalarınızı bağlamanız](integrate-payments) gerekir. ``` npx skills add adaptyteam/adapty-cli --skill adapty-cli ``` Skill 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ı \{#dashboard-approach\} Her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, herhangi bir kod yazmadan önce ihtiyacınız olanlar burada. LLM'niz 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. Flutter uygulamanız her iki platformu da hedefliyorsa hem App Store'u hem de Google Play'i bağlayın. Bu, satın alma işlemlerinin çalışması için zorunludur. [Uygulama mağazalarını bağlayın](integrate-payments) 2. **Genel SDK anahtarınızı kopyalayın**: Adapty Kontrol Paneli'nde **App settings → General** bölümüne gidin ve **API keys** kısmını bulun. Kodda bu, Adapty yapılandırmasına geçirdiğiniz metindir. 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 onları paywall'lar aracılığıyla iletir. [Ürün ekle](quickstart-products) 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()` fonksiyonuna geçirdiğiniz string'dir. [Paywall oluşturun](quickstart-paywalls) 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'e bakın. 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](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'im Y" — böylece doğru başlatma ve paywall getirme kodunu üretebilir. ::: ### Hazır olduğunuzda kurulum \{#set-up-when-ready\} Kodlamaya başlamak için bunlar zorunlu değil, ancak entegrasyonunuz olgunlaştıkça ihtiyaç duyacaksınız: - **A/B testleri**: **Placements** sayfasında 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ında yapılandırın. Kurulum entegrasyona göre değişir. Bkz. [analitik entegrasyonları](analytics-integration) ve [attribution entegrasyonları](attribution-integration). ## LLM'nize Adapty Dokümanlarını Besleyin \{#feed-adapty-docs-to-your-llm\} ### Context7 Kullanın (önerilen) \{#use-context7-recommended\} [Context7](https://context7.com), 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 — URL yapıştırmaya gerek yok. 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](https://github.com/upstash/context7) bakın. Yapılandırıldıktan sonra, Adapty kütüphanesine promptlarınızda başvurun: ``` Use the adaptyteam/adapty-docs library to look up how to install the Flutter 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ımlarını](#implementation-walkthrough) sırayla takip edin. ::: ### Düz metin doküman kullanımı \{#use-plain-text-docs\} Adapty dokümanlarının herhangi birine 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-flutter.md](https://adapty.io/docs/tr/adapty-cursor-flutter.md). Aşağıdaki [uygulama adım adım kılavuzundaki](#implementation-walkthrough) her aşama, yapıştırabileceğiniz `.md` bağlantılarıyla birlikte "Send this to your LLM" bloğu içerir. Daha fazla dokümanı aynı anda görmek için aşağıdaki [dizin dosyalarına ve platforma özgü alt kümelere](#plain-text-doc-index-files) bakın. ## Uygulama adım adım rehberi \{#implementation-walkthrough\} Bu rehberin geri kalanı, Adapty entegrasyonunu uygulama sırasına göre ele alır. Her aşamada LLM'inize gönderebileceğiniz belgeler, 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 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 almalar için hangi yaklaşımı kullandığınızı söyleyin — bu, takip etmesi gereken kılavuzları etkiler: - [**Adapty Paywall Builder**](adapty-paywall-builder): Adapty'nin kodsuz oluşturucusunda paywall'lar oluşturursunuz; SDK bunları otomatik olarak render eder. - [**Manuel olarak oluşturulan paywall'lar**](flutter-making-purchases): Kendi paywall arayüzünüzü kodla oluşturursunuz, ancak ürünleri getirmek ve satın alma işlemlerini yönetmek için yine Adapty'yi kullanırsınız. - [**Observer modu**](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](flutter-quickstart-paywalls) inceleyin. ### SDK'yı Yükleyin ve Yapılandırın \{#install-and-configure-the-sdk\} `flutter pub add` komutunu kullanarak Adapty SDK bağımlılığını ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu temel adımdır — diğer hiçbir şey bunu yapmadan çalışmaz. **Rehber:** [Adapty SDK'yı Yükleyin ve Yapılandırın](sdk-installation-flutter) Bunu LLM'inize gönderin: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/sdk-installation-flutter.md ``` :::tip[Checkpoint] - **Beklenen:** Uygulama hem iOS hem Android'de derleniyor ve çalışıyor. Debug konsolunda Adapty aktivasyon logu görünüyor. - **Dikkat:** "Public API key is missing" → **App settings** kısmından aldığın gerçek anahtarı placeholder'ın yerine koyduğundan emin ol. ::: ### Paywall'ları göster ve satın almaları yönet \{#show-paywalls-and-handle-purchases\} Bir paywall'ı placement ID ile çek, göster ve satın alma olaylarını yönet. İhtiyaç duyacağın kılavuzlar, satın almaları nasıl ele aldığına göre değişir. Her satın almayı süreç içinde sandbox'ta test et — sonuna bırakma. Kurulum talimatları için [Sandbox'ta satın alma testi](test-purchases-in-sandbox) sayfasına bak. **Kılavuzlar:** - [Paywall'ları kullanarak satın almaları etkinleştirin (hızlı başlangıç)](flutter-quickstart-paywalls) - [Paywall Builder paywall'larını ve yapılandırmalarını getirin](flutter-get-pb-paywalls) - [Paywall'ları görüntüleyin](flutter-present-paywalls) - [Paywall olaylarını yönetin](flutter-handling-events) - [Buton eylemlerine yanıt verin](flutter-handle-paywall-actions) Bu bir MDX belge çevirisi değil — bu, bir LLM'e gönderilmek üzere hazırlanmış ham bir istem (prompt) metnidir ve çevrilecek MDX içeriği bulunmamaktadır. Lütfen çevirmemi istediğiniz MDX belgesini paylaşın, size yardımcı olmaktan memnuniyet duyarım. :::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 iletişim kutusunu tetikler. - **Dikkat:** Boş paywall veya `getPaywall` hatası → placement ID'nin kontrol paneliyle birebir eşleştiğini ve placement'a bir kitle atandığını doğrulayın. ::: **Kılavuzlar:** - [Özel paywallınızda satın almaları etkinleştirme (hızlı başlangıç)](flutter-quickstart-manual) - [Paywall ve ürünleri getirme](fetch-paywalls-and-products-flutter) - [Remote config ile tasarlanan paywallı render etme](present-remote-config-paywalls-flutter) - [Satın alma yapma](flutter-making-purchases) - [Satın almaları geri yükleme](flutter-restore-purchase) ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/flutter-quickstart-manual.md - https://adapty.io/docs/tr/fetch-paywalls-and-products-flutter.md - https://adapty.io/docs/tr/present-remote-config-paywalls-flutter.md - https://adapty.io/docs/tr/flutter-making-purchases.md - https://adapty.io/docs/tr/flutter-restore-purchase.md ``` :::tip[Checkpoint] - **Beklenen:** Özel paywallınız Adapty'den çekilen ürünleri gösteriyor. Bir ürüne tıklamak sandbox satın alma diyaloğunu tetikliyor. - **Dikkat:** Boş ürünler dizisi → paywallın kontrol panelinde kendisine atanmış ürünleri olduğunu ve placement'ın bir kitleye sahip olduğunu doğrulayın. ::: **Kılavuzlar:** - [Observer mode'a genel bakış](observer-vs-full-mode) - [Observer mode'u uygulama](implement-observer-mode-flutter) - [Observer mode'da işlemleri raporlama](report-transactions-observer-mode-flutter) :::tip[Kontrol Noktası] - **Beklenen:** Mevcut satın alma akışınızı kullanarak sandbox ortamında yapılan bir satın alma işleminin ardından, işlem Adapty Kontrol Paneli **Event Feed** bölümünde görünür. - **Dikkat:** Hiç olay yoksa → işlemleri Adapty'e raporladığınızı ve her iki mağaza için sunucu bildirimlerinin yapılandırıldığını doğrulayın. ::: ### Abonelik durumunu kontrol etme \{#check-subscription-status\} Bir satın alma işleminin ardından, premium içeriğe erişimi kısıtlamak için kullanıcı profilindeki aktif access level'ı kontrol edin. **Rehber:** [Abonelik durumunu kontrol etme](flutter-check-subscription-status) Bunu LLM'inize gönderin: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/flutter-check-subscription-status.md ``` :::tip[Kontrol noktası] - **Beklenen:** Bir sandbox satın alma işleminin ardından `profile.accessLevels['premium']?.isActive` değeri `true` döner. - **Dikkat:** Satın alma sonrası `accessLevels` boş geliyor → kontrol panelinde ürüne bir access level atanıp atanmadığını kontrol edin. ::: ### Kullanıcıları tanımlayın \{#identify-users\} Uygulama kullanıcı hesaplarınızı Adapty profilleriyle ilişkilendirerek satın almaların cihazlar arasında kalıcı olmasını sağlayın. :::important Uygulamanızda kimlik doğrulama yoksa bu adımı atlayın. ::: **Kılavuz:** [Kullanıcıları tanımlayın](flutter-quickstart-identify) Bunu LLM'inize gönderin: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/tr/flutter-quickstart-identify.md ``` :::tip[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 sorununu önlemek için `identify` fonksiyonunu aktivasyondan sonra, paywall'ları çekmeden önce çağırın. ::: ### Yayına hazırlanma \{#prepare-for-release\} Entegrasyonunuz sandbox ortamında düzgün çalışıyorsa, her şeyin üretime hazır olduğundan emin olmak için yayın kontrol listesini gözden geçirin. **Kılavuz:** [Yayın kontrol listesi](release-checklist) Bunu 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 maddeleri onaylandı: mağaza bağlantıları, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri. - **Dikkat:** Sunucu bildirimleri eksikse → 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ı \{#plain-text-doc-index-files\} LLM'nize bireysel sayfaların ötesinde daha geniş bir bağlam sağlamanız gerekiyorsa, tüm Adapty belgelerini listeleyen veya birleştiren dizin dosyaları sunuyoruz: - [`llms.txt`](https://adapty.io/docs/tr/llms.txt): `.md` bağlantılarıyla tüm sayfaları listeler. LLM'lerin web sitelerine erişimini kolaylaştırmak için [gelişmekte olan bir standart](https://llmstxt.org/). Bazı yapay zeka ajanlarında (ör. ChatGPT) `llms.txt` dosyasını indirip sohbete yüklemeniz gerekebilir. - [`llms-full.txt`](https://adapty.io/docs/tr/llms-full.txt): Tüm Adapty dokümantasyon sitesini tek bir dosyada birleştirir. Oldukça büyük — yalnızca tam resme ihtiyaç duyduğunuzda kullanın. - Flutter'a özel [`flutter-llms.txt`](https://adapty.io/docs/tr/flutter-llms.txt) ve [`flutter-llms-full.txt`](https://adapty.io/docs/tr/flutter-llms-full.txt): Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.