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

Adapty CLI, uygulama yapılandırmanızı tamamen komut satırından yapmanıza olanak tanır. Terminal araçlarını tercih ediyorsanız veya MCP istemcileri kullanıyorsanız, kontrol paneli hızlı başlangıcı yerine bunu kullanabilirsiniz.

İşlem sonunda uygulamanız, access level’ınız, ürününüz, flow veya paywall’ınız ve placement’ınız Adapty Kontrol Paneli’nde görünür hale gelir.

Claude Cowork’te CLI’ı çalıştırıyorsanız, önce Claude’da kurulum yapın — bkz. Claude Cowork’te Adapty CLI’ı kurma.

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 flow veya paywall oluşturun

Her ürün, uygulamanızda görünmeden önce bir flow veya paywall içinde yer almalıdır. Birini seçin:

• Bir flow, Flow & Paywall Builder’da tasarladığınız ve Adapty SDK’nın cihazda yerli olarak render ettiği tek bir ekran veya ekran dizisidir: bir paywall ekranı, onboarding, bir quiz. Satın alma ekranını Adapty’nin render etmesini istediğinizde flow seçin. Flow’lar Adapty SDK 4.0 veya üzerini gerektirir.
• Bir paywall, tasarım eklenmemiş bir ürünler kümesidir. Satın alma ekranını kendi uygulama kodunuzda render ediyor ve Adapty’den yalnızca ürünleri, isteğe bağlı olarak bir remote config ile birlikte almanız gerekiyorsa paywall seçin.

Bir placement yalnızca tek bir içerik türüne hizmet eder, bu nedenle 7. adımdan önce karar verin.

6a. Flow oluşturma

CLI, flow kaydını oluşturur. Ekranları, CLI’nin üretmediği bir builder config (JSON belgesi) içinde bulunur. Config’i terminalden oluşturmak için sizin adınıza CLI’yi yöneten flow-generator skill’i kullanabilirsiniz.

Flow’u oluşturun:

adapty flows create --app <app-id> --name "Onboarding"

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

Ekranlarını flow-generator skill ile veya Flow & Paywall Builder’da oluşturun. Her iki durumda da sonuç, kullanıcılarınızın henüz görmediği kayıtlı bir taslaktır.

Flow’u yayınlayın:

adapty flows publish --app <app-id> <flow-id>

Komut onay ister. Yayınlama arka planda gerçekleşir; bu nedenle published durumuna gelene kadar adapty flows get --app <app-id> <flow-id> komutuyla durumu kontrol edin. publication_failed durumunda flows config get nedeni raporlar. Bir placement yalnızca yayınlanmış bir flow’u kabul eder.

6b. Paywall oluşturma

Paywall, ürünlerinizi barındıran kapsayıcıdır.

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 bir flow veya paywall gösterdiğiniz noktadır. Uygulama kodunuza sabit olarak yalnızca placement ID’sini yazmanız yeterlidir. Hangi flow veya paywall’ın hangi kullanıcılara gösterileceği ise yeni bir uygulama sürümü yayınlamadan kontrol panelinden yönetilir.

--developer-id, Adapty’ye bu noktada ne görüntüleneceğini sorduğunuzda uygulama kodunuzda referans alacağınız dizedir. "main", "onboarding" veya "settings" gibi konumu tanımlayan bir şey seçin.

adapty placements create --app <app-id> --title "Onboarding" --developer-id "onboarding" --audiences '[{"content_type":"flow","segment_ids":[],"flow_id":"<flow-id>","priority":0}]'

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

--audiences bayrağı, hangi flow veya paywall’ın hangi kullanıcılara gösterileceğini belirler. Yukarıdaki örnekler tek bir varsayılan kitle tanımlar: bu placement’taki tüm kullanıcılar aynı içeriği görür. Bir placement yalnızca tek bir içerik türüne hizmet eder, bu nedenle her kitle girişi aynı content_type değerini taşımalıdır. Segmente göre hedefleme için komut referansındaki Audiences shape bölümüne bakın.

Sonraki adımlar

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

• Bir flow’u sonradan değiştirmek — değişikliği flow-generator skill’e açıklayın ya da flow’u Flow & Paywall Builder’da açın.
• Uygulamanızda bir paywall oluşturmak — SDK ile paywall ve ürünleri getirin, ardından ekranı kendi kodunuzla oluşturun.
• Adapty SDK’yı entegre etmek — placement’ı çekip görüntülemek için SDK’yı uygulamanıza ekleyin.
• Farklı kullanıcı segmentlerini farklı flow’lara veya paywall’lara yönlendirmek — komut referansındaki placements update ve segments list sayfalarına bakın.