Adapty Geliştirici CLI için Hızlı Başlangıç kılavuzu

Adapty CLI, uygulama yapılandırmanızı tamamen komut satırından kurmanızı sağlar. Terminal araçlarını veya MCP istemcilerini tercih ediyorsanız kontrol paneli hızlı başlangıcı yerine bunu kullanabilirsiniz.

Tüm adımların sonunda uygulamanız, access level’ınız, ürününüz, paywall’unuz ve placement’ınız Adapty kontrol panelinde görünür hale gelecek. CLI’ı Claude Cowork’te çalıştırıyorsanız, başlamadan önce Adapty domainlerine izin verin — bkz. CLI’ı Cowork’te Çalıştırma.

1. CLI’ı yükleyin

Node.js 18 veya üzeri gereklidir.

CLI’ı yüklemek için şu komutu çalıştırın:

npm install -g adapty

Ya da doğrudan:

npx adapty auth login

2. Kimlik doğrulaması yapın

CLI’ı Adapty hesabınıza bağlamak için giriş komutunu çalıştırın.

adapty auth login

CLI bir tarayıcı sekmesi açar. Terminalde gösterilen kodu tarayıcıda gösterilen kodla eşleştirin, ardından Authorize butonuna tıklayın. Kimlik doğrulama tamamlandığında terminal bunu onaylar.

3. Uygulamanızı oluşturun

Adapty’deki bir uygulama, mobil uygulamanızı temsil eder. Tek bir Adapty uygulaması hem App Store hem de Google Play’e bağlanır — kaç mağazada yayın yaptığınızdan bağımsız olarak yalnızca bir tane oluşturmanız yeterlidir.

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

Komut bir <app-id> döndürür. Bu ID’yi sonraki tüm komutlarda kullanın.

4. Bir access level oluşturun (isteğe bağlı)

Access level’lar, kullanıcıların satın alma sonrasında neye erişebileceğini kontrol eder. Uygulamanız, kullanıcının belirli bir ürün satın alıp almadığını kontrol etmek yerine kullanıcının belirli bir access level’a sahip olup olmadığını kontrol eder. Bu sayede uygulama mantığınız belirli ürün ID’lerinden bağımsız hale gelir.

Her yeni uygulamayla birlikte otomatik olarak bir premium access level oluşturulur. Çoğu uygulama için bu adımı atlayabilirsiniz. 5. adımda access level ID olarak premium kullanın.

Bu komutu yalnızca farklı ürünler farklı kullanıcı grupları için farklı özelliklerin kilidini açıyorsa çalıştırın — örneğin “Basic” ve “Pro” abonelerinin uygulamanın farklı bölümlerine eriştiği durumlarda.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id, uygulama kodunuzda bir özelliğin kullanıcıya sunulup sunulmayacağını kontrol etmek için kullanacağınız tanımlayıcıdır (örneğin if user.hasAccessLevel("pro")). Bu adımı atlayıp varsayılan access level’ı kullanırsanız --sdk-id değeri premium olacaktır.
• --title, Adapty kontrol panelinde kendi referansınız için görünen bir etikettir.

Komut bir <access-level-id> döndürür.

5. Bir ürün oluşturun

Adapty’de bir ürün, uygulamanızın sattığı her şeyi temsil eder — bir abonelik veya tek seferlik satın alma. App Store Connect ve Google Play’deki öğeler tek bir Adapty ürünü altında gruplanabilir ve tek bir yerden yönetilebilir.

Her mağazadaki ürün ID’lerine ihtiyacınız olacak: App Store Connect’ten Apple ürün ID’si, Google Play Console’dan ise Android ürün ID’si ve base plan ID’si. Bunları nerede bulacağınızla ilgili ayrıntılar için Ürünler sayfasına bakın.

4. adımı atladıysanız, 3. adımda apps create komutu tarafından döndürülen default_access_level.id değerini <access-level-id> olarak kullanın.

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

Bu komut bir <product-id> döndürür.

Bu ürünü web üzerinden Stripe veya Paddle aracılığıyla da satıyorsanız, söz konusu ID’leri aynı komuta ekleyin. Komut referansındaki products create bölümüne bakın.

6. Bir paywall oluşturun

Paywall, ürünlerinizi barındıran kapsayıcıdır. Adapty’de paywall’lar, ürünleri kullanıcılara iletmenin tek yoludur. Her ürünün uygulamanızda görünebilmesi için bir paywall içinde olması gerekir.

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

Komut bir <paywall-id> döndürür.

7. Bir placement oluşturun

Placement, uygulamanızda paywall gösterdiğiniz noktadır. Uygulama kodunuzda sabit olarak tanımladığınız tek şey placement ID’sidir. Geri kalanı — hangi paywall’ın hangi kullanıcılara gösterileceği — yeni bir uygulama sürümü yayınlamadan kontrol panelinden yönetilir.

--developer-id, bu noktada hangi paywall’ın görüntüleneceğini Adapty’den sorgularken uygulama kodunuzda referans olarak kullanacağınız dizedir. Konumu tanımlayan bir şey seçin: "main", "onboarding" veya "settings" gibi.

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

--audiences bayrağı, hangi kullanıcıya hangi paywall’ın gösterileceğini belirler. Yukarıdaki örnekte tek bir varsayılan kitle tanımlanmıştır — bu placement’taki tüm kullanıcılar aynı paywall’ı görür.

CLI’yi Cowork’te Çalıştırma

Claude Cowork, komutları yalnızca izin verilen domainlere ulaşabilen bir sandbox içinde çalıştırır. Adapty’yi izin listesine eklemeden CLI giriş yapamaz veya hesabınızı okuyamaz. CLI’yi kendi terminalinizden çalıştırıyorsanız bu bölümü atlayın.

Hem adapty.io hem de *.adapty.io adreslerine izin verin. Çoğu izin listesi uygulamasında wildcard, apex domain’i kapsamaz. CLI’nin kendisi api.adapty.io adresine ulaşır; çalışırken Adapty dokümantasyonunu okuyan bir agent ise apex domain’e erişir.

Cowork, görev başladığında bu ayarları uygular. Bir konuşma sırasında erişim modunu değiştirirseniz veya domain eklerseniz, o konuşma başladığı andaki ayarlarla devam eder — yeni bir görev başlatmanız gerekir.

Her görev temiz bir makinede başlar: önceki oturumdan CLI, token veya yapılandırma aktarılmaz; bu nedenle kurulum ve giriş adımları her seferinde tekrarlanır.

Kişisel hesaplar

İzin listesini kendiniz ayarlarsınız:

1. Claude’da Settings → Capabilities bölümünü açın.
2. Code execution and file creation seçeneğini açın. Allow network egress bloğu bunu yapana kadar gizli kalır.
3. Allow network egress seçeneğini açın.
4. Domain allowlist bölümünde Package managers only seçeneğini belirleyin.
5. Additional allowed domains altına adapty.io ekleyin, ardından *.adapty.io ekleyin.

Diğer erişim modu olan All domains, sandbox’ın herhangi bir siteye ulaşmasına izin verir. Bu seçenek seçiliyken Adapty domain’lerini hiç eklemeniz gerekmez.

Kurumsal çalışma alanları

Allowlist’i bir yönetici kontrol eder. Her iki alan adını da çalışma alanına eklemeleri için onlarla iletişime geçin.

Sırada ne var

Tüm varlıklar artık Adapty Kontrol Paneli’nde görünür. Sıradakiler:

• Paywall’unuzu tasarlayın — az önce oluşturduğunuz paywall’a görseller, düzen ve metin eklemek için no-code Paywall Builder’ı kullanın.
• Adapty SDK’yı entegre edin — placement’ı getirmek ve görüntülemek için uygulamanıza SDK’yı ekleyin.
• Farklı kullanıcı segmentlerini farklı paywall’lara yönlendirin — komut referansındaki placements update ve segments list bölümlerine bakın.