Adapty Geliştirici CLI için komut referansı

Bu makale, hesabınızı yapılandıran Adapty CLI komutlarını listeler — uygulamalar, access level’lar, ürünler, paywalllar, placementlar ve segmentler — argümanları, bayrakları ve kabul edilen değerleriyle birlikte. Apple Ads kampanyaları için Ads Manager komutları bölümüne bakın.

Kimlik doğrulama kurulumu ve token yönetimi için bkz. Kimlik doğrulama.

Global bayraklar

Bu bayraklar tüm komutlarda kullanılabilir.

Bayrak	Açıklama
`--json`	Biçimlendirilmiş metin yerine JSON olarak çıktı verir
`--help`	Komut yardımını gösterir

Tüm list komutları ayrıca sayfalama bayraklarını da kabul eder:

Bayrak	Varsayılan	Açıklama
`--page`	`1`	Sayfa numarası
`--page-size`	`20`	Sayfa başına öğe sayısı (maks: 100)

Uygulamalar

Adapty hesabınızdaki uygulamaları yönetin. Kontrol paneli tabanlı yapılandırma için bkz. Uygulama ayarları.

adapty apps list

Adapty hesabınızdaki tüm uygulamaları listeler.

adapty apps list

Sayfalama bayraklarını kabul eder.

adapty apps get

Belirli bir uygulama için ayrıntıları getirir.

adapty apps get <app-id>

Argüman	Açıklama
`app-id`	Uygulama ID’si (UUID)

adapty apps create

Yeni bir uygulama oluşturur.

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

Bayrak	Zorunlu	Açıklama
`--title`	Evet	Uygulama başlığı
`--platform`	Evet	Platform: `ios` veya `android`. İkisi için tekrarlayın: `--platform ios --platform android`
`--apple-bundle-id`	`--platform ios` ile zorunlu	Apple bundle ID
`--google-bundle-id`	`--platform android` ile zorunlu	Google bundle ID

adapty apps update

Mevcut bir uygulamayı günceller.

adapty apps update <app-id> --title "New Name"

Argüman	Açıklama
`app-id`	Uygulama ID’si (UUID)

Bayrak	Açıklama
`--title`	Yeni uygulama başlığı
`--apple-bundle-id`	Yeni Apple bundle ID
`--google-bundle-id`	Yeni Google bundle ID

En az bir bayrak zorunludur. --platform oluşturulduktan sonra değiştirilemez.

Access level’lar

adapty access-levels list

Bir uygulamadaki tüm access level’ları listeler.

adapty access-levels list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty access-levels get

Belirli bir access level için ayrıntıları getirir.

adapty access-levels get --app <app-id> <access-level-id>

Argüman	Açıklama
`access-level-id`	Access level ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty access-levels create

Yeni bir access level oluşturur.

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

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--sdk-id`	Evet	Uygulama kodunda erişimi kontrol etmek için kullanılan tanımlayıcı (örneğin, `"pro"` veya `"premium"`)
`--title`	Evet	Adapty kontrol panelinde görünen etiket

adapty access-levels update

Mevcut bir access level’ı günceller.

adapty access-levels update --app <app-id> <access-level-id> --title "Pro Access"

Argüman	Açıklama
`access-level-id`	Access level ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Yeni görünen etiket

--sdk-id oluşturulduktan sonra değiştirilemez.

Ürünler

adapty products list

Bir uygulamadaki tüm ürünleri listeler.

adapty products list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty products get

Belirli bir ürün için ayrıntıları getirir.

adapty products get --app <app-id> <product-id>

Argüman	Açıklama
`product-id`	Ürün ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty products create

Yeni bir ürün oluşturun.

Important

Mağaza ürün ve fiyat ID’leri oluşturulduktan sonra değiştirilemez. Farklı mağaza ID’leri kullanmak için yeni bir ürün oluşturun.

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Ürün başlığı
`--access-level-id`	Evet	Bu ürünün kilidini açtığı access level ID’si (UUID)
`--period`	Evet	Abonelik dönemi: `weekly`, `monthly`, `two_months`, `trimonthly`, `semiannual`, `annual`, `lifetime`
`--ios-product-id`	En az bir mağaza zorunlu	App Store Connect’teki ürün ID’si
`--android-product-id`	En az bir mağaza zorunlu	Google Play Console’daki ürün ID’si
`--android-base-plan-id`	`--period lifetime` kullanılmadığı sürece `--android-product-id` ile birlikte zorunlu	Google Play Console’daki base plan ID’si
`--stripe-product-id`	En az bir mağaza zorunlu	Stripe’taki ürün ID’si
`--stripe-price-id`	`--stripe-product-id` ile birlikte zorunlu	Stripe’taki fiyat ID’si
`--paddle-product-id`	En az bir mağaza zorunlu	Paddle’daki ürün ID’si
`--paddle-price-id`	`--paddle-product-id` ile birlikte zorunlu	Paddle’daki fiyat ID’si

Her ürünün en az bir mağazaya ihtiyacı vardır: --ios-product-id, --android-product-id, --stripe-product-id veya --paddle-product-id. Tek bir ürün aynı anda birden fazla mağazanın ID’sini taşıyabilir.

Bir ürünü web üzerinden Stripe veya Paddle aracılığıyla satmak için önce ödeme sağlayıcısını Adapty’ye bağlayın: bkz. Stripe ve Paddle. Bu mağazaların her biri için ürün ID’sini ve fiyat ID’sini birlikte geçirin. Yalnızca ikisinden birini geçerseniz komut hata verir.

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --stripe-product-id prod_xxx --stripe-price-id price_xxx

Yalnızca web’e özgü bir ürün geçerlidir: Stripe veya Paddle ID’leriyle, App Store veya Google Play ID’leri olmadan bir ürün oluşturabilirsiniz.

adapty products update

Mevcut bir ürün günceller.

Mağaza ürün ve fiyat ID’leri oluşturulduktan sonra değiştirilemez ve bu komutta kullanılamaz. Farklı mağaza ID’leri kullanmak için yeni bir ürün oluşturun.

adapty products update --app <app-id> <product-id> --title "Monthly" --access-level-id <access-level-id>

Argüman	Açıklama
`product-id`	Ürün ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Hayır	Ürün başlığı
`--access-level-id`	Hayır	Bu ürünün kilidi açacağı access level ID’si (UUID)

Paywall’lar

adapty paywalls list

Bir uygulamadaki tüm paywall’ları listeler.

adapty paywalls list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty paywalls get

Belirli bir paywall için ayrıntıları getirir.

adapty paywalls get --app <app-id> <paywall-id>

Argüman	Açıklama
`paywall-id`	Paywall ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty paywalls create

Yeni bir paywall oluşturur.

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

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Paywall başlığı
`--product-id`	Evet	Ürün ID’si (UUID). Birden fazla ürün için tekrarlayın: `--product-id <id1> --product-id <id2>`

adapty paywalls update

Mevcut bir paywall’ın tüm alanlarını değiştirir.

Important

Bir paywall placement’a bağlandıktan sonra ürünleri değiştirilemez. Yayındaki bir paywall’da farklı ürünler kullanmak için yeni bir paywall oluşturun ve placement’ı buna yönlendirmek üzere güncelleyin.

adapty paywalls update --app <app-id> <paywall-id> --title "Default Paywall" --product-id <product-id>

Bu komut, tam ürün listesi dahil tüm paywall alanlarını değiştirir.

Argüman	Açıklama
`paywall-id`	Paywall ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Paywall başlığı
`--product-id`	Evet	Ürün ID’si (UUID). Birden fazla ürün için tekrarlayın: `--product-id <id1> --product-id <id2>`

adapty paywalls placements

Belirli bir paywall’ın şu anda hangi placement’larda kullanıldığını listeler.

adapty paywalls placements --app <app-id> <paywall-id>

Argüman	Açıklama
`paywall-id`	Paywall ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Bir paywall’ı değiştirmeden önce hangi placement’ların etkileneceğini görmek için bu komutu kullanın.

Placement’lar

adapty placements list

Bir uygulamadaki tüm placement’ları listeler.

adapty placements list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty placements get

Belirli bir placement için ayrıntıları alır.

adapty placements get --app <app-id> <placement-id>

Argüman	Açıklama
`placement-id`	Placement ID (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID (UUID)
Yanıt bir `audiences` dizisi içerir. Her giriş `{segment_ids, paywall_id, priority}` şeklindedir. Varsayılan kitle `segment_ids: []` değerine ve en yüksek öncelik değerine (en son değerlendirilen) sahiptir. Biçimlendirilmiş insan çıktısı, kolaylık sağlamak amacıyla varsayılan kitleden türetilen üst düzey bir `Paywall ID` de gösterir. `--json` seçeneği ham API şeklini değiştirmeden döndürür.

adapty placements create

Yeni bir placement oluşturur.

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

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Placement başlığı
`--developer-id`	Evet	Uygulamada bu placement’ı talep etmek için kullanılan string tanımlayıcı
`--audiences`	İkisinden biri	`{segment_ids, paywall_id, priority}` girişlerinden oluşan JSON dizisi. Bkz. Audiences şekli
`--paywall-id`	İkisinden biri	Kullanımdan kalkmış. Paywall ID’si (UUID). İstemci tarafında tek bir varsayılan kitleye sarılır

--audiences veya --paywall-id seçeneklerinden yalnızca birini girin. Her ikisini birden ya da hiçbirini geçmemek hata verir.

Warning

--paywall-id kullanımdan kaldırılmıştır ve ilerleyen sürümlerde kaldırılacaktır. Kullanıldığında, CLI stderr’e bir uyarı yazdırır ve değeri varsayılan bir kitleye dönüştürür. Yeni otomasyonlar için --audiences kullanın.

adapty placements update

Mevcut bir placement öğesinin tüm alanlarını değiştirir.

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

Bu komut, tüm kitle listesi dahil olmak üzere placement’ın tüm alanlarını değiştirir.

Argüman	Açıklama
`placement-id`	Placement ID’si (UUID)
Bayrak	Zorunlu
---	---
`--app`	Evet
`--title`	Evet
`--developer-id`	Evet
`--audiences`	İkisinden biri
`--paywall-id`	İkisinden biri

Warning

--paywall-id parametresini geçmek, placement üzerindeki tüm kitlelerin üzerine yazar. Segmente özel kitleler silinir. Bunları korumak için --audiences kullanın ve saklamak istediğiniz tüm girişleri dahil edin.

Kitle yapısı

--audiences bayrağı bir JSON dizisi alır. Her giriş şunları içerir:

Alan	Tür	Açıklama
`segment_ids`	`string[]`	Bu kitle tarafından hedeflenen segment ID’leri. Uzunluk 0 veya 1. Boş dizi varsayılan kitleyi işaret eder — başka hiçbir segmentle eşleşmeyen kullanıcılar için yedek
`paywall_id`	`string`	Bu kitleye gösterilen paywall ID’si (UUID)
`priority`	`number`	0 tabanlı, placement içinde benzersiz. Kitleler düşükten yükseğe doğru değerlendirilir; varsayılan kitle en yüksek değere sahip olmalıdır

Bir placement’ın tam olarak bir varsayılan kitlesi olmalıdır.

Bir hedefli kitle ve bir varsayılan kitle içeren örnek:

adapty placements update <placement-id> --app <app-id> --title "Main" --developer-id "main" \
  --audiences '[{"segment_ids":["<vip-segment-id>"],"paywall_id":"<vip-paywall-id>","priority":0},{"segment_ids":[],"paywall_id":"<default-paywall-id>","priority":1}]'

Segment bazlı yönlendirmeyi kaybetmeden bir paywallı birden fazla placement’ta değiştirmek için:

Etkilenen placement’ları bulun:

adapty paywalls placements --app <app-id> <old-paywall-id>

Her biri için tam audiences dizisini okuyun:

adapty placements get --app <app-id> <placement-id> --json

Eşleşen paywall_id değerlerini istemci tarafında değiştirin.

Değiştirilen payload’ı geri yazın:

adapty placements update --app <app-id> <placement-id> --title "<title>" --developer-id "<developer-id>" --audiences '<modified-payload>'

Segmentler

Segmentler CLI üzerinden yalnızca okunabilir. Oluşturmak ve düzenlemek için Adapty Kontrol Paneli’ni kullanın. Placement kitlelerini oluştururken segment ID’lerini bulmak için bu komutları kullanın.

adapty segments list

Bir uygulama için tüm segmentleri listeler.

adapty segments list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalandırma bayraklarını kabul eder.

adapty segments get

Belirli bir segment için ayrıntıları getirir.

adapty segments get --app <app-id> <segment-id>

Argüman	Açıklama
`segment-id`	Segment ID (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID (UUID)

Yanıt id, title ve description alanlarını içerir. Filtre kuralları bu API aracılığıyla gösterilmez.

Kimlik doğrulama

Komut	Açıklama
`adapty auth login`	Cihaz akışı ile tarayıcı üzerinden kimlik doğrulama yapar
`adapty auth logout`	Yerel olarak depolanan kimlik bilgilerini temizler
`adapty auth whoami`	Token’ı sunucu ile doğrular ve kullanıcı bilgilerini gösterir
`adapty auth status`	Sunucuya çağrı yapmadan yerel kimlik doğrulama durumunu gösterir
`adapty auth revoke`	Token’ı sunucu tarafında iptal eder ve yerel olarak temizler

Her komut hakkında ayrıntılı bilgi için bkz. Kimlik doğrulama.