Hazırlanıyor

Not: Bu konuyu okumadan önce, satın alma işlemiyle ilgili önemli kavramların yanı sıra ürünlerinizi satışa sunmak için nasıl oluşturup yapılandıracağınızı açıklayan Play Console Yardım Merkezi belgelerini okuduğunuzdan emin olun.

Bu konuda, uygulamanızda ürün satabilmek için yapmanız gereken kurulum adımları listelenmekte ve açıklanmaktadır. Bu kurulum, genel olarak 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, bir ürünün durumu her değiştiğinde bildirim almak için anlık 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. Faturalandırmayla ilgili ürünlerinizi ve ayarlarınızı yönetmek için Google Play Console'u da 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 ürünleri Google Play'de satmak için Google ödeme merkezinde bir profil oluşturmanız ve bu profili Google Play geliştirici hesabınıza bağlamanız gerekir. Profilinizi hesabınıza nasıl bağlayacağınızı veya halihazırda 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ızda 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ıları yeni satın alma işlemleri yapmaya yönlendirebilir ve daha fazlasını yapabilirsiniz.

Google Play Faturalandırma Kitaplığı, Google'ın Maven deposunda mevcuttur. Bağımlılığı, gösterildiği gibi uygulamanızın build.gradle dosyasına ekleyin:

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")
}

Kotlin kullanıyorsanız Play Faturalandırma Kitaplığı KTX modülü, Google Play'in faturalandırma sistemini kullanırken deyimsel Kotlin yazmanızı sağlayan Kotlin uzantılarını ve eş yordam desteğini 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:

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")
}

Bu sayfadaki Kotlin kodu örneklerinde mümkün olduğunda KTX'ten yararlanılır.

Uygulamanızı yükleme

Kitaplığı uygulamanıza ekledikten sonra uygulamanızı oluşturup yayınlayın. Bu adım için uygulamanızı oluşturun ve ardından dahili test kanalı da dahil olmak üzere herhangi bir kanalda yayınlayın.

Not: Dahili test kanalında yayınlanan veya taslak aşamasındaki uygulamalarda yapılan satın alma işlemleri harcama sınırlarına tabidir.

Ürünlerinizi oluşturma ve yapılandırma

Uygulamanızda 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ü sağlar.

• Tek seferlik ürün oluşturma ve yapılandırma hakkında bilgi edinmek için Yönetilen ürün oluşturma başlıklı makaleye göz atın. Google Play Console'da tek seferlik ürünlerin yönetilen ürünler olarak adlandırıldığını unutmayın.

• Abonelik oluşturma ve yapılandırma hakkında bilgi edinmek için Abonelik oluşturma bölümüne bakın.

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) sunar.

Google Play'in faturalandırma sistemini uygulamanıza entegre etme kapsamında, 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 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 gerekli olan 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 kullanıcının yetkisinde değişiklik olduğunda Google'dan bildirim almanızı sağlayan bir mekanizmadır. RTDN, Google Cloud Pub/Sub'ın kullanımından yararlanır. Bu sayede, belirlediğiniz bir URL'ye gönderilen veya istemci kitaplığı kullanılarak yoklanan verileri alabilirsiniz. Bu bildirimler, abonelik durumundaki değişikliklere anında tepki vermenizi sağlar ve Google Play Developer API'yi yoklamanıza gerek kalmaz. Google Play Geliştirici API'sinin verimsiz kullanımının API kotası kısıtlamalarına yol açabileceğini unutmayın.

Not: Tam durumu almak ve kendi arka uç durumunuzu güncellemek için Gerçek zamanlı geliştirici bildirimleri'ni aldıktan sonra Google Play Developer API'sini çağırmanız gerekir. Bu bildirimler yalnızca satın alma durumunun değiştiğini bildirir. Bu raporlar, satın alma işlemi hakkında eksiksiz bilgi vermez.

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 konularda 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 yapılan HTTPS isteklerine yanıt vererek veya Cloud Pub/Sub istemci kitaplıklarını kullanarak bu mesajları kullanabilir. Bu kitaplıklar çeşitli dillerde kullanılabilir. Daha fazla bilgiyi bu konudaki Pub/Sub aboneliği oluşturma bölümünde de bulabilirsiniz.

Fiyatlandırmayı ve kotaları belirleme

Fiyatlandırma ve kotalarla ilgili ayrıntılar için fiyatlandırma ve kotalar sayfalarına bakın.

Veri kullanımını tahmin etme

Abonelik bildiriminin veri kısmı, istek başına yaklaşık 1 KB'tır. Her yayınlama ve çekme işlemi için ayrı bir istek gerekir. Bildirim başına yaklaşık 2 KB veri kullanılır. Aylık bildirim sayısı, faturalandırma döneminize ve kullanıcılarınızın davranışlarına bağlıdır. Bir faturalandırma döneminde her kullanıcı için en az bir bildirim almayı bekleyebilirsiniz.

Cloud Pub/Sub'ı ayarlama

Gerçek zamanlı geliştirici bildirimlerini etkinleştirmek için önce kendi Google Cloud Platform (GCP) 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 GCP projeniz olmalıdır. GCP ve Cloud Pub/Sub hakkında bilginiz yoksa Hızlı başlangıç kılavuzuna bakın.

Not: Gerçek zamanlı geliştirici bildirimlerini her Android uygulaması için ayrı ayrı yapılandırmanız gerekir. Bu, Play Developer API'ye erişmek için kullanılan GCP projesiyle aynı GCP projesini kullanmayı seçebileceğiniz veya her uygulama için yeni bir GCP projesi oluşturabileceğiniz anlamına gelir. Birden fazla uygulamanız varsa Google Play Developer API için aynı Google Cloud Console projesini kullanmanız gerekir ancak her uygulama için farklı Google Cloud Console projeleri kullanabilirsiniz.

Konu oluşturma

Bildirim almaya başlamak için Google Play'in bildirimleri yayınlayacağı bir konu oluşturmanız gerekir. Konu oluşturmak için Konu oluşturma başlıklı makaledeki talimatları uygulayın.

Pub/Sub aboneliği oluşturma

Bir konuda yayınlanan mesajları almak için ilgili konuya Pub/Sub aboneliği oluşturmanız gerekir. Pub/Sub aboneliği oluşturmak için aşağıdakileri yapın:

1. Aboneliği push aboneliği veya çekme aboneliği olarak yapılandırıp yapılandırmayacağınıza karar vermek 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, mesajları almak için güvenli arka uç sunucunuzun Cloud Pub/Sub sunucusuna istek başlatmasını gerektirir.
2. Abonelik oluşturmak için Abonelik ekleme bölümündeki talimatları uygulayın.

Not: Çekme abonelikleri, çok sayıda ileti işlenirken kaynak kullanımını optimize etmek için yaygın olarak kullanılır. Bu durum genellikle RTDN için geçerli değildir. Push veya pull ile başlayıp başlamayacağınızdan emin değilseniz genellikle uygulaması daha kolay olduğu için push'u kullanmanızı öneririz. Uygulamanız için en uygun abonelik türünün push mu yoksa pull mu olduğuna karar vermek için Pull veya push teslimatı başlıklı makaleyi inceleyin.

Konunuzda yayınlama hakları verme

Cloud Pub/Sub, Google Play'e konunuza bildirim yayınlama ayrıcalıkları vermenizi gerektirir.

1. Google Cloud Console'u açın.
2. Projenizi seçin ve soldaki gezinme menüsünde Pub/Sub'ı tıklayın.

3. Konunuzu bulun ve izin ayrıntılarını açın.

   

   Şekil 1. İzinler konusunun yapılandırmasına erişme.

4. Hizmet hesabını ekleyin [e-mail] ve hesaba Pub/Sub Yayıncısı rolünü verin.

   

   Şekil 2. Google Play hizmet hesabını Pub/Sub yayıncısı olarak ekleme.

5. 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:

1. Google Play Console'u açın.
2. Uygulamanızı seçin.
3. Para kazanma > Para kazanma kurulumu'na gidin.

4. 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.

5. Anlık bildirimleri etkinleştir'i işaretleyin.

6. Konu adı alanına, daha önce yapılandırdığınız Cloud Pub/Sub konu adını eksiksiz bir şekilde girin. Konu adı şu biçimde olmalıdır: projects/{project_id}/topics/{topic_name} Burada project_id, projenizin benzersiz tanımlayıcısıdır ve topic_name, daha önce oluşturulan konunun adıdır.

7. Test mesajı göndermek için Test Mesajı Gönder'i tıklayın. Test yayını yapmak, her şeyin doğru şekilde ayarlanıp 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österilir. Bu konu için bir abonelik eklediyseniz test mesajını alırsınız.

   Çekme aboneliği için Cloud Console'da aboneliğe gidin, View Messages'ı (Mesajları Görüntüle) tıklayın ve mesajları çekme işlemine devam edin. Cloud Pub/Sub'ın mesajı tekrar göndermesini önlemek için çektiğiniz tüm mesajları onaylamanız gerekir. Anlık bildirim aboneliği için test mesajının anlık bildirim uç noktanıza teslim edilip edilmediğini kontrol edin. Başarılı bir yanıt kodu, mesajın alındığını gösterir.

   Yayınlama başarısız olursa bir hata gösterilir. Konu adının doğru olduğundan ve [e-mail] hizmet hesabının konu için Pub/Sub Yayıncısı erişimine sahip olduğundan emin olun.

8. Almak istediğiniz bildirim türlerini seçin.

   • Abonelikler ve tüm geçersiz satın alma işlemleri ile ilgili bildirimler alma: 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ünlerle ilgili tüm bildirimleri gönder: Tüm abonelik ve geçersiz satın alma işlemi etkinlikleriyle ilgili bildirimler alırsınız. Ayrıca ONE_TIME_PRODUCT_PURCHASED ve ONE_TIME_PRODUCT_CANCELED gibi tek seferlik ürün satın alma etkinliklerini 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ü başlıklı makaleyi inceleyin.

9. Değişiklikleri kaydet'i tıklayın.

Yapılandırmanızı doğrulama

Gerçek zamanlı geliştirici bildirimleri 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 üzere gcloud komut satırı aracını kullanabilirsiniz. gcloud kullanarak mesajları işleme talimatları için Abonelikten mesajı çekme başlıklı makaleyi inceleyin.

Sonraki adımlar

• Kitaplığı uygulamanıza entegre etme