Google Play

Verbinden Sie Google Play mit einem Dienstkonto, das Ihre Play-Console-Berichte und die Play Developer API liest.

RevGlance liest die monatlichen Sales- und Earnings-Berichte im Cloud-Storage-Bucket Ihrer Play Console und fragt die Play Developer API nach Abrechnungszeiträumen, Rückerstattungen und, mit Echtzeitbenachrichtigungen, nach Testphasen und Kündigungen.

Verbinden

Erstellen Sie in Google Cloud in einem Projekt ein service account, fügen Sie einen JSON-Schlüssel hinzu und laden Sie ihn herunter. Aktivieren Sie für das Projekt die Google Play Android Developer API.
Öffnen Sie in der Play Console Users and permissions, laden Sie die E-Mail-Adresse des Dienstkontos ein und geben Sie ihr für Ihre App View financial data.
Kopieren Sie Ihren Berichts-Bucket aus Download reports › Financial: den Teil pubsite_prod_rev_… der Cloud-Storage-URI.
Tragen Sie den Bucket, den Paketnamen Ihrer App (com.example.app) und den ganzen JSON-Schlüssel ein und wählen Sie dann Google Play verbinden. Bis eine neue Einladung die Berichte erreicht, kann bis zu ein Tag vergehen.

Was das Formular abfragt

Feld	Sieht so aus
Berichts-Bucket	`pubsite_prod_rev_01234567890987654321`
Paketname	`com.example.app`
Dienstkonto-JSONVerschlüsselt gespeichert	`{ "type": "service_account", … }`

Das Dienstkonto meldet sich mit Lesezugriff auf Cloud Storage (devstorage.read_only) und die Android Publisher API an.

Den Webhook hinzufügen

Ohne Benachrichtigungen sind Testphasen unsichtbar, und eine Kündigung erscheint erst, wenn eine Verlängerung drei Tage überfällig ist. Mit ihnen erfährt RevGlance das Purchase Token jedes Abonnements und fragt Play nach dessen aktuellem Stand.

Öffnen Sie in RevGlance Einstellungen › Quellen, öffnen Sie das Menü der Google-Play-Quelle und wählen Sie Webhook. Speichern Sie ein langes zufälliges Secret unter Signing Secret.
Erstellen Sie in Google Cloud ein Pub/Sub-Topic und erlauben Sie Google Play, darin zu veröffentlichen, wie es die Seite Monetization setup der Play Console erklärt.
Fügen Sie dem Topic ein push-Abonnement hinzu. Sein Endpunkt ist die Webhook-URL mit ?token= und Ihrem Secret am Ende.
Öffnen Sie in der Play Console Monetization setup, tragen Sie das Topic ein und senden Sie eine Testbenachrichtigung. RevGlance bestätigt Tests und Benachrichtigungen für andere Apps, ohne darauf zu reagieren.

Was Sie erwarten können

Berichte kommen spät. Google veröffentlicht sie drei bis sieben Tage nach dem Verkauf. Zuerst kommen die Sales; die Earnings ersetzen sie später durch das, was Google Ihnen ausgezahlt hat.
Anonyme Kunden. Play nennt keine Käufer. Die Bestellungen eines Abonnements teilen sich einen ID-Stamm (GPA.1234…), der zu einem anonymen Kunden wird. Einmalkäufe haben keinen Kunden.
Rückerstattungen über die API reichen 30 Tage zurück. Ältere Rückerstattungen kommen mit dem Earnings-Bericht.

Wie Google Play gezählt wird

Google veröffentlicht Berichte drei bis sieben Tage verzögert. Zuerst kommen die Verkäufe; die Einnahmen ersetzen sie später durch das, was Google Ihnen nach Abzug seiner Gebühr ausgezahlt hat. Zahlungen zählen vor Steuern.
Jede Erstattungszeile wird übernommen, auch Teilrückerstattungen. Zwei Teilrückerstattungen einer Bestellung, die auf zwei Monatsberichte verteilt sind, können kollidieren, sodass eine fehlen kann. Google gibt nicht an, ob Rückerstattungen in seinen Berichten negativ sind, daher werden sie als erstattete Beträge gelesen.
Rückerstattungen über die Play API reichen nur 30 Tage zurück. Ältere kommen mit dem Einnahmenbericht.
Ohne Echtzeitbenachrichtigungen erscheint eine Kündigung nur als drei Tage überfällige Verlängerung, gezählt, sobald die Berichte diesen Tag abdecken.
Testkäufe werden nicht berücksichtigt. Ein zurückgestelltes Abonnement zählt weiter; ein pausiertes zählt bis zur Fortsetzung als Abwanderung.
Der MRR ist die letzte Bestellung, vor Steuern. Ein Einführungsangebot zählt zum Angebotspreis, und der reguläre Preis erscheint danach als Expansion.
Fehlgeschlagene Zahlungen werden nicht gemeldet, daher bleibt dieser Wert bei null.