Test kullanıcılarından geri bildirim toplama

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 varyantlarına dahil edebileceğiniz yalnızca API kitaplığıdır.
  • firebase-appdistribution: Tam SDK uygulaması (isteğe bağlı).

Yalnızca API kitaplığı, kodunuzun SDK'ya çağrı yapmasını sağlar. Tam SDK uygulaması mevcut değilse çağrıların hiçbir etkisi olmaz.

  1. App Distribution Android SDK'sına yönelik bağımlılığı modülünüzde (uygulama düzeyinde) Gradle dosyanızda (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 dahil etmemek için App Distribution üzerinden dağıtacağınız derleme türleri veya ürün çeşitleri dahil derleme varyantlarını tanımlayın.

  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. SDK uygulamasının tamamını yalnızca yayın öncesi test için tasarlanmış varyantlara ekleyin:

    Kotlin+KTX

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

    Java

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

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 başlatmasını sağlayın:

  • Yerleşik bildirim tetikleyicisi: App Distribution Android SDK'sı, test kullanıcısının uygulama içinde herhangi bir yerden dokunabileceğine dair devam eden bir bildirim gösterebilir. Daha hızlı bir şekilde 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ızdaki bir düğmeye veya menü öğesine dokunma ya da cihazı sallama gibi kendi tetikleme 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 yürütür. Test özellikleri etkinleştirilmezse Android SDK'sı, test kullanıcısından Google Hesabı ile App Distribution'da oturum açmasını ister.

  3. Test kullanıcısının geri bildirim 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 geri bildirim başlatmak için dokunabileceği kalıcı veya devam eden bir bildirim görüntülemek üzere showFeedbackNotification() öğesini kullanın. Bildirimi yapılandırdığınızda, test kullanıcısına geri bildirim göndermeden önce gösterilecek metnin bir kısmını ve bildirimin kesilme düzeyini (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şlenmesiyle ilgili bildirim göndermek istiyorsanız bu tür bir bildirim göndermek için metin kullanabilirsiniz.

showFeedbackNotification() kullandığınızda ve uygulama arka plana gittiğinde bildirim gizlenir. Bildirimi açıkça gizlemek istiyorsanız cancelFeedbackNotification() öğesini kullanın. showFeedbackNotification() öğesini ana etkinliğinizin onCreate() bölümüne koymanızı öneririz.

Kotlin+KTX

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

Tercih ettiğ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ı sallamalarına veya ekran görüntüsü almalarına izin verebilirsiniz. Geri bildirimi tetiklediğinizde, test kullanıcı geri bildirimi göndermeden önce kullanıcıya gösterilecek bir metin sağlayın. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesiyle ilgili bir bildirim göndermek istiyorsanız bu metni kullanarak bildirimde bulunabilirsiniz.

Kotlin+KTX

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

Java

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

4. Adım: Uygulamanızı oluşturma ve test etme

Yerel test

Uygulamayı dağıtmadan önce 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ı, tüm Uygulama Dağıtım kitaplıklarını içeren bir yayın öncesi varyant olarak derleyin ve 3. Adım: Uygulama içi geri bildirimi yapılandırma bölümünde uygulanan mekanizmayı kullanarak geri bildirim tetikleyebildiğinizi test edin. Geliştirici modundayken geri bildirim gönderilmez.

  3. Test ettikten 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önderip gönderemediğini test etmek için uygulamanızı tüm App Distribution kitaplıklarını içeren yayın öncesi varyant olarak derleyin ve aşağıdaki adımları uygulayarak uygulamanızı test edin:

  1. App Distribution'a 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'ın web veya Android test kullanıcısı uygulamasından 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 olup geri bildirim gönderin.

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

Test kullanıcılarının uygulamada geri bildirim başlatamamaları gibi yaygın sorunları nasıl çözeceğinizi öğrenmek için SDK ile test özelliklerini etkinleştirme bölümüne bakın.

5. Adım: Test kullanıcılarının geri bildirimlerini yönetin

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

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üme göre düzenlenir. Böylece, geri bildirimin geçerli olduğu sürümü onaylayabilirsiniz.

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

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

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

Bu varsayılan mekanizma aracılığıyla App Distribution e-posta uyarılarını almak için firebase.projects.update izninizin olması gerekir. Şu roller varsayılan olarak bu gerekli izni içerir: Firebase Yöneticisi veya proje Sahip ya da Düzenleyici.

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

E-posta uyarılarını devre dışı bırakmak için Firebase uyarıları alma konusuna bakın.

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

Cloud Functions for Firebase'i 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ı etkinliğini yakalayan ve uyarı bilgilerini Discord, Slack veya Jira gibi üçüncü taraf bir hizmete yayınlayan bir işlev yazabilirsiniz.

Cloud Functions for Firebase'i kullanarak gelişmiş uyarı özellikleri ayarlamak için şu adımları uygulayın:

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

    1. Node.js ve npm'yi indirin.

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

    3. Firebase CLI'ı kullanarak Cloud Functions for Firebase'i başlatın.

  2. App Distribution'dan uygulama içi geri bildirim uyarı etkinliği yakalayan ve etkinlik yükünü işleyen (örneğin, uyarı bilgilerini Discord'daki bir mesajda yayınlayan) bir işlev yazın ve dağıtın.

Jira'ya yeni geri bildirim göndermeyi gösteren örnek bir işlev görmek 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 belgeleri inceleyin.