Google Play ile ilk entegrasyon
Google Play hesabınızı Adapty’ye bağlayarak sunucularımızın Play Store ürünlerinizi okuyabilmesini, satın almalarınızı doğrulayabilmesini ve Android abonelik etkinliklerini alabilmesini sağlayın.
Her mağaza ayrı ayrı bağlanır ve bu bağlantılar birbirinden bağımsızdır. Uygulamanız App Store’da da yayınlanıyorsa, App Store Connect entegrasyonunu yapılandırın.
Kurulum yaklaşık bir saat sürer. Tek bir pencerede kalmayı tercih ediyorsanız, Adapty Kontrol Paneli’ndeki yerleşik onboarding aynı adımları kapsamaktadır.
Başlamadan önce
Apple’dan farklı olarak Google, geliştirici ekosistemini iki ayrı ürüne böler — Google Play Console ve Google Cloud Console — ve bu kurulum her ikisini de kapsar.
Neler Gerektirir
- Hizmet hesabı: İnsanlar yerine makineler için oluşturulan bir Google hesabıdır. Adapty’ye Google Cloud ve Google Play Console’larınıza erişim vermek için yeni bir hizmet hesabı oluşturmanız gerekir.
- Google Cloud Console: Google’ın genel amaçlı altyapı platformudur. Play Store’un kendi API kimlik bilgileri olmadığından bunları burada oluşturursunuz. Developer API’lerini etkinleştirmek, hizmet hesabı oluşturmak ve gerekli izinlerin bir kısmını vermek için Cloud Console’u kullanın. Adapty’nin yenilemeleri, iptalleri ve iadeleri alabilmesi için bu izinlere ihtiyacı vardır. Adapty’nin Google ile kimlik doğrulamasını sağlayan hizmet hesabı anahtar dosyası buradan indirilebilir.
- Google Play Console: Uygulamanızı yayımladığınız ve abonelik sattığınız yerdir. Hizmet hesabına gerekli izinlerin geri kalanını vermek için Play Console’u kullanın. Adapty’nin ürünlerinizi okuyabilmesi ve satın almaları doğrulayabilmesi için bu izinlere ihtiyacı vardır. Bunlara ek olarak, Play Store ile Adapty arasında gerçek zamanlı iletişim kurabilmek için gerçek zamanlı geliştirici bildirimlerini (RTDN) de buradan etkinleştirirsiniz.
Gerekli erişim ayrıcalıkları
| Konsol | İhtiyacınız olan |
|---|---|
| Google Cloud Console | Projeniz yoksa oluşturmak için Project Creator (roles/resourcemanager.projectCreator). Servis hesabı oluşturmak için Service Account Creator (roles/iam.serviceAccountCreator) ve proje izinleri vermek için Project IAM Admin (roles/resourcemanager.projectIamAdmin). Owners rolü bu üçünü de kapsar. |
| Google Play Console | Kullanıcı davet etme hakkını da içeren Admin (all permissions); servis hesabını davet edebilmek için bu izne ihtiyacınız var. |
Google, yeni bir organizasyonda varsayılan olarak herkese Project Creator yetkisi verir, dolayısıyla büyük ihtimalle bu yetkiye zaten sahipsinizdir. Kurumsal düzeyde kısıtlanmış bir organizasyonda bu yetki kaldırılmış olabilir.
Gerekli kaynaklar
Bir Google Cloud projesi. Henüz yoksa oluşturun ya da halihazırda kullandığınız bir projeyi yeniden kullanın. Geliştirici API’lerini etkinleştirmek ve Adapty için servis hesabı oluşturmak amacıyla bu projeyi kullanırsınız.
Proje, Play Console uygulamanızdan bağımsızdır. Tek bir proje, birden fazla uygulamanın iletişimini yönetebilir. Her uygulama, proje içinde kendi topic’ini — bir iletişim kuyruğunu — alır.
Google’ın hizmetlerini Adapty’e bağlarken, baştan sona aynı projeyi kullanmanız gerekir. Kişisel bir proje yerine ekibinizin sahip olduğu bir projeyi tercih edin — anahtar ve konu, uygulama var olduğu sürece orada yaşar.
İlk entegrasyon için kontrol listesi
- Google Cloud Console’da Geliştirici API’lerini etkinleştirin.
- Google Cloud Console’da bir hizmet hesabı oluşturun.
- Google Play Console’da hizmet hesabına gerekli izinleri verin.
- Google Cloud Console’da hizmet hesabı anahtar dosyasını oluşturun.
- Adapty Kontrol Paneli’nde anahtar dosyasını ve paket adını Adapty’ye yükleyin. Yeni bir hizmet hesabının etkinleşmesi en az 24 saat sürer ve bu süre dolmadan Adapty ürünlerinizi okuyamaz — bu beklemeyi atlamak için Google Play Console’da herhangi bir ürün açıklamasını düzenleyip kaydedin.
- Google Play Console’da, Adapty’nin oluşturduğu konu adını kullanarak Gerçek zamanlı geliştirici bildirimlerini (RTDN) etkinleştirin.
- Uygulamanızın kullandığı her framework için Adapty SDK’sını yükleyin:
- Yayınlamadan önce gerçek bir cihazda uygulama içi satın almalarınızı test edin.
Sonraki adımlar
Entegrasyon tamamlandıktan sonra Adapty’nin özelliklerini kullanmaya başlayabilirsiniz.
Paywall’ları göstermek için entegrasyonun üzerine uygulama kodu gerekir: en azından paywall’ları gösterin ve paywall’ları kendiniz oluşturuyorsanız satın alma sürecini yönetin.
Uygulamanızı yayınlamadan önce Yayın kontrol listesini gözden geçirin.