Bắt đầu sử dụng tính năng Gửi thông báo trong ứng dụng của Firebase

Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn cách thiết lập Firebase In-App Messaging và gửi tin nhắn đầu tiên.


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.

Thêm SDK Firebase In-App Messaging vào dự án của bạn

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), thêm phần phụ thuộc cho thư viện In-App Messaging cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.

Để sử dụng In-App Messaging, bạn phải bật Google Analytics trong dự án Firebase và thêm Firebase SDK cho Google Analytics vào ứng dụng của bạn.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.4.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

Khi sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android trên Firebase.

(Phương án thay thế) Thêm các phần phụ thuộc của thư viện Firebase mà không sử dụng BoM

Nếu chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phần phụ thuộc của thư viện đó.

Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự bạn nên sử dụng BoM để quản lý các phiên bản thư viện. Việc này đảm bảo rằng tất cả các phiên bản đều tương thích.

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:21.0.0")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
Bạn đang tìm một mô-đun thư viện dành riêng cho Kotlin? Bắt đầu sau Tháng 10 năm 2023 (Firebase BoM 32.5.0), cả nhà phát triển Kotlin và Java đều có thể phụ thuộc vào mô-đun thư viện chính (để biết thông tin chi tiết, hãy xem Câu hỏi thường gặp về sáng kiến này).

Gửi tin nhắn thử nghiệm

Lấy mã cài đặt của ứng dụng

Để tiết kiệm pin, Firebase In-App Messaging chỉ truy xuất tin nhắn từ máy chủ một lần mỗi ngày. Điều này có thể gây khó khăn cho việc thử nghiệm, vì vậy Bảng điều khiển Firebase cho phép bạn chỉ định một thiết bị thử nghiệm có hiển thị thông báo theo yêu cầu.

Thiết bị kiểm thử đó được xác định bằng mã nhận dạng FirebaseInstallations hoặc FID. Tìm FID của ứng dụng kiểm thử bằng cách kiểm tra Logcat trong Android Studio cho nhật ký cấp "Thông tin" sau đây:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

Gửi tin nhắn đến thiết bị thử nghiệm

Sau khi chạy ứng dụng trên thiết bị thử nghiệm và có mã cài đặt Firebase (FID), bạn có thể thử thiết lập Firebase In-App Messaging bằng cách gửi một thông báo kiểm thử:

  1. Trong bảng điều khiển Firebase, hãy mở trang Nhắn tin.
  2. Nếu đây là chiến dịch đầu tiên của bạn, hãy nhấp vào Tạo chiến dịch đầu tiên.
    1. Chọn Thông báo trong ứng dụng Firebase rồi nhấp vào Tạo.
  3. Nếu không, trên thẻ Chiến dịch, hãy nhấp vào Chiến dịch mới.
    1. Chọn Nhắn tin trong ứng dụng.
  4. Nhập Tiêu đề cho thư đầu tiên.
  5. Nhấp vào Kiểm thử trên thiết bị
  6. Nhập mã cài đặt Firebase của ứng dụng vào trường Thêm mã cài đặt.
  7. Nhấp vào Kiểm thử để gửi tin nhắn.

Firebase In-App Messaging gửi thông báo thử nghiệm của bạn ngay khi bạn nhấp vào Kiểm tra. Để xem , bạn cần đóng, sau đó mở lại ứng dụng trên thiết bị thử nghiệm.

Để xác nhận xem thiết bị của bạn có phải là thiết bị thử nghiệm hay không, hãy tìm những thông tin sau thông điệp nhật ký:

I/FIAM.Headless: Setting this device as a test device