RevGlanceDocumentatie

App Store

Koppel App Store Connect met een API-sleutel om dagelijkse Sales and Trends-rapporten voor iOS en Mac te lezen.

RevGlance leest de dagelijkse Sales and Trends-rapporten van Apple via de App Store Connect API. Het SALES-overzicht geeft betaalde apps en in-app-aankopen; het SUBSCRIBER-rapport geeft elke abonnementsbetaling, gratis proefperiode en terugbetaling.

Koppelen

  1. Open in App Store Connect Users and Access › Integrations › App Store Connect API en genereer een teamsleutel met de rol Finance of Sales.
  2. Noteer de Issuer ID boven de lijst met sleutels en de Key ID van de sleutel, en download daarna het .p8-bestand. Apple laat je het maar één keer downloaden.
  3. Je vendor number vind je onder Payments and Financial Reports (linksboven).
  4. Vul de vier velden in, plak daarbij het hele .p8-bestand inclusief de regels -----BEGIN PRIVATE KEY-----, en kies dan App Store koppelen.

Wat het formulier vraagt

VeldZiet eruit als
Issuer-ID57246542-96fe-1a63-e053-0824d011072a
Sleutel-ID2X9R4HXF34
Leveranciersnummer85012345
Privésleutel (inhoud van .p8)Versleuteld opgeslagen-----BEGIN PRIVATE KEY-----

Voeg de webhook toe

Rapporten komen ongeveer een dag later binnen. App Store Server Notifications laten RevGlance meteen weten dat er iets verandert, zodat het volgende rapport wordt opgehaald zodra het er is.

  1. Open in RevGlance Instellingen › Bronnen, open het menu van de App Store-bron en kies Webhook.
  2. Verzin een lang willekeurig geheim, plak het onder Ondertekeningsgeheim en sla op.
  3. Kopieer de webhook-URL en zet ?token= en je geheim aan het eind.
  4. Open in App Store Connect de App Information van je app, en stel onder App Store Server Notifications dat adres in als productie-URL, versie 2.

RevGlance controleert het geheim in de URL en de eigen handtekening van Apple, een certificaatketen tot aan Apple Root CA G3.

Wat je kunt verwachten

  • Anonieme klanten. Apple noemt geen kopers. Elke abonnee wordt één klant met een anonieme Subscriber ID, en aanbiedingscodes, upgrades tussen abonnementsgroepen en ID-resets kunnen eruitzien als nieuwe abonnementen.
  • Een jaar geschiedenis. Dagrapporten gaan een jaar terug, en elke dag komt ongeveer een dag later binnen.
  • Opzeggingen verschijnen laat. Apple meldt geen opzeggingen: een abonnement eindigt als de verlenging drie dagen te laat is.

Hoe de App Store wordt geteld

  • De klantprijs telt als omzet en de kosten zijn de klantprijs min je opbrengst, dus belasting in prijzen inclusief belasting verschijnt als kosten.
  • De MRR is de laatste klantprijs, dus die bevat belasting waar de prijzen dat doen: de rapporten van Apple splitsen belasting niet uit. Een introductieaanbieding telt tegen de aanbiedingsprijs, en de normale prijs verschijnt daarna als een uitbreiding.
  • Een terugbetaling komt uit het rapport van Apple met een negatieve prijs. Wanneer Apple een terugbetaling terugdraait, verwijdert RevGlance de laatste terugbetaling van die abonnee en dat abonnement. Apple zegt niet welke terugbetaling is teruggedraaid, dus bij meerdere terugbetalingen op één abonnement kan de verkeerde verdwijnen.
  • Terugbetalingen die zijn aangevraagd nadat Apple de ID van een abonnee heeft gereset (180 dagen), worden bewaard, maar zonder klant.
  • Tegoeden voor app-bundels (CMB-C) zijn geen terugbetalingen en worden weggelaten.
  • Apple toont geen opzeggingen: een abonnement eindigt wanneer een verlenging drie dagen te laat is.
  • Mislukte betalingen worden niet gemeld, dus dat cijfer blijft op nul.