RevGlanceDokumentacja

App Store

Połącz App Store Connect kluczem API, aby odczytywać dzienne raporty Sales and Trends dla iOS i Mac.

RevGlance odczytuje dzienne raporty Sales and Trends Apple przez App Store Connect API. Podsumowanie SALES podaje płatne aplikacje i zakupy w aplikacji; raport SUBSCRIBER podaje każdą płatność za subskrypcję, bezpłatny okres próbny i zwrot.

Połączenie

  1. W App Store Connect otwórz Users and Access › Integrations › App Store Connect API i wygeneruj klucz zespołu z rolą Finance lub Sales.
  2. Zanotuj Issuer ID nad listą kluczy i Key ID klucza, a potem pobierz plik .p8. Apple pozwala pobrać go tylko raz.
  3. Znajdź swój numer dostawcy (Vendor number) w Payments and Financial Reports (w lewym górnym rogu).
  4. Wypełnij cztery pola, wklejając cały plik .p8 razem z wierszami -----BEGIN PRIVATE KEY-----, a potem wybierz Połącz App Store.

O co pyta formularz

PoleWygląda tak
Issuer ID57246542-96fe-1a63-e053-0824d011072a
Key ID2X9R4HXF34
Numer dostawcy (Vendor number)85012345
Klucz prywatny (zawartość pliku .p8)Przechowywane w postaci zaszyfrowanej-----BEGIN PRIVATE KEY-----

Dodawanie webhooka

Raporty docierają z mniej więcej jednodniowym opóźnieniem. App Store Server Notifications informują RevGlance w chwili, gdy coś się zmienia, więc następny raport jest pobierany, gdy tylko będzie dostępny.

  1. W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła App Store i wybierz Webhook.
  2. Wymyśl długi losowy sekret, wklej go w polu Sekret podpisywania i zapisz.
  3. Skopiuj adres URL webhooka i dodaj na końcu ?token= oraz swój sekret.
  4. W App Store Connect otwórz App Information swojej aplikacji i w sekcji App Store Server Notifications ustaw ten adres jako produkcyjny URL, wersja 2.

RevGlance sprawdza sekret w adresie URL oraz własny podpis Apple, łańcuch certyfikatów aż do Apple Root CA G3.

Czego się spodziewać

  • Anonimowi klienci. Apple nie podaje kupujących. Każdy subskrybent staje się jednym klientem z anonimowym Subscriber ID, a kody ofertowe, przejścia między grupami subskrypcji i resety ID mogą wyglądać jak nowe subskrypcje.
  • Rok historii. Dzienne raporty sięgają rok wstecz, a każdy dzień dociera z mniej więcej jednodniowym opóźnieniem.
  • Anulowania widać z opóźnieniem. Apple nie zgłasza anulowań: subskrypcja kończy się, gdy jej odnowienie jest opóźnione o trzy dni.

Jak liczony jest App Store

  • Cena dla klienta liczy się jako przychód, a prowizja to cena dla klienta minus twoje wpływy, więc podatek w cenach z podatkiem pojawia się jako prowizja.
  • MRR to ostatnia cena dla klienta, więc zawiera podatek tam, gdzie zawierają go ceny: raporty Apple nie wydzielają podatku. Oferta wprowadzająca liczy się po cenie oferty, a zwykła cena pokazuje się potem jako rozszerzenie.
  • Zwrot pochodzi z raportu Apple z ujemną ceną. Gdy Apple cofa zwrot, RevGlance usuwa najnowszy zwrot danego subskrybenta i subskrypcji. Apple nie podaje, który zwrot został cofnięty, więc przy kilku zwrotach w jednej subskrypcji może zniknąć niewłaściwy.
  • Zwroty, o które poproszono po zresetowaniu przez Apple identyfikatora subskrybenta (180 dni), są zachowywane, ale bez klienta.
  • Środki z pakietów aplikacji (CMB-C) nie są zwrotami i są pomijane.
  • Apple nie pokazuje anulowań: subskrypcja kończy się, gdy odnowienie jest opóźnione o trzy dni.
  • Nieudane płatności nie są zgłaszane, więc ta wartość pozostaje na zerze.