1. Tổng quan

Đây là bước cấu hình nền tảng đầu tiên để đưa bộ công cụ Mobio SDK vào source code ứng dụng iOS của bạn. Quá trình này bao gồm việc tải thư viện và thiết lập các quyền riêng tư bắt buộc theo tiêu chuẩn của Apple.

Lợi ích/Giá trị:

Đảm bảo ứng dụng có đầy đủ các package cần thiết để sẵn sàng giao tiếp với hệ thống Mobio CDP.

Tránh các lỗi crash ứng dụng hoặc bị Apple từ chối khi submit lên App Store do vi phạm chính sách quyền riêng tư của người dùng.

Đối tượng thao tác: iOS Developer.

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

• Info.plist: File cấu hình chứa các thông tin thiết lập quan trọng của một ứng dụng iOS.
• NSUserTrackingUsageDescription: Khóa (key) hệ thống của Apple dùng để khai báo và xin phép người dùng cho việc theo dõi dữ liệu (Tracking).

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

• Đã hoàn thành Khai báo ứng dụng và lấy thông tin tích hợp và có sẵn các thông tin
  • Merchant ID
  • Connector ID
  • API URL
• Ứng dụng iOS của bạn phải có Target Deployment từ iOS 11.0 trở lên.
• Đã nhận được file Mobio SDK từ team CS hoặc kỹ thuật của Mobio.

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

Bước 1: Thêm SDK vào Target App (Bắt buộc)

1. Mở App trên XCode
2. Chọn Target
3. Chọn Project của bạn (ví dụ MobioExample)
4. Chọn tab General
5. Chọn Frameworks, Libraries, and Embedded Content

6. Chọn Add Item

7. Chọn add file

8. Mở thư mục chứa file SDK Mobio đã tải về

9. Chọn MobioSDK.xcframework, nhấn Open

10. Chọn Embed & Sign

Bước 2: Khai báo quyền Tracking trong Info.plist

Mở file Info.plist của dự án dưới dạng Source Code (XML) và thêm đoạn mã sau:

XML

<key>NSUserTrackingUsageDescription</key>
<string>Ứng dụng sử dụng thông tin này để cá nhân hóa quảng cáo và phân tích hành vi người dùng.</string>

Mẹo nhỏ: Nội dung chuỗi mô tả <string> có thể tùy chỉnh theo ngữ cảnh ứng dụng của bạn, nhưng cần giải thích rõ mục đích sử dụng dữ liệu tracking để tránh bị Apple bắt lỗi “mô tả quá chung chung”.

Bước 3: Gọi hàm Khởi tạo SDK trong AppDelegate

Hàm khởi tạo phải được đặt trong phương thức chạy đầu tiên của vòng đời iOS app.

1. Mở file AppDelegate.swift của dự án
   
2. Import MobioSDK vào header

import MobioSDK

3. Khởi tạo Mobio SDK

import UIKit
import CoreData
import MobioSDK

@mainclass AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
          
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
          
          Mobio.shared.initWithLaunchOptions(merchantId: "MERCHANT_ID", connectorId: "CONNECTOR_ID", apiUrl: "API_URL", source: "SOURCE")
          returntrue
     }
}

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

Nghiêm túc tuân thủ Bước 2 (Khai báo Info.plist). Nếu bạn bỏ qua bước này, hậu quả sẽ xảy ra ngay khi app khởi chạy:

• Đối với thiết bị chạy iOS 14.x: Ứng dụng sẽ bị Crash ngay lập tức khi Mobio SDK bắt đầu hoạt động.
• Đối với thiết bị chạy iOS 15 trở lên: Ứng dụng không bị crash (hệ thống tự động từ chối quyền theo dõi một cách ngầm định và không hiển thị popup xin quyền), nhưng chắc chắn Apple sẽ từ chối ứng dụng khi bạn đẩy bản build lên App Store.

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

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

7. Bước tiếp theo

Gọi hàm Khởi tạo SDK (INIT) trên ứng dụng iOS