Adapty Developer CLI için hızlı başlangıç kılavuzu

Bir yapay zeka asistanı mı kullanıyorsunuz? LLM’lerin CLI ile çalışmasına yardımcı olmak için bir Adapty CLI skill mevcuttur.

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.

Adapty’yi App Store Connect ve Google Play’e bağlamak, kontrol panelinde tek seferlik bir kurulum gerektiriyor — bu işlem 3. adımda ele alınıyor.

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.

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.

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

Devam etmeden önce uygulamanızı Adapty kontrol panelinden App Store Connect ve Google Play’e bağlayın. Her iki mağazadaki ürün ID’leri 5. adımda gereklidir.

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.

  1. adımı atladıysanız, <access-level-id> olarak 3. adımdaki apps create komutunun döndürdüğü default_access_level.id değerini kullanın.

Burada bağladığınız mağaza ürün ID’leri (--ios-product-id, --android-product-id) oluşturulduktan sonra değiştirilemez. Farklı mağaza ürün ID’leri kullanmak için yeni bir ürün oluşturmanız gerekir.

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

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.

Bir paywall bir placement’a bağlandıktan sonra ürünleri değiştirilemez. Farklı ürünler kullanmak için yeni bir paywall oluşturun ve placement’ı bu yeni paywall’a işaret edecek şekilde güncelleyin.

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.

Sırada ne var

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