Vorbereitung läuft

In diesem Thema werden die Einrichtungsschritte aufgeführt und beschrieben, die Sie vor dem Verkauf von Produkten in Ihrer App ausführen müssen. Im Wesentlichen umfasst diese Einrichtung das Erstellen eines Entwicklerkontos, das Erstellen und Konfigurieren der Produkte, die Sie verkaufen möchten, sowie die Aktivierung und Konfiguration der APIs, die Sie zum Verkauf und Verwalten Ihrer Produkte verwenden. Außerdem wird hier beschrieben, wie Entwicklerbenachrichtigungen in Echtzeit so konfiguriert werden, dass sie immer dann benachrichtigt werden, wenn sich der Status eines Produkts ändert.

Google Play-Entwicklerkonto einrichten

Veröffentlichen Sie Ihre Apps und Spiele bei Google Play mit der Google Play Console. In der Google Play Console kannst du auch deine abrechnungsbezogenen Produkte und Einstellungen verwalten.

Für den Zugriff auf die Google Play Console musst du ein Google Play-Entwicklerkonto einrichten.

Wenn Sie kostenpflichtige Apps und In-App-Käufe bei Google Play verkaufen möchten, müssen Sie außerdem ein Profil im Google-Zahlungscenter einrichten und dieses Profil dann mit Ihrem Google Play-Entwicklerkonto verknüpfen. Wie Sie Ihr Profil mit Ihrem Konto verknüpfen oder wie Sie prüfen können, ob Sie bereits ein verknüpftes Konto und Profil haben, erfahren Sie unter Google Play-Entwicklerkonto mit Zahlungsprofil verknüpfen.

Abrechnungsbezogene Funktionen in der Google Play Console aktivieren

Nachdem du ein Entwicklerkonto eingerichtet hast, musst du eine Version deiner App veröffentlichen, die die Google Play Billing Library enthält. Dieser Schritt ist erforderlich, um abrechnungsbezogene Funktionen in der Google Play Console zu aktivieren und beispielsweise die Produkte zu konfigurieren, die du verkaufen möchtest.

Bibliotheksabhängigkeit hinzufügen

Wenn du das Abrechnungssystem von Google Play integrieren möchtest, füge zuerst in deiner App eine Abhängigkeit zur Google Play Billing Library hinzu. Über diese Bibliothek erhältst du Zugriff auf Android-APIs, über die du mit Google Play verbunden bist. Von dort aus können Sie auf Kaufinformationen zugreifen, Updates zu Käufen abfragen, Nutzer zu neuen Käufen auffordern und vieles mehr.

Die Google Play Billing Library ist im Maven-Repository von Google verfügbar. Fügen Sie die Abhängigkeit wie gezeigt in die Datei build.gradle Ihrer App ein:

Groovy

dependencies {
    def billing_version = "7.0.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "7.0.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

Wenn Sie Kotlin verwenden, enthält das Modul der Play Billing Library KTX Kotlin-Erweiterungen und unterstützt Koroutinen, mit denen Sie idiomatischen Kotlin-Code mithilfe des Abrechnungssystems von Google Play schreiben können. Wenn Sie diese Erweiterungen in Ihr Projekt aufnehmen möchten, fügen Sie der Datei build.gradle Ihrer Anwendung die folgende Abhängigkeit hinzu:

Groovy

dependencies {
    def billing_version = "7.0.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "7.0.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

In den Kotlin-Codebeispielen auf dieser Seite wird nach Möglichkeit KTX genutzt.

App hochladen

Nachdem Sie die Bibliothek Ihrer App hinzugefügt haben, erstellen und veröffentlichen Sie Ihre App. Für diesen Schritt erstellen und veröffentlichen Sie Ihre App dann in einem beliebigen Track, einschließlich des internen Test-Tracks.

Produkte erstellen und konfigurieren

Nachdem du die Google Play Billing-Funktionen für deine App aktiviert hast, musst du die Produkte für den Verkauf konfigurieren.

Die Schritte zum Erstellen von einmaligen Produkten und Abos sind ähnlich. Sie müssen für jedes Produkt eine eindeutige Produkt-ID, einen Titel, eine Beschreibung und Preisinformationen angeben. Für Abos sind zusätzliche erforderliche Informationen erforderlich, z. B. ob es sich um einen automatisch verlängernden oder einen im Voraus bezahlten Verlängerungstyp für das Basis-Abo handelt.

Die Google Play Console bietet eine Weboberfläche, über die du deine Produkte verwalten kannst.

  • Informationen zum Erstellen und Konfigurieren von Einmalprodukten finden Sie unter Verwaltetes Produkt erstellen. In der Google Play Console werden Einmalprodukte als verwaltete Produkte bezeichnet.

  • Informationen zum Erstellen und Konfigurieren von Abos finden Sie unter Abo erstellen.

Alternativ zur Weboberfläche kannst du deine Produkte auch mit der REST-Ressource inappproducts für In-App-Produkte und der monetization.subscriptions-REST-Ressource für Aboprodukte in der Google Play Developer API verwalten.

Google Play Developer API konfigurieren

Die Google Play Developer API ist eine Server-zu-Server-API, die die Google Play Billing Library unter Android ergänzt. Diese API bietet Funktionen, die in der Google Play Billing Library nicht verfügbar sind, z. B. das sichere Überprüfen von Käufen und das Veranlassen von Erstattungen für deine Nutzer.

Wenn du das Abrechnungssystem von Google Play in deine App einbindest, musst du den Zugriff auf die Google Play Developer API über die Google Play Console konfigurieren. Eine Anleitung dazu finden Sie unter Erste Schritte mit der Google Play Developer API.

Nachdem Sie den Zugriff auf die Google Play Developer API konfiguriert haben, muss die Berechtigung Finanzdaten einsehen gewährt werden. Diese ist für den Zugriff auf abrechnungsbezogene Funktionen erforderlich. Best Practices und weitere Informationen zum Konfigurieren von Berechtigungen finden Sie unter Nutzer von Entwicklerkonten hinzufügen und Berechtigungen verwalten.

Entwicklerbenachrichtigungen in Echtzeit konfigurieren

Entwicklerbenachrichtigungen in Echtzeit (Real-time Developer Notification, RTDN) sind ein Mechanismus, um Benachrichtigungen von Google zu erhalten, wenn sich die Berechtigung eines Nutzers in Ihrer App ändert. RTDN nutzt Google Cloud Pub/Sub, um Daten zu empfangen, die entweder an eine von Ihnen festgelegte URL gesendet oder mithilfe einer Clientbibliothek abgefragt werden. Mit diesen Benachrichtigungen kannst du sofort auf Änderungen des Abostatus reagieren, ohne die Google Play Developer API abfragen zu müssen. Die ineffiziente Nutzung der Google Play Developer API kann zu Einschränkungen des API-Kontingents führen.

Cloud Pub/Sub ist ein vollständig verwalteter Echtzeit-Messaging-Dienst, mit dem Sie Nachrichten zwischen unabhängigen Anwendungen senden und empfangen können. Google Play verwendet Cloud Pub/Sub, um Push-Benachrichtigungen zu Themen zu veröffentlichen, die du abonniert hast.

Um Benachrichtigungen zu erhalten, müssen Sie einen Back-End-Server erstellen, um die an Ihr Thema gesendeten Nachrichten zu verarbeiten. Ihr Server kann diese Nachrichten dann verarbeiten, indem er auf HTTPS-Anfragen an einen registrierten Endpunkt antwortet oder die Cloud Pub/Sub-Clientbibliotheken verwendet. Diese Bibliotheken sind in verschiedenen Sprachen verfügbar. Weitere Informationen finden Sie auch im Abschnitt Pub/Sub-Abo erstellen in diesem Thema.

Preise und Kontingente bestimmen

Ausführliche Informationen zu Preisen und Kontingenten finden Sie unter Preise und Kontingente.

Datennutzung schätzen

Der Datenteil der Abobenachrichtigung umfasst etwa 1 KB an Daten pro Anfrage. Jede Veröffentlichung und jeder Abruf erfordert eine separate Anfrage mit etwa 2 KB Daten pro Benachrichtigung. Die Anzahl der Benachrichtigungen pro Monat hängt von Ihrem Abrechnungszeitraum und dem Verhalten Ihrer Nutzer ab. Während eines Abrechnungszeitraums solltest du mindestens eine Benachrichtigung pro Nutzer erwarten.

Cloud Pub/Sub einrichten

Wenn Sie Entwicklerbenachrichtigungen in Echtzeit aktivieren möchten, müssen Sie zuerst Cloud Pub/Sub mit Ihrem eigenen Google Cloud Platform-Projekt (GCP) einrichten und dann die Benachrichtigungen für Ihre Anwendung aktivieren.

Wenn Sie Cloud Pub/Sub verwenden möchten, benötigen Sie ein GCP-Projekt mit aktivierter Cloud Pub/Sub API. Wenn Sie mit der GCP und Cloud Pub/Sub nicht vertraut sind, lesen Sie die Kurzanleitung.

Thema erstellen

Um Benachrichtigungen zu erhalten, müssen Sie ein Thema erstellen, in dem Google Play die Benachrichtigungen veröffentlichen soll. Folgen Sie der Anleitung unter Thema erstellen, um ein Thema zu erstellen.

Pub/Sub-Abo erstellen

Wenn Sie Nachrichten empfangen möchten, die zu einem Thema veröffentlicht werden, müssen Sie ein Pub/Sub-Abo für dieses Thema erstellen. So erstellen Sie ein Pub/Sub-Abo:

  1. Lesen Sie den Cloud Pub/Sub-Abonnentenleitfaden, um zu ermitteln, ob Sie das Abo als Push-Abo oder als Pull-Abo konfigurieren möchten.
    • Mit einem Push-Abo kann Cloud Pub/Sub durch Senden von HTTPS-Anfragen Benachrichtigungen an Ihr sicheres Backend senden.
    • Bei einem Pull-Abo muss Ihr sicherer Backend-Server Anfragen an den Cloud Pub/Sub-Server initiieren, um Nachrichten abzurufen.
  2. Folgen Sie der Anleitung unter Abo hinzufügen, um ein Abo zu erstellen.

Veröffentlichungsrechte für dein Thema gewähren

Cloud Pub/Sub erfordert, dass Sie Google Play-Berechtigungen gewähren, um Benachrichtigungen zu Ihrem Thema zu veröffentlichen.

  1. Öffnen Sie die Google Cloud Console.
  2. Wählen Sie Ihr Projekt aus und klicken Sie im linken Navigationsbereich auf Pub/Sub.
  3. Suchen Sie Ihr Thema und öffnen Sie die Berechtigungsdetails.

    Zugriff auf Konfiguration für das Berechtigungsthema
    Abbildung 1: Zugriff auf die Konfiguration für das Thema Berechtigungen.
  4. Fügen Sie das Dienstkonto google-play-developer-notifications@system.gserviceaccount.com hinzu und weisen Sie ihm die Rolle Pub/Sub-Publisher zu.

    Google Play-Dienstkonto als Pub/Sub-Publisher hinzufügen
    Abbildung 2: Google Play-Dienstkonto als Pub/Sub-Publisher hinzufügen.
  5. Klicken Sie auf Speichern, um die Einrichtung des Themas abzuschließen.

    ein konfiguriertes Thema
    Abbildung 3: Ein konfiguriertes Thema.

Entwicklerbenachrichtigungen in Echtzeit für deine App aktivieren

So aktivieren Sie Entwicklerbenachrichtigungen in Echtzeit für Ihre App:

  1. Öffnen Sie die Google Play Console.
  2. Wählen Sie Ihre App aus.
  3. Gehe zu Monetarisieren > Einrichtung der Monetarisierung.
  4. Scrollen Sie oben auf der Seite zum Abschnitt Entwicklerbenachrichtigungen in Echtzeit.

    Bereich für Entwicklerbenachrichtigungen in Echtzeit
    Abbildung 4: Bereich für Entwicklerbenachrichtigungen in Echtzeit.
  5. Klicken Sie das Kästchen Echtzeitbenachrichtigungen aktivieren an.

  6. Geben Sie im Feld Name des Themas den vollständigen Namen des Cloud Pub/Sub-Themas ein, den Sie zuvor konfiguriert haben. Der Themenname sollte das Format projects/{project_id}/topics/{topic_name} haben, wobei project_id die eindeutige Kennzeichnung des Projekts und topic_name der Name des zuvor erstellten Themas ist.

  7. Klicken Sie auf Testnachricht senden, um eine Testnachricht zu senden. Mit einer Testveröffentlichung kannst du prüfen, ob alles richtig eingerichtet und konfiguriert ist. Wenn die Testveröffentlichung erfolgreich war, wird eine Meldung angezeigt, die besagt, dass die Testveröffentlichung erfolgreich war. Wenn Sie ein Abo für dieses Thema angehängt haben, sollten Sie die Testnachricht erhalten.

    Rufen Sie für ein Pull-Abo das Abo in der Cloud Console auf, klicken Sie auf Nachrichten anzeigen und fahren Sie mit dem Abruf von Nachrichten fort. Sie sollten alle abgerufenen Nachrichten bestätigen, um eine wiederholte Zustellung durch Cloud Pub/Sub zu vermeiden. Prüfen Sie bei einem Push-Abo, ob die Testnachricht an Ihren Push-Endpunkt gesendet wird. Ein erfolgreicher Antwortcode dient als Nachrichtenbestätigung.

    Wenn die Veröffentlichung fehlschlägt, wird ein Fehler angezeigt. Prüfen Sie, ob der Name des Themas korrekt ist und dass das Dienstkonto google-play-developer-notifications@system.gserviceaccount.com Pub/Sub-Publisher-Zugriff auf das Thema hat.

  8. Wähle aus, welche Benachrichtigungstypen du erhalten möchtest.

    • Benachrichtigungen zu Abos und allen ungültigen Käufen erhalten: Du erhältst Entwicklerbenachrichtigungen in Echtzeit zu Abos und stornierten Käufen. Sie erhalten keine Benachrichtigungen für einmalige Produktkäufe.
    • Alle Benachrichtigungen zu Abos und einmaligen Produkten erhalten: Du erhältst Benachrichtigungen zu allen Abos und ungültigen Kaufereignissen. Außerdem erhältst du einmalige Produktkaufereignisse wie ONE_TIME_PRODUCT_PURCHASED und ONE_TIME_PRODUCT_CANCELED. Weitere Informationen zu diesen Kaufereignissen finden Sie unter Lebenszyklus einmaliger Kauf.
  9. Klicken Sie auf Änderungen speichern.

Konfiguration prüfen

Wenn Sie Entwicklerbenachrichtigungen in Echtzeit erhalten möchten, müssen Sie einen sicheren Back-End-Server erstellen, um die an Ihr Cloud Pub/Sub-Thema gesendeten Nachrichten zu verarbeiten.

Sie können Ihre Konfiguration testen, indem Sie wie im vorherigen Abschnitt beschrieben in der Google Play Console auf die Schaltfläche Testnachricht senden klicken. Wenn Sie keinen Back-End-Server zum Verarbeiten von Benachrichtigungen konfiguriert haben, können Sie die Konfiguration mit dem gcloud-Befehlszeilentool prüfen. Eine Anleitung zum Verarbeiten von Nachrichten mit gcloud finden Sie unter Nachricht aus dem Abo abrufen.

Nächste Schritte