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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
days | query | integer | gü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"Ö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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
days | query | integer | gü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"Ö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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
days | query | integer | gü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"Ö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.
Ayrıca kabul ettikleri: appId (zorunlu)
curl "https://storelift.net/v1/apps/sbx-lumen/campaigns" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Ö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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
country | query | string | organik sıra sütunu için ülke kodu (varsayılan: uygulamanın ilk ülkesi) |
campaign | query | string | tek 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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
country | query | string | organik sıra sütunu için ülke kodu (varsayılan: uygulamanın ilk ülkesi) |
campaign | query | string | tek 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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
id | query | string | tek 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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
terms | query | string | bakılacak ek terimler, virgülle ayrılmış, en fazla 50 |
limit | query | number | dö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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
country | query | string | tek vitrine daraltmak için iki harfli ülke kodu |
product | query | string | tek ü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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
country | query | string | tek satır döndürmek için iki harfli ülke kodu |
product | query | string | ü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.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
country | query | string | sıralar ve sayfa zaman çizelgesi için ülke kodu (varsayılan: uygulamanın ilk ülkesi) |
day | query | string | değişiklik günü YYYY-MM-DD (varsayılan: en son değişiklik) |
window | query | integer | her 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"