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 kontrol paneli hızlı başlangıç rehberine alternatif olarak kullanabilirsiniz. Adapty eklentisine sahip bir yapay zeka kodlama ajanı da CLI’ı sizin adınıza çalıştırabilir.

İşlem tamamlandığında uygulamanız, access level’ınız, ürününüz, flow veya paywall’ınız ve placement’ınız Adapty kontrol panelinde görünür hale gelir.

Claude uygulamasında (eski adıyla Claude Cowork) CLI’yi çalıştırıyorsanız, önce Claude’da kurulumu yapın — bkz. Claude uygulamasında Adapty CLI’yi 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>

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. Daha fazla bilgi için komut referansındaki products create sayfasına bakın.

Ürünün Google Play’de ücretsiz deneme süresi veya indirimi, ya da App Store’da promosyon teklifi veya geri kazanma teklifi varsa, Adapty’nin bunu uygulayabilmesi için teklifi ürüne bağlayın. Daha fazla bilgi için komut referansındaki product-offers create sayfasına 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ımla:

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

Komut onay ister. Yayımlama arka planda çalışır; published durumunu görene kadar adapty flows get --app <app-id> <flow-id> komutuyla durumu kontrol et. publication_failed durumunda, flows config get nedenini bildirir. Bir placement yalnızca yayımlanmış 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" --products '[{"product_id":"<product-id>"}]'

adapty paywalls create --app <app-id> --title "My Paywall" --products '[{"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 kullanıcıya hangi flow veya paywall’ın gösterileceğini kontrol eder. Yukarıdaki örnekler tek bir varsayılan kitle ayarlar: bu placement’taki her kullanıcı aynı içeriği görür. Bir placement yalnızca tek bir içerik türüne hizmet eder: paywall placement’ı paywall girdileri alır, flow placement’ı ise flow girdileri alı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ştirin — değişikliği flow-generator skill’ine açıklayın ya da flow’u Flow & Paywall Builder’da açın.
• Uygulamanızda bir paywall render edin — SDK ile paywall’u ve ürünlerini çekin ve ekranı kendi kodunuzla oluşturun.
• Adapty SDK’yı entegre edin — placement’ı çekip görüntülemek için SDK’yı uygulamanıza ekleyin.
• Farklı kullanıcı segmentlerini farklı flow’lara veya paywall’lara yönlendirin — komut referansındaki placements update ve segments list bölümlerine bakın.