Bu konuda, uygulamanızda ürün satabilmek için uygulamanız gereken kurulum adımları açıklanmaktadır. Genel anlamda bu kurulum, geliştirici hesabı oluşturmayı, satmak istediğiniz ürünleri oluşturup yapılandırmayı ve ürünlerinizi satmak ve yönetmek için kullandığınız API'leri etkinleştirip yapılandırmayı içerir. Bu konuda ayrıca, bir ürünün durumu değiştiğinde bildirim almak için Gerçek zamanlı geliştirici bildirimlerinin nasıl yapılandırılacağı da açıklanmaktadır.
Google Play geliştirici hesabı oluşturun
Uygulamalarınızı ve oyunlarınızı Google Play'de yayınlamak için Google Play Console'u kullanın. Faturalandırmayla ilgili ürün ve ayarlarınızı yönetmek için de Google Play Console'u kullanırsınız.
Google Play Console'a erişmek için Google Play Geliştirici Hesabı oluşturmanız gerekir.
Google Play'de ücretli uygulamalar ve uygulama içi ürünler satmak için Google Ödeme Merkezi'nde de bir profil oluşturmanız ve ardından bu profili Google Play geliştirici hesabınıza bağlamanız gerekir. Profilinizi hesabınıza nasıl bağlayacağınızı öğrenmek veya bağlı bir hesabınız ve profiliniz olup olmadığını nasıl kontrol edeceğinizi öğrenmek için Google Play geliştirici hesabını ödeme profilinize bağlama bölümüne bakın.
Google Play Console'da faturalandırmayla ilgili özellikleri etkinleştirme
Geliştirici hesabı oluşturduktan sonra, uygulamanızın Google Play Faturalandırma Kitaplığı'nı içeren bir sürümünü yayınlamanız gerekir. Bu adım, Google Play Console'da satmak istediğiniz ürünleri yapılandırma gibi faturalandırmayla ilgili özellikleri etkinleştirmek için gereklidir.
Kitaplık bağımlılığı ekle
Google Play'in faturalandırma sistemini entegre etmek için öncelikle uygulamanızdaki Google Play Faturalandırma Kitaplığı'na bir bağımlılık ekleyin. Bu kitaplık, sizi Google Play'e bağlayan Android API'lerine erişim sağlar. Buradan satın alma bilgilerine erişebilir, satın alma işlemleriyle ilgili güncellemeleri sorgulayabilir, kullanıcıdan yeni satın alma işlemleri yapmasını isteyebilir ve daha pek çok şey yapabilirsiniz.
Google Play Faturalandırma Kitaplığı'na Google'ın Maven deposundan erişebilirsiniz. Bağımlılığı aşağıdaki gibi uygulamanızın build.gradle
dosyasına ekleyin:
Eski
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") }
Kotlin kullanıyorsanız Play Faturalandırma Kitaplığı KTX modülü, Google Play'in faturalandırma sistemini kullanırken deyimsel Kotlin yazabilmenizi sağlayan Kotlin uzantıları ve eş yordamlar desteği içerir. Bu uzantıları projenize dahil etmek için uygulamanızın build.gradle
dosyasına aşağıdaki bağımlılığı gösterildiği gibi ekleyin:
Eski
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") }
Bu sayfadaki Kotlin kodu örnekleri, mümkün olduğunda KTX'ten yararlanır.
Uygulamanızı yükleme
Kitaplığı uygulamanıza ekledikten sonra uygulamanızı geliştirip yayınlayın. Bu adım için uygulamanızı oluşturun ve dahili test kanalı dahil herhangi bir kanala yayınlayın.
Ürünlerinizi oluşturma ve yapılandırma
Uygulamanızda Google Play Faturalandırma özelliklerini etkinleştirdikten sonra satış için ürünleri yapılandırmanız gerekir.
Tek seferlik ürün ve abonelik oluşturma adımları benzerdir. Her ürün için benzersiz bir ürün kimliği, başlık, açıklama ve fiyat bilgisi sağlamanız gerekir. Aboneliklerde, temel plan için otomatik yenilenen veya ön ödemeli yenileme türü arasından seçim yapma gibi gerekli ek bilgiler bulunur.
Google Play Console, ürünlerinizi yönetmek için kullanabileceğiniz bir web arayüzü sunar.
Tek seferlik ürünler oluşturmak ve yapılandırmak için Yönetilen ürün oluşturma başlıklı makaleyi inceleyin. Google Play Console'un tek seferlik ürünleri yönetilen ürünler olarak adlandırdığını unutmayın.
Abonelik oluşturmak ve yapılandırmak için Abonelik oluşturma bölümünü inceleyin.
Web arayüzüne alternatif olarak, uygulama içi ürünler için inappproducts
REST kaynağını ve Google Play Developer API'deki abonelik ürünleri için monetization.subscriptions
REST kaynağını kullanarak da ürünlerinizi yönetebilirsiniz.
Google Play Developer API'yi yapılandırma
Google Play Developer API, Android'de Google Play Faturalandırma Kitaplığı'nı tamamlayan sunucular arası bir API'dir. Bu API, satın alma işlemlerini güvenli bir şekilde doğrulama ve kullanıcılarınıza geri ödeme yapma gibi Google Play Faturalandırma Kitaplığı'nda bulunmayan işlevler sağlar.
Google Play'in faturalandırma sistemini uygulamanıza entegre etmenin bir parçası olarak Google Play Console üzerinden Google Play Developer API'ye erişimi yapılandırmanız gerekir. Talimatlar için Google Play Developer API'yi Kullanmaya Başlama bölümüne bakın.
Google Play Developer API'ye erişimi yapılandırdıktan sonra, faturalandırmayla ilgili işlevlere erişmek için gerekli olan Finansal verileri görüntüleme iznini verdiğinizden emin olun. En iyi uygulamalar hakkında bilgi edinmek ve izinleri yapılandırmayla ilgili daha fazla bilgi edinmek için Geliştirici hesabı kullanıcıları ekleme ve izinleri yönetme bölümünü inceleyin.
Gerçek zamanlı geliştirici bildirimlerini yapılandırma
Gerçek zamanlı geliştirici bildirimleri (RTDN), uygulamanızın içinde bir kullanıcının yararlanma haklarında değişiklik olduğunda Google'dan bildirim almayı sağlayan bir mekanizmadır. RTDN, belirlediğiniz bir URL'ye aktarılan veya bir istemci kitaplığı kullanılarak anket yapılan verileri almanıza olanak tanıyan Google Cloud Pub/Sub kullanımından yararlanır. Bu bildirimler, abonelik durumundaki değişikliklere anında tepki vermenize olanak tanıyarak Google Play Developer API'yi yoklama ihtiyacını ortadan kaldırır. Google Play Developer API'nin verimsiz kullanımının API kota kısıtlamalarına yol açabileceğini unutmayın.
Cloud Pub/Sub, bağımsız uygulamalar arasında mesaj göndermek ve almak için kullanabileceğiniz, tümüyle yönetilen bir gerçek zamanlı mesajlaşma hizmetidir. Google Play, abone olduğunuz konularda push bildirimleri yayınlamak için Cloud Pub/Sub'ı kullanır.
Bildirimleri almak için konunuza gönderilen mesajları kullanacak bir arka uç sunucusu oluşturmanız gerekir. Ardından sunucunuz, kayıtlı bir uç noktaya gelen HTTPS isteklerine yanıt vererek veya Cloud Pub/Sub İstemci Kitaplıklarını kullanarak bu mesajları kullanabilir. Bu kütüphaneler çeşitli dillerde mevcuttur. Bu konudaki Pub/Sub aboneliği oluşturma bölümünden daha fazla bilgi edinebilirsiniz.
Fiyatlandırma ve kotaları belirleme
Fiyatlandırma ve kotalarla ilgili ayrıntılar için fiyatlandırma ve kotalar bölümlerini inceleyin.
Veri kullanımını tahmin et
Abonelik bildiriminin veri bölümü, istek başına yaklaşık 1 KB boyutunda veridir. Her publish ve pull için ayrı bir istek veya bildirim başına yaklaşık 2 KB veri gerekir. Aylık bildirim sayısı, faturalandırma döngünüze ve kullanıcılarınızın davranışına bağlıdır. Faturalandırma döneminde her kullanıcı için en az bir bildirim bekleyebilirsiniz.
Cloud Pub/Sub'ı kurun
Gerçek zamanlı geliştirici bildirimlerini etkinleştirmek için önce kendi Google Cloud Platform (GCP) projenizi kullanarak Cloud Pub/Sub'ı kurmanız ve ardından uygulamanız için bildirimleri etkinleştirmeniz gerekir.
Cloud Pub/Sub'ı kullanmak için Cloud Pub/Sub API'nin etkinleştirildiği bir GCP projeniz olmalıdır. GCP ve Cloud Pub/Sub hakkında bilginiz yoksa Hızlı Başlangıç Kılavuzu'na göz atın.
Konu oluşturma
Bildirim almaya başlamak için Google Play'in bildirimleri yayınlaması gereken bir konu oluşturmalısınız. Konu oluşturmak için Konuyu oluşturma bölümündeki talimatları uygulayın.
Pub/Sub aboneliği oluşturma
Bir konuda yayınlanan mesajları almak için o konuda Pub/Sub aboneliği oluşturmanız gerekir. Pub/Sub aboneliği oluşturmak için şunları yapın:
- Aboneliğin push aboneliği veya pull aboneliği olarak yapılandırılıp yapılandırılmayacağını belirlemek için Cloud Pub/Sub Abone Kılavuzu'nu okuyun.
- Push aboneliği, Cloud Pub/Sub'ın HTTPS istekleri yayınlayarak güvenli arka ucunuza bildirim göndermesine olanak tanır.
- Pull aboneliği, güvenli arka uç sunucunuzun mesajları almak için Cloud Pub/Sub sunucusuna istek başlatmasını gerektirir.
- Abonelik oluşturmak için Abonelik ekleme başlıklı makaledeki talimatları uygulayın.
Konunuz için yayın hakları verin
Cloud Pub/Sub konunuzla ilgili bildirim yayınlaması için Google Play ayrıcalıkları vermenizi gerektirir.
- Google Cloud Console'u açın.
- Projenizi seçin ve ardından soldaki gezinme bölümünde Pub/Sub'ı tıklayın.
Konunuzu bulun ve izin ayrıntılarını açın.
Şekil 1. İzinler konusuyla ilgili yapılandırmaya erişme. google-play-developer-notifications@system.gserviceaccount.com
hizmet hesabını ekleyin ve hesaba Pub/Sub Yayıncısı rolü verin.Şekil 2. Google Play hizmet hesabını, Pub/Sub yayıncısı olarak ekleme. Konu oluşturma işlemini tamamlamak için Kaydet'i tıklayın.
Şekil 3. Yapılandırılmış bir konu.
Uygulamanız için Gerçek zamanlı geliştirici bildirimlerini etkinleştirin
Uygulamanızda Gerçek zamanlı geliştirici bildirimlerini etkinleştirmek için aşağıdakileri yapın:
- Google Play Console'u açın.
- Uygulamanızı seçin.
- Para kazanma > Para kazanma kurulumu'na gidin.
Sayfanın üst kısmındaki Gerçek zamanlı geliştirici bildirimleri bölümüne gidin.
Şekil 4. Gerçek zamanlı geliştirici bildirimleri bölümü. Gerçek zamanlı bildirimleri etkinleştir'i işaretleyin.
Konu adı alanına, daha önce yapılandırdığınız Cloud Pub/Sub konu adını eksiksiz bir şekilde girin. Konu adı
projects/{project_id}/topics/{topic_name}
biçiminde olmalıdır. Buradaproject_id
, projenizin benzersiz tanımlayıcısıdır.topic_name
ise daha önce oluşturulan konunun adıdır.Test mesajı göndermek için Test Mesajı Gönder'i tıklayın. Test yayını yapmak, her şeyin düzgün bir şekilde ayarlandığından ve yapılandırıldığından emin olmanıza yardımcı olur. Test yayını başarılı olursa test yayınının başarılı olduğunu belirten bir mesaj görüntülenir. Bu konuya bir abonelik eklediyseniz test mesajını alırsınız.
Pull aboneliği için Cloud Console'da aboneliğe gidin, Mesajları Görüntüle'yi tıklayın ve mesajları almaya devam edin. Cloud Pub/Sub tarafından tekrarlanan teslimatlardan kaçınmak için aldığınız tüm mesajları onaylamanız gerekir. Push aboneliği için test mesajının push uç noktanıza teslim edilip edilmediğini kontrol edin. Başarılı bir yanıt kodu, mesaj onayı işlevi görür.
Yayınlama başarısız olursa bir hata gösterilir. Konu adının doğru olduğundan ve
google-play-developer-notifications@system.gserviceaccount.com
hizmet hesabının konuya Pub/Sub Yayıncısı erişimine sahip olduğundan emin olun.Almak istediğiniz bildirim türlerini seçin.
- Abonelikler ve geçersiz satın alma işlemleri için bildirim alın: Abonelikler ve geçersiz satın alma işlemleriyle ilgili gerçek zamanlı geliştirici bildirimleri alın. Tek seferlik ürün satın alma işlemleri için bildirim almazsınız.
- Abonelikler ve tek seferlik ürünlerle ilgili tüm bildirimleri al: Tüm abonelikler ve geçersiz satın alma etkinlikleri için bildirim alın. Ayrıca
ONE_TIME_PRODUCT_PURCHASED
veONE_TIME_PRODUCT_CANCELED
gibi tek seferlik ürün satın alma etkinlikleri de alırsınız. Bu satın alma etkinlikleri hakkında daha fazla bilgi edinmek için Tek seferlik satın alma yaşam döngüsü bölümüne bakın.
Değişiklikleri kaydet'i tıklayın.
Yapılandırmanız doğrulanıyor
Gerçek zamanlı geliştirici bildirimleri almak için Cloud Pub/Sub konunuza gönderilen mesajları kullanacak güvenli bir arka uç sunucusu oluşturmalısınız.
Önceki bölümde açıklandığı gibi, Google Play Console'daki Test Mesajı Gönder düğmesini kullanarak yapılandırmanızı test edebilirsiniz. Bir arka uç sunucusunu bildirimleri kullanacak şekilde yapılandırmadıysanız yapılandırmayı doğrulamak için gcloud
komut satırı aracını kullanabilirsiniz. gcloud
kullanarak mesajları işleme hakkında talimatlar için Mesajı abonelikten çekme bölümüne bakın.