Vorbereitung läuft

Hinweis :Bevor Sie dieses Thema lesen, sollten Sie sich die Play Console-Hilfe ansehen. Dort werden wichtige kaufbezogene Konzepte sowie die Erstellung und Konfiguration Ihrer Produkte für den Verkauf beschrieben.

In diesem Thema werden die Einrichtungsschritte aufgeführt und beschrieben, die Sie ausführen müssen, bevor Sie Produkte in Ihrer App verkaufen können. Dazu gehören das Erstellen eines Entwicklerkontos, das Erstellen und Konfigurieren der Produkte, die Sie verkaufen möchten, sowie das Aktivieren und Konfigurieren der APIs, die Sie zum Verkaufen und Verwalten Ihrer Produkte verwenden. Außerdem wird in diesem Thema beschrieben, wie Sie Echtzeit-Entwicklerbenachrichtigungen konfigurieren, damit Sie benachrichtigt werden, wenn sich der Status eines Produkts ändert.

Google Play-Entwicklerkonto einrichten

Wenn Sie Ihre Apps und Spiele bei Google Play veröffentlichen möchten, verwenden Sie die Google Play Console. Außerdem können Sie in der Google Play Console Ihre abrechnungsbezogenen Produkte und Einstellungen verwalten.

Um auf die Google Play Console zuzugreifen, müssen Sie ein Google Play-Entwicklerkonto einrichten.

Wenn Sie kostenpflichtige Apps und In-App-Produkte bei Google Play anbieten möchten, müssen Sie außerdem ein Profil im Google-Zahlungscenter einrichten und dieses Profil dann mit Ihrem Google Play-Entwicklerkonto verknüpfen. Hier erfahren Sie, wie Sie Ihr Profil mit Ihrem Konto verknüpfen oder prüfen, ob Sie bereits ein verknüpftes Konto und Profil haben.

Abrechnungsbezogene Funktionen in der Google Play Console aktivieren

Nachdem Sie ein Entwicklerkonto eingerichtet haben, müssen Sie eine Version Ihrer 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, z. B. die Konfiguration der Produkte, die Sie verkaufen möchten.

Bibliotheksabhängigkeit hinzufügen

Wenn Sie das Abrechnungssystem von Google Play einbinden möchten, müssen Sie zuerst eine Abhängigkeit zur Google Play Billing Library in Ihrer App hinzufügen. Diese Bibliothek bietet Zugriff auf Android-APIs, die Sie mit Google Play verbinden. Von dort aus können Sie auf Kaufinformationen zugreifen, nach Aktualisierungen von Käufen suchen, einen Nutzer auffordern, neue Käufe zu tätigen, und vieles mehr.

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

Groovy

dependencies {
    def billing_version = "8.3.0"

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

Kotlin

dependencies {
    val billing_version = "8.3.0"

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

Wenn Sie Kotlin verwenden, enthält das KTX-Modul der Play Billing Library Kotlin-Erweiterungen und Coroutine-Unterstützung, mit denen Sie idiomatischen Kotlin-Code schreiben können, wenn Sie das Abrechnungssystem von Google Play verwenden. Wenn Sie diese Erweiterungen in Ihr Projekt einbinden möchten, fügen Sie der Datei build.gradle Ihrer App die folgende Abhängigkeit hinzu:

Groovy

dependencies {
    def billing_version = "8.3.0"

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

Kotlin

dependencies {
    val billing_version = "8.3.0"

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

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

App hochladen

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

Hinweis :Für Käufe in Apps, die im internen Test-Track veröffentlicht wurden oder sich im Entwurfsstatus befinden, gelten Ausgabenlimits.

Produkte erstellen und konfigurieren

Nachdem Sie Google Play Billing-Funktionen für Ihre App aktiviert haben, müssen Sie Produkte zum Verkauf konfigurieren.

Die Schritte zum Erstellen von Einmalkaufprodukten und Abos sind ähnlich. Für jedes Produkt müssen Sie 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 beim Basis-Abo um eine automatische Verlängerung oder eine Vorauszahlung handelt.

Die Google Play Console bietet eine Weboberfläche, über die Sie Ihre Produkte verwalten können.

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

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

Alternativ zur Weboberfläche können Sie Ihre Produkte auch mit der inappproducts-REST-Ressource für In-App-Produkte und der monetization.subscriptions-REST-Ressource für Abo-Produkte 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 für Android ergänzt. Diese API bietet Funktionen, die in der Google Play Billing Library nicht verfügbar sind, z. B. das sichere Bestätigen von Käufen und das Ausstellen von Erstattungen für Ihre Nutzer.

Im Rahmen der Einbindung des Abrechnungssystems von Google Play in Ihre App müssen Sie den Zugriff auf die Google Play Developer API über die Google Play Console konfigurieren. Eine Anleitung finden Sie unter Erste Schritte mit der Google Play Developer API.

Nachdem Sie den Zugriff auf die Google Play Developer API konfiguriert haben, müssen Sie die Berechtigung Finanzdaten ansehen erteilen, die für den Zugriff auf abrechnungsbezogene Funktionen erforderlich ist. Informationen zu Best Practices und 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 notifications, RTDN) sind ein Mechanismus, mit dem Sie Benachrichtigungen von Google erhalten, wenn sich die Berechtigung eines Nutzers in Ihrer App ändert. RTDN nutzt Google Cloud Pub/Sub, sodass Sie Daten empfangen können, die entweder an eine von Ihnen festgelegte URL gesendet oder über eine Clientbibliothek abgerufen werden. Mit diesen Benachrichtigungen können Sie sofort auf Änderungen des Abostatus reagieren und vermeiden, dass die Google Play Developer API abgefragt werden muss. Die ineffiziente Verwendung der Google Play Developer API kann zur Einschränkung von API-Kontingenten führen.

Hinweis: Sie müssen die Google Play Developer API aufrufen, nachdem Sie Entwicklerbenachrichtigungen in Echtzeit erhalten haben, um den vollständigen Status abzurufen und Ihren eigenen Backend-Status zu aktualisieren. Diese Benachrichtigungen informieren Sie nur darüber, dass sich der Kaufstatus geändert hat. Sie enthalten keine vollständigen Informationen zum Kauf.

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 Sie abonnieren.

Um Benachrichtigungen zu erhalten, müssen Sie einen Backend-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 festlegen

Weitere Informationen zu Preisen und Kontingenten finden Sie unter Preise und Kontingente.

Datennutzung schätzen

Der Datenteil der Abo-Benachrichtigung umfasst etwa 1 KB Daten pro Anfrage. Für jede Veröffentlichung und jeden Pull ist eine separate Anfrage oder etwa 2 KB an Daten pro Benachrichtigung erforderlich. Die Anzahl der Benachrichtigungen pro Monat hängt von Ihrem Abrechnungszeitraum und dem Verhalten Ihrer Nutzer ab. Sie sollten mindestens eine Benachrichtigung pro Nutzer während eines Abrechnungszeitraums erhalten.

Cloud Pub/Sub einrichten

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

Um Cloud Pub/Sub verwenden zu können, benötigen Sie ein GCP-Projekt, in dem die Cloud Pub/Sub API aktiviert ist. Wenn Sie mit GCP und Cloud Pub/Sub nicht vertraut sind, lesen Sie die Kurzanleitung.

Hinweis:Sie müssen Entwicklerbenachrichtigungen in Echtzeit für jede Android-App separat konfigurieren. Das bedeutet, dass Sie entweder dasselbe GCP-Projekt wie für den Zugriff auf die Play Developer API verwenden oder für jede App ein neues GCP-Projekt erstellen können. Wenn Sie mehrere Apps haben, müssen Sie dasselbe Google Cloud Console-Projekt für die Google Play Developer API verwenden, können aber für jede einzelne App unterschiedliche Google Cloud Console-Projekte verwenden.

Thema erstellen

Damit Sie Benachrichtigungen erhalten können, 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 wurden, 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 entscheiden, 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 dein sicherer Backend-Server Anfragen an den Cloud Pub/Sub-Server initiieren, um Nachrichten abzurufen.
2. Folge der Anleitung unter Abo hinzufügen, um ein Abo zu erstellen.

Hinweis :Pull-Abos werden häufig verwendet, um die Ressourcennutzung zu optimieren, wenn eine große Anzahl von Nachrichten verarbeitet wird. Dies gilt in der Regel nicht für RTDN. Wenn Sie sich nicht sicher sind, ob Sie mit Push oder Pull beginnen sollen, empfehlen wir Ihnen, Push zu verwenden, da die Implementierung in der Regel einfacher ist. Weitere Informationen dazu, ob ein Push- oder Pull-Abo für Ihre App am besten geeignet ist, finden Sie unter Pull- oder Push-Zustellung.

Veröffentlichungsrechte für das Thema gewähren

Für Cloud Pub/Sub müssen Sie Google Play-Berechtigungen zum Veröffentlichen von Benachrichtigungen in Ihrem Thema gewähren.

1. Öffnen Sie die Google Cloud Console.
2. Wählen Sie Ihr Projekt aus und klicken Sie dann in der linken Navigationsleiste auf Pub/Sub.

3. Suchen Sie nach Ihrem Thema und öffnen Sie die Berechtigungsdetails.

   

   Abbildung 1: Auf die Konfiguration für das Thema Berechtigungen zugreifen

4. Fügen Sie das Dienstkonto [e-mail] hinzu und weisen Sie ihm die Rolle Pub/Sub Publisher zu.

   

   Abbildung 2. Google Play-Dienstkonto als Pub/Sub-Publisher hinzufügen.

5. Klicken Sie auf Speichern, um die Einrichtung des Themas abzuschließen.

   

   Abbildung 3: Ein konfiguriertes Thema.

Entwicklerbenachrichtigungen in Echtzeit für Ihre 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. Rufe Monetarisieren > Einrichtung der Monetarisierung auf.

4. Scrollen Sie oben auf der Seite zum Abschnitt Entwicklerbenachrichtigungen in Echtzeit.

   

   Abbildung 4: Abschnitt „Entwicklerbenachrichtigungen in Echtzeit“

   .

5. Klicken Sie das Kästchen Echtzeitbenachrichtigungen aktivieren an.

6. Geben Sie im Feld Name des Themas den vollständigen Cloud Pub/Sub-Themennamen ein, den Sie zuvor konfiguriert haben. Der Themenname muss das Format projects/{project_id}/topics/{topic_name} haben, wobei project_id die eindeutige Kennung für Ihr Projekt und topic_name der Name des zuvor erstellten Themas ist.

7. Klicken Sie auf Testnachricht senden, um eine Testnachricht zu senden. Durch einen Testlauf können Sie sicherstellen, dass alles richtig eingerichtet und konfiguriert ist. Wenn die Testveröffentlichung erfolgreich ist, wird eine Meldung angezeigt, die besagt, dass die Testveröffentlichung erfolgreich war. Wenn Sie ein Abo für dieses Thema haben, sollten Sie die Testnachricht erhalten.

   Rufen Sie für ein Pull-Abo das Abo in der Cloud Console auf, klicken Sie auf Nachrichten ansehen und rufen Sie Nachrichten ab. Sie sollten jede Nachricht bestätigen, die Sie abgerufen haben, 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 Bestätigung der Nachricht.

   Wenn die Veröffentlichung fehlschlägt, wird ein Fehler angezeigt. Prüfen Sie, ob der Themenname korrekt ist und das [e-mail]-Dienstkonto Pub/Sub-Publisher-Zugriff auf das Thema hat.

8. Wählen Sie aus, welche Benachrichtigungstypen Sie erhalten möchten.

   • Benachrichtigungen zu Abos und allen ungültigen Käufen erhalten: Sie erhalten Entwicklerbenachrichtigungen in Echtzeit zu Abos und ungültigen Käufen. Sie erhalten keine Benachrichtigungen für Einmalkaufprodukte.
   • Alle Benachrichtigungen zu Abos und Einmalprodukten erhalten: Sie erhalten Benachrichtigungen zu allen Abo- und ungültigen Kaufereignissen. Sie erhalten auch Ereignisse für Einmalkäufe, z. B. ONE_TIME_PRODUCT_PURCHASED und ONE_TIME_PRODUCT_CANCELED. Weitere Informationen zu diesen Kaufereignissen finden Sie unter Lebenszyklus von Einmalkäufen.

9. Klicken Sie auf Änderungen speichern.

Konfiguration überprüfen

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

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

Nächste Schritte

• Bibliothek in Ihre App einbinden