Google Play

Collega Google Play con un service account che legge i report della Play Console e la Play Developer API.

RevGlance legge i report mensili sales ed earnings nel bucket Cloud Storage della tua Play Console, e interroga la Play Developer API su periodi di fatturazione, rimborsi e, con le notifiche in tempo reale, prove e disdette.

Collegamento

In Google Cloud, crea un service account in un progetto, aggiungi una chiave JSON e scaricala. Attiva la Google Play Android Developer API per il progetto.
In Play Console, apri Users and permissions, invita l'email del service account e assegnagli View financial data per la tua app.
Copia il bucket dei report da Download reports › Financial: la parte pubsite_prod_rev_… dell'URI di Cloud Storage.
Inserisci il bucket, il nome del pacchetto della tua app (com.example.app) e l'intera chiave JSON, poi scegli Collega Google Play. Un nuovo invito può impiegare fino a un giorno per arrivare ai report.

Cosa chiede il modulo

Campo	Esempio
Bucket dei report	`pubsite_prod_rev_01234567890987654321`
Nome del pacchetto	`com.example.app`
JSON dell'account di servizioSalvato cifrato	`{ "type": "service_account", … }`

Il service account accede in sola lettura a Cloud Storage (devstorage.read_only) e alla Android Publisher API.

Aggiungi il webhook

Senza le notifiche, le prove sono invisibili e una disdetta compare solo quando un rinnovo è in ritardo di tre giorni. Con le notifiche, RevGlance conosce il purchase token di ogni abbonamento e chiede a Play il suo stato attuale.

In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Google Play e scegli Webhook. Salva un segreto lungo e casuale in Segreto di firma.
In Google Cloud, crea un topic Pub/Sub e consenti a Google Play di pubblicarvi, come spiega la pagina Monetization setup della Play Console.
Aggiungi una subscription push al topic. Il suo endpoint è l'URL del webhook con ?token= e il tuo segreto alla fine.
In Play Console, apri Monetization setup, inserisci il topic e invia una notifica di test. RevGlance conferma la ricezione dei test e delle notifiche per altre app senza agire.

Cosa aspettarsi

I report arrivano in ritardo. Google li pubblica da tre a sette giorni dopo la vendita. Prima arrivano le vendite; in seguito gli earnings le sostituiscono con quanto Google ti ha pagato.
Clienti anonimi. Play non indica gli acquirenti. Gli ordini di uno stesso abbonamento condividono una radice di ID (GPA.1234…), che diventa un cliente anonimo. Gli acquisti singoli non hanno un cliente.
I rimborsi tramite l'API risalgono fino a 30 giorni fa. I rimborsi più vecchi arrivano con il report earnings.

Come viene calcolato Google Play

Google pubblica i report con tre-sette giorni di ritardo. Prima arrivano le vendite; poi i guadagni le sostituiscono con quanto Google ti ha pagato, al netto della sua commissione. Gli addebiti contano al netto delle imposte.
Ogni riga di rimborso viene conservata, anche quelle parziali. Due rimborsi parziali dello stesso ordine distribuiti su due report mensili possono sovrapporsi, e uno può andare perso. Google non dice se i rimborsi sono negativi nei suoi report, quindi vengono letti come importi rimborsati.
I rimborsi tramite la Play API risalgono solo a 30 giorni fa. Quelli più vecchi arrivano con il report dei guadagni.
Senza notifiche in tempo reale, una disdetta appare solo come un rinnovo in ritardo di tre giorni, contato quando i report coprono quel giorno.
Gli acquisti di prova sono esclusi. Un abbonamento sospeso continua a contare; uno in pausa conta come abbandono finché non riprende.
L'MRR è l'ultimo ordine, al netto delle imposte. Un'offerta introduttiva conta al suo prezzo di offerta, e il prezzo normale appare poi come un'espansione.
Gli addebiti non riusciti non vengono riportati, quindi quel valore resta a zero.