Uygulama içi öğeleri algılayıp yayınlama

Bu konuda, oyuncular Google Play uygulamasında Play Points ile satın aldıktan sonra oyununuzdaki uygulama içi ürünlerin nasıl algılanacağı ve teslim edileceği açıklanmaktadır.

Kullanıcılar, Play puanlarını Google Play uygulamasında uygulama içi ürün için kullandığında öğeler oyununuzda anında teslim edilmelidir. Aşağıda, kullanıcının Play Points ile nasıl öğe satın aldığı gösterilmektedir.

1. Play Points'i tıklayın.	1. Öğeleri görüntülemek için Kullan sekmesini tıklayın.	2. Bir öğe seçin ve satın alma işlemini tamamlamak için Puan Kullan'ı tıklayın.	3. Öğeyi teslim alın.

Örnekte, ürün satın alınırken oyun çalışmıyor. Kullanıcılar, oyun cihazlarına yüklü olmasa bile Play puanlarını ürünlerle değiştirebilir. Bu nedenle, oyununuzu oyun içi mağaza dışından uygulama içi öğe teslimatını işleyecek şekilde tasarlamanız gerekir.

Başlamadan önce

Uygulama içi ürünleri algılayıp sunmadan önce ürünü ve Play Points promosyonlarını oluşturmanız gerekir.

Yayınlama koşulları

Play Points promosyonu kullanarak oyununuzda uygulama içi ürünler sunduğunuzda bu bölümdeki şartlara uymanız gerekir.

Teslimat zamanlaması

Bir oyuncu Play puanlarını uygulama içi ürünle değiştirdiğinde, oyunu yeniden başlatmasını istemeden öğeyi hemen teslim etmeniz gerekir. Oyun içeriğinin önceden tamamlanması gerektiği durumlarda (ör. eğiticiyi tamamlama) öğe hemen teslim edilmelidir.

Teslimat mesajı

Bir kullanıcı, oyun dışında uygulama içi ürün satın aldıktan sonra oyununuza döndüğünde, ürünün oyunda başarıyla verildiğine dair bir onay göstermeniz gerekir. Mesaj, pop-up iletişim kutusu veya oyun içi mesaj olarak gösterilmelidir. Kullanıcılar, öğeyi almak için ek işlem yapmak zorunda kalmamalıdır.

Gerekli mesajlaşma biçimi şöyledir:

• Öğenin alındığını belirten net bir mesaj.

• Kullanıcıların, aldıkları diğer içeriklerden ayırt edebilmesi için öğe adını ve "Play Puanları"nı net bir şekilde belirtin.

• Birden fazla mezhebe sahip benzer öğeler varsa öğenin adında doğru mezhep de yer almalıdır.

• Pop-up iletişim kutusu, mesaj veya oyun içi bildirim, kullanıcı Devam ya da Tamam gibi bir onayı tıklayana kadar kullanıcıya görünür olmalıdır. Bu mesaj yalnızca kullanıcıları oyun içinde aldıkları öğe hakkında bilgilendirmek için gönderildiğinden iptal düğmesi olmamalıdır. Onay düğmesi yoksa kullanıcıların öğelerini aldıklarını bilmeleri için mesajın kaybolmadan önce en az 3 saniye boyunca görünür olması gerekir.

Örnek mesaj:

"Öğe alındı! Play Points ile 100 mücevher kazandınız. Devam et."

Kullanıcılar, oyun içi para birimi bakiyelerindeki artışı gösteren bir animasyon veya görsel onay görmelidir. Öğe, dayanıklı veya tüketilebilir bir uygulama içi öğeyse kullanıcılar, öğenin kilidinin açıldığı ya da oyun içinde kullanılabildiği yere yönlendirilmelidir.

Oyun dışında alınan öğeleri algılama

Oyununuzda Google Play Faturalandırma Kitaplığı kullanılıyorsa oyun dışında alınan uygulama içi ürünleri algılamak için aşağıdaki değişiklikleri yapın.

1. Hangi öğelerin onaylanmadığını belirleyebilmek için oyununuzun onResume() geri çağırmasında queryPurchases() yöntemini çağırarak öğe listesini alın.

2. Oyununuzun sunucusu varsa Subscriptions and In-App Purchases API'yi kullanarak satın alma işlemini sunucunuzdan doğrulamanızı önemle tavsiye ederiz.

3. Sahip olunan ancak onaylanmamış öğeler varsa tüketilebilir öğeler için consumeAsync(), tüketilemez öğeler için acknowledgePurchase() ile satın alma işlemini onaylayın.

4. Satın alınan öğenin oyun içinde kullanılabilmesini sağlayın.

Bölünmüş ekran modunda alınan öğeleri algılama

Oyununuz çoklu pencere modunu destekliyorsa kullanıcılar, Play Store uygulamasını ve oyununuzu aynı anda çalıştırırken Play puanlarını kullanıp öğeyi alabilir. Bu ekran görüntüsünde bir örnek gösterilmektedir:

Bu senaryoyu Google Play Faturalandırma Kitaplığı ile desteklemek için aşağıdakileri yapın:

1. Google Play, oyununuza bekleyen yeni bir öğe olduğunu bildirmek için onPurchasesUpdated() yöntemini çağırır.

2. Oyununuzun sunucusu varsa Subscriptions and In-App Purchases API'yi kullanarak satın alma işlemini sunucunuzdan doğrulamanızı önemle tavsiye ederiz.

3. Satın alma işlemini tüketilebilir öğeler için consumeAsync(), tüketilemez öğeler için ise acknowledgePurchase() ile onaylayın.

4. Satın alınan öğenin oyun içinde kullanılabilmesini sağlayın.

Teslimat onayı gösterme

Kullanıcılar Play puanlarını kullanarak bir öğe aldığında oyunun, öğeyi doğru şekilde aldığını ve işlediğini bildirmek için oyun içi mesaj göstermesini veya bir tür bildirim kullanmasını bekler. Aşağıda bazı teslimat onayı seçenekleri verilmiştir:

• Oyun içi pop-up gösterin.

• Mesajı oyun içi mesaj kutusuna iletin ve oyun içi mesaj kutusunda yeni bir mesaj olduğunu net bir şekilde belirtin.

• İşletim sistemi bildirim mesajı kullanın.

Promosyon ürünü alındığında oyunun cihazda yüklü olmaması da dahil olmak üzere herhangi bir durumda olması mümkündür. Öğe alındığında oyunun durumu ne olursa olsun promosyonlu öğeleri algılamanız gerekir. Ancak, öğenin alındığı konusunda kullanıcıyı hemen bilgilendirmenin kabul edilebilir olmadığı bazı istisnalar vardır. Örneğin:

• Oyun sırasında mesaj göstermek kullanıcıların dikkatini dağıtabilir. Bu durumda, işlem sona erdikten sonra kullanıcıyı bilgilendirmeniz gerekir.

• Kullanıcının dikkatini dağıtabilecek mesajların gösterildiği ara sahnelerde. Bu durumda, ara sahne bittikten sonra kullanıcıyı bilgilendirmeniz gerekir.

• Oyunun ilk eğitici ve kullanıcı kurulumu bölümlerinde. Yeni kullanıcıları, oyunu açtıktan hemen sonra veya ilk kullanıcı kurulumu sırasında ödül hakkında bilgilendirmenizi öneririz. Ancak kullanıcıyı bilgilendirmek için ana oyun sırasının kullanılabilir olmasını beklemek kabul edilebilir.

Öğe, uygulamanızda birden fazla karaktere veya hesaba uygulanabiliyorsa kullanıcıdan promosyon öğelerini hangi hesabın alacağını seçmesini istemenizi öneririz.

Kullanıcıları tanıtım amaçlı öğeler hakkında ne zaman ve nasıl bilgilendireceğinize karar verirken kullanıcıları göz önünde bulundurun. Kullanıcılar bildirimleri hemen almadıklarında kafaları karışabilir, oyunu oynamayı bırakabilir, kullanıcı desteğiyle iletişime geçebilir veya sosyal medyada bu durumdan şikayet edebilir.

Belirli oyun motorlarına yönelik güncellemeler

Belirli oyun motorları için dikkate alınması gereken bazı noktaları aşağıda bulabilirsiniz:

• Oyununuz Unity ile geliştirildiyse kullandığınız uygulama içi satın alma uygulamasının Play Points promosyonlarını destekleyip desteklemediğini doğrulamanızı öneririz.

• Oyununuz Cocos2d-x veya Unreal Engine (C/C++) ile oluşturulmuşsa büyük olasılıkla C/C++ kodunuzdan Java API'lerini çağıran JNI kodunu yazmanız gerekir.

Sunucu tarafıyla ilgili en iyi uygulamalar

Bu bölümde, Play Points promosyonlarında kullanabileceğiniz sunucu tarafı en iyi uygulamaları yer almaktadır:

• Sunucunuzda Purchases.products: get çağrısı yapıyorsanız productId değerlerine göre Play ödül değişim öğelerini ve diğer uygulama içi ürünleri ayrı ayrı işlemeniz gerekip gerekmediğini doğrulayın.

• Sunucunuzda Inappproducts: list kullanıyorsanız Play ödül değişimi öğelerini diğer uygulama içi ürünlerden productId değerlerine göre ayırmanız gerekip gerekmediğini doğrulayın.

• Ek değişiklik yapmanız gerekip gerekmediğini doğrulamak için aşağıdaki en iyi uygulamaları inceleyin:

  • Referans:
    • Sahtekarlık ve kötüye kullanımla mücadele
    • Benzersiz tanımlayıcılarla ilgili en iyi uygulamalar
  • Sunucu tarafı imza doğrulamasını uygulayın.
  • purchaseToken ve orderId değerlerinin benzersiz olduğundan ve daha önce kullanılmadığından emin olun.

Sorun giderme

Bu bölümde, müşteri sorgularına yol açabilecek senaryolarla ilgili öneriler yer almaktadır.

Birden fazla kullanıcı hesabı

Cihazında birden fazla Google Hesabı olan bir kullanıcı Play Points'i yanlış hesapta kullanırsa Google, öğeleri diğer hesaplara aktaramaz. Benzer şekilde, uygulamanız getPurchases() yöntemini çağırarak öğeyi aktaramaz. Bu senaryoda, müşteri desteği işlemlerinizi kullanarak uygulama içi öğeleri kullanıcıya manuel olarak sağlamayı düşünebilirsiniz.

Geciken veya eksik öğeler

Oyuncular ödül öğelerini geç alıyor veya alamıyorsa Google Play yardım belgelerindeki uygulama içi satın alma işlemleriyle ilgili sorun giderme kılavuzuna bakın.