1. Tổng quan

Đây là bước kết nối ứng dụng với CSDL mạng và cài đặt hệ thống nhận thông báo gửi mã Push Device lên Mobio CDP.

Đối tượng sử dụng: Developer Android.

2. Điều kiện tiên quyết

• Đã hoàn thành bước Thêm thư viện Mobio SDK bằng Gradle (Android)
• Môi trường Firebase Messaging Service đã được nạp không báo lỗi.

3. Quy trình thực hiện

Bước 1: Khai báo Permissions (Internet và Cảnh báo)

Mở file gốc app/src/main/AndroidManifest.xml trong mã nguồn dự án. Đảm bảo đã bổ sung các quyền (permissions) dưới đây nằm kề bên ngoài thẻ khai báo App mẹ <application> (thẻ con trực tiếp của thẻ <manifest>):

<!-- Quyền bắt buộc để truyền dữ liệu Tracking về Mobio -->
<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 

<!-- Quyền bắt buộc từ Android 13 trở lên để hệ điều hành cho phép hiển thị Banner Push Notification --> 
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

Bước 2: Cấu hình nhận và xuất App Push (Firebase Messaging)

Để điện thoại bắt được luồng thông báo App Push từ Mobio, cần cấu hình nhận gói tin Payload từ máy chủ Google đẩy xuống.

Tìm (hoặc tạo mới) Class dịch vụ chuyên quản lý Messaging kế thừa từ FirebaseMessagingService.

Bổ sung 2 thủ tục bắt buộc này vào File Code Class của bạn:

1. Chuyển tiếp Dữ liệu Packet gửi từ Mobio: Thêm dòng mã gọi hàm SDK vào phương thức quản trị onMessageReceived để Mobio tự động vẽ giao diện Push lên màn hình thông báo người dùng theo kịch bản:

override fun onMessageReceived(remoteMessage: RemoteMessage) { 
    super.onMessageReceived(remoteMessage) 
    
    // Gọi lệnh chuyển tiếp Data gói tin Cloud để Mobio SDK vẽ UI Push Notification
    Mobio.getInstance().onMessageReceived(remoteMessage) 
} 

2. Cập nhật Thiết bị Token ID mới: Tái ghi đè phương thức onNewToken. OS kích hoạt luồng này mỗi khi Token liên lạc nhận Push của ứng dụng phát sinh hoặc làm mới (Refresh). UID Push Token tái sinh cần được cung cấp về máy chủ Mobio.

override fun onNewToken(token: String) { 
    super.onNewToken(token) 
    
    // Lệnh Update Token bắt buộc để CDP thiết lập nhận diện định vị Target Endpoint
    Mobio.getInstance().setDeviceToken(token) 
} 

4. Quy tắc Vận hành

• Đảm bảo Quyền truyền tín hiệu dữ liệu (INTERNET / ACCESS_NETWORK_STATE) không bị xóa bỏ trong Manifest. Nếu ứng dụng không có Permission mạng hệ thống, hàm Tracking Event Log Code sẽ vô tác dụng và không thể gửi History Data về Server CSDL.

5. Câu hỏi thường gặp (FAQ)

Chưa có thông tin cho mục này.

6. Bước tiếp theo

Khởi tạo SDK trong lớp Application với hàm Init (Android)