Google Play

Koppel Google Play met een serviceaccount dat je Play Console-rapporten en de Play Developer API leest.

RevGlance leest de maandelijkse sales- en earnings-rapporten in de Cloud Storage-bucket van je Play Console, en vraagt de Play Developer API naar factureringsperiodes, terugbetalingen en, met realtime meldingen, proefperiodes en opzeggingen.

Koppelen

Maak in Google Cloud een service account aan in een project, voeg een JSON-sleutel toe en download die. Zet de Google Play Android Developer API aan voor het project.
Open in Play Console Users and permissions, nodig het e-mailadres van het serviceaccount uit en geef het View financial data voor je app.
Kopieer je rapportenbucket uit Download reports › Financial: het deel pubsite_prod_rev_… van de Cloud Storage-URI.
Vul de bucket, de pakketnaam van je app (com.example.app) en de hele JSON-sleutel in, en kies dan Google Play koppelen. Het kan tot een dag duren voordat een nieuwe uitnodiging toegang heeft tot de rapporten.

Wat het formulier vraagt

Veld	Ziet eruit als
Bucket voor rapporten	`pubsite_prod_rev_01234567890987654321`
Pakketnaam	`com.example.app`
JSON van serviceaccountVersleuteld opgeslagen	`{ "type": "service_account", … }`

Het serviceaccount logt in met alleen-lezentoegang tot Cloud Storage (devstorage.read_only) en de Android Publisher API.

Voeg de webhook toe

Zonder realtime meldingen zijn proefperiodes onzichtbaar en verschijnt een opzegging pas als een verlenging drie dagen te laat is. Met meldingen leert RevGlance het aankooptoken van elk abonnement en vraagt het Play naar de actuele stand.

Open in RevGlance Instellingen › Bronnen, open het menu van de Google Play-bron en kies Webhook. Sla een lang willekeurig geheim op onder Ondertekeningsgeheim.
Maak in Google Cloud een Pub/Sub-topic aan en sta Google Play toe ernaar te publiceren, zoals de pagina Monetization setup in Play Console uitlegt.
Voeg een push-abonnement toe aan het topic. Het endpoint is de webhook-URL met ?token= en je geheim aan het eind.
Open in Play Console Monetization setup, vul het topic in en stuur een testmelding. RevGlance bevestigt tests en meldingen voor andere apps zonder er iets mee te doen.

Wat je kunt verwachten

Rapporten komen laat. Google plaatst ze drie tot zeven dagen na de verkoop. Eerst komen de sales; de earnings vervangen ze later met wat Google je heeft uitbetaald.
Anonieme klanten. Play noemt geen kopers. Bestellingen van één abonnement delen een ID-stam (GPA.1234…), die één anonieme klant wordt. Eenmalige aankopen hebben geen klant.
Terugbetalingen via de API gaan 30 dagen terug. Oudere terugbetalingen komen binnen met het earnings-rapport.

Hoe Google Play wordt geteld

Google plaatst rapporten drie tot zeven dagen te laat. Verkopen komen eerst; inkomsten vervangen ze later door wat Google je na de eigen kosten heeft betaald. Betalingen tellen vóór belasting.
Elke terugbetalingsregel wordt bewaard, ook gedeeltelijke. Twee gedeeltelijke terugbetalingen van één bestelling verspreid over twee maandrapporten kunnen botsen, en er kan er een worden gemist. Google zegt niet of terugbetalingen negatief zijn in de rapporten, dus ze worden gelezen als terugbetaalde bedragen.
Terugbetalingen via de Play API gaan maar 30 dagen terug. Oudere komen binnen met het inkomstenrapport.
Zonder realtime meldingen verschijnt een opzegging alleen als een verlenging die drie dagen te laat is, geteld zodra de rapporten die dag dekken.
Testaankopen worden weggelaten. Een abonnement in de wacht blijft meetellen; een gepauzeerd abonnement telt als verloop tot het wordt hervat.
De MRR is de laatste bestelling, vóór belasting. Een introductieaanbieding telt tegen de aanbiedingsprijs, en de normale prijs verschijnt daarna als een uitbreiding.
Mislukte betalingen worden niet gemeld, dus dat cijfer blijft op nul.