Placement ve segment komutları
Bu Adapty CLI komutları placement’ları, üzerlerindeki kitleleri ve bu kitlelerin hedeflediği segmentleri yönetir.
Placement’lar
Placement’lar, flow’larınızın, paywall’larınızın ve onboarding’lerinizin kullanıcılara ulaştığı yerlerdir. Bir placement’ın içerik türü oluşturma sırasında belirlenir; bu nedenle bir uygulamayı paywall’lardan flow’lara taşımak, mevcut placement’ları güncellemek yerine yeni placement’lar oluşturmayı gerektirir — migrate-placements skill bu komutları toplu olarak gerçekleştirmek için kullanılır.
adapty placements list
Bir uygulama için tüm placement’ları listeler.
adapty placements list --app <app-id>
| Flag | Gerekli | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID’si (UUID) |
--type | Hayır | Yalnızca şu türdeki placement’ları listeler: paywall, flow veya onboarding |
Sayfalama flag’lerini kabul eder.
Her öğe id, developer_id, title, is_active ve type içerir. is_active, aktif bir placement için true, etkin olmayan bir placement için false değerini alır. type, placement’ın içerik türüdür: paywall, flow veya onboarding. --json çıktısında, türü olmayan bir placement için type: null gösterilir. --type bayrağı ve type alanı için CLI 0.15.0 veya sonraki bir sürüm gereklidir.
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 | Gerekli | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID (UUID) |
Yanıt; id, developer_id, title, is_active, type ve bir audiences dizisi içerir. is_active, aktif bir placement için true, pasif bir placement için false değerini alır. Her kitle girişi; content_type, segment_ids, priority ve içeriğinin ID’sini taşır: paywall için paywall_id, flow için flow_id, ya da A/B testi çalıştıran bir kitle için ab_test_id ve ab_test_title. Varsayılan kitle segment_ids: [] değerine sahiptir ve en yüksek priority değerini alır (en son değerlendirilir). Bkz. Audiences şekli.
adapty placements create
Yeni bir placement oluşturur.
adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"content_type":"paywall","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 | Uygulamanın kodunda bu placement’ı istemek için kullanılan string tanımlayıcı |
--audiences | İkisinden biri | Her biri açık bir content_type içeren audience girdilerinden oluşan JSON dizisi. Bkz. Audiences shape |
--paywall-id | İkisinden biri | Kullanımdan kaldırıldı. Paywall ID’si (UUID). İstemci tarafında tek bir varsayılan audience içine sarılır |
--audiences veya --paywall-id seçeneklerinden yalnızca birini geçirin. İkisini birden ya da hiçbirini geçmek hatayla sonuçlanır.
--paywall-id kullanımdan kaldırılmıştır ve ileride kaldırılacaktır. Geçirildiğinde, CLI bir stderr uyarısı yazdırır ve değeri varsayılan bir kitleye dönüştürür. Yeni otomasyon için --audiences kullanın.
adapty placements update
Mevcut bir placement’ın tüm alanlarını değiştirir.
adapty placements update --app <app-id> <placement-id> --title "Main" --developer-id "main" --audiences '[{"content_type":"paywall","segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'
Bu komut, tam kitle listesi de dahil olmak üzere placement’ın tüm alanlarını değiştirir.
| Argüman | Açıklama |
|---|---|
placement-id | Placement ID’si (UUID) |
| Bayrak | Gerekli | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID’si (UUID) |
--title | Evet | Placement başlığı |
--developer-id | Evet | Uygulamada bu placement’ı istemek için kullanılan string tanımlayıcı |
--audiences | İkisinden biri | Her biri açık bir content_type içeren kitle girdilerinden oluşan JSON dizisi. Bkz. Kitleler şekli |
--paywall-id | İkisinden biri | Kullanımdan kaldırıldı. Paywall ID’si (UUID). Tüm kitleleri tek bir varsayılan kitleyle değiştirir |
--paywall-id parametresi geçirildiğinde, placement üzerindeki tüm kitleler yeniden yazılır. Segmente özgü kitleler silinir. Bunları korumak için --audiences kullanın ve tutmak istediğiniz tüm girişleri dahil edin.
Kitleler yapısı
--audiences bayrağı bir JSON dizisi alır. Her girişin şunları içerir:
| Alan | Tür | Açıklama |
|---|---|---|
content_type | string | Her girdide zorunludur. "paywall", "flow", "ab_test" (paywall A/B testi), "flow_ab_test" (flow A/B testi), "cross_ab_test" veya "flow_cross_ab_test" (crossplacement A/B testi). Paywall placement’ında paywall, ab_test ve cross_ab_test; flow placement’ında ise flow, flow_ab_test ve flow_cross_ab_test kullanın |
segment_ids | string[] | Bu kitle tarafından hedeflenen Segment ID’leri. Uzunluk 0 veya 1. Boş dizi, başka hiçbir segmentle eşleşmeyen kullanıcılar için yedek olan varsayılan kitleyi işaret eder |
paywall_id | string | Bu kitledeki kullanıcılara gösterilen Paywall ID’si (UUID). content_type değeri "paywall" olduğunda zorunludur |
flow_id | string | Bu kitledeki kullanıcılara gösterilen Flow ID’si (UUID). content_type değeri "flow" olduğunda zorunludur |
ab_test_id | string | Bu kitledeki kullanıcılar için çalıştırılan A/B testi ID’si. Dört A/B testi içerik türünde de zorunludur |
ab_test_title | string | A/B testi başlığı. Salt okunur: API, yazma işleminde bu alanı yok sayar |
priority | number | 0 tabanlı, placement içinde benzersizdir. 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.
placements update komutu, A/B testi çalıştıran kitleler de dahil olmak üzere tam kitle listesini değiştirir. Çalışan bir testi korumak için placements get komutundan ilgili girişi --audiences parametresine olduğu gibi kopyalayın; ab_test_id ve segment_ids değerleri aynı kalmalıdır. Bu girişi kaldıran veya değiştiren bir yazma işlemi, testi kazanansız durdurur. Girişi başka segmentlere taşıyan bir yazma işlemi testi yeniden başlatır; başka bir kitlede ab_test_id belirtmek ise testi orada başlatır. Yalnızca öncelikleri değiştiren bir yazma işlemi testi çalışmaya devam ettirir. CLI bu durumlar için sizi uyarmaz.
Çapraz placement A/B testi girdileri (cross_ab_test, flow_cross_ab_test) salt okunurdur. API, yazma işlemlerinde bunları yok sayar ve mevcut olanları korur.
Bir placement’ın içerik türü oluşturulduğunda sabitlenir; bu nedenle placements update komutu bir paywall placement’ını flow’a veya tersine çeviremez. Flow’u kendi placement’ından sunun — bkz. Flow için yeni bir placement oluşturma.
CLI, isteği göndermeden önce her girişi kontrol eder. Eksik veya bilinmeyen content_type içeren ya da content_type’ının gerektirdiği ID’ye sahip olmayan bir giriş, kod 2 ile çıkar ve hiçbir şey gönderilmez. Tanımadığı bir content_type için CLI, this CLI does not know this audience kind; update the CLI mesajını yazdırır. Giriş placements get komutundan geldiyse, girişi kaldırmak yerine CLI’yi güncelleyin: giriş çalışan bir A/B testi olabilir.
Bir flow yalnızca yayımlandıktan sonra eklenebilir. draft durumundaki bir flow veya ilk yayımlaması hâlâ devam eden bir flow sunucu tarafından reddedilir; CLI bu reddi algılar ve flows publish komutunu yazdırarak 2 koduyla çıkar. Bir flow’u yayımlamak için flows publish komutunu veya Flow & Paywall Builder’ı kullanın, ardından durumunun published olmasını bekleyin.
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 '[{"content_type":"paywall","segment_ids":["<vip-segment-id>"],"paywall_id":"<vip-paywall-id>","priority":0},{"content_type":"paywall","segment_ids":[],"paywall_id":"<default-paywall-id>","priority":1}]'
Yayımlanmış bir flow’u tüm kullanıcılara sunan bir placement örneği:
adapty placements create --app <app-id> --title "Onboarding" --developer-id "onboarding" \
--audiences '[{"content_type":"flow","segment_ids":[],"flow_id":"<flow-id>","priority":0}]'
Segment’e özgü yönlendirmeyi kaybetmeden bir paywall’u 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
audiencesdizisinin tamamını okuyun:adapty placements get --app <app-id> <placement-id> --json -
Eşleşen
paywall_iddeğerlerini istemci tarafında değiştirin. A/B testi girdileri dahil diğer tüm girdileri değiştirmeden bırakın. -
Değiştirilen payload’ı geri yazın:
adapty placements update --app <app-id> <placement-id> --title "<title>" --developer-id "<developer-id>" --audiences '<modified-payload>'
adapty placements metrics list
Birkaç flow placement veya paywall placement’ın tüm zamanlara ait metriklerini, her placement için bir satır olacak şekilde gösterir. Bu veriler, kontrol panelindeki placement tablosunun verileridir.
adapty placements metrics list --app <app-id> --type flow --ids <placement-id>,<placement-id>
| Bayrak | Gerekli | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID’si (UUID) |
--type | Evet | placements list komutunun gösterdiği şekliyle placement türü: flow veya paywall |
--ids | Evet | Placement ID’leri (UUID’ler). Virgülle ayırın ya da bayrağı tekrarlayın |
--csv | Hayır | CSV olarak yazdır: her placement için bir satır, placement ID’si ve sayısal metriklerle birlikte. --json ile birlikte kullanılamaz |
placements metrics komutları, placement metrics sayfasındaki verileri okur. Flow placement’lar için CLI 0.15.0 veya üzeri, paywall placement’lar için ise 0.16.0 veya üzeri gereklidir. --type değeri, placement’ın türüyle eşleşmelidir: Adapty farklı türdeki bir placement’ı reddeder ve onboarding placement’lar için herhangi bir metrik bulunmaz.
Her satırda placement ID’si ile görüntüleme, satın alma, deneme ve gelir bilgileri gösterilir. Bir flow placement için --json ve --csv seçenekleri 27 metriğin tamamını taşır.
Bir paywall placement’ının lifetime satırında görüntüleme yoktur, bu nedenle görüntüleme sütununda — gösterilir. Bu satır; purchases, revenue ve refunds gibi 15 metrik taşır. Bir paywall placement’ının izleyicilerini okumak için dönemli placements metrics get komutunu kullanın.
adapty placements metrics values
Bir flow placement veya paywall placement için filtre anahtar ve değerlerini listeler: placements metrics get --filter parametresinin kabul ettiği değerler.
adapty placements metrics values --app <app-id> <placement-id> --type flow
| Argüman | Açıklama |
|---|---|
placement-id | Placement ID (UUID) |
| Bayrak | Zorunlu | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID (UUID) |
--type | Evet | Placement türü: flow veya paywall |
flows metrics values çıktısıyla aynı biçimdedir: her grubun en üstündeki değer filtre anahtarıdır ve en içteki değerler anahtarın alabileceği değerlerdir. Filtre anahtarı olmayan bir placement için No filter values. yazdırılır.
adapty placements metrics get
Bir flow placement veya paywall placement’ın metriklerini placement metrikleri sayfasındaki ağaç yapısında gösterir. Bir flow placement tüm ömrünü veya belirli bir dönemi kapsar. Bir paywall placement bir dönemi kapsar.
adapty placements metrics get --app <app-id> <placement-id> --type flow --based-on flow
| Argüman | Açıklama |
|---|---|
placement-id | Placement ID (UUID) |
| Bayrak | Gerekli | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID’si (UUID) |
--type | Evet | Placement türü: flow veya paywall |
--based-on | Evet | Ağacın ilk seviyesinin neye göre bölüneceği. Bir flow placement için: audience, flow veya placement. Bir paywall placement için: audience veya paywall |
--group-by | Hayır | Bir flow placement için her kitleyi country veya store’a göre böler. Bir paywall placement için ürünleri product, store veya country’ye göre gruplar |
--date-from | Hayır | Dönemin ilk günü, dahil (YYYY-MM-DD). --date-to ve --date-type ile birlikte kullanın |
--date-to | Hayır | Dönemin son günü, dahil (YYYY-MM-DD). --date-from ve --date-type ile birlikte kullanın |
--date-type | Hayır | Dönemin hangi tarihe uygulanacağı: purchase_date veya profile_install_date. --date-from ve --date-to ile birlikte kullanın |
--granularity | Hayır | Dönemi noktalara böler: day, week, month, quarter veya year |
--filter | Hayır | Yalnızca belirtilen filtre anahtarı değerlerine sahip verileri tutar. Tekrarlanabilir. Bkz. Metrikleri filtreleme |
--timezone | Hayır | Dönem noktalarının IANA saat dilimi, örneğin Europe/Berlin. Belirtilmezse Adapty uygulama saat dilimini kullanır |
--depth | Hayır | Total altında kaç seviye ağaç yazdırılacağı. Varsayılan: 1 |
--csv | Hayır | CSV olarak yazdırır: tüm ağacın her düğümü için bir satır. --json ile birlikte kullanılamaz |
Bir flow placement için, --date-from, --date-to ve --date-type olmadan komut yaşam boyu metrikleri döndürür. Belirli bir dönem için üçünü birden geçirin: --date-type olmayan bir dönem, 4 koduyla çıkar. Bir paywall placement her zaman üçünü birden gerektirir ve bunlar olmadan 4 koduyla çıkar.
Bir flow placement için çıktı, --depth, --json, --csv ve --filter seçenekleri flows metrics get içindeki gibi çalışır. Bir paywall placement için ise paywalls metrics get içindeki gibi çalışır. Örneğin, bir placement’ın kitlelerin store’a göre karşılaştırmak için:
adapty placements metrics get --app <app-id> <placement-id> --type flow --based-on audience --group-by store \
--date-from 2026-09-01 --date-to 2026-10-21 --date-type purchase_date --depth 2
Bir paywall placement üzerindeki A/B testinin her kolunu okumak için ağacı paywall’a göre bölün. Her paywall’ın altında, A/B testi satırı o kolun rakamlarını gösterir:
adapty placements metrics get --app <app-id> <placement-id> --type paywall --based-on paywall \
--date-from 2026-09-01 --date-to 2026-10-21 --date-type purchase_date --depth 3
--based-on audience ağacında A/B testinin toplamı kendi satırında gösterilir. Bu toplam her kullanıcıyı yalnızca bir kez sayar; dolayısıyla kolların toplamından düşük olabilir: her iki kolu da gören bir kullanıcı her kolda ayrı ayrı sayılır.
Segmentler
Segmentler, kullanıcıları profil özelliklerine göre gruplar. Placement kitlelerini oluştururken segment ID’lerini bulmak veya yeni segment oluşturmak için bu komutları kullanın. Apple Ads kampanyalarına, reklam gruplarına veya anahtar kelimelere göre segment oluşturmak için adapty asa segments create komutunu kullanın: Apple ID’lerini sizin yerinize bulur ve segmenti Ads Manager’ın kullandığı şekilde adlandırır.
adapty segments list
Bir uygulamaya ait tüm segment’leri 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ı alır.
adapty segments get --app <app-id> <segment-id>
| Argüman | Açıklama |
|---|---|
segment-id | Segment ID’si (UUID) |
| Bayrak | Zorunlu | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID’si (UUID) |
Yanıt, id, title, description, filters, profile_count, refresh_in_progress, created_at ve updated_at alanlarını içerir. list yalnızca id, title ve description alanlarını döndürür.
adapty segments create
Bir veya daha fazla filtreden segment oluşturur.
adapty segments create --app <app-id> --title "US installs" --filter ip_country:IN:US --filter install_date:>=:2026-01-01
| Flag | Gerekli | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID’si (UUID) |
--title | Evet | Segment başlığı |
--filter | Evet | Filtre kuralı. Tekrarlanabilir. Bkz. Filtre söz dizimi |
--description | Hayır | Segment açıklaması |
Bir kullanıcı, segmente yalnızca tüm filtreleri sağladığında dahil edilir. Yanıt, segments get ile aynı alanları içerir. profile_count 0 ile başlar ve Adapty, segment oluşturulduktan sonra bunu yeniden hesaplar.
adapty segments update
Mevcut bir segment’in başlığını, açıklamasını ve filtrelerini değiştirir.
adapty segments update --app <app-id> <segment-id> --title "US installs" --filter ip_country:IN:US,CA
| Argüman | Açıklama |
|---|---|
segment-id | Segment ID (UUID) |
| Flag | Zorunlu | Açıklama |
|---|---|---|
--app | Evet | Uygulama ID (UUID) |
--title | Evet | Segment başlığı |
--filter | Evet | Filtre kuralı. Tekrarlanabilir. Bkz. Filtre sözdizimi |
--description | Hayır | Segment açıklaması |
segments update tüm segmenti değiştirir. Yalnızca değiştirdiğiniz filtreyi değil, korumak istediğiniz her filtreyi geçirin. Mevcut filtreleri okumak için şunu çalıştırın: adapty segments get --app <app-id> <segment-id> --json.
Filtre sözdizimi
Her --filter değerini field:OPERATOR:value biçiminde yazın. Birden fazla değerden herhangi biriyle eşleştirmek için değerleri virgülle ayırın: ip_country:IN:US,CA.
| Operatör | Değerler | Örnek |
|---|---|---|
IN, NOT IN | Bir veya daha fazla | ip_country:NOT IN:US,CA |
>, >=, <, <= | Bir | age:>:18 |
BETWEEN | İki | total_revenue_usd:BETWEEN:10,100 |
IS NULL, IS NOT NULL | Hiçbiri | age:IS NULL |
Sayıları düz değerler olarak iletin; örneğin age:>:18. Adapty, bunları age, total_revenue_usd ve float türündeki özel öznitelikler gibi sayısal alanlar için dönüştürür.
Bu kısa formun ifade edemediği bir değer için filtreyi JSON nesnesi olarak iletin:
adapty segments create --app <app-id> --title "Adults" --filter '{"field_name":"age","operator":">","value_list":[18]}'
Adapty alan adlarını, operatörleri ve değer türlerini doğrular; geçersiz her filtre için ayrı bir hata bildirir. Mevcut filtrelerin alan adlarını ve değer biçimlerini görmek için kontrol panelinde oluşturulmuş bir segment üzerinde adapty segments get --app <app-id> <segment-id> --json komutunu çalıştırın.
Sırada ne var
- Komut referansı — tüm CLI konuları, genel bayraklar ve sayfalama bayrakları.