1. Tổng quan

• Định nghĩa: Tích hợp SDK là cầu nối giữa ứng dụng iOS/Android của doanh nghiệp và hệ thống Mobio, giúp:
  • Tự động thu thập và gửi dữ liệu hành vi người dùng (event, profile) từ Mobile app về hệ thống Mobio CDP
  • Thông qua các chiến dịch Marketing, gửi app-push từ Mobio CDP đến Mobile app
• Lợi ích: Đồng bộ dữ liệu hành vi khách hàng từ thiết bị di động về CDP, giúp doanh nghiệp định danh khách hàng, phân tích hành trình, kích hoạt hành trình tự động (marketing automation) dựa trên dữ liệu thật.
• Đối tượng sử dụng: Admin Mobio, Nhân sự marketing, iOS Developer, Android Developer.

2. Giải thích Thuật ngữ & Thông số

• SDK (Software Development Kit): Bộ công cụ phát triển phần mềm giúp kết nối ứng dụng với Mobio.
• Event tracking: Hành vi của khách hàng trên ứng dụng (VD: bấm nút, xem màn hình, giỏ hàng).
• Profile attributes: Các thông tin định danh và thuộc tính mở rộng (tuổi, sở thích…) của người dùng mobile app.
• Known Profile: Hồ sơ khách hàng được định danh trên hệ thống Mobio.
• Anonymous Profile: Hồ sơ ẩn danh khi khách hàng lần đầu mở app hoặc khi chưa đăng nhập.

3. Điều kiện tiên quyết (Prerequisite)

• Phân quyền: Xem chi tiết tại các bài viết sau
• Mobio hỗ trợ các ngôn ngữ sau:
  • iOS: Swift và Objective-C.
  • Android: Java và Kotlin.
  • Nếu ứng dụng được phát triển bằng ngôn ngữ khác, vui lòng liên hệ bộ phận Customer Service của Mobio để được hỗ trợ thêm.

4. Quy trình triển khai

Quy trình tích hợp SDK bao gồm 3 phân đoạn chính, tương ứng với 3 nhóm người phụ trách. Hãy tuân thủ lần lượt:

Giai đoạn 1: Thiết lập trên giao diện Mobio (Dành cho Admin/ Nhân viên Marketing)

Đây là công đoạn cung cấp thông tin “cửa ngõ” để hai hệ thống có thể giao tiếp với nhau. Cần tiến hành trước khi Developer sửa code.

1. Khai báo ứng dụng trên CDP và lấy thông tin cấu hình
2. Cấu hình Identity Rules (Quy tắc định danh) cho ứng dụng
3. Cấu hình App-push giúp gửi thông báo di động
4. Định nghĩa Tracking Event và lấy Code Tracking gắn vào App

Giai đoạn 2: Tích hợp SDK vào Mobile App (Dành cho Developer)

Với hệ điều hành iOS

1. Cài đặt & Khởi tạo SDK (Init) trên Xcode (Bắt buộc)
2. Cấu hình Target Notification Extension nhận Rich Push
3. Gắn Event Tracking vào ứng dụng iOS
4. Quản lý danh tính người dùng iOS (Auth

Với hệ điều hành Android

1. Thêm thư viện Mobio SDK (.aar) vào build.gradle
2. Cấu hình Permissions & Firebase Service (FCM)
3. Khởi tạo SDK trong lớp Application
4. Gắn Event Tracking vào ứng dụng Android
5. Quản lý danh tính người dùng Android (Auth)

5. Quy tắc vận hành

• Phải hoàn thành toàn bộ Bước thiết lập trên Giao diện Mobio (Giai đoạn 1) để lấy được bộ khoá `MerchantID`, `ConnectorID` trước khi thao tác trong Source Code.
• Mobio hỗ trợ độc lập hai nền tảng iOS (XCode – Swift/Objective-C) và Android (Android Studio – Java/Kotlin). Có thể thao tác song song trên 2 hệ điều hành mà không phụ thuộc lẫn nhau.

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

Mọi giải đáp sẽ có chi tiết trong từng bài cấu hình.

7. Bước tiếp theo

Khai báo ứng dụng trên CDP và lấy thông tin cấu hình.