RevGlanceGoogle Play
Połącz Google Play kontem usługi, które odczytuje raporty z Play Console i Play Developer API.
RevGlance odczytuje miesięczne raporty sales i earnings z zasobnika Cloud Storage w twojej Play Console, a w Play Developer API sprawdza okresy rozliczeniowe, zwroty oraz, przy powiadomieniach w czasie rzeczywistym, okresy próbne i anulowania.
Połączenie
- W Google Cloud utwórz w projekcie service account, dodaj klucz JSON i go pobierz. Włącz dla projektu Google Play Android Developer API.
- W Play Console otwórz Users and permissions, zaproś adres e-mail konta usługi i nadaj mu uprawnienie View financial data dla swojej aplikacji.
- Skopiuj swój zasobnik raportów z Download reports › Financial: część
pubsite_prod_rev_…z identyfikatora URI Cloud Storage. - Wypełnij zasobnik, nazwę pakietu aplikacji (
com.example.app) i cały klucz JSON, a potem wybierz Połącz Google Play. Nowe zaproszenie może potrzebować nawet doby, zanim uzyska dostęp do raportów.
O co pyta formularz
| Pole | Wygląda tak |
|---|---|
| Zasobnik raportów | pubsite_prod_rev_01234567890987654321 |
| Nazwa pakietu | com.example.app |
| JSON konta usługiPrzechowywane w postaci zaszyfrowanej | { "type": "service_account", … } |
Konto usługi loguje się z dostępem tylko do odczytu do Cloud Storage (devstorage.read_only) i Android Publisher API.
Dodawanie webhooka
Bez powiadomień okresy próbne są niewidoczne, a anulowanie pojawia się dopiero wtedy, gdy odnowienie jest opóźnione o trzy dni. Z nimi RevGlance poznaje token zakupu każdej subskrypcji i pyta Play o jej bieżący stan.
- W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Google Play i wybierz Webhook. Zapisz długi losowy sekret w polu Sekret podpisywania.
- W Google Cloud utwórz temat Pub/Sub i pozwól Google Play na publikowanie w nim, jak wyjaśnia strona Monetization setup w Play Console.
- Dodaj do tematu subskrypcję typu push. Jej punkt końcowy to adres URL webhooka z
?token=i twoim sekretem na końcu. - W Play Console otwórz Monetization setup, wpisz temat i wyślij powiadomienie testowe. RevGlance potwierdza odbiór powiadomień testowych i powiadomień dotyczących innych aplikacji, nie podejmując żadnych działań.
Czego się spodziewać
- Raporty przychodzą z opóźnieniem. Google publikuje je od trzech do siedmiu dni po sprzedaży. Najpierw pojawia się sprzedaż; później raport earnings zastępuje ją tym, co Google ci wypłacił.
- Anonimowi klienci. Play nie podaje kupujących. Zamówienia jednej subskrypcji mają wspólny rdzeń ID (
GPA.1234…), który staje się jednym anonimowym klientem. Zakupy jednorazowe nie mają klienta. - Zwroty przez API sięgają 30 dni wstecz. Starsze zwroty docierają z raportem earnings.
Jak liczony jest Google Play
- Google publikuje raporty z opóźnieniem od trzech do siedmiu dni. Najpierw pojawia się sprzedaż; później raporty zarobków zastępują ją tym, co Google ci wypłacił, po odjęciu prowizji. Płatności liczą się przed podatkiem.
- Każdy wiersz zwrotu jest zachowywany, również częściowe. Dwa częściowe zwroty jednego zamówienia rozłożone na dwa miesięczne raporty mogą się zderzyć i jeden może zostać pominięty. Google nie podaje, czy zwroty w raportach są ujemne, więc są odczytywane jako zwrócone kwoty.
- Zwroty przez Play API sięgają tylko 30 dni wstecz. Starsze docierają z raportem zarobków.
- Bez powiadomień w czasie rzeczywistym anulowanie pojawia się tylko jako odnowienie opóźnione o trzy dni, liczone, gdy raporty obejmą ten dzień.
- Zakupy testowe są pomijane. Subskrypcja zawieszona liczy się dalej; wstrzymana liczy się jako odpływ, dopóki nie zostanie wznowiona.
- MRR to ostatnie zamówienie, przed podatkiem. Oferta wprowadzająca liczy się po cenie oferty, a zwykła cena pokazuje się potem jako rozszerzenie.
- Nieudane płatności nie są zgłaszane, więc ta wartość pozostaje na zerze.