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

Firebase App Distribution Android SDK là một bản phát hành beta. Điều này có nghĩa là chức năng này có thể thay đổi theo cách không tương thích ngược. Bản phát hành thử nghiệm không phải tuân theo bất kỳ SLA hoặc chính sách ngừng sử dụng nào và có thể nhận được sự hỗ trợ hạn chế hoặc không nhận được sự hỗ trợ nào.

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 Firebase App Distribution Android SDK không bắt buộc, để 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

Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Android.

Lưu ý: Nếu bạn có nhiều ứng dụng trong dự án Firebase, hãy đảm bảo ứng dụng mà bạn muốn phân phối bằng App Distribution có tệp cấu hình google-services.json riêng. Để biết thêm thông tin, hãy xem phần Hỗ trợ nhiều môi trường.

Bước 1: Bật App Distribution API kiểm thử

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

2. Trong Firebase App Testers API, 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 2 thư viện:

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

Thận trọng: Để hỗ trợ các tính năng như thông báo cho người kiểm thử về các bản dựng mới, việc triển khai đầy đủ SDK Android App Distribution có chức năng tự cập nhật có thể bị coi là vi phạm chính sách của Google Play, ngay cả khi mã đó không được thực thi trong thời gian chạy. Nếu bạn gửi ứng dụng lên Google Play mà không xoá toàn bộ quá trình triển khai SDK, thì ứng dụng của bạn có thể bị xoá khỏi Google Play.

Thư viện chỉ có API cho phép mã của bạn gọi SDK. Các lệnh gọi này sẽ không có hiệu lực nếu không có quá trình 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 đưa chức năng tự cập nhật của quá trình triển khai SDK đầy đủ vào các bản dựng Google Play, hãy xác định các biến thể bản dựng, bao gồm cả các loại bản dựng hoặc cá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 (ở cấp ứng dụng) trong mô-đun (thường là app/build.gradle). Chỉ thêm chế độ triển khai SDK đầy đủ vào những biến thể dành riêng cho kiểm thử trước khi phát hành:

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

Bước 3: Định cấu hình ý kiến phản hồi trong ứng dụng

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

• Trình kích hoạt thông báo tích hợp: SDK Android App Distribution có thể hiển thị một thông báo liên tục mà người kiểm thử có thể nhấn vào từ bất kỳ vị trí nào trong ứng dụng. Hãy sử dụng trình kích hoạt này nếu bạn muốn bắt đầu nhanh hơn và 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 tuỳ chỉnh: Bạn có thể cung cấp cơ chế kích hoạt của riêng mình, chẳng hạn như nhấn vào một nút hoặc mục trình đơn trong ứng dụng hoặc lắc thiết bị.

Khi bạn sử dụng một trong hai điều kiện kích hoạt này và người kiểm thử gửi ý kiến phản hồi, Android SDK sẽ thực hiện các thao tác sau:

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

2. Chạy các quy trình 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 kiểm thử chưa được bật, thì Android SDK sẽ nhắc người kiểm thử đăng nhập vào App Distribution bằng Tài khoản Google của họ.

   Lưu ý: Bật các tính năng kiểm thử là một quy trình diễn ra một lần trên thiết bị kiểm thử và vẫn duy trì trong các bản cập nhật của ứng dụng. Các tính năng kiểm thử vẫn được bật trên thiết bị kiểm thử cho đến khi người kiểm thử gỡ cài đặt ứng dụng hoặc cho đến khi ứng dụng gọi phương thức signOutTester.

3. Khởi động 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.

Lựa chọn 1: Trình kích hoạt thông báo

Sử dụng showFeedbackNotification() để hiển thị một thông báo liên tục hoặc đang diễn ra trên thiết bị của người kiểm thử. Người kiểm thử có thể nhấn vào thông báo này để bắt đầu gửi ý kiến 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 sẽ hiển thị cho người kiểm thử trước khi họ gửi ý kiến phản hồi và mức độ 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 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 để cung cấp thông báo đó.

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

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

Lưu ý: Trên Android 13 trở lên, phương thức này yêu cầu quyền khi bắt đầu chạy để gửi thông báo: POST_NOTIFICATIONS. Nếu ứng dụng của bạn nhắm đến Android 13 (API cấp 33) trở lên, thì bạn cần khai báo quyền rồi yêu cầu quyền đó trong thời gian chạy.

Cách 2: Trình kích hoạt tuỳ chỉnh

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

Kotlin

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

Java

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

Bước 4: Tạo và kiểm thử quá trình triển khai

Kiểm thử cục bộ

Để kiểm thử việc triển khai mà không cần 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ộ:

   adb shell setprop debug.firebase.appdistro.devmode true

2. Tạo ứng dụng dưới dạng một biến thể phát hành trước bao gồm toàn bộ các thư viện App Distribution và kiểm thử để đảm bảo bạn có thể 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 ý kiến phản hồi trong ứng dụng. Ý kiến phản hồi sẽ không được gửi khi ở chế độ nhà phát triển.

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

   adb shell setprop debug.firebase.appdistro.devmode false

Kiểm thử toàn diện

Lưu ý: Theo mặc định, phản hồi mới sẽ kích hoạt email và cảnh báo trong bảng điều khiển cho tất cả Chủ sở hữu và Người chỉnh sửa dự án Firebase.

Để kiểm thử xem ứng dụng của bạn có thể gửi ý kiến phản hồi hay không, hãy tạo ứng dụng dưới dạng một biến thể phát hành trước có chứa toàn bộ thư viện App Distribution và kiểm thử việc triển khai của bạn 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 đến 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 trang web hoặc ứng dụng kiểm thử Android 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 ý kiến phản hồi trong ứng dụng.

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

6. Xem ý kiến phản hồi của bạn trong thẻ của bản phát hành mới trong Firebaseconsole.

Thận trọng: Trước khi phát hành ứng dụng lên Cửa hàng Google Play, hãy nhớ kiểm thử ứng dụng để xác minh rằng bạn chỉ đưa phần phụ thuộc thư viện chỉ có API vào và cơ chế phản hồi của bạn không có trong biến thể phát hành. Để biết thêm thông tin, hãy xem Bước 2: Thêm App Distribution vào ứng dụng.

Để 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 kiểm thử không thể bắt đầu gửi ý kiến phản hồi trong ứng dụng, hãy xem bài viết Bật các tính năng kiểm thử bằng SDK.

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

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 các công cụ sau để xem xét và xử lý ý kiến phản hồi đó:

• Firebase console

• Thông báo qua email về ý kiến phản hồi mới

• Công cụ của bên thứ ba

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

Bạn có thể xem xét và xoá ý kiến phản hồi của người dùng (bao gồm cả ảnh chụp màn hình) bằng cách mở thẻ Ý kiến phản hồi của người kiểm thử trong một bản phát hành cụ thể trên 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 ý kiến phản hồi của người dùng, bạn có thể xoá ý kiến phản hồi đó bằng cách nhấp vào nút Xoá ý kiến phản hồi. Ý kiến phản hồi đã bị xoá sẽ bị loại bỏ khỏi bản phát hành của bạn.

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

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

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

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

Để tắt thông báo qua email, hãy xem phần Nhận thông báo của Firebase.

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

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

Lưu ý: Để sử dụng các tính năng cảnh báo nâng cao, dự án Firebase của bạn phải sử dụng Gói giá linh hoạt.

Để thiết lập các chức 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 các việc sau:

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

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

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

2. Viết và triển khai một hàm để ghi lại 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 cho biết cách gửi ý kiến phản hồi mới đến 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ể ghi lại, hãy xem tài liệu tham khảo về cảnh báo App Distribution.