Adapty'yi Unity uygulamanıza yapay zeka yardımıyla entegre edin

Bu kılavuz, bir AI kodlama aracıyla Unity uygulamanıza Adapty’yi adım adım entegre etme sürecini anlatır — doğru Adapty dökümanlarını doğru sırayla besleyerek ilerlersiniz.

Başlamadan önce: kontrol paneli kurulumu

Adapty, herhangi bir SDK kodu yazmadan önce kontrol panelinde bazı ayarların yapılmasını gerektirir. Bunu etkileşimli bir LLM aracıyla ya da Kontrol Paneli üzerinden manuel olarak yapabilirsiniz.

Skill yaklaşımı (önerilen)

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 yeterlidir.

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 de dahil olmak üzere her adımda sizi yönlendirecektir.

Kontrol paneli yaklaşımı

Her şeyi manuel olarak yapılandırmayı tercih ediyorsanız, herhangi bir kod yazmadan önce bunlara ihtiyacınız olacak. LLM’niz kontrol paneli değerlerini sizin için arayamaz — bunları kendiniz sağlamanız gerekir.

1. Uygulama mağazalarınızı bağlayın: Adapty Kontrol Paneli’nde App settings → General bölümüne gidin. Unity uygulamanız her iki platformu da hedefliyorsa hem App Store’u hem de Google Play’i bağlayın. Bu, satın alımların çalışması için gereklidir. Uygulama mağazalarını bağlayın

2. Public SDK anahtarınızı kopyalayın: Adapty Kontrol Paneli’nde App settings → General sayfasına gidin, ardından 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 ekle

4. Bir paywall ve placement oluşturun: Adapty Kontrol Paneli’nde Paywalls sayfasında bir paywall oluşturun, ardından bunu Placements sayfasında bir placement’a atayın. Kodda, placement ID’si Adapty.GetPaywall("YOUR_PLACEMENT_ID") çağrısına ilettiğiniz string’dir. Paywall oluştur

5. Access level’ları ayarlayın: Adapty Kontrol Paneli’nde, Products sayfasında ürün bazında yapılandırın. Kodda, profile.AccessLevels["premium"]?.IsActive içinde kontrol edilen string’dir. 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.

Hazır olduğunuzda kurulum

Bunlar kodlamaya başlamak için zorunlu değildir, 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 Dokümanlarını Besleyin

Context7’yi Kullanın (ö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, Adapty kütüphanesine prompt’larınızda referans verin:

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

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

Aşağıdaki uygulama adım adım rehberi’nin her aşamasında, yapıştırabileceğiniz .md bağlantılarıyla birlikte “Send this to your LLM” bloğu yer almaktadır.

Aynı anda daha fazla doküman için aşağıdaki indeks dosyaları ve platforma özel alt kümelerine bakın.

Uygulama adım adım

Bu kılavuzun geri kalanı, Adapty entegrasyonunu uygulama sırasına göre ele alır. Her aşamada LLM’inize gönderebileceğiniz 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), LLM’in herhangi bir kod yazmadan önce hem proje yapınızı hem de Adapty dokümanlarını okuyabilmesi için bunu kullanın.

LLM’inize satın alma işlemleri için hangi yaklaşımı kullandığınızı söyleyin — bu, takip etmesi gereken kılavuzları etkiler:

• Adapty Paywall Builder: Adapty’nin no-code builder’ında paywall’lar oluşturursunuz ve SDK bunları otomatik olarak render eder.
• Manuel 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 Adapty’yi kullanmaya devam edersiniz.
• 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 Unity Package Manager aracılığıyla ekleyin ve Public SDK anahtarınızla etkinleştirin. Bu, temel adımdır — diğer hiçbir şey bu olmadan çalışmaz.

Rehber: 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-unity.md

Paywall’ları göster ve satın almaları yönet

Placement ID’sine göre bir paywall getir, görüntüle ve satın alma olaylarını yönet. İhtiyacınız olan kılavuzlar, satın almaları nasıl yönettiğinize bağlıdır.

Her satın almayı ilerledikçe sandbox’ta test et — sona kadar bekleme. Kurulum talimatları için Sandbox’ta satın alma testi bölümüne bakın.

Read these Adapty docs before writing code:
- https://adapty.io/docs/tr/unity-quickstart-manual.md
- https://adapty.io/docs/tr/fetch-paywalls-and-products-unity.md
- https://adapty.io/docs/tr/present-remote-config-paywalls-unity.md
- https://adapty.io/docs/tr/unity-making-purchases.md
- https://adapty.io/docs/tr/unity-restore-purchase.md

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

Abonelik durumunu kontrol et

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.

Rehber: Abonelik durumunu kontrol et

Bunu LLM’inize gönderin:

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

Kullanıcıları tanımlayın

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

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

Bunu LLM’inize gönderin:

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

Yayına hazırlanın

Entegrasyonunuz sandbox ortamında çalışır hale geldiğinde, her şeyin production’a 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

Düz metin belge dizin dosyaları

LLM’inize tek tek 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: Tüm sayfaları .md bağlantılarıyla listeler. LLM’lerin web sitelerine erişimini kolaylaştırmak için kullanılan gelişmekte olan bir standart. Bazı yapay zeka ajanlarında (ör. ChatGPT) llms.txt dosyasını indirip sohbete yüklemeniz gerekebilir.
• llms-full.txt: Tüm Adapty dokümantasyon sitesini tek bir dosyada birleştirir. Çok büyük bir dosya; yalnızca tam resme ihtiyaç duyduğunuzda kullanın.
• Unity’e özel unity-llms.txt ve unity-llms-full.txt: Tam siteye kıyasla token tasarrufu sağlayan platforma özgü alt kümeler.