Hướng dẫn nhanh này cho bạn biết cách thiết lập Firebase In-App Messaging và gửi thông báo đầu tiên.
Trước khi bắt đầu
Nếu bạn chưa làm, hãy thêm Firebase vào dự án Android.
Thêm SDK Firebase In-App Messaging vào dự án
Trong tệp Gradle của mô-đun (cấp ứng dụng)
(thường là <project>/<app-module>/build.gradle.kts hoặc
<project>/<app-module>/build.gradle),
hãy 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 quản lý 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.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:34.14.1")) // 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") }
Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng những phiên bản tương thích của thư viện Android trên Firebase.
(Tuỳ chọn) Thêm 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.
Xin lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng, bạn nên sử dụng BoM để quản lý các phiên bản thư viện nhằm đả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:22.0.3") implementation("com.google.firebase:firebase-analytics:23.2.0") }
Gửi tin nhắn thử nghiệm
Lấy mã lượt cài đặt của ứng dụng
Để tiết kiệm pin, Firebase In-App Messaging chỉ truy xuất thông báo 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 của Firebase cho phép bạn chỉ định một thiết bị thử nghiệm để hiển thị thông báo theo yêu cầu.
Thiết bị thử nghiệm đó được xác định bằng một
FirebaseInstallations ID hay FID.
Tìm FID của ứng dụng thử nghiệm bằng cách kiểm tra Logcat trong
Android Studio để tìm nhật ký cấp `Info` sau:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Gửi thông báo đến thiết bị thử nghiệm
Sau khi khởi chạy ứng dụng trên thiết bị thử nghiệm và có Firebase mã lượt cài đặt (FID) của thiết bị đó, bạn có thể dùng thử chế độ Firebase In-App Messaging thiết lập bằng cách gửi thông báo thử nghiệm:
Trong bảng điều khiển của Firebase, hãy chuyển đến DevOps & Engagement > Messaging (DevOps và Tương tác > Gửi thông báo).
Khởi chạy quy trình làm việc để thiết lập một chiến dịch mới:
Nếu đây là chiến dịch đầu tiên của bạn:
- Nhấp vào Create your first campaign (Tạo chiến dịch đầu tiên).
- Chọn Firebase In-App messages (Thông báo trong ứng dụng của Firebase) rồi nhấp vào Create (Tạo).
Nếu bạn đã tạo chiến dịch trước đó:
- Trên thẻ Campaigns (Chiến dịch), hãy nhấp vào New campaign (Chiến dịch mới).
- Chọn In-App Messaging (Gửi thông báo trong ứng dụng).
Nhập Title (Tiêu đề) cho thông báo đầu tiên.
Nhấp vào Test on Device (Thử nghiệm trên thiết bị).
Nhập mã lượt cài đặt Firebase Firebase của ứng dụng vào trường Add an installation ID.
Nhấp vào Test (Thử nghiệm) để gửi thông báo. Thông báo sẽ được gửi ngay lập tức.
Để xem thông báo trên thiết bị thử nghiệm, bạn cần đóng rồi 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 thông điệp nhật ký sau:
I/FIAM.Headless: Setting this device as a test device