Paywall komutları

Bu Adapty CLI komutları paywall’ları ve her paywall’ın sattığı ürünleri yönetir, ayrıca metriklerini okur.

adapty paywalls list

Bir uygulama için tüm paywall’ları listeler.

adapty paywalls list --app <app-id>
FlagGerekliAçıklama
--appEvetUygulama ID’si (UUID)

Sayfalama flag’lerini kabul eder.

adapty paywalls get

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

adapty paywalls get --app <app-id> <paywall-id>
ArgümanAçıklama
paywall-idPaywall ID (UUID)
BayrakGerekliAçıklama
--appEvetUygulama ID’si (UUID)

adapty paywalls create

Yeni bir paywall oluşturun.

adapty paywalls create --app <app-id> --title "Default Paywall" --products '[{"product_id":"<product-id-1>"},{"product_id":"<product-id-2>"}]'
BayrakGerekliAçıklama
--appEvetUygulama ID’si (UUID)
--titleEvetPaywall başlığı
--productsEvetGörüntüleme sırasına göre ürünlerin JSON dizisi: [{product_id, offer_id, fallback_offer_id, billing_plan_id, flow_product_id}]. Yalnızca product_id (ürün ID’si, UUID) gereklidir; diğer anahtarlar paywalls get komutunun yazdırdığı products listesinden gelir
--remote-configsHayır{locale, data} girişlerinden oluşan JSON dizisi; data, JSON dizesi olarak remote config içeriğidir
--use-paywall-builder-v4HayırPaywall’ın Paywall Builder kullanıp kullanmadığı
--screenshot-idHayırPaywall ekran görüntüsünün görsel ID’si (bir tam sayı) veya null
--builder-screenshot-idHayırBuilder ekran görüntüsünün görsel ID’si (bir tam sayı) veya null
--web-purchase-urlHayırWeb satın alma URL’si veya null
--product-idHayırKullanımdan kaldırıldı: --products kullanın. Her ürün için tekrarlanan ürün ID’si (UUID). Teklif ve faturalama planı olmadan ürünleri ayarlar; --products ile birlikte kullanılamaz

Boş bıraktığınız bir alan, kontrol paneli varsayılanını alır: remote config yok, builder yok, ekran görüntüsü yok ve web satın alma URL’si yok. --app, --title ve --product-id dışındaki flag’ler CLI 0.20.0 veya üstü sürüm gerektirir.

adapty paywalls update

Mevcut bir paywall’ın tüm alanlarını günceller.

Important

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

Tek bir alanı değiştirmek için önce paywall’ı okuyun, ilgili alanı düzenleyin ve dosyanın tamamını geri gönderin:

adapty paywalls get --app <app-id> <paywall-id> --json > paywall.json
adapty paywalls update --app <app-id> <paywall-id> --file paywall.json

Bu komut, tam ürün listesi ve remote config listesinin tamamı dahil olmak üzere paywall’ın her alanını değiştirir. Her alan zorunludur: bir flag eksik olduğunda, komut 2 koduyla çıkar, eksik flag’leri listeler ve istek göndermez. Bunun için CLI 0.20.0 veya üzeri gereklidir: bu sürümden önceki sürümler yalnızca --title ve --product-id alır.

ArgümanAçıklama
paywall-idPaywall ID (UUID)
BayrakGerekliAçıklama
--appEvetUygulama kimliği (UUID)
--fileAlan bayrakları yerineTüm paywall’ı içeren bir JSON dosyasının yolu veya stdin’den okumak için -. paywalls get --json çıktısı olduğu gibi kullanılabilir; id alanı yok sayılır. Hiçbir alan bayrağıyla birlikte kullanılamaz
--title--file olmadanPaywall başlığı
--products--file olmadanpaywalls create ile aynı biçimde ürünlerin JSON dizisi. Teklifleri ve fatura planlarını korumak için paywalls get çıktısındaki listeyi gönderin
--remote-configs--file olmadan{locale, data} girdilerinden oluşan JSON dizisi; data bir JSON dizesidir. [] tüm remote config’leri siler
--use-paywall-builder-v4 veya --no-use-paywall-builder-v4--file olmadanPaywall’ın Paywall Builder kullanıp kullanmadığı. paywalls get çıktısındaki değeri gönderin: --no-use-paywall-builder-v4 builder düzenini cihazlardan kaldırır
--screenshot-id--file olmadanPaywall ekran görüntüsünün resim kimliği veya null
--builder-screenshot-id--file olmadanBuilder ekran görüntüsünün resim kimliği veya null
--web-purchase-url--file olmadanWeb satın alma URL’si veya null
--product-idHayırKullanım dışı: --products kullanın. Ürünleri teklif ve fatura planı olmadan ayarlar

adapty paywalls placements

Belirli bir paywall için şu anda hangi placement’ların kullanıldığını listeler.

adapty paywalls placements --app <app-id> <paywall-id>
ArgümanAçıklama
paywall-idPaywall ID (UUID)
BayrakZorunluAçıklama
--appEvetUygulama ID (UUID)

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

Bu listedeki öğeler is_active alanı taşımaz. Bir placement’ın aktiflik durumunu okumak için placements list veya placements get komutunu kullanın.

adapty paywalls metrics list

Birkaç paywall’ın ömür boyu metriklerini gösterir; her paywall için bir satır. Bu, kontrol panelindeki paywalls tablosunun verileridir.

adapty paywalls metrics list --app <app-id> --ids <paywall-id>,<paywall-id>
FlagZorunluAçıklama
--appEvetUygulama ID’si (UUID)
--idsEvetPaywall ID’leri (UUID’ler). Virgülle ayırın ya da flag’i tekrarlayın
--csvHayırCSV yazdırır: her paywall için paywall ID’si ve sayısal metrikleri içeren bir satır. --json ile birlikte kullanılamaz

paywalls metrics komutları, paywall metrikleri sayfasındaki verileri okur ve CLI 0.16.0 veya daha yeni bir sürüm gerektirir.

Her satır, paywall ID’sini ve bu paywall’a ait görüntüleme, satın alma, deneme ve gelir bilgilerini gösterir. --json ile unique_profiles_views, net_revenue ve conversion_rate_purchases gibi tüm 21 metrik, ayrıca last_purchases alanı da döner. --csv ise sayısal olmayan iki alanı (in_current_state ve last_purchases) dışarıda bırakır. Verisi bulunmayan bir metrik null değil, 0 olarak görünür.

adapty paywalls metrics values

paywalls metrics get --filter komutunun aldığı paywall filtre anahtarlarını ve değerlerini listeler.

adapty paywalls metrics values --app <app-id> <paywall-id>
ArgümanAçıklama
paywall-idPaywall ID (UUID)
FlagZorunluAçıklama
--appEvetApp ID (UUID)

Çıktı, flows metrics values ile aynı biçimdedir: her grubun en üst değeri filtre anahtarıdır, en içteki değerler ise o anahtarın kabul ettiği değerlerdir.

adapty paywalls metrics get

Bir paywall’ın belirli bir dönemdeki metriklerini, paywall metrikleri sayfasındaki ağaç yapısı şeklinde gösterir.

adapty paywalls metrics get --app <app-id> <paywall-id> --date-from 2026-09-01 --date-to 2026-10-21 --date-type purchase_date --based-on placement
ArgümanAçıklama
paywall-idPaywall ID’si (UUID)
BayrakZorunluAçıklama
--appEvetUygulama ID’si (UUID)
--based-onEvetAğacın ilk seviyesinin neye göre bölüneceği: placement veya audience. Bunlar, paywall metrikleri sayfasının placement tabanlı ve kitle tabanlı görünümleridir
--date-typeEvetDönemin hangi tarihe uygulanacağı: purchase_date veya yükleme tarihine göre filtrelemek için profile_install_date
--date-fromEvetDönemin ilk günü, dahil (YYYY-MM-DD)
--date-toEvetDönemin son günü, dahil (YYYY-MM-DD)
--group-byHayırÜrünleri product, store veya country değerlerine göre gruplandırır. Varsayılan: product
--granularityHayırDönemi noktalara böler: day, week, month, quarter veya year
--filterHayırYalnızca belirtilen filtre anahtarı değerlerine sahip verileri tutar. Tekrarlanabilir. Bkz. Metrikleri filtreleme
--timezoneHayırDönem noktalarının IANA zaman dilimi, örneğin Europe/Berlin. Belirtilmezse Adapty, uygulamanın zaman dilimini kullanır
--depthHayırTotal altında kaç seviye ağacın yazdırılacağı. Varsayılan: 1
--csvHayırCSV olarak yazdırır: tüm ağacın her düğümü için bir satır. --json ile birlikte kullanılamaz

--based-on veya --date-type eksik olduğunda ya da dönemin yalnızca bir ucu verildiğinde CLI, kod 2 ile çıkar ve hiçbir istek göndermez. Dönem belirtilmezse Adapty isteği reddeder ve komut kod 4 ile çıkar. Adapty, --based-on, --date-type, --group-by ve --granularity değerlerini doğrular: yanlış bir değer kod 4 ile çıkışa neden olur ve hata mesajı kabul edilen değerleri listeler.

Çıktıyı okuma

Komut bir Total satırı yazdırır, ardından flows metrics get ile aynı sütunlara sahip ağacın ilk seviyesini gösterir. İlk seviyenin düğümleri, --granularity kullanılıp kullanılmadığına bakılmaksızın her zaman dönemin puanlarıyla birlikte gelir.

Ağacın seviyeleri sırasıyla placement veya kitle, ardından orada çalışan paywall ya da A/B testi ve son olarak --group-by gruplarıdır. Daha fazla seviye yazdırmak için --depth parametresini kullanın; örneğin --depth 4.

Tüm metrikleriyle birlikte ağacın tamamını görmek için şu flag’lerden birini kullanın:

  • --json sunucunun yanıtını olduğu gibi yazdırır.
  • --csv her düğüm için, dönem noktaları dahil olmak üzere bir satır yazdırır. Sütunlar şunlardır: path (Total’den düğüme kadar olan başlıklar, > ile ayrılmış), level, title ve ardından sayısal metrikler. Paywall ağacında seviye olmadığından level, Total’de root ve diğer tüm satırlarda boştur.

Metrikleri filtreleyin

Her --filter’ı key=value biçiminde yazın; anahtarlar ve değerler paywalls metrics values sayfasında listelenmiştir. Filtreler, flows metrics get içindekiyle aynı kuralları izler:

adapty paywalls metrics get --app <app-id> <paywall-id> --date-from 2026-09-01 --date-to 2026-10-21 \
  --date-type purchase_date --based-on placement --filter state=live

Sırada ne var

  • Komut referansı — tüm CLI konuları, genel bayraklar ve sayfalama bayrakları.