Tích hợp SDK Mobio vào Website (Dành cho Kỹ thuật)

1. Tổng quan

Sau khi quản trị viên đã khai báo website trên hệ thống Mobio CDP, bước tiếp theo là nhúng mã SDK Mobio vào mã nguồn website của doanh nghiệp. Việc này giúp Mobio có thể bắt đầu theo dõi hành vi người dùng (Xem trang, bấm link, submit form…) và kích hoạt các kịch bản tương tác ngay lập tức.
Lợi ích:
- Tracking hành vi: Tự động ghi nhận mọi tương tác của khách hàng trên trang.
- Trigger Journey: Cho phép hiển thị các thông điệp cá nhân hóa (Popup, Banner) dựa trên hành vi tương tác của khách hàng.
Đối tượng thao tác: Lập trình viên (Developer) hoặc bộ phận quản trị kỹ thuật website.

SDK (Software Development Kit): Bộ công cụ phát triển phần mềm dưới dạng mã nhúng.
Header (<head>): Phần khai báo đầu tiên trong mã nguồn HTML của website, nơi chứa các đoạn mã script ưu tiên tải sớm.
Tracking: Theo dõi và ghi lại các hành vi tương tác của khách hàng trên website của doanh nghiệp.

Đã hoàn tất bước Khai báo và quản lý Website trên Mobio CDP.
Quyền truy cập: Tài khoản Mobio phải được cấp quyền RBAC: Integration, mục Cài đặt > Cài đặt doanh nghiệp > Tích hợp > Web Push để lấy tệp Mobio SDK. Xem hướng dẫn thiết lập quyền RBAC tại đây.
Trạng thái Website: Website đã được khai báo trên Mobio đang ở trạng thái bật ghi nhận dữ liệu.
Quyền quản trị mã nguồn: Lập trình viên có quyền can thiệp vào file header hoặc hệ thống quản lý thẻ (như Google Tag Manager) của website doanh nghiệp.

Sao chép đoạn mã script được cung cấp.
Mở tệp tin quản lý giao diện chung (thường là header.php, index.html hoặc qua công cụ quản lý thẻ).
Dán đoạn mã vào bên trong cặp thẻ <head> ... </head> của website.
- Lưu ý: Nên đặt mã SDK Mobio lên phía trên cùng của thẻ <head> để đảm bảo dữ liệu được tracking ngay khi trang bắt đầu tải.

Lựa chọn hình thức tích hợp: Tại tab chi tiết, hệ thống phân tách rõ 2 phần: “Hướng dẫn tích hợp website” (SDK cơ bản) và “Thông số tích hợp Firebase” (dành cho Web Push). Doanh nghiệp không bắt buộc phải cấu hình Web Push. Nếu chỉ có nhu cầu tracking hành vi và chạy Popup/Banner, chỉ cần thực hiện nhúng mã SDK tại tab “Hướng dẫn tích hợp website” là đủ.

Tôi có thể dán mã SDK vào thẻ <body> thay vì <head> không?
- Theo khuyến nghị kỹ thuật từ Mobio, bạn nên dán vào thẻ <head> để SDK được ưu tiên tải trước, tránh mất mát dữ liệu khi khách hàng rời trang quá nhanh.
Làm sao để biết SDK đang hoạt động bình thường?
- Sử dụng công cụ Inspect Element (F12) trên trình duyệt, chuyển sang tab Network và tìm kiếm các yêu cầu (request) gửi tới domain của Mobio.