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

Bu rehber, bir yapay zeka kodlama aracı yardımıyla Adapty’yi iOS uygulamanıza adım adım entegre etmenizi sağlar — doğru Adapty dokümanlarını doğru sırayla besleyerek ilerlersiniz.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce kontrol panelinde bazı yapılandırmalar gerektiriyor. Bunu etkileşimli bir LLM becerisiyle ya da kontrol paneli üzerinden manuel olarak yapabilirsiniz.

Beceri yaklaşımı (önerilen)

Adapty CLI becerisi, LLM’inizin uygulamanızı, ürünlerinizi, access level’ları, paywall’ları ve placement’ları doğrudan kurmasını sağlar — her adım için kontrol panelini açmanıza gerek kalmaz. Yalnızca mağazanızı bağlamanız gerekir.

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

Beceri eklendikten sonra agent’ınızda /adapty-cli komutunu çalıştırın. Mağazanızı bağlamak için kontrol panelini açmanız gereken anlar dahil her adımda 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 için bulamaz — bunları kendiniz sağlamanız gerekir.

Uygulama mağazanızı bağlayın: Adapty Kontrol Paneli’nde App settings → General sayfasına gidin. Satın almaların çalışması için bu zorunludur. App Store’u bağlayın
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.activate("YOUR_PUBLIC_SDK_KEY") çağrısına geçirdiğiniz dizedir.
En az bir ürün oluşturun: Adapty Kontrol Paneli’nde Products sayfasına gidin. Ürünlere koddan doğrudan başvurmazsınız — Adapty bunları flow’lar veya paywall’lar aracılığıyla iletir. Ürün ekleyin
Bir flow veya paywall ve bir placement oluşturun: Adapty Kontrol Paneli’nde bir flow (ya da kullanıcı arayüzünü kendiniz oluşturacaksanız bir paywall) oluşturun, ardından Placements sayfasında bir placement’a atayın. Kodda, placement ID’si Adapty.getFlow("YOUR_PLACEMENT_ID") fonksiyonuna geçirdiğiniz string değerdir. Flow oluşturun
Access level’ları ayarlayın: Adapty Kontrol Paneli’nde Products sayfasındaki her ürün için yapılandırın. Kodda profile.accessLevels["premium"] içinde kontrol edilen dizedir. 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), kod yazmaya başlamadan önce ek access level’lar oluşturun.

Bu beşini tamamladığınızda 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 yapılandırın

Kodlamaya başlamak için bunlar zorunlu değil, ancak entegrasyonunuz olgunlaştıkça ihtiyacınız olacak:

A/B testleri: Placements sayfasından yapılandırın. Kod değişikliği gerekmez. A/B testleri
Ek flow’lar ve placement’lar: Farklı placement ID’leriyle daha fazla getFlow ç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 kullanın (önerilen)

Context7, LLM’inize güncel Adapty dokümantasyonuna doğrudan erişim sağlayan bir MCP sunucusudur. LLM’iniz, ne sorduğunuza göre doğru dokümanları otomatik olarak getirir — manuel URL yapıştırmaya gerek kalmaz.

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 iOS 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 adımlarını 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 düğmesine tıklayın. Örnek: adapty-cursor.md.

Aşağıdaki uygulama adımlarının her biri, yapıştırabileceğiniz .md bağlantılarıyla bir “LLM’inize gönderin” bloğu içerir.

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

Uygulama adımları

Bu kılavuzun 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 atlamadan ö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), kod yazmadan önce LLM’in 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, hangi kılavuzları takip etmesi gerektiğini etkiler:

Adapty Flow Builder: Flow’ları Adapty’nin no-code builder’ında oluşturursunuz; SDK bunları otomatik olarak render eder.
Manuel oluşturulan paywalllar: Kendi paywall arayüzünüzü kodla inşa edersiniz, ancak ürünleri getirmek ve satın almaları yönetmek için Adapty’yi 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

Adapty SDK paketini Xcode’da Swift Package Manager aracılığıyla yükleyin ve Public SDK anahtarınızla etkinleştirin. Bu temeldir — bunu yapmadan hiçbir şey çalışmaz.

Kılavuz: 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-ios.md

Kontrol noktası

Beklenen: Uygulama derlenir ve çalışır. Xcode konsolu Adapty aktivasyon logunu gösterir.
Dikkat: “Public API key is missing” hatası → placeholder’ı App settings’deki gerçek anahtarınızla değiştirdiğinizi doğrulayın.

Flow veya paywall gösterme ve satın alma işlemlerini yönetme

Placement ID’ye göre bir flow veya paywall getirin, görüntüleyin ve satın alma olaylarını yönetin. İhtiyacınız olan kılavuzlar, satın alma işlemlerini nasıl yönettiğinize bağlıdır.

Her satın almayı ilerlerken sandbox’ta test edin — sona bırakmayın. Kurulum talimatları için Sandbox’ta satın alma testi bölümüne bakın.

Kılavuzlar:

Flow Builder ile satın almaları etkinleştirin (hızlı başlangıç)
Flow’ları ve yapılandırmalarını alın
Flow’ları görüntüleyin
Flow olaylarını yönetin
Buton eylemlerine yanıt verin Bu metni LLM’inize gönderin:

Kod yazmadan önce şu Adapty dokümanlarını okuyun:
- https://adapty.io/docs/tr/ios-quickstart-paywalls.md
- https://adapty.io/docs/tr/get-pb-paywalls.md
- https://adapty.io/docs/tr/ios-present-paywalls.md
- https://adapty.io/docs/tr/ios-handling-events.md
- https://adapty.io/docs/tr/handle-paywall-actions.md

Kontrol Noktası

Beklenen: Flow, 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ş flow veya getFlow hatası → placement ID’nin kontrol panelindekiyle birebir eşleştiğini ve placement’a bir kitle atandığını doğrulayın.

Abonelik durumunu kontrol edin

Satın alma işleminin ardından premium içeriği kısıtlamak için kullanıcı profilinde aktif bir access level olup olmadığını kontrol edin.

Kılavuz: Abonelik durumunu kontrol edin

LLM’inize gönderin:

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/ios-check-subscription-status.md

Kontrol noktası

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

Kullanıcıları tanımlayın

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

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

Kılavuz: Kullanıcıları tanımlayın

LLM’inize gönderin:

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

Kontrol noktası

Beklenen: Adapty.identify("your-user-id") çağrısının ardından kontrol paneli Profiles bölümü özel kullanıcı ID’nizi gösterir.
Dikkat: Anonim profil attribution sorunlarından kaçınmak için identify’ı aktivasyondan sonra ama paywall’ları çekmeden önce çağırın.

Yayına hazırlanın

Entegrasyonunuz sandbox’ta çalışır hale geldiğinde, her şeyin üretime hazır olduğundan emin olmak için yayın kontrol listesini adım adım geçin.

Kılavuz: 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 maddeleri onaylandı: mağaza bağlantısı, sunucu bildirimleri, satın alma akışı, access level kontrolleri ve gizlilik gereksinimleri.
Dikkat: App Store Server Notifications eksik → bunları App settings → iOS SDK bölümünden yapılandırın; aksi halde olaylar kontrol panelinde görünmez.

Düz metin doküman dizin dosyaları

LLM’inize tek tek sayfaların ötesinde daha geniş bir bağlam vermeniz gerekirse, tüm Adapty dokümantasyonunu listeleyen veya birleştiren dizin dosyaları sunuyoruz:

llms.txt: .md bağlantılarıyla tüm sayfaları listeler. Web sitelerini LLM’lere erişilebilir kılmaya yönelik gelişmekte olan bir standart. Bazı AI agent’lar (örn. ChatGPT) için llms.txt dosyasını indirip sohbete yüklemeniz gerekebilir.
llms-full.txt: Tüm Adapty dokümantasyon sitesi tek bir dosyada birleştirilmiş hali. Çok büyüktür — yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
iOS’a özgü ios-llms.txt ve ios-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.