Test kullanıcılarından geri bildirim toplayın

Firebase App Distribution Android SDK'sı bir beta sürümüdür. Bu nedenle, işlevsellik geriye dönük olarak uyumsuz şekilde değişebilir. Beta sürümü herhangi bir HDS veya kullanımdan kaldırma politikasına tabi değildir ve sınırlı destek alabilir ya da hiç destek almayabilir.

Bu rehberde, isteğe bağlı Firebase App DistributionAndroid SDK'sını kullanarak uygulama içi geri bildirimi nasıl etkinleştireceğiniz açıklanmaktadır. Böylece test kullanıcılarınız doğrudan uygulamadan geri bildirim (ekran görüntüleri dahil) gönderebilir.

Başlamadan önce

Henüz yapmadıysanız Firebase'i Android projenize ekleyin.

Not: Firebase projenizde birden fazla uygulamanız varsa App Distribution ile dağıtmak istediğiniz uygulamanın kendi google-services.json yapılandırma dosyası olduğundan emin olun. Daha fazla bilgi için Birden fazla ortamı destekleme başlıklı makaleyi inceleyin.

1. adım: App Distribution Tester API'yi etkinleştirin

1. Google Cloud konsolunu açın ve Firebase projenizi seçin.

2. Firebase App Testers API bölümünde Etkinleştir'i tıklayın.

2. adım: Uygulamanıza App Distribution ekleyin

App Distribution Android SDK'sı iki kitaplıktan oluşur:

• firebase-appdistribution-api: Tüm derleme varyantlarına dahil edebileceğiniz, yalnızca API'ye yönelik kitaplık.
• firebase-appdistribution: Tam SDK uygulaması (isteğe bağlı).

Dikkat: Test kullanıcılarını yeni derlemeler hakkında bilgilendirme gibi özellikleri desteklemek için tam App Distribution Android SDK uygulaması, çalışma zamanında yürütülmese bile Google Play politikası'nın ihlali olarak kabul edilebilecek otomatik güncelleme işlevini içerir. Uygulamanızı Google Play'e tam SDK uygulamasını kaldırmadan göndermeniz, uygulamanızın Google Play'den kaldırılmasına neden olabilir.

Yalnızca API'ye yönelik kitaplık, kodunuzun SDK'ya çağrı yapmasına olanak tanır. Tam SDK uygulaması mevcut değilse çağrıların hiçbir etkisi olmaz.

1. App Distribution Android SDK'sına olan bağımlılığı, modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) tanımlayın.

2. Google Play derlemelerinize tam SDK uygulamasının otomatik güncelleme işlevini dahil etmemek için App Distribution üzerinden dağıtacağınız derleme türleri veya ürün çeşitleri gibi derleme varyantlarını belirleyin.

3. App Distribution Android SDK'sına olan bağımlılığı modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle app/build.gradle) tanımlayın. Yalnızca tam SDK uygulamasını, yalnızca yayın öncesi test için tasarlanmış varyantlara ekleyin:

   Kotlin

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta15")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta16")
   }

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta16")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta16")
   }

3. adım: Uygulama içi geri bildirimi yapılandırın

Test kullanıcılarınızdan geri bildirim toplamak için aşağıdaki tetikleyicilerden birini kullanarak test kullanıcılarının geri bildirim göndermesini sağlayın:

• Yerleşik bildirim tetikleyici: App Distribution Android SDK'sı, test kullanıcısının uygulamanın herhangi bir yerinden dokunabileceği devam eden bir bildirim gösterebilir. Daha hızlı bir başlangıç yapmak istiyorsanız ve test kullanıcılarınızın geri bildirimlerini nasıl sağlayacağını özelleştirmeniz gerekmiyorsa bu tetikleyiciyi kullanın.

• Özel tetikleyici: Uygulamanızda bir düğmeye veya menü öğesine dokunma ya da cihazı sallama gibi kendi tetikleyici mekanizmanızı sağlayabilirsiniz.

Bu tetikleyicilerden birini kullandığınızda ve test kullanıcısı geri bildirim gönderdiğinde Android SDK aşağıdaki işlemleri gerçekleştirir:

1. Uygulamanın mevcut etkinliğinin ekran görüntüsünü alır.

2. Testçinin SDK'nın test özelliklerini etkinleştirdiğinden emin olmak için kontroller yapar. Test özellikleri etkinleştirilmemişse Android SDK, test kullanıcısından Google Hesabı ile App Distribution'da oturum açmasını ister.

   Not: Test özelliklerinin etkinleştirilmesi, test cihazında tek seferlik bir işlemdir ve uygulamanızın güncellemeleri boyunca devam eder. Test özellikleri, test kullanıcısı uygulamayı kaldırana veya uygulama signOutTester yöntemini çağırana kadar test cihazında etkin kalır.

3. Test kullanıcısının geri bildirimini yazıp göndermesine olanak tanıyan tam ekran etkinliği başlatır.

1. seçenek: Bildirim tetikleyici

Test kullanıcısının cihazında, geri bildirim başlatmak için dokunabileceği kalıcı veya showFeedbackNotification() devam eden bildirim göstermek için showFeedbackNotification() kullanın. Bildirimi yapılandırırken test kullanıcısına geri bildirim göndermeden önce gösterilecek bir metin ve bildirim için kesinti düzeyi (bildirim kanalının önem düzeyine karşılık gelir) sağlamanız gerekir. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirimde bulunmak istiyorsanız bu metni kullanarak bildirimde bulunabilirsiniz.

showFeedbackNotification() özelliğini kullandığınızda ve uygulama arka plana geçtiğinde bildirim gizlenir. Bildirimi açıkça gizlemek istiyorsanız cancelFeedbackNotification() simgesini kullanın. showFeedbackNotification() öğesini ana etkinliğinizin onCreate() bölümüne yerleştirmenizi öneririz.

Kotlin

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

Not: Android 13 ve sonraki sürümlerde bu yöntem için bildirim gönderme çalışma zamanı izni gerekir: POST_NOTIFICATIONS. Uygulamanız Android 13'ü (API düzeyi 33) veya sonraki sürümleri hedefliyorsa izni beyan etmeniz ve ardından çalışma zamanında istemeniz gerekir.

2. seçenek: Özel tetikleyici

Seçtiğiniz bir mekanizmayı kullanarak geri bildirim başlatmak için startFeedback() yöntemini kullanın. Örneğin, geri bildirimi tetiklemek için uygulamanızın işlem menüsüne "Geri bildirim gönder" menü öğesi ekleyebilir veya test kullanıcılarınızın cihazlarını sallamasına ya da ekran görüntüsü almasına izin verebilirsiniz. Geri bildirimi tetiklediğinizde, test kullanıcısına geri bildirim göndermeden önce gösterilecek bir metin sağlayın. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirimde bulunmak istiyorsanız bu metni kullanarak bildirimde bulunabilirsiniz.

Kotlin

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

4. adım: Uygulamanızı oluşturun ve test edin

Yerel test

Uygulamayı önce dağıtmak zorunda kalmadan uygulamanızı test etmek için aşağıdaki adımları uygulayın:

1. Yerel cihazınızda geliştirici modunu etkinleştirin:

   adb shell setprop debug.firebase.appdistro.devmode true

2. Uygulamanızı, tam App Distribution kitaplıkları içeren bir yayın öncesi varyant olarak oluşturun ve 3. adım: Uygulama içi geri bildirimi yapılandırın bölümünde uygulanan mekanizmayı kullanarak geri bildirim tetikleyebildiğinizi test edin. Geliştirici modundayken geri bildirim gönderilmez.

3. Test işleminden sonra cihazınızda geliştirici modunu devre dışı bırakabilirsiniz:

   adb shell setprop debug.firebase.appdistro.devmode false

Uçtan uca test

Not: Yeni geri bildirimler varsayılan olarak tüm Firebase projesi sahiplerine ve düzenleyicilerine e-posta ve konsol içi uyarılar gönderir.

Uygulamanızın geri bildirim gönderebildiğini test etmek için uygulamanızı tam App Distribution kitaplıklarını içeren bir yayın öncesi varyant olarak oluşturun ve aşağıdaki adımları uygulayarak uygulamanızı test edin:

1. App Distribution'ya yeni bir uygulama sürümü yükleyin.

2. Uygulama sürümünü, erişim izninizin olduğu bir hesaba dağıtın.

3. Uygulamayı App Distribution web sitesi veya Android test uygulaması üzerinden indirin.

4. 3. adım: Uygulama içi geri bildirimi yapılandırın bölümünde uygulanan mekanizmayı kullanarak geri bildirimi tetikleyin.

5. Uygulama sürümünü dağıttığınız hesapla oturum açtığınızdan emin olun ve geri bildirim gönderin.

6. Geri bildiriminizi Firebase konsolundaki yeni sürümün kartında görüntüleyin.

Dikkat: Uygulamanızı Google Play Store'da yayınlamadan önce, yalnızca API'ye özel kitaplık bağımlılığını eklediğinizi ve geri bildirim mekanizmanızın yayın varyantınıza dahil edilmediğini doğrulamak için uygulamanızı test ettiğinizden emin olun. Daha fazla bilgi için 2. adım: Uygulamanıza App Distribution ekleyin başlıklı makaleyi inceleyin.

Test kullanıcılarının uygulamada geri bildirim başlatamaması gibi sık karşılaşılan sorunları nasıl çözeceğinizi öğrenmek için SDK ile test özelliklerini etkinleştirme başlıklı makaleyi inceleyin.

5. adım: Test kullanıcılarından gelen geri bildirimleri yönetin

Test kullanıcılarınızın geri bildirim göndermesine izin verdikten sonra, bu geri bildirimleri incelemek ve bunlarla ilgili işlem yapmak için aşağıdaki araçları kullanabilirsiniz:

• Firebase console

• Yeni geri bildirimler için e-posta uyarıları

• Üçüncü taraf araçları

Firebase konsolunda geri bildirimleri görüntüleme ve silme

Firebase konsolunda belirli bir sürümün altındaki Test kullanıcısı geri bildirimi sekmesini açarak ekran görüntüleri de dahil olmak üzere kullanıcı geri bildirimlerini inceleyip silebilirsiniz. Kullanıcı geri bildirimleri sürümlere göre düzenlenir. Böylece geri bildirimin hangi sürüm için geçerli olduğunu doğrulayabilirsiniz.

Kullanıcı geri bildirimini inceledikten sonra Geri bildirimi sil düğmesini tıklayarak geri bildirimi silebilirsiniz. Silinen geri bildirim, sürümünüzden kaldırılır.

Yeni geri bildirimler için e-posta uyarıları alma

Yeni test kullanıcısı geri bildirimleri hakkında proaktif olarak bilgi edinmek için test kullanıcısı geri bildirim gönderdiğinde e-posta uyarıları alabilirsiniz. E-posta uyarısında, test kullanıcınızın sağladığı yazılı geri bildirim ve gönderdiği ekran görüntülerinin bağlantısı yer alır.

Bu varsayılan mekanizma üzerinden App Distribution e-posta uyarıları almak için firebase.projects.update izninizin olması gerekir. Bu gerekli izin, varsayılan olarak şu rollere dahildir: Firebase Yöneticisi veya proje Sahibi ya da Düzenleyicisi.

Varsayılan olarak, e-posta uyarıları almak için gerekli izinlere sahip her proje üyesi, yeni bir geri bildirim raporu gönderildiğinde e-posta alır. Proje üyeleri bu uyarıları tek tek devre dışı bırakabilir.

E-posta uyarılarını devre dışı bırakmak için Firebase uyarılarını alma başlıklı makaleyi inceleyin.

Üçüncü taraf araçlarına yeni geri bildirimler gönderme

Ayrıca, App Distribution kullanarak ekibinizin tercih ettiği bildirim kanalına Cloud Functions for Firebase uyarıları da gönderebilirsiniz. Örneğin, yeni uygulama içi geri bildirimler için uyarı etkinliği yakalayan ve uyarı bilgilerini Discord, Slack veya Jira gibi üçüncü taraf hizmetine gönderen bir işlev yazabilirsiniz.

Not: Gelişmiş uyarı özelliklerini kullanmak için Firebase projenizin Blaze fiyatlandırma planını kullanması gerekir.

Cloud Functions for Firebase kullanarak gelişmiş uyarı özelliklerini ayarlamak için aşağıdaki adımları uygulayın:

1. Aşağıdaki görevleri içeren Cloud Functions for Firebase'ı ayarlayın:

   1. Node.js ve npm'yi indirin.

   2. Firebase CLI'yi yükleyip oturum açın.

   3. Firebase KSA'yı kullanarak Cloud Functions for Firebase başlatın.

2. App Distribution uygulamasından uygulama içi geri bildirim uyarısı etkinliğini yakalayan ve etkinlik yükünü işleyen (ör. uyarı bilgilerini Discord'da mesaj olarak yayınlayan) bir işlev yazıp dağıtın.

Jira'ya nasıl yeni geri bildirim göndereceğinizi gösteren örnek bir işlev için bu örneğe bakın.

Yakalayabileceğiniz tüm uyarı etkinlikleri hakkında bilgi edinmek için App Distribution uyarıları ile ilgili referans belgelerine bakın.