Thu thập ý kiến phản hồi của người kiểm thử

Hướng dẫn này mô tả cách bật tính năng phản hồi trong ứng dụng bằng cách sử dụng Firebase App Distribution SDK Android để người kiểm thử có thể gửi ý kiến phản hồi (bao gồm cả ảnh chụp màn hình) ngay trong ứng dụng.

Trước khi bắt đầu

Thêm Firebase vào dự án Android của bạn nếu bạn chưa thực hiện.

Bước 1: Bật API Người kiểm tra App Distribution

  1. Mở bảng điều khiển của Google Cloud rồi chọn dự án Firebase của bạn.

  2. Trong API Người kiểm tra ứng dụng Firebase, hãy nhấp vào Bật.

Bước 2: Thêm App Distribution vào ứng dụng

SDK Android App Distribution bao gồm hai thư viện:

  • firebase-appdistribution-api: Thư viện chỉ dành cho API mà bạn có thể đưa vào trong mọi biến thể bản dựng.
  • firebase-appdistribution: Triển khai SDK đầy đủ (không bắt buộc).

Thư viện chỉ API cho phép mã của bạn thực hiện lệnh gọi đến SDK. Các cuộc gọi có sẽ không có hiệu lực nếu không triển khai SDK đầy đủ.

  1. Khai báo phần phụ thuộc cho SDK Android App Distribution trong tệp Gradle mô-đun (cấp ứng dụng) (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle).

  2. Để tránh bao gồm chức năng tự cập nhật của quá trình triển khai SDK đầy đủ trong các bản dựng trên Google Play, hãy xác định các biến thể bản dựng, bao gồm loại bản dựng hoặc phiên bản sản phẩm mà bạn sẽ phân phối thông qua App Distribution.

  3. Khai báo phần phụ thuộc cho SDK Android App Distribution trong tệp Gradle mô-đun (cấp ứng dụng) (thường là app/build.gradle). Chỉ thêm triển khai SDK đầy đủ cho các biến thể dành riêng cho thử nghiệm trước khi phát hành:

    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")
    }
    

Bước 3: Định cấu hình tính năng phản hồi trong ứng dụng

Để thu thập ý kiến phản hồi từ người kiểm thử, hãy sử dụng một trong các điều kiện kích hoạt sau để cho phép người kiểm thử gửi ý kiến phản hồi:

  • Trình kích hoạt thông báo tích hợp sẵn: SDK Android App Distribution có thể hiển thị một thông báo liên tục cho biết rằng người kiểm thử có thể nhấn từ bất cứ vị trí nào trong ứng dụng. Sử dụng trình kích hoạt này nếu bạn muốn bắt đầu nhanh hơn và bạn không cần tuỳ chỉnh cách người kiểm thử cung cấp ý kiến phản hồi.

  • Trình kích hoạt tùy chỉnh: Bạn có thể cung cấp trình kích hoạt của riêng mình cơ chế, chẳng hạn như nhấn vào nút hoặc mục trong trình đơn trong ứng dụng hoặc lắc thiết bị.

Khi bạn sử dụng một trong các trình kích hoạt này và người thử nghiệm gửi phản hồi, SDK Android sẽ thực hiện những thao tác sau:

  1. Chụp ảnh màn hình về hoạt động hiện tại của ứng dụng.

  2. Chạy các bước kiểm tra để đảm bảo người kiểm thử đã bật các tính năng kiểm thử của SDK. Nếu các tính năng thử nghiệm chưa được bật, SDK Android sẽ nhắc người thử nghiệm ký vào App Distribution bằng Tài khoản Google của họ.

  3. Bắt đầu một hoạt động toàn màn hình cho phép người kiểm thử viết và gửi ý kiến phản hồi.

Cách 1: Điều kiện kích hoạt thông báo

Sử dụng showFeedbackNotification() để hiển thị cố định hoặc đang diễn ra trên thiết bị của người thử nghiệm rằng họ có thể nhấn để bắt đầu phản hồi. Khi định cấu hình thông báo, bạn cần cung cấp một số văn bản được hiển thị cho người thử nghiệm trước khi họ gửi phản hồi và cấp độ gián đoạn cho thông báo (tương ứng với mức độ quan trọng của kênh thông báo). Nếu bạn muốn thông báo cho người kiểm thử về việc thu thập và xử lý dữ liệu phản hồi, bạn có thể sử dụng văn bản để đưa ra thông báo như vậy.

Khi bạn sử dụng showFeedbackNotification() và khi ứng dụng chuyển đến nền, thông báo sẽ bị ẩn. Nếu bạn muốn ẩn rõ ràng thông báo đó, hãy dùng cancelFeedbackNotification(). Bạn nên hãy đặt showFeedbackNotification() vào onCreate() của hoạt động chính.

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);
    }
}

Cách 2: Điều kiện kích hoạt tuỳ chỉnh

Sử dụng phương thức startFeedback() để bắt đầu phản hồi bằng cơ chế lựa chọn. Ví dụ: để kích hoạt phản hồi, bạn có thể muốn thêm "Gửi phản hồi" mục trong trình đơn vào trình đơn thao tác của ứng dụng hoặc cho phép người thử nghiệm lắc thiết bị hoặc chụp ảnh màn hình. Khi bạn kích hoạt ý kiến phản hồi, hãy cung cấp một số văn bản sẽ hiển thị cho người kiểm thử trước khi gửi ý kiến phản hồi. Nếu bạn muốn thông báo cho người kiểm thử về việc thu thập và xử lý dữ liệu phản hồi của họ, bạn có thể sử dụng văn bản này để thì đưa ra thông báo như vậy.

Kotlin+KTX

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

Java

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

Bước 4: Xây dựng và kiểm thử kết quả triển khai

Kiểm thử cục bộ

Để kiểm thử kết quả triển khai mà không cần phải phân phối ứng dụng trước, hãy làm theo các bước sau:

  1. Bật chế độ nhà phát triển trên thiết bị cục bộ của bạn:

    adb shell setprop debug.firebase.appdistro.devmode true
    
  2. Tạo ứng dụng dưới dạng một biến thể bản phát hành trước có App Distribution đầy đủ thư viện và kiểm thử xem bạn có thể kích hoạt phản hồi bằng cơ chế này hay không được triển khai trong Bước 3: Định cấu hình tính năng phản hồi trong ứng dụng. Ý kiến phản hồi là không được gửi khi ở chế độ nhà phát triển.

  3. Sau khi thử nghiệm, bạn có thể tắt chế độ nhà phát triển trên thiết bị của mình:

    adb shell setprop debug.firebase.appdistro.devmode false
    

Kiểm thử toàn diện

Để kiểm tra xem ứng dụng của bạn có thể gửi phản hồi hay không, hãy tạo bản phát hành trước của ứng dụng biến thể bao gồm toàn bộ thư viện App Distribution và kiểm thử biến thể theo các bước sau:

  1. Tải bản phát hành ứng dụng mới lên App Distribution.

  2. Phân phối bản phát hành ứng dụng đó tới một tài khoản mà bạn có quyền truy cập.

  3. Tải ứng dụng xuống thông qua ứng dụng kiểm thử Android hoặc web của App Distribution.

  4. Kích hoạt ý kiến phản hồi bằng cơ chế được triển khai trong Bước 3: Định cấu hình tính năng phản hồi trong ứng dụng.

  5. Hãy đảm bảo bạn đăng nhập bằng chính tài khoản mà bạn đã phân phối bản phát hành ứng dụng và gửi ý kiến phản hồi.

  6. Xem phản hồi của bạn trong thẻ của bản phát hành mới trong Bảng điều khiển Firebase.

Để tìm hiểu cách giải quyết các vấn đề thường gặp, chẳng hạn như người thử nghiệm không thể bắt đầu gửi ý kiến phản hồi trong ứng dụng, hãy xem phần Bật tính năng thử nghiệm bằng SDK.

Bước 5: Quản lý ý kiến phản hồi của người thử nghiệm

Sau khi cho phép người kiểm thử gửi ý kiến phản hồi, bạn có thể sử dụng để xem xét và hành động dựa trên phản hồi đó:

Xem và xoá ý kiến phản hồi trong bảng điều khiển của Firebase

Bạn có thể xem lại và xoá phản hồi của người dùng, bao gồm ảnh chụp màn hình, bằng cách mở thẻ Phản hồi của nhân viên kiểm thử trong một bản phát hành cụ thể trong bảng điều khiển Firebase. Ý kiến phản hồi của người dùng được sắp xếp theo bản phát hành để bạn có thể xác nhận phiên bản mà ý kiến phản hồi áp dụng.

Sau khi xem xét phản hồi của người dùng, bạn có thể xoá phản hồi đó bằng cách nhấp vào Nút Xoá ý kiến phản hồi. Phản hồi đã bị xoá sẽ bị loại bỏ khỏi bản phát hành.

Nhận thông báo qua email khi có ý kiến phản hồi mới

Để chủ động tìm hiểu thêm về phản hồi của người thử nghiệm mới, bạn có thể nhận được email khi người kiểm thử gửi ý kiến phản hồi. Cảnh báo qua email bao gồm phản hồi mà người kiểm thử cung cấp và một đường liên kết đến mọi ảnh chụp màn hình mà họ gửi.

Để nhận App Distribution cảnh báo qua email thông qua cơ chế mặc định này, bạn phải có quyền firebase.projects.update. Sau đây là những vai trò quyền cần thiết theo mặc định: Quản trị viên Firebase hoặc dự án Chủ sở hữu hoặc Người chỉnh sửa.

Theo mặc định, mọi thành viên của dự án có các quyền cần thiết để nhận thông báo qua email sẽ nhận được email khi báo cáo phản hồi mới được gửi. Từng thành viên dự án có thể chọn không nhận các thông báo này.

Để tắt cảnh báo qua email, hãy xem Nhận cảnh báo Firebase.

Gửi ý kiến phản hồi mới đến các công cụ của bên thứ ba

Bạn cũng có thể gửi App Distribution thông báo đến thông báo ưu tiên của nhóm bằng Cloud Functions for Firebase. Ví dụ: bạn có thể viết ghi lại một sự kiện thông báo về phản hồi mới trong ứng dụng và đăng thông tin cho một dịch vụ của bên thứ ba như Discord, Slack hoặc Jira.

Để thiết lập tính năng cảnh báo nâng cao bằng Cloud Functions for Firebase, hãy làm theo các bước sau:

  1. Thiết lập Cloud Functions for Firebase, bao gồm những việc sau:

    1. Tải Node.js và npm xuống.

    2. Cài đặt và đăng nhập vào CLI Firebase.

    3. Khởi động Cloud Functions for Firebase bằng CLI Firebase.

  2. Viết và triển khai hàm ghi lại một sự kiện cảnh báo phản hồi trong ứng dụng từ App Distribution và xử lý tải trọng sự kiện (ví dụ: đăng thông tin cảnh báo trong một thông báo trên Discord).

Để xem một hàm mẫu hướng dẫn bạn cách gửi phản hồi mới cho Jira, hãy tham khảo mẫu này.

Để tìm hiểu về tất cả các sự kiện cảnh báo mà bạn có thể nắm bắt, hãy xem tài liệu tham khảo tài liệu về thông báo App Distribution.