Bu belgede, uygulamanızda ürün satabilmeniz için gerçekleştirmeniz gereken kurulum adımları listelenmekte ve açıklanmaktadır. Genel olarak 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 belgede, bir ürünün durumu her 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şturma
Uygulama ve oyunlarınızı Google Play'de yayınlamak için Google Play Console'u kullanın. Google Play Console'u, faturalandırmayla ilgili ürün ve ayarlarınızı yönetmek için de kullanırsınız.
Google Play Console'a erişmek için Google Play Geliştirici Hesabı oluşturmanız gerekir.
Ücretli uygulamaları ve uygulama içi satın almaları Google Play'de satmak için Google ödeme merkezinde 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ı 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 başlıklı makaleyi inceleyin.
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 faturalandırmayla ilgili özellikleri (ör. satmak istediğiniz ürünleri yapılandırma) etkinleştirmek için gereklidir.
Kitaplık bağımlılığı ekleme
Google Play'in faturalandırma sistemini entegre etmek için öncelikle uygulamanıza Google Play Faturalandırma Kitaplığı'na yönelik 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 fazlasını yapabilirsiniz.
Google Play Faturalandırma Kitaplığı'na Google'ın Maven deposundan erişebilirsiniz. Bağımlılığı, uygulamanızın build.gradle dosyasına gösterildiği gibi ekleyin:
Modern
dependencies { def billing_version = "9.1.0" implementation "com.android.billingclient:billing:$billing_version" }
Kotlin
dependencies { val billing_version = "9.1.0" implementation("com.android.billingclient:billing:$billing_version") }
Kotlin kullanıyorsanız Google Play Faturalandırma Kitaplığı KTX modülü, Google Play'in faturalandırma sistemini kullanırken deyimsel Kotlin yazmanıza olanak tanıyan Kotlin uzantıları ve eş yordam desteği içerir. Bu uzantıları projenize dahil etmek için aşağıdaki bağımlılığı uygulamanızın build.gradle dosyasına gösterildiği gibi ekleyin:
Modern
dependencies { def billing_version = "9.1.0" implementation "com.android.billingclient:billing-ktx:$billing_version" }
Kotlin
dependencies { val billing_version = "9.1.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ı derleyip yayınlayın. Bu adımda uygulamanızı oluşturun ve ardından dahili test kanalı dahil olmak üzere herhangi bir kanalda yayınlayın.
Ürünlerinizi oluşturma ve yapılandırma
Uygulamanız için Google Play Faturalandırma özelliklerini etkinleştirdikten sonra satılacak ü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 fiyatlandırma bilgileri sağlamanız gerekir. Aboneliklerde, temel plan için otomatik yenilenen veya ön ödemeli yenileme türünün seçilmesi gibi ek zorunlu bilgiler bulunur.
Google Play Console, ürünlerinizi yönetmek için kullanabileceğiniz bir web arayüzü sunar.
Tek seferlik ürünleri oluşturmak ve yapılandırmak için Yönetilen ürün oluşturma başlıklı makaleye bakın. Google Play Console'da tek seferlik ürünlerin yönetilen ürünler olarak adlandırıldığını unutmayın.
Abonelik oluşturmak ve yapılandırmak için Abonelik oluşturma başlıklı makaleyi inceleyin.
Web arayüzüne alternatif olarak, Google Play Developer API'deki uygulama içi ürünler için inappproducts REST kaynağını ve 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'deki Google Play Faturalandırma Kitaplığı'nı tamamlayan bir sunucudan sunucuya API'dir. Bu API, Google Play Faturalandırma Kitaplığı'nda bulunmayan işlevler (ör. satın alma işlemlerini güvenli bir şekilde doğrulama ve kullanıcılarınıza geri ödeme yapma) sağlar.
Google Play'in faturalandırma sistemini uygulamanıza entegre etme kapsamında Google Play Developer API'ye erişimi Google Play Console üzerinden yapılandırmanız gerekir. Talimatlar için Google Play Developer API'yi Kullanmaya Başlama başlıklı makaleyi inceleyin.
Google Play Developer API'ye erişimi yapılandırdıktan sonra, faturalandırmayla ilgili işlevlere erişmek için gereken Finansal verileri görüntüleme iznini verdiğinizden emin olun. En iyi uygulamalar ve izinleri yapılandırma hakkında daha fazla bilgi için Geliştirici hesabı kullanıcıları ekleme ve izinleri yönetme başlıklı makaleyi inceleyin.
Gerçek zamanlı geliştirici bildirimlerini yapılandırma
Gerçek zamanlı geliştirici bildirimleri (RTDN), uygulamanızda bir kullanıcının hakkıyla ilgili değişiklik olduğunda Google'dan bildirim almanızı sağlayan bir mekanizmadır. RTDN, Google Cloud Pub/Sub'ı kullanır. Bu sayede, belirlediğiniz bir URL'ye gönderilen veya bir istemci kitaplığı kullanılarak sorgulanan verileri alabilirsiniz. Bu bildirimler, abonelik durumu değişikliklerine anında tepki vermenizi sağlayarak Google Play Developer API'yi yoklama ihtiyacını ortadan kaldırır. Google Play Developer API'nin verimsiz kullanımı, API kota kısıtlamalarına neden olabilir.
Cloud Pub/Sub, bağımsız uygulamalar arasında mesaj gönderip almak için kullanabileceğiniz, tümüyle yönetilen bir anlık mesajlaşma hizmetidir. Google Play, abone olduğunuz konularla ilgili push bildirimleri yayınlamak için Cloud Pub/Sub'ı kullanır.
Bildirim almak için konunuza gönderilen mesajları kullanacak bir arka uç sunucusu oluşturmanız gerekir. Sunucunuz daha sonra kayıtlı bir uç noktaya gönderilen HTTPS isteklerine yanıt vererek veya Cloud Pub/Sub istemci kitaplıklarını kullanarak bu mesajları kullanabilir. Bu kitaplıklar çeşitli dillerde sunulur. Daha fazla bilgiyi bu belgedeki Pub/Sub aboneliği oluşturma bölümünde de bulabilirsiniz.
Fiyatlandırmayı ve kotaları belirleme
Fiyatlandırma ve kotalar hakkında ayrıntılı bilgi için fiyatlandırma ve kotalar sayfalarını inceleyin.
Veri kullanımını tahmin etme
Abonelik bildiriminin veri kısmı, istek başına yaklaşık 1 KB veri içerir. Her yayınlama ve çekme işlemi için ayrı bir istek veya bildirim başına yaklaşık 2 KB veri gerekir. Aylık bildirim sayısı, faturalandırma döneminize ve kullanıcılarınızın davranışına bağlıdır. Faturalandırma dönemi boyunca her kullanıcı için en az bir bildirim alırsınız.
Cloud Pub/Sub'ı ayarlama
Gerçek zamanlı geliştirici bildirimlerini etkinleştirmek için önce kendi Google Cloud projenizi kullanarak Cloud Pub/Sub'ı ayarlamanız, ardından uygulamanız için bildirimleri etkinleştirmeniz gerekir.
Cloud Pub/Sub'ı kullanmak için Cloud Pub/Sub API'nin etkin olduğu bir Google Cloud projeniz olmalıdır. Google Cloud ve Cloud Pub/Sub hakkında bilginiz yoksa Hızlı başlangıç kılavuzuna bakın.
Konu oluşturma
Bildirim almaya başlamak için Google Play'in bildirimleri yayınlaması gereken bir konu oluşturmanız gerekir. Konu oluşturmak için Konu oluşturma bölümündeki talimatları uygulayın.
Pub/Sub aboneliği oluşturma
Bir konuda yayınlanan mesajları almak için o konuya Pub/Sub aboneliği oluşturmanız gerekir. Pub/Sub aboneliği oluşturmak için aşağıdakileri yapın:
- Aboneliği push aboneliği olarak mı yoksa pull aboneliği olarak mı yapılandıracağınızı belirlemek için Cloud Pub/Sub Abone Kılavuzu'nu okuyun.
- Push aboneliği, Cloud Pub/Sub'ın HTTPS istekleri göndererek güvenli arka ucunuza bildirim göndermesine olanak tanır.
- Çekme aboneliği, güvenli arka uç sunucunuzun mesajları almak için Cloud Pub/Sub sunucusuna istek göndermesini gerektirir.
- Abonelik oluşturmak için Abonelik ekleme bölümündeki talimatları uygulayın.
Konunuzda yayınlama hakları verme
Cloud Pub/Sub, konunuzda bildirim yayınlamak için Google Play'e ayrıcalıklar vermenizi gerektirir.
- Google Cloud Console'u açın.
- Projenizi seçin ve ardından soldaki gezinme menüsünde Pub/Sub'ı tıklayın.
Konunuzu bulun ve izin ayrıntılarını açın.
Şekil 1. İzinler konusunun yapılandırmasına erişme Hizmet hesabını ekleyin
google-play-developer-notifications@system.gserviceaccount.comve bu hesaba Pub/Sub Yayıncısı rolünü verin.
Şekil 2. Google Play hizmet hesabını Pub/Sub yayıncısı olarak ekleme. Konu kurulumunu 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ştirme
Uygulamanız için gerçek zamanlı geliştirici bildirimlerini etkinleştirmek üzere 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üne gidin. Anlık bildirimleri etkinleştir'i seçin.
Konu adı alanına, daha önce yapılandırdığınız Cloud Pub/Sub konu adının tamamını girin. Konu adı
projects/{project_id}/topics/{topic_name}biçiminde olmalıdır. Buradaproject_id, projenizin benzersiz tanımlayıcısı,topic_nameise 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 doğru şekilde ayarlandığından ve yapılandırıldığından emin olmanıza yardımcı olur. Test yayınlama başarılı olursa test yayınlamanın başarılı olduğunu belirten bir mesaj gösterilir. Bu konu için bir abonelik eklediyseniz test mesajını almanız gerekir.
Çekme aboneliği için Cloud Console'da aboneliğe gidin, Mesajları Görüntüle'yi tıklayın ve mesajları çekmeye devam edin. Cloud Pub/Sub tarafından tekrar tekrar yayınlanmasını önlemek için çektiğiniz 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ı yanıt kodu, mesajın alındığını onaylar.
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.comhizmet hesabının konuya Pub/Sub Yayıncısı erişimi olduğundan emin olun.Almak istediğiniz bildirim türlerini seçin.
- Abonelikler ve tüm geçersiz satın alma işlemleri ile ilgili bildirim gönder: 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şlemleriyle ilgili bildirim almazsınız.
- Abonelikler ve tek seferlik ürünler ile ilgili tüm bildirimleri gönder: Tüm abonelik ve geçersiz satın alma işlemi etkinlikleriyle ilgili bildirim gönderilir.
Ayrıca
ONE_TIME_PRODUCT_PURCHASEDveONE_TIME_PRODUCT_CANCELEDgibi tek seferlik ürün satın alma işlemlerini de alırsınız. Bu satın alma işlemleri hakkında daha fazla bilgi edinmek için Tek seferlik satın alım yaşam döngüsü bölümünü inceleyin.
Değişiklikleri kaydet'i tıklayın.
Yapılandırmanız doğrulanıyor
Gerçek zamanlı geliştirici bildirimlerini almak için Cloud Pub/Sub konunuza gönderilen mesajları kullanacak güvenli bir arka uç sunucusu oluşturmanız gerekir.
Önceki bölümde açıklandığı gibi Google Play Console'daki Test Mesajı Gönder düğmesini kullanarak yapılandırmanızı test edebilirsiniz. Bildirimleri kullanmak için bir arka uç sunucusu yapılandırmadıysanız yapılandırmayı doğrulamak için gcloud komut satırı aracını kullanabilirsiniz. gcloud kullanarak mesajları işleme talimatları için Mesajı abonelikten alma başlıklı makaleyi inceleyin.