Bu makale, Adapty CLI’daki her Ads Manager komutunu argümanları, bayrakları ve kabul edilen değerleriyle birlikte listeler. Ads Manager komutları adapty asa konusu altında yer alır.

Bu komutlar, bağlı bir Apple Ads hesabı ve aktif bir Ads Manager aboneliği gerektirir. İkisini de kontrol etmek için adapty asa whoami komutunu çalıştırın. CLI’ın geri kalanı için komut referansına bakın.

Global flag’ler

Bu flag’ler tüm Ads Manager komutlarında kullanılabilir.

Flag	Açıklama
--json	Biçimlendirilmiş metin yerine JSON olarak çıktı ver
--help	Komut yardımını göster

Tüm list komutları sayfalama flag’lerini de kabul eder:

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

Ads Manager sayfaları CLI’ın geri kalanına kıyasla daha büyüktür. Küçük sayfalar üzerinde döngü kurmak yerine tek bir büyük sayfa tercih edin.

Hesabınızda değişiklik yapan tüm komutlar şu flag’leri kabul eder:

Bayrak	Açıklama
--yes, -y	Onay istemeden uygular. Çıktı yönlendirildiğinde veya --json kullanıldığında zorunludur
--idempotency-key	Bu yazma işlemi için sabit anahtar. Aynı anahtar ve gövdeyle 24 saat içinde tekrarlanan bir istek, değişikliği yeniden uygulamak yerine saklanan sonucu döndürür

Ads Manager komutları --app bayrağı almaz. Kapsam, token’ınızın ait olduğu şirkettir. --app yalnızca bazı list komutlarında filtre olarak bulunur.

Liste filtreleri

Filtreler, görüntülenen sayfayı değil sorgunun kendisini daraltır. Filtresiz bir keywords list komutu hesaptaki tüm anahtar kelimeleri sayfalandırarak getirir; bu nedenle her okumayı ihtiyaç duyduğunuz düzeyde kapsamlandırın.

Filtre	Kabul eden
--campaign-group	campaigns, ad-groups, keywords, negative-keywords, search-terms, ads, creatives, product-pages
--app	campaigns, ad-groups, keywords, negative-keywords, search-terms, creatives, product-pages
--campaign	ad-groups, keywords, negative-keywords, search-terms, ads
--ad-group	keywords, negative-keywords, search-terms, ads
--status	campaigns, ad-groups, ads (ENABLED veya PAUSED), keywords (ACTIVE veya PAUSED)
--search	campaigns, ad-groups, keywords, negative-keywords, search-terms, ads. Ada göre büyük/küçük harf duyarsız alt dize eşleşmesi

adapty asa apps list, orgs list, automations list ve automations runs herhangi bir filtre almaz. Yalnızca sayfalama bayraklarını kabul eder.

--campaign-group, --app, --campaign ve --ad-group seçenekleri, ilgili list komutunun yazdırdığı UUID’leri alır ve her biri tekrarlanabilir:

adapty asa keywords list --ad-group <ad-group-id> --ad-group <other-ad-group-id>

Başka bir şirkete ait bir ID hiçbir şeyle eşleşmez; bu durumda hata döndürmek yerine sayfa boş gelir.

Hesap

adapty asa whoami

Şirketi, Ads Manager erişiminin nasıl sağlandığını ve Apple Ads’in bağlı olup olmadığını gösterir.

adapty asa whoami

Bu komutu önce çalıştırın. Diğer tüm komutların ön koşullarının karşılanıp karşılanmadığını raporlar.

adapty asa connect

Bir Apple Ads hesabını Adapty’ye bağlayın.

adapty asa connect

Bu komut bir Apple yetkilendirme bağlantısı yazdırır ve Apple hesabın bağlandığını bildirene kadar bekler.

Bayrak	Varsayılan	Açıklama
--wait / --no-wait	--wait	Apple Ads’in bağlandığını bildirmesini bekler. --no-wait hemen geri döner
--timeout	300	Tarayıcı adımı için beklenecek saniye sayısı

adapty asa orgs list

Şirketinize ait kampanya gruplarını (Apple Ads kuruluşları) listeler.

adapty asa orgs list

Her satır birbiriyle karıştırılmaması gereken iki tanımlayıcı içerir:

Alan	Kullanım yeri
internal_id	campaigns create komutundaki --org bayrağının ve liste filtresi olarak --campaign-group bayrağının aldığı UUID
org_id	Apple’ın sayısal kuruluş kimliği. Her iki bayrak da bu değeri reddeder

--org yalnızca campaigns create komutunda bulunur. Hiçbir listeleme komutu bu bayrağı kabul etmez.

Sayfalama bayraklarını destekler.

adapty asa apps list

Apple Ads’de tanıtılan uygulamaları listeler.

adapty asa apps list

Her satır iki tanımlayıcı içerir ve bunlar birbirinin yerine kullanılamaz:

Alan	Kullanım amacı
internal_id	--app’in liste filtresi olarak aldığı UUID
adam_id	Apple’ın sayısal App Store ID’si; campaigns create ve product-pages sync komutlarında --adam-id tarafından alınır

Sayfalandırma flag’lerini kabul eder.

Kampanyalar

adapty asa campaigns list

Kampanyaları listeler. Yalnızca meta veri döndürür — performans rakamlarını asa metrics ile okuyun.

adapty asa campaigns list --app <app-id> --status PAUSED

Sayfalama bayraklarını ve --campaign-group, --app, --search ile --status liste filtrelerini kabul eder.

adapty asa campaigns get

Belirli bir kampanyanın ayrıntılarını alır.

adapty asa campaigns get <campaign-id>

Argüman	Açıklama
campaign-id	Kampanya kimliği (UUID)

adapty asa campaigns create

Bir kampanya oluşturun.

adapty asa campaigns create --org <campaign-group-id> --name "Winter push" --adam-id 123456 --country US --daily-budget 50

Bayrak	Zorunlu	Açıklama
--org	Evet	Kampanya grubu ID’si (UUID). Bkz. orgs list
--name	Evet	Kampanya adı
--adam-id	Evet	App Store uygulama ID’si (adam_id)
--country	Evet	Ülke veya bölge kodu. Birden fazla için tekrarlayın: --country US --country CA
--daily-budget	Evet	Günlük bütçe, düz tutar olarak; örneğin 50 veya 12.50
--budget	Hayır	Toplam ömür boyu bütçe
--target-cpa	Hayır	Hedef edinim başına maliyet
--currency	Hayır	Bu çağrıdaki tutarlar için para birimi kodu. Varsayılan: USD
--bidding-strategy	Hayır	MANUAL_CPT veya MAX_CONVERSIONS. Apple varsayılanı: MANUAL_CPT
--ad-channel-type	Hayır	SEARCH veya DISPLAY. Varsayılan: SEARCH
--billing-event	Hayır	TAPS veya IMPRESSIONS. Varsayılan: TAPS
--supply-source	Hayır	Tedarik kaynağı, tekrarlanabilir. Varsayılan: APPSTORE_SEARCH_RESULTS
--status	Hayır	Başlangıç durumu: ENABLED veya PAUSED

adapty asa campaigns update

Mevcut bir kampanyayı günceller.

adapty asa campaigns update <campaign-id> --daily-budget 80 --status PAUSED

Argüman	Açıklama
campaign-id	Kampanya ID’si (UUID)

Flag	Açıklama
--name	Yeni kampanya adı
--status	ENABLED veya PAUSED
--country	Ülke listesini değiştirir. Birden fazla ülke için tekrarlayın
--daily-budget	Yeni günlük bütçe
--budget	Yeni toplam ömür boyu bütçe
--target-cpa	Yeni hedef edinim başına maliyet
--bidding-strategy	MANUAL_CPT veya MAX_CONVERSIONS
--currency	Bu çağrıdaki tutarlar için para birimi kodu. Varsayılan: USD

En az bir flag zorunludur.

Reklam grupları

adapty asa ad-groups list

Reklam gruplarını listeler. Yalnızca meta veri döndürür — performans rakamlarını okumak için asa metrics kullanın.

adapty asa ad-groups list --campaign <campaign-id>

Sayfalama flaglerini ve --campaign-group, --app, --campaign, --search ve --status liste filtrelerini kabul eder.

adapty asa ad-groups get

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

adapty asa ad-groups get <ad-group-id>

Argüman	Açıklama
ad-group-id	Reklam grubu kimliği (UUID)

adapty asa ad-groups create

Bir kampanyada reklam grubu oluşturur.

adapty asa ad-groups create --campaign <campaign-id> --name "Brand terms" --default-bid 1.20

Bayrak	Zorunlu	Açıklama
--campaign	Evet	Kampanya ID’si (UUID)
--name	Evet	Reklam grubu adı
--default-bid	Evet	Varsayılan teklif, düz tutar olarak, örneğin 1.20
--cpa-goal	Hayır	Edinim başına maliyet hedefi
--pricing-model	Hayır	CPC veya CPM. Apple her reklam grubunda birini zorunlu kılar. Varsayılan: CPC
--start-time	Hayır	Zamanlama başlangıcı (YYYY-MM-DD). Varsayılan: bugün
--end-time	Hayır	Zamanlama bitişi (YYYY-MM-DD)
--automated-keywords / --no-automated-keywords	Hayır	Apple’ın anahtar kelimeleri otomatik eklemesine izin ver
--currency	Hayır	Bu çağrıdaki tutarlar için para birimi kodu. Varsayılan: USD
--status	Hayır	Başlangıç durumu: ENABLED veya PAUSED

adapty asa ad-groups update

Mevcut bir reklam grubunu günceller.

adapty asa ad-groups update <ad-group-id> --default-bid 1.50 --status PAUSED

Argüman	Açıklama
ad-group-id	Reklam grubu ID’si (UUID)

Bayrak	Açıklama
--name	Yeni reklam grubu adı
--status	ENABLED veya PAUSED
--default-bid	Yeni varsayılan teklif
--cpa-goal	Yeni edinim başı maliyet hedefi
--start-time	Zamanlama başlangıcı (YYYY-MM-DD)
--end-time	Zamanlama bitişi (YYYY-MM-DD)
--automated-keywords / --no-automated-keywords	Apple’ın anahtar kelime eklemesine izin ver
--currency	Bu çağrıdaki tutarlar için para birimi kodu. Varsayılan: USD

En az bir bayrak zorunludur. Üst kampanya sunucu tarafında çözümlenir ve hiçbir zaman iletilmez.

Anahtar Kelimeler

Anahtar kelime komutları, çağrı başına en fazla 100 öğelik gruplar halinde uygulanır. Kontrol paneli eşdeğeri için Anahtar kelimeleri yönet bölümüne bakın.

adapty asa keywords list

Hedefleme anahtar kelimelerini listeler. Performans verilerini okumak için asa metrics komutunu kullanın.

adapty asa keywords list --ad-group <ad-group-id> --status ACTIVE

Sayfalama bayraklarını ve --campaign-group, --app, --campaign, --ad-group, --search ile --status liste filtrelerini kabul eder. --ad-group ile filtreleyin — filtre olmadan bu, konudaki en geniş kapsamlı okumadır.

adapty asa keywords add

Bir reklam grubuna hedefleme anahtar kelimeleri ekleyin.

adapty asa keywords add --ad-group <ad-group-id> --text "running shoes" --text "trail shoes" --bid 1.20

Bunun yerine anahtar kelimeleri bir dosyadan okuyun, her satırda bir tane:

adapty asa keywords add --ad-group <ad-group-id> --from-file keywords.txt

Flag	Gerekli	Açıklama
--ad-group	Evet	Reklam grubu ID’si (UUID). Kampanya buradan çözümlenir
--text	Evet, --from-file kullanılmıyorsa	Anahtar kelime metni. Birden fazlası için tekrarlayın
--from-file	Hayır	Her satırda bir anahtar kelime içeren dosya. --text değerleriyle birleştirilebilir
--bid	Hayır	Anahtar kelime başına teklif miktarı
--match-type	Hayır	BROAD veya EXACT. Varsayılan: BROAD
--currency	Hayır	Bu çağrıdaki tutarlar için para birimi kodu. Varsayılan: USD
--status	Hayır	ACTIVE veya PAUSED. Varsayılan: ACTIVE

Geçersiz bir ID, Apple çağrılmadan önce tüm toplu işlemi başarısız kılar. Apple yine de tek tek anahtar kelimeleri reddedebilir ve her red, nedeniyle birlikte raporlanır.

adapty asa keywords update

Bir veya daha fazla anahtar kelimenin teklifi, durumu, metni veya eşleşme türünü değiştirin.

adapty asa keywords update <keyword-id> <keyword-id> --bid 2.00 --status PAUSED

Argüman	Açıklama
keyword-id	Anahtar kelime ID’si (UUID). Birden fazlasını ekstra argüman olarak geçirin

Flag	Açıklama
--bid	Yeni teklif
--status	ACTIVE veya PAUSED
--match-type	BROAD veya EXACT
--text	Yeni anahtar kelime metni. Yalnızca tek bir anahtar kelime için geçerlidir
--currency	Bu çağrıdaki tutarlar için para birimi kodu. Varsayılan: USD

Geçirilen her ID için tek bir değişiklik uygulanır.

Negatif anahtar kelimeler

adapty asa negative-keywords list

Negatif anahtar kelimeleri listele. ad_group_id alanı boş olan satırlar kampanya düzeyindedir.

adapty asa negative-keywords list --campaign <campaign-id>

Flag	Açıklama
--campaign-level-only	Yalnızca kampanya düzeyindeki satırları göster

Sayfalama flag’lerini ve --campaign-group, --app, --campaign, --ad-group ve --search liste filtrelerini kabul eder.

adapty asa negative-keywords add

Bir reklam grubuna veya kampanyaya negatif anahtar kelimeler ekleyin.

adapty asa negative-keywords add --ad-group <ad-group-id> --text free

Bunları bir kampanyanın tüm reklam gruplarına uygulayın:

adapty asa negative-keywords add --campaign <campaign-id> --all-ad-groups --text free

Bayrak	Zorunlu	Açıklama
--ad-group	--ad-group veya --campaign’den biri	Reklam grubu ID’si (UUID). Kampanya buradan çözümlenir
--campaign	--ad-group veya --campaign’den biri	Kampanya ID’si (UUID)
--text	Evet	Anahtar kelime metni. Birden fazla için tekrarlayın
--all-ad-groups	Hayır	Kampanyanın kendisi yerine tüm reklam gruplarına uygular. --campaign gerektirir
--match-type	Hayır	BROAD veya EXACT. Varsayılan: EXACT
--status	Hayır	ACTIVE veya PAUSED. Varsayılan: ACTIVE

--ad-group ve --campaign birbirini dışlar. Yalnızca birini belirtin.

Arama terimleri

adapty asa search-terms list

Reklamlarınızı tetikleyen arama terimlerini listeler. Yeni anahtar kelimeler ve negatif anahtar kelimeler bulmak için kullanın.

adapty asa search-terms list --ad-group <ad-group-id> --date-from 2026-07-01 --date-to 2026-07-31

Flag	Varsayılan	Açıklama
--date-from	Bugün	Raporlama döneminin başlangıcı (YYYY-MM-DD)
--date-to	Bugün	Raporlama döneminin sonu (YYYY-MM-DD)

Sayfalama flag’lerini ve --campaign-group, --app, --campaign, --ad-group ile --search liste filtrelerini kabul eder.

Bu komut, asa metrics ile analitik havuzunu paylaşır. Bkz. Hatalar.

Reklamlar

adapty asa ads list

Reklamları listeler. serving_state_reasons alanı, bir reklamın neden yayınlanmadığını açıklar.

adapty asa ads list --ad-group <ad-group-id>

Sayfalama bayraklarını ve --campaign-group, --campaign, --ad-group, --search ve --status liste filtrelerini kabul eder. Bu listede --app filtresi yoktur, çünkü reklamlar reklam gruplarına aittir.

adapty asa ads get

Belirli bir reklamın ayrıntılarını alır.

adapty asa ads get <ad-id>

Argüman	Açıklama
ad-id	Reklam ID (UUID)

adapty asa ads create

Bir reklam grubunda reklam oluşturur.

adapty asa ads create --ad-group <ad-group-id> --creative-id 4321 --name "Summer ad"

Flag	Zorunlu	Açıklama
--ad-group	Evet	Reklam grubu ID’si (UUID). Kampanya buradan çözümlenir
--creative-id	Evet	Apple kreatif ID’si. Bkz. creatives list
--name	Evet	Reklam adı
--status	Hayır	Başlangıç durumu: ENABLED veya PAUSED

adapty asa ads update

Mevcut bir reklamı günceller.

adapty asa ads update <ad-id> --status PAUSED

Argüman	Açıklama
ad-id	Reklam ID’si (UUID)

Flag	Açıklama
--name	Yeni reklam adı
--status	ENABLED veya PAUSED

En az bir flag gereklidir. Kreatif ve üst reklam grubu oluşturma sırasında sabitlenir.

Görseller

adapty asa creatives list

Yeni reklamlar için mevcut creative’leri listeler.

adapty asa creatives list --app <app-id>

Burada döndürülen creative_id, ads create için --creative-id değeridir.

Sayfalama bayraklarını ve --campaign-group ile --app liste filtrelerini kabul eder.

Ürün sayfaları

adapty asa product-pages list

Uygulamalarınızda mevcut olan özel ürün sayfalarını listeleyin.

adapty asa product-pages list --app <app-id>

Sayfalama bayraklarını ve --campaign-group ile --app liste filtrelerini kabul eder.

adapty asa product-pages sync

App Store Connect’teki özel ürün sayfalarını yeniler.

adapty asa product-pages sync --adam-id 123456

Flag	Açıklama
--adam-id	Yenilemeyi tek bir uygulamayla sınırlar. Her uygulamayı kapsamak için atlayın

Yenileme hemen gerçekleştirilmez, sıraya alınır ve komut Sync queued. mesajıyla bunu onaylar. Aynı yenileme zaten devam ediyorsa bunun yerine Already running; nothing new was queued. mesajı görüntülenir.

Otomasyonlar

CLI, verdiğiniz kural JSON’ını saklar — kuralları oluşturmaz. Her kural türünün ne yaptığı için Otomasyonlar sayfasına, kural dosyası oluşturma hakkında ise Otomasyon kurallarını çalıştır sayfasına bakın.

adapty asa automations list

Otomasyon kurallarını listeler. status alanı aktif için 1, durdurulmuş için 0 değerini alır.

adapty asa automations list

Sayfalandırma bayraklarını kabul eder.

adapty asa automations get

Belirli bir otomasyon kuralını, koşulları ve eylemlerini dahil ederek getirir.

adapty asa automations get <automation-id>

Argument	Description
automation-id	Otomasyon kuralı ID’si (UUID)

adapty asa automations create

JSON kural dosyasından bir otomasyon kuralı oluşturur.

adapty asa automations create --file rule.json

Flag	Açıklama
--file	Kural gövdesini içeren JSON dosyası veya standart girdiden okumak için -
--run-now	Kural kaydedildikten hemen sonra ilk çalıştırmayı kuyruğa alır

--file zorunludur.

adapty asa automations update

Bir otomasyon kuralını değiştirin: durdurun, yeniden adlandırın veya kuralın bölümlerini değiştirin.

adapty asa automations update <automation-id> --stop

Argüman	Açıklama
automation-id	Otomasyon kuralı kimliği (UUID)

Bayrak	Açıklama
--start	Kuralı etkinleştir
--stop	Kuralı durdur ve bir sonraki çalışma zamanını temizle
--name	Yeni kural adı
--file	Değiştirilecek bölümleri içeren JSON dosyası ya da standart girdiden okumak için -

--start ve --stop birlikte kullanılamaz. Buraya iletilen dosya internal_id içermemelidir.

adapty asa automations run

Bir otomasyon kuralını program dışında tek seferlik çalıştırır.

adapty asa automations run <automation-id> --dry-run

Argüman	Açıklama
automation-id	Otomasyon kuralı ID’si (UUID)

Bayrak	Açıklama
--dry-run	Kuralı değerlendirir ve Apple Ads’te herhangi bir değişiklik yapmadan sonucu kaydeder

Çalıştırma kuyruğa alınır ve komut bir çalıştırma ID’si yazdırır. Sonucu automations runs ile okuyun.

adapty asa automations runs

Bir otomasyon kuralının geçmiş çalışmalarını, deneme çalışmaları (dry run) dahil olmak üzere listeler.

adapty asa automations runs <automation-id>

Argüman	Açıklama
automation-id	Otomasyon kuralı kimliği (UUID)

Sayfalandırma bayraklarını kabul eder.

Metrikler

adapty asa metrics

Bir tarih aralığında hesabın herhangi bir düzeyi için metrikleri sorgulayın.

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31

Bayrak	Zorunlu	Açıklama
--entity	Evet	Raporlanacak şey: campaign, ad-group, keyword veya ad
--date-from	Evet	Dönem başlangıcı (YYYY-MM-DD)
--date-to	Evet	Dönem sonu (YYYY-MM-DD)
--metric	Hayır	Metrik adı, tekrarlanabilir. Tüm metrikler için belirtmeyin
--group-by	Hayır	Satırları country, day, week, month, quarter veya year değerlerine göre gruplandırır. Tekrarlanabilir
--by-days	Hayır	Kohort metrikleri için gün cinsinden yenileme penceresi, tekrarlanabilir. Çağrı başına maksimum 16. Kontrol paneli varsayılanları için belirtmeyin
--order-by	Hayır	Sıralama için kullanılacak metrik veya alan
--order-by-day	Hayır	Bu yenileme penceresindeki kohort metriğine göre sırala. --by-days değerlerinden biri olmalıdır
--order	Hayır	asc veya desc. Varsayılan: desc

Sayfalama bayraklarını kabul eder. Bu komut liste filtreleri almaz — raporu varlık düzeyi ve döneme göre daraltın, ardından satırları kapsamlı bir list komutundan gelen ID’lerle eşleştirin.

Her satır, sunucuda toplanmış ve --order-by ile sıralanmış tek bir varlıktır. Dolayısıyla en yüksek N sorusu tek bir çağrıdır — sonuçlar arasında sayfalama yapıp toplama yapmak yerine --order-by ve --page-size N ayarlarını kullanın:

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5

--metric parametresi, Ads Manager’ın takip ettiği metrik adlarını alır; kontrol paneli terminolojisiyle — örneğin spend, taps veya gross_roas. Tam liste ve her birinin nasıl hesaplandığı için Metrikler bölümüne bakın. Var olmayan bir ad, hata mesajında geçerli adlar listelenerek başarısız olur.

Raporlama döneminin uzunluğu, en kaba --group-by değeriyle sınırlandırılır. Daha uzun bir dönem için rapor almak istiyorsanız, isteği birden fazla çağrıya bölmek yerine gruplama düzeyini kabalaştırın:

En kaba --group-by	Maksimum dönem
day veya dönem gruplandırması yok	90 gün
week	180 gün
month ve daha kaba	365 gün

ltv metriği yoktur. Lifetime value, bir yenileme penceresinde okunan bir kohort metriğidir; bu nedenle 7. gün veya 90. gün değerini almak için --by-days kullanılır:

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90

--order-by-day, satırları bu pencerelerden birine göre sıralar; böylece tek bir çağrıda 90. güne göre en iyi kampanyaları ROAS sırasıyla döndürür.

adapty asa metrics overview

Belirli bir dönem için sorgulama toplamlarını zaman birimine göre gruplandırır.

adapty asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit week

Bayrak	Zorunlu	Açıklama
--entity	Evet	Raporlanacak öğe: campaign, ad-group, keyword veya ad
--date-from	Evet	Dönemin başlangıcı (YYYY-MM-DD)
--date-to	Evet	Dönemin sonu (YYYY-MM-DD)
--period-unit	Hayır	Gruplama birimi: day, week, month, quarter veya year. Varsayılan: day
--metric	Hayır	Metrik adı, tekrarlanabilir. Tüm metrikler için belirtmeyin
--by-days	Hayır	Kohort metrikleri için yenileme penceresi (gün cinsinden), tekrarlanabilir. Çağrı başına en fazla 16

Bu komut, tüm varlık düzeyi için toplamları ve dönem bazlı bir seriyi birlikte döndürür; böylece “toplamda ne kadar harcadım veya kazandım” sorusunu tek bir çağrıyla yanıtlar. Sıralama bayrağı ve sayfalama içermez.

Bu komutta --metric, yalnızca kohort köklerini kabul eder — revenue, roas ve arpu — gross_, proceeds_ veya net_ varyantlarını kabul etmez.

Raporlama döneminin uzunluğu --period-unit tarafından sınırlandırılır:

--period-unit	Maksimum dönem
day	90 gün
week	180 gün
month ve daha kaba	365 gün

Rakipler

adapty asa competitors summary

Bir dizi App Store uygulamasının teklif verdiği Apple Ads anahtar kelimelerini özetler. Bu komut, kontrol panelindeki Market Intelligence ile aynı rakip verilerini döndürür.

adapty asa competitors summary --app-ids 1668337467,6503873027

Flag	Gerekli	Açıklama
--app-ids	Evet	Apple App Store ID’leri (adam_id), virgülle ayrılmış. 1 ile 5 arasında değer

Raporlama dönemi ve ülke kümesi sunucuda sabittir — son tam ay, tüm ülkeler. Bu komutun dönem, ülke veya sayfalama bayrakları yoktur.

Komut üç blok yazdırır: analize ilişkin toplamlar, performansa göre öne çıkan uygulamalar ve en çok rekabet edilen terimler. Tam sonuç için --json ekleyin; bu aynı zamanda her uygulamanın terimlerini ülkeye göre de ayrıştırır.

Bir uygulama kümesi için ilk çağrı, veriler hazırlanırken onlarca saniye sürebilir. Aynı uygulamalar için sonraki çağrılar daha hızlı döner.

Hatalar

Durum	Kod	Anlam
402	ads_manager_subscription_required	Şirketin aktif bir Ads Manager aboneliği yok
404	—	Varlık mevcut değil veya başka bir şirkete ait
409	cli_idempotency_in_progress	Aynı idempotency anahtarıyla yapılan bir yazma işlemi hâlâ devam ediyor
422	cli_idempotency_key_reuse	Aynı idempotency anahtarı farklı bir istek gövdesiyle kullanıldı
429	cli_analytics_busy	Analytics havuzu meşgul. Bekleme süresi Retry-After başlığında belirtiliyor
429	cli_cooldown_active	Çok fazla reddedilen istek, token’ı bekleme moduna aldı

Metrikler ve arama terimleri listesi, şirket başına tek bir analitik bütçesini paylaşır: dakikada 5 çağrı ve her 10 saniyede en fazla 2 çağrı. 5 dakika içinde 20 reddedilen istek birikimi, kademeli bir bekleme süresi başlatır: önce 5 dakika, ardından 30 dakika, sonra 3 saat. Bekleme süresi boyunca yeniden deneme yapmak bu süreyi uzatmaz; ancak asıl çözüm, başarısız isteği düzeltmektir, tekrarlamak değil.

CLI, kısa bekleme sürelerini sizin yerinize yönetir. Bekleme süresi olmayan bir 429 hatasında, Retry-After değeri 60 saniye veya daha azsa komut bu kadar bekler ve bir kez daha dener; bekleme süresi standart hata çıktısında raporlanır.