Entwicklerdokumentation › API-Referenz

Endpunkte für Umsatz & Apple Ads

Die verbundenen Quellen je App: Umsatz, Abo-Ereignisse, der App-Store-Funnel, Preise und Angebotscodes, das Vorher und Nachher einer Änderung sowie Kampagnen, Keywords, Suchbegriffe und Befehle in Apple Ads. Scopes revenue:read und ads:read.

Authentifizierung · Credits · Gemeinsame Parameter · Fehlercodes · openapi.json

GET /apps/{appId}/revenue

Umsatz und Downloads einer App aus den Quellen, die der Nutzer verbunden hat: tägliche Einheiten je Land aus App Store Connect, tägliche Installationen aus Google Play und aus RevenueCat MRR, 28-Tage-Umsatz, aktive Abos und Testphasen mit der Aufschlüsselung der MRR-Bewegung. connected=false heißt, es ist keine Quelle verbunden; measured=false heißt, die Quellen enthalten keine Zeilen für diese App. Nichts hier ist geschätzt.

Scope
revenue:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
daysqueryintegerwie viele Tage der Tagesreihe geliefert werden, 1–365 (Standard 90)

Nimmt außerdem: appId (erforderlich)

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

In der Sandbox öffnen

Beispielantwort

GET /apps/{appId}/subscriptions

Zahl der Abo-Ereignisse einer App aus dem Webhook von RevenueCat / Adapty: je Tag und je Land — Testphasen-Starts, Testphasen-Umwandlungen, bezahlte Starts, Verlängerungen, Kündigungen, Erstattungen, Zahlungsprobleme und Umsatz — dazu Monatskohorten (Nutzer, Zahlende). Gezählt werden Ereignisse, nicht Nutzer. connected=false heißt, es ist kein Webhook verbunden.

Scope
revenue:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
daysqueryintegerFenster in Tagen, 1–365 (Standard 90)

Nimmt außerdem: appId (erforderlich)

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

In der Sandbox öffnen

Beispielantwort

GET /apps/{appId}/funnel

Der Conversion-Funnel des App Store für eine App aus den Analysedaten von App Store Connect: Impressionen → Produktseitenaufrufe → Downloads, der heutige Punkt plus der Verlauf Tag für Tag, mit den Aufschlüsselungen nach Traffic-Quelle und eigener Produktseite, wenn Apple sie bereitstellt. Für Google Play gibt es hier keine Entsprechung. connected=false heißt, App Store Connect ist nicht verbunden.

Scope
revenue:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
daysqueryintegerVerlaufsfenster in Tagen, 1–365 (Standard 90)

Nimmt außerdem: appId (erforderlich)

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

In der Sandbox öffnen

Beispielantwort

GET /apps/{appId}/campaigns

Apple-Ads-Kampagnen, die eine App bewerben (zugeordnet über die App-Store-ID der App, nicht über den Namen): Ausgaben, Impressionen, Taps, Installationen, Budget und Auslieferungsstatus je Kampagne über die letzten 28 Tage, die Summen sowie die Top-Keywords und Suchbegriffe nach Ausgaben. Die Ausgaben stehen in der Währung des Kontos (currency). connected=false heißt, Apple Ads ist nicht verbunden.

Scope
ads:read
Credits
1
Plan
Pro

Nimmt außerdem: appId (erforderlich)

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

In der Sandbox öffnen

Beispielantwort

GET /apps/{appId}/ads-keywords

Jedes für eine App gebuchte Apple-Ads-Keyword über alle ihre Kampagnen (letzte 28 Tage), nach Ausgaben: Gebot, Match-Typ, Anzeigengruppe, Ausgaben, Impressionen, Taps, Installationen, Tap-Through-Rate, Conversion-Rate, Kosten pro Tap und Kosten pro Installation, daneben der organische Platz der App für dasselbe Wort im Land (tracked:false, wenn das Wort nicht verfolgt wird). Übergeben Sie campaign, um auf eine Kampagne einzugrenzen. connected=false heißt, Apple Ads ist nicht verbunden.

Scope
ads:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
countryquerystringLändercode für die Spalte mit dem organischen Platz (Standard: erstes Land der App)
campaignquerystringKampagnen-ID, um auf eine Kampagne einzugrenzen

Nimmt außerdem: appId (erforderlich)

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

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

Die Suchanfragen, die Menschen tatsächlich eingegeben haben und die Apple-Ads-Anzeigen der App ausgelöst haben (letzte 28 Tage), nach Ausgaben: der Suchbegriff, das Keyword und der Match-Typ, die ihn erfasst haben, Ausgaben, Taps, Installationen, Kosten pro Tap und pro Installation und daneben der organische Platz der App für diese Suche im Land — die Liste der Suchanfragen, die als Keywords oder als negative Keywords hinzugefügt werden sollten oder für die nicht mehr gezahlt werden muss, weil die App dort bereits rankt. Begriffe, die Apple wegen geringen Volumens verbirgt, werden unter hidden summiert. connected=false heißt, Apple Ads ist nicht verbunden.

Scope
ads:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
countryquerystringLändercode für die Spalte mit dem organischen Platz (Standard: erstes Land der App)
campaignquerystringKampagnen-ID, um auf eine Kampagne einzugrenzen

Nimmt außerdem: appId (erforderlich)

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

GET /apps/{appId}/ads-commands

Apple-Ads-Befehle für die Kampagnen einer App — aus dem Dashboard, aus Automatisierungsregeln und aus confirm_action — das Neueste zuerst, jeweils mit Status: queued, applying, applied, failed oder unknown (der Schreibvorgang wurde unterbrochen und hat Apple vielleicht erreicht, vielleicht auch nicht — prüfen Sie Apple Ads, bevor Sie ihn erneut senden), wann er abgeschlossen wurde, dem Fehler, falls vorhanden, und dem zugehörigen Rückgängig-Schritt. Übergeben Sie id für einen einzelnen Befehl.

Scope
ads:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
idquerystringBefehls-ID, wie in der Liste geliefert, für einen einzelnen Befehl

Nimmt außerdem: appId (erforderlich)

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

GET /apps/{appId}/search-popularity

Apples eigene Suchpopularität, aus dem mit diesem Workspace verbundenen Apple-Ads-Konto: die meistgesuchten Begriffe im Land für die Kategorie der App (wöchentlich, in Apples Reihenfolge), jeweils mit Platz in der Kategorie und Popularität 1-100 (in der Kategorie und landesweit) und 1-5 (die Apple-Ads-Skala), dazu jedes verfolgte Keyword mit inTopTerms true oder false. Übergeben Sie terms, um weitere Wörter zu prüfen. connected=false heißt, Apple Ads ist nicht verbunden.

Scope
ads:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
termsquerystringzusätzliche Begriffe zum Nachschlagen, durch Komma getrennt, bis zu 50
limitquerynumberAnzahl der Top-Begriffe, bis zu 200 (Standard 50)

Nimmt außerdem: appId (erforderlich) · country

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

GET /apps/{appId}/pricing

Produktpreise und Angebotscodes einer App aus dem Webhook von RevenueCat oder Adapty, über die letzten 365 Tage: je Produkt und Land der derzeit geltende Preis (Währung, lokaler Preis, seit wann) und jeder Zeitraum mit festem Preis samt Testphasen-Starts, neuen bezahlten Abos, Testphasen-Umwandlungen und Umsatz, dazu jeder Angebotscode mit erstem und letztem Tag und Einlösungen. Eine Preisänderung erscheint als neuer Zeitraum, Vorher/Nachher wird also Zeitraum für Zeitraum gelesen. connected=false heißt, keiner der beiden Webhooks ist verbunden.

Scope
revenue:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
countryquerystringzweistelliger Ländercode, um auf ein Storefront einzugrenzen
productquerystringProdukt-ID des Stores, um auf ein Produkt einzugrenzen

Nimmt außerdem: appId (erforderlich)

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

GET /apps/{appId}/country-prices

Länderpreise für eines der Produkte der App, gelesen aus App Store Connect / Google Play (Pro): je Land der lokale Preis, sein USD-Wert und Index (USA = 100), ob es noch Apples (oder Googles) automatischer Preis ist, der Median der Wettbewerber, die ihre Preise lokalisieren (Multiplikator gegenüber Apples automatischem Preis, mit der Zahl der Wettbewerber) und die Differenz in Prozent, dazu ein empfohlener Preis, auf eine attraktive Preisstufe gerundet, mit Begründung (Wettbewerber-Median oder Einkommensband). Wettbewerber sind die manuell hinzugefügten iOS-Wettbewerber der App; ein Land braucht mindestens 3 davon für einen Vergleich. summary zählt die Länder, die über und unter den Wettbewerbern bepreist sind, und die, die noch beim automatischen Preis liegen. state ist not_connected, pending (die erste Lesung steht noch aus), permission (die Rolle des Schlüssels darf keine Preise lesen), no_products oder ok. products listet die anderen Produkte; übergeben Sie product, um zu wechseln.

Scope
revenue:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
countryquerystringzweistelliger Ländercode, um eine Zeile zu erhalten
productquerystringProdukt-ID oder SKU (Standard: das erste Produkt)

Nimmt außerdem: appId (erforderlich)

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

GET /apps/{appId}/change-impact

Was eine Änderung bewirkt hat: Für einen Änderungstag (eine neue Version, Screenshots, Untertitel, Keyword-Feld, ein Kampagnenstart — Standard ist die jüngste Änderung auf der Zeitleiste der Produktseite) wird dieselbe Anzahl Tage davor und danach nebeneinander verglichen: Keyword-Platzierungen (gestiegen/gefallen/neu/herausgefallen und die größten Bewegungen), der App-Store-Funnel (Impressionen, Seitenaufrufe, Downloads pro Tag und die Conversion-Rates), Downloads aus dem Verkaufsbericht sowie Abo-Umsatz und Testphasen-/bezahlte Starts pro Tag, jeweils mit der Veränderung in Prozent. Der Änderungstag selbst bleibt aus beiden Fenstern heraus. complete=false heißt, das Danach-Fenster läuft noch. recentChanges listet die letzten Änderungstage, um einen anderen zu wählen.

Scope
revenue:read
Credits
1
Plan
Pro
ParameterOrtTypBeschreibung
countryquerystringLändercode für Platzierungen und die Zeitleiste der Produktseite (Standard: erstes Land der App)
dayquerystringÄnderungstag YYYY-MM-DD (Standard: die jüngste Änderung)
windowqueryintegerTage auf jeder Seite, 3–30 (Standard 7)

Nimmt außerdem: appId (erforderlich)

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