# Gelir ve Apple Ads uçları

> https://storelift.net/tr/docs/api/growth/

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. Temel adres `https://storelift.net/v1` · kimlik doğrulama, kredi ve ortak parametreler: https://storelift.net/tr/docs/api/

## 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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `days` (query, integer) — günlük serinin kaç gün döneceği, 1–365 (varsayılan 90)

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

## 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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `days` (query, integer) — gün cinsinden pencere, 1–365 (varsayılan 90)

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

## 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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `days` (query, integer) — gün cinsinden geçmiş penceresi, 1–365 (varsayılan 90)

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

## 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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği

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

## 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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `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

```sh
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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `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

```sh
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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `id` (query, string) — tek komut için, listede döndüğü hâliyle komut kimliği

```sh
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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `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)

```sh
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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `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

```sh
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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `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)

```sh
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

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `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)

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