1. Tổng quan

• Định nghĩa: Bước đầu tiên khởi tạo và khai báo ứng dụng trên giao diện Mobio CDP.
• Lợi ích: Giúp hệ thống Mobio sinh ra các mã định danh định tuyến (MerchantID, ConnectorID, API URL) để Mobile App có thể kết nối cổng dữ liệu thành công.
• Đối tượng sử dụng: Admin, Marketer.

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

• MerchantID: Mã định danh cho doanh nghiệp của bạn trên hệ thống Mobio.
• ConnectorID: Mã định danh của Data Connector đảm nhiệm việc tiếp nhận và ghi nhận dữ liệu trên Mobio CDP.
• API URL: Đường dẫn server để SDK khai báo và đẩy log dữ liệu hành vi về CDP.

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

• Bài viết trước: Tổng quan tích hợp SDK Mobile App
• Phân quyền: Tài khoản Mobio phải được cấp quyền RBAC:
  • Khởi tạo ứng dụng: INTEGRATION: Cài đặt > Cài đặt doanh nghiệp > Tích hợp kênh tương tác > App push. Xem hướng dẫn phân quyền truy cập RBAC tại đây.
  • Kiểm tra Data Connector:
    • INTEGRATION: Cài đặt > Cài đặt DN > Đồng bộ dữ liệu > Data Flow
    • INTEGRATION: Cài đặt > Cài đặt DN > Đồng bộ dữ liệu > Data Flow > Nguồn dữ liệu
• Đường dẫn truy cập: Cài đặt doanh nghiệp → Tích hợp kênh tương tác → Ứng dụng.
• Dữ liệu đầu vào: tên ứng dụng, ảnh đại diện thiết kế, ngôn ngữ phát triển.

4. Các bước thực hiện

4.1. Khởi tạo Ứng dụng trên Mobio CDP

• Đăng nhập vào hệ thống Mobio CDP, truy cập thanh menu bên trái Cài đặt → Tích hợp kênh tương tác → Ứng dụng.
• Nhấn nút Thêm ứng dụng mới để bắt đầu khởi tạo.
• Khai báo thông tin hiển thị của ứng dụng: Nhập Tên ứng dụng, Tài ảnh lên, Tải file Danh sách màn hình.
• Lựa chọn Ngôn ngữ phát triển cho iOS (Swift/Objective-C) hoặc Android (Java/Kotlin).
• Nhấn nút Lưu.

4.2. Kiểm tra Data Connector tự động

Ngay sau khi thao tác Lưu ứng dụng thành công, hệ thống tự động tạo một Data Connector tương ứng.

• Truy cập vào menu Tích hợp dữ liệu → Data Flow.
• Xác nhận trạng thái Connector tương ứng với ứng dụng chuyển sang Bật kết nối.

Lưu ý: Trong trường hợp bạn muốn tạm dừng việc thu thập dữ liệu từ ứng dụng, có thể chuyển trạng thái Data Connector này sang Ngắt kết nối thay vì gỡ bỏ SDK app.

4.3. Lấy thông tin chứng chỉ để cung cấp cho Developer

• Truy cập vào Ứng dụng vừa khởi tạo trên Mobio. Lựa chọn màn hình Hướng dẫn tích hợp.
• Sao chép chính xác 3 bộ khóa: MerchantID, ConnectorID, API URL.
• Bàn giao thông tin đó cho bộ phận IT/Dev App.

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

• Việc khai báo đúng các tham số MerchantID và ConnectorID giúp đảm bảo dữ liệu được thu thập và đẩy về Mobio chính xác, tránh nhầm lẫn với các ứng dụng khác hoặc Data Connector khác.
• Nếu ứng dụng được phát triển bằng ngôn ngữ khác ngoài Swift, Objective-C, Java, Kotlin, liên hệ bộ phận Customer Service của Mobio để được hỗ trợ mở cổng dữ liệu thêm.

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

• Hỏi: Có thể tạo một Data Connector thủ công cho App Push thay vì tự động được không?
  • Trả lời: Không. Ngay sau khi khai báo ứng dụng thành công, hệ thống mặc định tự sinh một Data Connector và chuyển qua trạng thái Bật kết nối.

7. Bước tiếp theo

Sau khi có các thông tin MerchantID, ConnectorID, API URL, dùng trực tiếp làm input để cấu hình tại iOS – khởi tạo SDK trong code / Android – khởi tạo SDK trong code.

Cấu hình Identity Rules (Quy tắc định danh) để thiết lập cách dữ liệu khách hàng được ghi nhận và hợp nhất trên Mobio.