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

Bu kılavuzda, test kullanıcılarınızın doğrudan uygulama içinden geri bildirim (ekran görüntüleri dahil) gönderebilmesi için isteğe bağlı Firebase App Distribution Android SDK'sını kullanarak uygulama içi geri bildirimi nasıl etkinleştireceğiniz açıklanmaktadır.

Başlamadan önce

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

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'nin altında 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 değişkenlerine ekleyebileceğiniz, yalnızca API içeren kitaplık.
  • firebase-appdistribution: Tam SDK uygulaması (isteğe bağlı).

Yalnızca API kitaplığı, kodunuzun SDK'ya çağrı yapmasına olanak tanır. Tam SDK uygulaması yoksa ç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 kendi kendine güncelleme işlevini eklememek için App Distribution üzerinden dağıtacağınız derleme türleri veya ürün türleri dahil olmak üzere derleme değişkenlerini 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. 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:16.0.0-beta21")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21")
}

    Java 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta21")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21")
}

Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Ekim 2023 sürümünden itibaren hem Kotlin hem de Java geliştiricileri, ana kitaplık modülüne bağlı olabilir. Ayrıntılar için bu girişimle ilgili SSS bölümüne bakın.

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 tetikleyicisi: 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ı başlamak istiyorsanız ve test kullanıcılarınızın geri bildirim sağlama şeklini ö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 kullanıcısının SDK'nın test özelliklerini etkinleştirdiğinden emin olmak için kontroller yapar. Test özellikleri etkinleştirilmemişse Android SDK'sı, test kullanıcısından Google Hesabı ile App Distribution uygulamasında oturum açmasını ister.

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

1. seçenek: Bildirim tetikleyici

Test kullanıcısının cihazında, dokunarak geri bildirim göndermeyi başlatabileceği kalıcı veya devam eden bir 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 önemine karşılık gelir) sağlamanız gerekir. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirim göndermek istiyorsanız bu metni kullanabilirsiniz.

showFeedbackNotification() uygulamasını kullandığınızda ve uygulama arka plana geçtiğinde bildirim gizlenir. Bildirimi açıkça gizlemek istiyorsanız cancelFeedbackNotification() 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);
    }
}

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 bildirim gönderme işlemini 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ı sallamalarına ya da ekran görüntüsü almalarına izin verebilirsiniz. Geri bildirim 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 bildirim göndermek istiyorsanız bu metni kullanabilirsiniz.

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

Uygulamanızı 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ştirme:

    adb shell setprop debug.firebase.appdistro.devmode true

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

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

    adb shell setprop debug.firebase.appdistro.devmode false

Uçtan uca test

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 derleyin ve aşağıdaki adımları uygulayarak uygulamanızı test edin:

  1. App Distribution için yeni bir uygulama sürümü yükleyin.

  2. Uygulama sürümünü, erişim izniniz olan bir hesaba dağıtın.

  3. Uygulamayı App Distribution web sitesinden veya Android test kullanıcısı uygulamasından indirin.

  4. 3. adım: Uygulama içi geri bildirimi yapılandırma 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 Console'daki yeni sürüm kartında görüntüleyin.

Test kullanıcılarının uygulamada geri bildirim başlatamaması gibi yaygın 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ısı geri bildirimlerini yönetin

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

Firebase Console'da geri bildirimleri görüntüleme ve silme

Firebase Console'da 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üme göre düzenlenir. Böylece geri bildirimin hangi sürüm için geçerli olduğunu doğrulayabilirsiniz.

Kullanıcı geri bildirimlerini inceledikten sonra Geri bildirimi sil düğmesini tıklayarak 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 bildirimlerini proaktif olarak öğrenmek için test kullanıcıları 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 mekanizmayı kullanarak App Distribution e-posta uyarıları almak için firebase.projects.update iznine sahip olmanız gerekir. Aşağıdaki roller, varsayılan olarak bu gerekli izni içerir: 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ı alma başlıklı makaleyi inceleyin.

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

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

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

  1. Cloud Functions for Firebase kurulumu: Bu aşama aşağıdaki görevleri içerir:

    1. Node.js ve npm'yi indirin.

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

    3. Firebase KSA'yı kullanarak Cloud Functions for Firebase uygulamasını ilk kullanıma hazırlayın.

  2. App Distribution uygulamasından uygulama içi geri bildirim uyarısı etkinliğini yakalayan ve etkinlik yükünü işleyen (örneğin, uyarı bilgilerini Discord'da bir mesajda 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 işlev örneğine bakın.

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