Geliştirici belgeleri › API referansı

Gelir ve Apple Ads uçları

Uygulama başına bağlı kaynaklar: gelir, abonelik olayları, App Store hunisi, fiyatlar ve teklif kodları, bir değişikliğin öncesi ve sonrası; Apple Ads kampanyaları, kelimeleri, arama terimleri ve komutları. Kapsamlar: revenue:read ve ads:read.

Kimlik doğrulama · Kredi · Ortak parametreler · Hata kodları · openapi.json

GET /apps/{appId}/revenue

Bir uygulamanın, kullanıcının bağladığı kaynaklardan gelen geliri ve indirmeleri: App Store Connect'ten ülke başına günlük adetler, Google Play'den günlük kurulumlar ve RevenueCat'ten MRR, 28 günlük gelir, aktif abonelikler ve denemeler ile MRR hareket dökümü. connected=false hiçbir kaynağın bağlı olmadığını; measured=false kaynaklarda bu uygulama için satır bulunmadığını gösterir. Buradaki hiçbir sayı tahmin değildir.

Kapsam
revenue:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
daysqueryintegergünlük serinin kaç gün döneceği, 1–365 (varsayılan 90)

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/revenue" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Kum havuzunda aç

Örnek yanıt

GET /apps/{appId}/subscriptions

Bir uygulama için RevenueCat / Adapty webhook'undan gelen abonelik olayı sayıları: gün ve ülke bazında — deneme başlangıçları, deneme dönüşümleri, ücretli başlangıçlar, yenilemeler, iptaller, iadeler, ödeme sorunları ve gelir — ayrıca aylık kohortlar (kullanıcılar, ödeyenler). Sayılar olaydır, kullanıcı değil. connected=false hiçbir webhook'un bağlı olmadığını gösterir.

Kapsam
revenue:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
daysqueryintegergün cinsinden pencere, 1–365 (varsayılan 90)

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/subscriptions" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Kum havuzunda aç

Örnek yanıt

GET /apps/{appId}/funnel

Bir uygulamanın App Store Connect analitiğinden gelen App Store dönüşüm hunisi: gösterimler → ürün sayfası görüntülemeleri → indirmeler; bugünün noktası ve gün gün geçmiş, Apple sağladığında trafik kaynağı ve özel ürün sayfası dökümleriyle. Google Play'in burada karşılığı yok. connected=false App Store Connect'in bağlı olmadığını gösterir.

Kapsam
revenue:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
daysqueryintegergün cinsinden geçmiş penceresi, 1–365 (varsayılan 90)

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/funnel" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Kum havuzunda aç

Örnek yanıt

GET /apps/{appId}/campaigns

Bir uygulamayı tanıtan Apple Ads kampanyaları (ada göre değil, uygulamanın App Store kimliğine göre eşleşir): son 28 günde kampanya başına harcama, gösterim, dokunma, kurulum, bütçe ve yayın durumu, toplamlar ve harcamaya göre en üstteki kelimeler ile arama terimleri. Harcama hesabın kendi para birimindedir (currency). connected=false Apple Ads'in bağlı olmadığını gösterir.

Kapsam
ads:read
Kredi
1
Plan
Pro

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/campaigns" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Kum havuzunda aç

Örnek yanıt

GET /apps/{appId}/ads-keywords

Bir uygulama için kampanyalarının tamamında satın alınan bütün Apple Ads kelimeleri (son 28 gün), harcamaya göre: teklif, eşleşme türü, reklam grubu, harcama, gösterim, dokunma, kurulum, dokunma oranı, dönüşüm oranı, dokunma başı ve kurulum başı maliyet; yanında uygulamanın o ülkede aynı kelimedeki organik sırası (kelime izlenmiyorsa tracked:false). Tek kampanyaya daraltmak için campaign gönder. connected=false Apple Ads'in bağlı olmadığını gösterir.

Kapsam
ads:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
countryquerystringorganik sıra sütunu için ülke kodu (varsayılan: uygulamanın ilk ülkesi)
campaignquerystringtek kampanyaya daraltmak için kampanya kimliği

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/ads-keywords?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/ads-search-terms

İnsanların gerçekten yazdığı ve uygulamanın Apple Ads reklamlarını tetikleyen aramalar (son 28 gün), harcamaya göre: arama terimi, onu yakalayan kelime ve eşleşme türü, harcama, dokunma, kurulum, dokunma başı ve kurulum başı maliyet, yanında uygulamanın o ülkede aynı aramadaki organik sırası — kelime olarak eklenecek, negatif olarak eklenecek ya da uygulama orada zaten sıralandığı için parası kesilecek aramaların listesi. Apple'ın düşük hacim nedeniyle gizlediği terimler hidden altında toplanır. connected=false Apple Ads'in bağlı olmadığını gösterir.

Kapsam
ads:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
countryquerystringorganik sıra sütunu için ülke kodu (varsayılan: uygulamanın ilk ülkesi)
campaignquerystringtek kampanyaya daraltmak için kampanya kimliği

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/ads-search-terms?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/ads-commands

Bir uygulamanın kampanyaları için Apple Ads komutları — panelden, otomasyon kurallarından ve confirm_action'dan — en yeni en üstte, her biri durumuyla: queued, applying, applied, failed ya da unknown (yazım yarıda kesildi; Apple'a ulaşmış da olabilir, ulaşmamış da — yeniden göndermeden önce Apple Ads'te kontrol et), ne zaman bittiği, varsa hata ve taşıdığı geri alma. Tek komut için id gönder.

Kapsam
ads:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
idquerystringtek komut için, listede döndüğü hâliyle komut kimliği

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/ads-commands" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/search-popularity

Apple'ın kendi arama popülerliği, bu çalışma alanına bağlı Apple Ads hesabından: uygulamanın kategorisi için o ülkede en çok aranan terimler (haftalık, Apple'ın sırasıyla); her biri kategorideki sırası ve 1-100 (kategoride ve ülke genelinde) ile 1-5 (Apple Ads ölçeği) popülerliğiyle, ayrıca izlenen her kelime inTopTerms true ya da false olarak işaretli. Daha fazla kelimeye bakmak için terms gönder. connected=false Apple Ads'in bağlı olmadığını gösterir.

Kapsam
ads:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
termsquerystringbakılacak ek terimler, virgülle ayrılmış, en fazla 50
limitquerynumberdöndürülecek üst terim sayısı, en fazla 200 (varsayılan 50)

Ayrıca kabul ettikleri: appId (zorunlu) · country

curl "https://storelift.net/v1/apps/sbx-lumen/search-popularity?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/pricing

Bir uygulamanın RevenueCat ya da Adapty webhook'undan gelen ürün fiyatları ve offer code'ları, son 365 gün için: ürün ve ülke bazında şu an geçerli fiyat (para birimi, yerel fiyat, ne zamandan beri) ve her sabit fiyat dönemi; deneme başlangıçları, yeni ücretli abonelikler, deneme dönüşümleri ve geliriyle; ayrıca her offer code ilk ve son günü ve kullanım sayısıyla. Fiyat değişikliği yeni bir dönem olarak görünür; böylece öncesi/sonrası dönem dönem okunur. connected=false iki webhook'un da bağlı olmadığını gösterir.

Kapsam
revenue:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
countryquerystringtek vitrine daraltmak için iki harfli ülke kodu
productquerystringtek ürüne daraltmak için mağaza ürün kimliği

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/pricing?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/country-prices

Uygulamanın bir ürünü için ülke fiyatları, App Store Connect / Google Play'den okunur (Pro): ülke başına yerel fiyat, USD karşılığı ve endeksi (ABD = 100), hâlâ Apple'ın (ya da Google'ın) otomatik fiyatı olup olmadığı, fiyatlarını yerelleştiren rakiplerin medyanı (Apple'ın otomatik fiyatına göre çarpan, kaç rakiple) ve yüzde farkı; ayrıca çekici bir fiyat basamağına yuvarlanmış önerilen fiyat ve gerekçesi (rakip medyanı ya da gelir bandı). Rakipler, uygulamanın elle eklenmiş iOS rakipleridir; bir ülkenin karşılaştırılması için bunlardan en az 3'ü gerekir. summary, rakiplerin üstünde ve altında fiyatlanan ve hâlâ otomatik fiyatta olan ülkeleri sayar. state şunlardan biridir: not_connected, pending (ilk okuma henüz yapılmadı), permission (anahtarın rolü fiyatları okuyamıyor), no_products ya da ok. products diğer ürünleri listeler; değiştirmek için product gönder.

Kapsam
revenue:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
countryquerystringtek satır döndürmek için iki harfli ülke kodu
productquerystringürün kimliği ya da SKU (varsayılan: ilk ürün)

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/country-prices?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/change-impact

Bir değişikliğin ne yaptığı: tek bir değişiklik günü için (yeni sürüm, ekran görüntüleri, alt başlık, kelime alanı, kampanya başlangıcı — varsayılan, sayfa zaman çizelgesindeki en son değişiklik) öncesindeki ve sonrasındaki aynı sayıda günü yan yana karşılaştırır: kelime sıraları (yükselen/düşen/giren/çıkan ve en büyük hareketler), App Store hunisi (günlük gösterim, sayfa görüntüleme, indirme ve dönüşüm oranları), satış raporundan indirmeler ve günlük abonelik geliri ile deneme/ücretli başlangıçlar; her biri yüzde değişimiyle. Değişiklik gününün kendisi iki pencerenin de dışında tutulur. complete=false sonraki pencerenin hâlâ sürdüğünü gösterir. recentChanges, başka birini seçmek için son değişiklik günlerini listeler.

Kapsam
revenue:read
Kredi
1
Plan
Pro
ParametreYerTürAçıklama
countryquerystringsıralar ve sayfa zaman çizelgesi için ülke kodu (varsayılan: uygulamanın ilk ülkesi)
dayquerystringdeğişiklik günü YYYY-MM-DD (varsayılan: en son değişiklik)
windowqueryintegerher iki yandaki gün sayısı, 3–30 (varsayılan 7)

Ayrıca kabul ettikleri: appId (zorunlu)

curl "https://storelift.net/v1/apps/sbx-lumen/change-impact?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"