Berichtsarten
Detaillierte BerichteDetaillierte Berichte enthalten Daten zu einzelnen Ereignissen:
- Rezensionen
- Finanzberichte: geschätzte Verkäufe, Einnahmen, Prämien und südkoreanischer Play-Bericht über die Finanzierung per Guthaben
Zusammengefasste Berichte enthalten konsolidierte statistische Daten wie Durchschnittswerte und Tagesgesamtwerte für Ihre App:
- Statistiken: Installationen, Abstürze, Bewertungen und Abos
- Statistiken zur Nutzergewinnung: Personen, die die App installiert und bisher nicht deinstalliert haben, Käufer (7 Tage nach der Installation) und Abonnenten
Berichte herunterladen
- Öffnen Sie die Play Console.
- Klicken Sie auf Berichte herunterladen und wählen Sie Rezensionen, Statistiken oder Finanzen.
- Geben Sie unter „App auswählen“ den Namen Ihrer App ein und wählen Sie ihn aus.
- Wählen Sie das Jahr und den Monat des Berichts aus, den Sie herunterladen möchten.
Hinweis: Bei den Angaben in Finanzberichten werden alle Apps in Ihrem Konto berücksichtigt.
Berichte von Google Cloud Storage herunterladen
Berichte stehen in Google Cloud Storage zur Verfügung. Sie werden täglich erstellt und monatlich in CSV-Dateien zusammengefasst. Gespeichert werden sie in einem privaten Google Cloud Storage-Bucket für Ihr Google Play-Entwicklerkonto.
Sie können über Google Cloud Storage in Ihrem Browser oder programmgesteuert mithilfe von gsutil auf Berichte zugreifen. Auch andere Tools für den programmgesteuerten Zugriff auf Ihren Cloud Storage-Bucket stehen zur Verfügung.
Tipp: Wenn Sie Ihre Berichte aus Google Cloud Storage in BigQuery importieren möchten, müssen Sie die CSV-Dateien von UTF-16
in UTF-8
konvertieren.
Google Cloud Storage-URI ermitteln
Sie können den Google Cloud Storage-URI kopieren. Klicken Sie dazu auf der Seite Berichte herunterladen neben der entsprechenden Bereichsüberschrift auf Cloud Storage-URI kopieren.
Ihr Cloud Storage-URI beginnt mit pubsite_prod_rev
. Beispiel: pubsite_prod_rev_01234567890987654321
.
- Installieren Sie das Tool gsutil.
- Authentifizieren Sie Ihr Konto mithilfe eines Kontos mit Zugriff auf die Play Console.
- Wenn Sie das gsutil-Tool zum ersten Mal verwenden und in Google Cloud Storage keine anderen Projekte konfiguriert haben, können Sie bei der Einrichtung den Namen Ihrer App als Projekt-ID eingeben, sobald Sie dazu aufgefordert werden.
- Suchen Sie Ihre Berichterstellungs-Bucket-ID. Klicken Sie dazu auf der Seite Berichte herunterladen neben der entsprechenden Bereichsüberschrift auf Cloud Storage-URI kopieren.
- Ihr Cloud Storage-URI beginnt mit
pubsite_prod_rev
. Beispiel:pubsite_prod_rev_01234567890987654321
.
- Ihr Cloud Storage-URI beginnt mit
- Laden Sie mit dem Befehl
gsutil cp
Berichte herunter.- Weitere Befehle für den Zugriff auf Ihre Berichte finden Sie in der Dokumentation zu gsutil.
Berichte werden in Verzeichnissen organisiert, die nach den einzelnen Berichtstypen benannt werden. CSV-Dateinamen enthalten den Berichtstyp, den Paketnamen, den Zeitraum und ggf. die Dimension.
Schritt 1: Dienstkonto erstellen
- Öffnen Sie die Google Developers Console.
- Wenn Sie bereits ein Projekt haben, wählen Sie es über das Drop-down-Menü aus. Falls Sie kein Projekt haben oder ein neues erstellen möchten, klicken Sie auf Projekt erstellen.
- Wählen Sie das Dreistrich-Menü > Berechtigungen > Dienstkonten > Dienstkonto erstellen aus.
- Folgen Sie der Anleitung auf dem Bildschirm und wählen Sie Erstellen aus.
- Kopieren Sie die aufgeführte E-Mail-Adresse.
- Beispiel:
Kontoname@project.iam.gserviceaccount.com
- Beispiel:
Schritt 2: Dienstkonto der Play Console hinzufügen
- Öffnen Sie die Play Console.
- Wählen Sie die Einstellungen > Nutzerkonten & Rechte > Neuen Nutzer einladen.
- Fügen oder geben Sie die E-Mail-Adresse ein, die mit Ihrem Dienstkonto verknüpft ist.
- Wählen Sie die Berechtigungen anhand der benötigten Berichtstypen aus.
- Tipp: Lesen Sie den Artikel Nutzer von Entwicklerkonten hinzufügen und Berechtigungen verwalten. Dort erfahren Sie, welche Zugriffsebenen Nutzer haben und welche Rechte ihnen verschiedene Berechtigungen gewähren.
- Klicken Sie auf Nutzer hinzufügen. Ihr Dienstkonto wird Ihrem Konto hinzugefügt.
Schritt 3: Berichte mit einem API-Aufruf abrufen
- Installieren Sie die API-Clientbibliothek für Ihre bevorzugte Codesprache.
- Konfigurieren Sie den Code, der den API-Aufruf durchführt, so, dass er eine
OAuth2
-Server-zu-Server-Authentifizierung nutzt und die Berechtigung für denOAuth2
-Bereich (https://www.googleapis.com/auth/devstorage.read_only) anfordert. - Nutzen Sie authentifizierte API-Aufrufe, um Ihre Berichte abzurufen.
Hier ein Codebeispiel, wenn Sie zum Abruf von Berichten Python verwendet haben:
import json
from httplib2 import Http
from oauth2client.client import SignedJwtAssertionCredentials
from apiclient.discovery import build
# Ändern Sie diese Variablen entsprechend.
client_email = 'your service account here'
json_file = 'path_to_json_file_obtained_when_creating_the_service_account'
cloud_storage_bucket = 'pubsite_prod_rev_…'
report_to_download = ‘earnings/earnings_….zip’
private_key = json.loads(open(json_file).read())['private_key']
credentials = SignedJwtAssertionCredentials(client_email, private_key,
'https://www.googleapis.com/auth/devstorage.read_only')
storage = build('storage', 'v1', http=credentials.authorize(Http()))
print storage.objects().get(
bucket=cloud_storage_bucket,
object=report_to_download).execute()
Zugriff auf Google Cloud Storage verwalten
Für Berichte, die in Google Cloud Storage zur Verfügung stehen, werden die gleichen Zugriffsbeschränkungen genutzt, die auch den Datenzugriff in der Play Console steuern. Das bedeutet, dass Kontonutzer mit Zugriff auf Bereiche eines Play Console-Kontos auch auf die entsprechenden Berichte in Google Cloud Storage zugreifen können.
Kontoinhaber können jederzeit Berechtigungen für einzelne Nutzer verwalten.
- Für den Zugriff auf Bulk-Berichte muss die Berechtigung „App-Informationen aufrufen“ auf „Global“ gesetzt sein.
- Um Finanzberichte herunterladen zu können, muss die Berechtigung „Finanzdaten einsehen“ auf „Global“ gesetzt sein.
Befehle und Dateiformate für detaillierte Berichte
Abstürze und ANRs
Ab Mai 2018 können Sie keine detaillierten Berichte mehr zu Abstürzen und ANRs herunterladen.
Rezensionen
Befehl
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Paketname | String | NEIN | com.company.app |
Code der App-Version | Ganzzahl | JA | Nur APKs im Produktions-Track |
Name der App-Version | String | JA | |
Sprache des Rezensenten | String, ISO 639-1 (Kennung mit zwei Buchstaben) | JA | de |
Gerät | String | JA | hammerhead |
Datum und Uhrzeit der Rezensionsübermittlung | ISO_8601 mit Zeitangabe, Zeitzone UTC | NEIN | 2014-06-19T19:12:32Z |
Millisekunden seit der UNIX-Epoche der Rezensionsübermittlung | Ganzzahl, Millisekunden seit Epoche | NEIN | |
Datum und Uhrzeit der letzten Aktualisierung der Rezension | ISO_8601 mit Zeitangabe, Zeitzone UTC | JA | 2014-06-19T19:12:32Z |
Millisekunden seit der UNIX-Epoche der letzten Aktualisierung der Rezension | Ganzzahl, Millisekunden seit Epoche | JA | |
Bewertung | Ganzzahl zwischen 1 und 5 | NEIN | |
Titel der Rezension | String, in der Sprache des Rezensenten (Zeilenumbrüche entfernt) | JA | |
Text der Rezension | String, in der Sprache des Rezensenten (Zeilenumbrüche entfernt) | JA | |
Datum und Uhrzeit der Antwort des Entwicklers | ISO_8601 mit Zeitangabe, Zeitzone UTC | JA | 2014-06-19T19:12:32Z |
Millisekunden seit der UNIX-Epoche der Antwort des Entwicklers | Ganzzahl, Millisekunden seit Epoche | JA | |
Text der Antwort des Entwicklers | String (Zeilenumbrüche entfernt und Leerzeichen komprimiert) | JA | |
Rezensionslink | String | JA | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2014 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Finanzberichte
Geschätzte VerkäufeWir empfehlen, dass Sie sich im Hinblick auf Ihre automatisierten Berichte nicht auf die Anzahl der Spalten in den CSV-Dateien verlassen.
Info
Im Bericht über geschätzte Verkäufe finden Sie relativ zeitnah Informationen über Apps, In-App-Produkte oder Aboverkäufe. Dieser Bericht enthält die von den Käufern bezahlten Beträge. Die aufgeführten Gesamtsummen enthalten keine Steuern oder Google-Gebühren.
Sie können diesen Bericht für Analysen oder Trendanalysen verwenden, für die Buchhaltung ist er hingegen nicht geeignet. Verwenden Sie für diesen Zweck stattdessen die Abrechnungen.
Zwischen diesem Bericht und den Abrechnungen können aus mehreren Gründen Unterschiede auftreten. Zum Beispiel werden im Bericht über geschätzte Verkäufe keine einbehaltenen Steuern oder Rückbuchungen berücksichtigt. In diesem Bericht sind die Beträge aufgeführt, die von den Käufern in ihrer lokalen Währung bezahlt wurden. Er enthält keine umgerechneten Beträge in der Währung Ihrer Auszahlungen.
Befehl
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2014 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Bestellnummer |
String |
Nein |
Die letzte Ziffer der Bestell-IDs für Abos gibt die Anzahl der Verlängerungen an. Die erste Verlängerung lautet beispielsweise |
Datum der Rechnung |
String |
Nein |
Das Datum dieser Bestellung im Format JJJJ-MM-TT basierend auf der koordinierten Weltzeit UTC |
Zeitstempel der Rechnung |
Ganzzahl |
Nein |
Der UNIX-Zeitstempel für das Datum, an dem die Bestellung dem Nutzer in Rechnung gestellt wurde. Gemessen in Sekunden seit der UNIX-Epoche. |
Status der Transaktion |
String |
Nein |
Wenn Sie eine Bestellung vollständig erstatten, nachdem Sie eine teilweise Erstattung ausgestellt haben,
|
Gerätemodell |
String |
Nein |
Das Android-Gerätemodell, das für den Kauf verwendet wurde. Bei Abobestellungen bezieht sich dies auf das Gerät, das für den ursprünglichen Kauf verwendet wurde. |
Produkttitel |
String |
Nein |
Der vom Entwickler angegebene Name des Produkts. Er wird in der Sprache des Käufers angezeigt. |
Produkt-ID |
String |
Nein |
Der Paketname der App, in der das Produkt verkauft wurde |
Produkttyp |
String |
Nein |
|
SKU-ID |
String |
Nein |
Die vom Entwickler angegebene eindeutige ID des Produkts |
Verkaufswährung |
String |
Nein |
|
Artikelpreis |
Ganzzahl |
Nein |
Der Preis wird in der lokalen Währung des Käufers angezeigt. Als Tausendertrennzeichen wird „,“ verwendet. |
Erhobene Steuern |
Ganzzahl |
Ja |
Der Betrag wird in der lokalen Währung des Käufers angezeigt. Als Tausendertrennzeichen wird „,“ verwendet. |
Rechnungsbetrag |
Ganzzahl |
Nein |
Der Betrag wird in der lokalen Währung des Käufers angezeigt. Das ist die Summe aus dem Artikelpreis und den erhobenen Steuern. Als Tausendertrennzeichen wird „,“ verwendet. |
Wohnsitz des Käufers: Stadt |
String |
Ja |
Das Feld wird nur für Verkäufe ausgefüllt, für die Sie der zuständige Vertragspartner sind. |
Wohnsitz des Käufers: Bundesstaat |
String |
Ja |
|
Postleitzahl des Käufers |
String |
Ja |
Das Feld wird nur für Verkäufe ausgefüllt, für die Sie der zuständige Vertragspartner sind. |
Wohnsitz des Käufers: Land |
String |
Nein |
|
Basis-Abo-ID |
String |
Ja |
Die Basis-Abo-ID des Abos. Wird nur für Abos ausgefüllt. Weitere Informationen |
Angebots-ID |
String |
Ja |
Die Angebots-ID des Abos. Wird nur für Abos ausgefüllt. Weitere Informationen |
Gruppen-ID | Ganzzahl | Ja |
Eine eindeutige ID wird bei der Erstellung einer Entwicklerkontogruppe vergeben. Weitere Informationen |
Berechtigte erste Million USD | String | Ja |
Wird nur ausgefüllt, wenn eine Entwicklerkontogruppe eingerichtet wird. Weitere Informationen |
Promotion-ID | String | Ja |
|
Gutscheinwert | Ganzzahl | Ja |
Der Preis wird in der Landeswährung des Käufers angezeigt. Als Tausendertrennzeichen wird „,“ verwendet. Das Feld wird nur für Verkäufe im Zusammenhang mit Play Points-Gutscheinen ausgefüllt. Weitere Informationen |
Rabatt | Ganzzahl | Ja |
Der Rabatt in % gibt an, wie viel der Nutzer durch das Einlösen von Play Points spart – im Vergleich dazu, wenn er den Artikel mit Geld bezahlen würde. Das Feld wird nur für Verkäufe im Zusammenhang mit Play Points ausgefüllt. Weitere Informationen |
ID der ausgewählten Produkte |
Ganzzahl |
Ja |
Eine eindeutige ID wird bei der Erstellung eines ausgewählten Produkts vergeben. Weitere Informationen |
Preistest-ID | String | Ja |
Preistest-ID und Testverzweigung |
Wir empfehlen, dass Sie sich im Hinblick auf Ihre automatisierten Berichte nicht auf die Anzahl der Spalten in den CSV-Dateien verlassen.
Info
Anhand der Abrechnungen können Sie Ihre Auszahlungen und Transaktionen nachvollziehen. Jede Position in den Abrechnungen steht für einen Transaktionstyp, z. B. wenn Sie einem Kunden einen Betrag in Rechnung stellen oder Google eine Gebühr zahlen. Außerdem sind die ursprünglichen und die umgerechneten Beträge angegeben.
Abrechnungen enthalten die Transaktionen des Vormonats. Die Auszahlungen erhalten Sie erst mehrere Wochen nach den Abrechnungen.
Die Abrechnung wird einmal im Monat erstellt und ist in der Regel am 5. des Folgemonats verfügbar. Gelegentlich passt Google Ihre Abrechnung an, um Fehlkalkulationen zu korrigieren. In diesem Fall setzen wir uns mit Ihnen in Verbindung, um Sie über das Problem zu informieren, und erstellen für Ihre Unterlagen eine zusätzliche Abrechnungsdatei, die nur die angepassten Transaktionen enthält.
Hinweise:
- Google-Gebühren sind jetzt für alle Transaktionen sichtbar, unabhängig davon, ob Google Merchant of Record (Vertragspartner) für die verkauften Produkte ist.
- Die Abrechnung enthält keine Rückbuchungen.
- Für Transaktionen wird jeden Monat eine einzelne Datei für die Abrechnung erstellt.
- Die taiwanesische Quellensteuer wird im Monat, bevor sie gemeldet wird, ausgezahlt.
Befehl
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2014 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Beschreibung |
String |
Nein |
Die letzte Ziffer der Bestell‑IDs für Abos gibt die Anzahl der Verlängerungen an. Die erste Verlängerung lautet beispielsweise |
Transaktionsdatum |
String |
Nein |
Das Datum dieser Bestellung im Format MMM TT, JJJJ basierend auf der pazifischen Zeitzone. Beachten Sie, dass der Zeitstempel der Transaktion möglicherweise den Folgemonat zeigt, da Berichte anhand des Zeitstempels der Ausstellung generiert werden. |
Zeitpunkt der Transaktion |
String |
Nein |
|
Steuerart |
String |
Ja |
Bei nicht steuerpflichtigen Produkten bleibt das Feld leer. |
Transaktionstyp |
String |
Nein |
|
Art der Erstattung |
String |
Ja |
Erstattungen, bei denen dem Käufer der gesamte Betrag erstattet wurde, werden als „Full“ gekennzeichnet.Erstattungen, bei denen dem Käufer der Betrag teilweise erstattet wurde, werden als „Partial“ gekennzeichnet. |
Produkttitel |
String |
Nein |
Der vom Entwickler angegebene Name des Produkts. Er wird in der Sprache des Käufers angezeigt. |
Produkt-ID |
String |
Nein |
Der Paketname der App, in der das Produkt verkauft wurde |
Produkttyp |
Ganzzahl |
Nein |
In diesem Feld wird der Typ des verkauften Produkts angegeben. „0“ steht für den Verkauf einer kostenpflichtigen App, „1“ für den Verkauf eines In-App-Produkts oder Abos. |
Artikelnummer-ID |
String |
Nein |
Die vom Entwickler angegebene eindeutige ID des Produkts |
Hardware |
String |
Nein |
Das Android-Gerätemodell, das für den Kauf verwendet wurde. Bei Abobestellungen bezieht sich dies auf das Modell, das für den ursprünglichen Kauf verwendet wurde. |
Wohnsitz des Käufers: Land |
String |
Nein |
|
Wohnsitz des Käufers: Bundesstaat |
String |
Ja |
|
Postleitzahl des Käufers |
String |
Ja |
|
Währung des Käufers |
String |
Nein |
|
Betrag (Währung des Käufers) |
Ganzzahl |
Nein |
Der Gesamtbetrag für diese Rechnungsposition vor der Währungsumrechnung |
Umrechnungskurs für die Währung |
Ganzzahl |
Nein |
Der Wechselkurs, der beim Umrechnen der Kaufbeträge in die Auszahlungsbeträge in der Währung des Händlers verwendet wurde |
Währung des Händlers | String | Nein |
Die Währung, in die die Bestellung umgerechnet wurde. Das ist die lokale Währung für Ihre Auszahlungen. |
Betrag (Währung des Händlers) | Ganzzahl | Nein |
Der Gesamtbetrag für diese Rechnungsposition nach der Währungsumrechnung |
Basis-Abo-ID |
String |
Ja |
Die Basis-Abo-ID des Abos. Wird nur für Abos ausgefüllt. Weitere Informationen |
Angebots-ID |
String |
Ja |
Die Angebots-ID des Abos. Wird nur für Abos ausgefüllt. Weitere Informationen |
Gruppen-ID | Ganzzahl | Ja |
Eine eindeutige ID wird bei der Erstellung einer Entwicklerkontogruppe vergeben. Weitere Informationen |
Berechtigte erste Million USD | String | Ja |
Wird nur ausgefüllt, wenn eine Entwicklerkontogruppe eingerichtet wird. Weitere Informationen |
Servicegebühr % |
Ganzzahl |
Ja |
|
Gebührenbeschreibung | String | Ja |
Details für die Berechnung der Servicegebühr von Google. |
Promotion-ID | String | Ja |
Das Feld wird nur für Verkäufe im Zusammenhang mit Play Points und Play Pass ausgefüllt. Mit den Präfixen „PP.C“ und „PP.P“ werden Bestellungen mit Play Points-Gutscheinen bzw. In-App-Produkt-Aktionen definiert. Bestellungen, bei denen Play Points direkt ausgegeben wurden, werden ebenfalls angezeigt. Mit dem Präfix „pass“ werden Bestellungen definiert, für die Nutzer Gutscheine eingelöst haben, die im Rahmen ihres Play Pass-Abos ausgestellt wurden. |
Wir empfehlen, dass Sie sich im Hinblick auf Ihre automatisierten Berichte nicht auf die Anzahl der Spalten in den CSV-Dateien verlassen.
Info
Wenn Sie an einem Programm zur alternativen Abrechnung oder für externe Angebote teilnehmen und Transaktionen an Google Play gemeldet haben, können Sie den Bericht zur Rechnungsstellung verwenden, um Ihre Transaktionen und die Ihnen in Rechnung gestellten Google-Servicegebühren nachzuvollziehen.
Der Bericht zur Rechnungsstellung enthält Transaktionen aus dem Vormonat in einer einzelnen CSV‑Datei. Er bietet eine Aufschlüsselung der Nutzergebühr, der Google-Servicegebühr und gegebenenfalls des Steuerbetrags pro Transaktion. Informationen wie der Prozentsatz der Servicegebühr und der Wechselkurs geben Aufschluss darüber, wie der Betrag der Servicegebühren in der Rechnung zustande kommt.
Hinweis:
- Der Bericht zur Rechnungsstellung wird einmal im Monat erstellt und ist in der Regel am 5. des Folgemonats verfügbar.
- Positionen mit Google-Gebühren oder Steuern, die nach der Rundung in der Abrechnungswährung null ergeben, werden nicht in den Bericht aufgenommen.
Befehl
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2024 unter der Berichts-Bucket‑ID pubsite_prod_rev_0123456789
erstellt wurden, würde der Befehl so lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory
Dateiformat
Das Datum der Transaktion basierend auf der pazifischen Zeitzone
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Rechnungs‑ID |
String |
Nein |
ID, die mit der Nummer auf Ihrer Rechnung übereinstimmt |
Programm |
String |
Ja |
Nur für Positionen mit Google-Gebühren festgelegt |
ID für externe Transaktion |
String |
Nein |
|
Transaktionsdatum |
String |
Nein |
Das Datum der Transaktion basierend auf der pazifischen Zeitzone |
Zeitstempel für Transaktion |
Ganzzahl |
Nein |
UNIX‑Zeitstempel der Transaktion, gemessen in Sekunden seit Epoche |
Transaktionstyp |
String |
Nein |
User charge, Google fee, Tax, User charge refund, Google fee refund, Tax refund, User charge partial refund, Google fee partial refund, Tax partial refund |
Steuerart |
String |
Ja |
Nur für Steuerpositionen festgelegt |
SKU‑Typ |
String |
Nein |
|
Paket‑ID |
String |
Nein |
Der Paketname der App, in der das Produkt verkauft wurde |
Verkaufsland |
String |
Nein |
|
Artikelpreis ohne Steuern (Verkaufswährung) |
Dezimalzahl |
Ja |
Preis des Produkts in Verkaufswährung ohne Steuern; nur für Positionen mit Nutzergebühr festgelegt |
Verkaufswährung |
String |
Nein |
Landeswährung des Käufers |
Fälliger Betrag (Verkaufswährung) |
Dezimalzahl |
Ja |
Fälliger Betrag in Verkaufswährung. Nur für Positionen mit Google-Gebühren und Steuern festgelegt. Positiv für den berechneten Betrag und negativ für Erstattungsbeträge oder Beträge teilweiser Erstattungen. |
Wechselkurs |
Dezimalzahl |
Nein |
Der beim Umrechnen des fälligen Betrags aus der Verkaufswährung in die Abrechnungswährung verwendete Wechselkurs |
Abrechnungswährung |
String |
Nein |
|
Fälliger Betrag (Abrechnungswährung) |
Dezimalzahl |
Ja |
Fälliger Betrag in Abrechnungswährung. Nur für Positionen mit Google-Gebühren und Steuern festgelegt. Positiv für den berechneten Betrag und negativ für Erstattungsbeträge oder Beträge teilweiser Erstattungen. |
Gruppen‑ID |
Ganzzahl |
Ja |
Eine eindeutige ID wird bei der Erstellung einer Entwicklerkontogruppe vergeben. Weitere Informationen |
Berechtigte erste Million USD |
String |
Ja |
Wird nur ausgefüllt, wenn eine Entwicklerkontogruppe eingerichtet wird. Weitere Informationen |
Servicegebühr % |
Ganzzahl |
Ja |
|
Gebührenbeschreibung |
String |
Ja |
Details für die Berechnung der Servicegebühr von Google |
Informationen
Sie sind dazu verpflichtet, auf Anfrage von App-Käufern Belege für kostenpflichtige Apps oder In-App-Produkte auszustellen, die mit Google Play-Geschenkkarten in südkoreanischen Won (KRW) erworben wurden, wenn Sie sich freiwillig zum Ausstellen von Belegen bereit erklärt haben oder dies als Händler in Südkorea nach geltenden Regeln und Bestimmungen tun müssen.
Im südkoreanischen Play-Bericht über die Finanzierung per Guthaben finden Sie alle Käufe mit Play-Guthaben in südkoreanischen Won, damit Sie dem Nutzer einen entsprechenden Beleg zusenden können.
Hinweis: Nutzer können das Play-Guthaben aus mehreren Quellen auffüllen und zum Beispiel auch Startguthaben von Google oder unseren Partnern hinzufügen. Bevor Sie einen Beleg ausstellen, sollten Sie unbedingt überprüfen, ob der Nutzer sein Guthaben mit einem Zahlungsmitteläquivalent aufgefüllt hat, z. B. mit einer Geschenkkarte.
Befehl
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2018 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl so lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Bestellnummer |
Ganzzahl |
Nein |
Die letzte Ziffer der Bestell-IDs für Abos gibt die Anzahl der Verlängerungen an. Die erste Verlängerung lautet beispielsweise |
Datum der Rechnung |
String |
Nein |
Datum dieser Bestellung im Format JJJJ‑MM‑TT basierend auf der koordinierten Weltzeit UTC |
Status der Transaktion |
String |
Nein |
|
Per Play-Guthaben gezahlter Betrag |
String |
Nein |
Betrag der Transaktion |
Währung des Play-Guthabens | String | Nein | KRW In südkoreanischen Play-Berichten über die Finanzierung per Guthaben werden immer südkoreanische Won (KRW) verwendet. |
Zeitstempel der Rechnung | Ganzzahl | Nein | 1480507200
Der UNIX-Zeitstempel für das Datum, an dem die Bestellung dem Nutzer in Rechnung gestellt wurde. Gemessen in Sekunden seit der UNIX-Epoche. |
Abos
Antworten aus der KündigungsumfrageBefehl
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Datum der Stornierung | String | Nein | 2016-11-30 |
SKU-ID | String | Ja | treasure_chest_for_new_users Die vom Entwickler angegebene eindeutige ID des Produkts |
Land | String | Nein | US, CA, etc. |
Antwort | String | Nein |
Befehle und Dateiformate für zusammengefasste Berichte
Statistiken
InstallationenBefehl
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
Dateiformat
Feld | Format | Optional | Beispiel |
---|---|---|---|
Datum | JJJJ-MM-TT | NEIN | 2014-06-19 |
Paketname | String | NEIN | com.my.app |
Gerät oder eine andere unterstützte Dimension | String | JA | hammerhead |
Aktuelle Installationen auf Geräten | Ganzzahl | NEIN | |
Installationen auf aktiven Geräten | Ganzzahl | NEIN | |
Tägliche Installationen auf Geräten | Ganzzahl | NEIN | |
Tägliche Deinstallationen auf Geräten | Ganzzahl | NEIN | |
Tägliche Upgrades auf Geräten | Ganzzahl | NEIN | |
Aktuelle Installationen durch Nutzer | Ganzzahl | NEIN | |
Installationen durch Nutzer insgesamt | Ganzzahl | NEIN | |
Tägliche Installationen durch Nutzer | Ganzzahl | NEIN | |
Tägliche Deinstallationen durch Nutzer | Ganzzahl | NEIN |
Unterstützte Dimensionen
Dimension | Dateiname |
---|---|
Code der App-Version | ..._app_version.csv |
Mobilfunkanbieter | ..._carrier.csv |
Land | ..._country.csv |
Gerät | ..._device.csv |
Sprache | ..._language.csv |
Version des Android-Betriebssystems | ..._os_version.csv |
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2014 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
Hinweis: Seit Januar 2018 enthalten Exporte Daten aus der neuen Datenquelle und stimmen mit den Informationen auf der Seite Statistiken Ihrer App überein. Exporte vor Januar 2018 sind nur für Daten verfügbar, die aus der vorherigen Datenquelle abgerufen werden.
Befehl
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
Dateiformat
Feld | Format | Optional | Beispiel |
---|---|---|---|
Datum | JJJJ-MM-TT | NEIN | 2014-06-19 |
Paketname | String | NEIN | com.my.app |
Gerät oder eine andere unterstützte Dimension | String | JA | hammerhead |
Tägliche Abstürze | Ganzzahl | NEIN | |
Tägliche ANRs | Ganzzahl | NEIN |
Unterstützte Dimensionen
Dimension | Dateiname |
---|---|
Code der App-Version | ..._app_version.csv |
Gerät | ..._device.csv |
Version des Android-Betriebssystems | ..._os_version.csv |
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2014 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
Befehl
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
Dateiformat
Feld | Format | Optional | Beispiel |
---|---|---|---|
Datum | JJJJ-MM-TT | NEIN | 2014-06-19 |
Paketname | String | NEIN | com.my.app |
Gerät oder eine andere unterstützte Dimension | String | JA | hammerhead |
Durchschnittliche Bewertung pro Tag | %.2f | JA | |
Durchschnittliche Bewertung insgesamt | %.2f | Ja | 4.16 |
Unterstützte Dimensionen
Dimension | Dateiname |
---|---|
Code der App-Version | ..._app_version.csv |
Mobilfunkanbieter | ..._carrier.csv |
Land | ..._country.csv |
Gerät | ..._device.csv |
Sprache | ..._language.csv |
Version des Android-Betriebssystems | ..._os_version.csv |
Beispiel
Wenn Sie beispielsweise alle Berichte herunterladen möchten, die im Jahr 2014 unter der Berichts-Bucket-ID pubsite_prod_rev_0123456789
für Ihre App mit dem Paketnamen „com.example.app“ erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
Befehl
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Datum | JJJJ-MM-TT | NEIN |
Das Datum dieser Bestellung im Format JJJJ-MM-TT basierend auf der koordinierten Weltzeit UTC |
Paketname | String | NEIN | com.example.app |
Produkt-ID | String | NEIN | Premium-Zugang |
Land | String | NEIN |
|
Neue Abos | Nummer | NEIN | 1234 |
Gekündigte Abos | Nummer | NEIN | 1234 |
Aktive Abos | Nummer | NEIN | 1234 |
Basis-Abo-ID | String | NEIN | weekly |
Angebots-ID | String | NEIN | spring-offer |
Hinweis: Weitere Informationen zu neuen, gekündigten und aktiven Abos erhalten Sie im Hilfeartikel Umsatz- und Käuferdaten Ihrer App prüfen.
Unterstützte Dimensionen
Dimension | Dateiname |
---|---|
Land | ..._country.csv |
Statistiken zur Nutzergewinnung
Über die Berichte zu Käufern und Personen, die die App installiert und bisher nicht deinstalliert haben, haben Sie programmatischen Zugriff auf Daten aus dem alten Akquisitionsbericht. Dieser Export wurde durch einen neuen programmatischen Export ersetzt, der Daten für die Store-Analyse und Conversion-Analyse in der Play Console enthält. Er ist seit März 2021 verfügbar.
Die alten Berichte wurden im Oktober 2021 entfernt.
Unter Wie lade ich Akquisitionsdaten herunter? erhalten Sie weitere Informationen.
Hinweis: Der Abonnentenbericht wird seit November 2019 nicht mehr unterstützt. Weitere Informationen zu Nutzergewinnung und -messwerten erhalten Sie in diesem Artikel.
„Personen, die die App installiert und bisher nicht deinstalliert haben“ (alter Export – verfügbar bis August 2021)Befehl
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Datum | JJJJ-MM-TT | NEIN |
Datum, an dem der Nutzer Ihren Store-Eintrag aufgerufen hat Hinweis: Wenn Sie über mehrere Tage hinweg einzelne Besucher des Store-Eintrags hinzufügen, ist die Anzahl der Besucher höher als in den Ansichten der wöchentlichen oder monatlichen Kohorte. In den Ansichten der wöchentlichen und monatlichen Kohorte wird jeder Besucher nur einmal gezählt, auch wenn der Eintrag von einem Besucher mehrmals aufgerufen wurde. |
Akquisitionskanal | String | JA |
Für die Dimension „Akquisitionskanal“ vorhanden Hinweis: Der Kanal „Play Store (organisch)“ ist die Summe aus „(Organische) Suche im Play Store“ und „(Organisches) Stöbern im Play Store“. Um zu vermeiden, dass Besucher in diesem Bericht doppelt gezählt werden, ignorieren Sie entweder die gesamte Zeile „Play Store (organisch)“ oder sowohl die Zeile zur Suche als auch die zum Stöbern. |
Land | String | JA | Für die Dimensionen „Land“ und „Land (Zugriffe vom Play Store)“ vorhanden |
UTM-Quelle/-Kampagne | String | JA |
Für die Dimension „Analysierte Kanäle (UTM)“ vorhanden |
Suchbegriff | String | JA |
Für die Dimension „(Organische) Suche im Play Store“ vorhanden |
Besucher des Store-Eintrags | Ganzzahl | NEIN | |
Personen, die die App installiert haben | Ganzzahl | NEIN | |
Conversion-Rate von Besuchern zu Personen, die die App installiert haben | Dezimalzahl | NEIN | |
Benchmark für den Medianwert der Conversion-Rate von Besuchern zu Personen, die die App installiert haben | Dezimalzahl | JA |
Wird ab August 2019 nicht angegeben. Eine aktualisierte Reihe von Benchmarks mit einer neuen Berechnung ist auf der Seite „Akquisitionsberichte“ verfügbar. Weitere Informationen erhalten Sie im Abschnitt Vergleich mit der Conversion-Rate ähnlicher Apps bei Play Store-Zugriffen. |
Personen, die die App installiert und für 1 Tag behalten haben | Ganzzahl | NEIN | |
Rate der Personen, die die App installiert und 1 Tag behalten haben | Dezimalzahl | NEIN | |
Personen, die die App installiert und für 7 Tage behalten haben | Ganzzahl | NEIN | |
Rate der Personen, die die App installiert und 7 Tage behalten haben | Dezimalzahl | NEIN | |
Personen, die die App installiert und für 15 Tage behalten haben | Ganzzahl | NEIN | |
Rate der Personen, die die App installiert und 15 Tage behalten haben | Dezimalzahl | NEIN | |
Personen, die die App installiert und für 30 Tage behalten haben | Ganzzahl | NEIN | |
Rate der Personen, die die App installiert und 30 Tage behalten haben | Dezimalzahl | NEIN |
Unterstützte Dimensionen
Dimension | Dateiname |
---|---|
Akquisitionskanal* | ..._channel.csv |
Land | ..._country.csv |
Land (Zugriffe vom Play Store) | ..._play_country.csv |
(Organische) Suche im Play Store | ..._play_search.csv |
Analysierte Kanäle (UTM) | ..._utm_tagged.csv |
* Hinweis: Der Kanal „Play Store (organisch)“ ist die Summe aus „(Organische) Suche im Play Store“ und „(Organisches) Stöbern im Play Store“. Wenn Sie vermeiden möchten, dass Besucher in diesem Bericht doppelt gezählt werden, ignorieren Sie entweder die gesamte Zeile „Play Store (organisch)“ oder sowohl die Zeile zur Suche als auch die zum Stöbern.
Die Dimension „Google Suche (organisch)“ wird seit Juni 2019 nicht mehr unterstützt.
CSV-Namen
Jede verfügbare CSV-Datei enthält Daten für einen Monat und eine Aufschlüsselung. CSV-Dateien erhalten strukturierte Namen, die das Jahr, den Monat und die Berichtsaufschlüsselung folgendermaßen darstellen:
Format Dateinamen: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Hinweise:
- Der Paketname wird unverändert in den Dateinamen aufgenommen und enthält gegebenenfalls Sonderzeichen (
.
oder_
). yyyyMM
steht für das Jahr und den Monat, z. B.202101
.
Befehl
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Dateiformat
Feld | Format | Optional | Beispiel | Beschreibung |
---|---|---|---|---|
Datum | JJJJ-MM-TT | NEIN | 2021-01-01 |
Datum, an dem der Nutzer Ihren Store-Eintrag aufgerufen hat |
Paketname | String | NEIN | com.example.app |
Der Paketname, zu dem die Berichtsdaten gehören |
Land/Region | String | NEIN | Vereinigtes Königreich |
Land oder Region, in der das Google-Konto des Nutzers registriert ist |
Besucherquelle | String | NEIN | Google Play-Suche |
Wie der Nutzer zu Ihrem Store-Eintrag gelangt ist:
Hinweis: Kann |
Suchbegriff | String | JA | App-Store |
Der Begriff, nach dem der Nutzer gesucht hat, bevor er Ihren Store-Eintrag aufgerufen hat. Nur verfügbar für die Google Play-Suche. Hinweis: Kann |
UTM-Quelle | String | JA | google |
Der Wert des URL-Parameters „utm_source“ in Deeplinks zu Ihrem Store-Eintrag. Nur verfügbar für Drittanbieter-Empfehlungen. Hinweis: Kann |
UTM-Kampagne | String | JA | Kampagne |
Der Wert des URL-Parameters „utm_campaign“ in Deeplinks zu Ihrem Store-Eintrag. Nur verfügbar für Drittanbieter-Empfehlungen. Hinweis: KannOther sein, falls dieser Wert nicht den minimalen Grenzwert erreicht. |
Akquisitionen über Store-Eintrag | Ganzzahl | NEIN | 10 |
Anzahl der Nutzer, die den Store-Eintrag besucht und Ihre App installiert haben, ohne dass sie auf einem anderen ihrer Geräte installiert war. |
Besucher des Store-Eintrags | Ganzzahl | NEIN | 100 |
Anzahl der Nutzer, die den Store-Eintrag besucht haben, ohne dass Ihre App auf einem anderen ihrer Geräte installiert war. |
Conversion-Rate des Store-Eintrags | Dezimalzahl | NEIN | 0.1 |
Prozentsatz der Besucher Ihres Store-Eintrags, die Ihre App installiert haben. Hinweis: Enthält keine Besuche oder Installationen von Nutzern, die Ihre App bereits auf einem anderen Gerät installiert haben. |
Verfügbare Aufschlüsselungsstruktur
Folgende Aufschlüsselungen sind verfügbar:
Name der Aufschlüsselung | Felder in den einzelnen CSV-Dateien (in der richtigen Reihenfolge): |
---|---|
Beispiel für Dateiname:
|
Datum, Paketname, Land, Akquisitionen über Store-Eintrag, Besucher des Store-Eintrags, Conversion-Rate des Store-Eintrags |
Beispiel für Dateiname:
|
Datum, Paketname, Besucherquelle, Suchbegriff, UTM-Quelle, UTM-Kampagne, Akquisitionen über Store-Eintrag, Besucher des Store-Eintrags, Conversion-Rate des Store-Eintrags |
Escape-Schema
- Verdoppeln Sie doppelte Anführungszeichen. (
"
->""
) - Wenn eine Zelle Tabulatoren, Zeilenumbrüche, doppelte Anführungszeichen oder Kommas enthält, setzen Sie die Zelle in doppelte Anführungszeichen. (
...
->"..."
)
Beispiel
Wenn Sie alle Berichte herunterladen möchten, die im Jahr 2020 unter der Berichts-Bucket-ID pubsite_prod_0123456789
für Ihre App mit dem Paketnamen com.example.app
erstellt wurden, würde der Befehl folgendermaßen lauten:
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Befehl
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
Dateiformat
Feld | Format | Optional | Beispiele und Hinweise |
---|---|---|---|
Datum | JJJJ-MM-TT | NEIN |
Datum, an dem der Nutzer Ihren Store-Eintrag aufgerufen hat Hinweis: Wenn Sie über mehrere Tage hinweg einzelne Besucher des Store-Eintrags hinzufügen, ist die Anzahl der Besucher höher als in den Ansichten der wöchentlichen oder monatlichen Kohorte. In den Ansichten der wöchentlichen und monatlichen Kohorte wird jeder Besucher nur einmal gezählt, auch wenn der Eintrag von einem Besucher mehrmals aufgerufen wurde. |
Akquisitionskanal | String | JA |
Für die Dimension „Akquisitionskanal“ vorhanden Hinweis: Der Kanal „Play Store (organisch)“ ist die Summe aus „(Organische) Suche im Play Store“ und „(Organisches) Stöbern im Play Store“. Um zu vermeiden, dass Besucher in diesem Bericht doppelt gezählt werden, ignorieren Sie entweder die gesamte Zeile „Play Store (organisch)“ oder sowohl die Zeile zur Suche als auch die zum Stöbern. |
Land | String | JA | Für die Dimensionen „Land“ und „Land (Zugriffe vom Play Store)“ vorhanden |
UTM-Quelle/-Kampagne | String | JA | Für die Dimension „Analysierte Kanäle (UTM)“ vorhanden |
Suchbegriff | String | JA |
Für die Dimension „(Organische) Suche im Play Store“ vorhanden |
Besucher des Store-Eintrags | Ganzzahl | NEIN | |
Personen, die die App installiert haben | Ganzzahl | NEIN | |
Conversion-Rate von Besuchern zu Personen, die die App installiert haben | Dezimalzahl | NEIN | |
Benchmark für den Medianwert der Conversion-Rate von Besuchern zu Personen, die die App installiert haben | Dezimalzahl | JA |
Wird ab August 2019 nicht angegeben. Eine aktualisierte Reihe von Benchmarks mit einer neuen Berechnung ist auf der Seite „Akquisitionsberichte“ verfügbar. Weitere Informationen erhalten Sie im Abschnitt Vergleich mit der Conversion-Rate ähnlicher Apps bei Play Store-Zugriffen. |
Käufer | Ganzzahl | NEIN | |
Conversion-Rate von Personen, die die App installiert haben, zu Käufern | Dezimalzahl | NEIN | |
Wiederholungskäufer | Ganzzahl | NEIN | |
Conversion-Rate von Personen, die die App installiert haben, zu Wiederholungskäufern | Dezimalzahl | NEIN | |
Conversion-Rate von Käufern zu Wiederholungskäufern | Ganzzahl | NEIN |
Unterstützte Dimensionen
Dimension | Dateiname |
---|---|
Akquisitionskanal* | ..._channel.csv |
Land |
..._country.csv |
Land (Zugriffe vom Play Store) |
..._play_country.csv |
(Organische) Suche im Play Store | ..._play_search.csv |
Analysierte Kanäle (UTM) | ..._utm_tagged.csv |
* Hinweis: Der Kanal „Play Store (organisch)“ ist die Summe aus „(Organische) Suche im Play Store“ und „(Organisches) Stöbern im Play Store“. Wenn Sie vermeiden möchten, dass Besucher in diesem Bericht doppelt gezählt werden, ignorieren Sie entweder die gesamte Zeile „Play Store (organisch)“ oder sowohl die Zeile zur Suche als auch die zum Stöbern.
Die Dimension „Google Suche (organisch)“ wird seit Juni 2019 nicht mehr unterstützt.