Bài viết sẽ hướng dẫn cách cấu hình đồng bộ Event tùy biến (Dynamic Event) từ nguồn dữ liệu về hệ thống Mobio, với dữ liệu có cấu trúc và dữ liệu phi cấu trúc,
Event tùy biến là gì?
Event tùy biến (dynamic event) là các event do người dùng tự cấu hình với tên và cấu trúc linh hoạt, nhằm ghi nhận các hành vi tương tác từ các nguồn dữ liệu như website, app mobile, CRM hoặc POS . Trên Mobio, event tùy biến được sử dụng để chạy các chiến dịch marketing, phân loại tệp khách hàng hoặc thiết lập các quy trình tự động hóa.
Tìm hiểu thêm về event tùy biến tại đây
Sau khi đã hoàn tất cấu hình nguồn ghi nhận dữ liệu trên Data Flow, bước tiếp theo người dùng cần cấu hình đối tượng đồng bộ dữ liệu và đối tượng liên quan.
Chọn đối tượng
Chọn đối tượng
Đây là bước bắt buộc khi cấu hình đồng bộ dữ liệu. Mỗi connector chỉ được chọn 1 trong 4 đối tượng chính:
- Profile
- Công ty
- Cơ hội bán
- Ticket
Các connector khác nhau có thể chọn đối tượng giống nhau. Sau khi lưu cấu hình connector, người dùng không được phép sửa đối tượng.

Chọn loại dữ liệu
Đây là bước bắt buộc sau khi đã chọn đối tượng đồng bộ dữ liệu. Mỗi connector chỉ được chọn 1 trong 3 loại dữ liệu:
- Thuộc tính
- Event tùy biến
- Product Holding
Các connector khác nhau có thể chọn loại dữ liệu giống nhau. Sau khi lưu cấu hình connector, người dùng không được phép sửa loại dữ liệu.
Bài viết này sẽ tập trung hướng dẫn cấu hình đồng bộ khi chọn loại dữ liệu Event tùy biến.

Chọn event
Đây là bước bắt buộc sau khi đã chọn loại dữ liệu. Khi người dùng bấm chọn thông tin, danh sách các event tùy biến đã tạo sẽ hiển thị.

Nếu chưa tạo event tùy biến, người dùng có thể bấm + Thêm mới để mở giao diện tạo event tùy biến.
Xem HDSD event tùy biến tại đây
Hệ thống sẽ hiển thị tên event và event key sau khi người dùng chọn xong event tùy biến.
Sau khi lưu cấu hình connector, người dùng không được phép sửa event tùy biến đã chọn.
Chọn dữ liệu từ nguồn
Đây là bước bắt buộc để giúp hệ thống xác định dữ liệu muốn đưa vào Mobio. Cách lựa chọn dữ liệu tùy thuộc vào kiểu dữ liệu: có cấu trúc hoặc phi cấu trúc.
Đối với dữ liệu có cấu trúc
Chọn bảng dữ liệu
Hệ thống hiển thị dạnh sách các bảng dữ liệu mà Mobio có quyền view.

Trường hợp không nhìn thấy bảng, người dùng cần kiểm tra theo thông tin username/password đã khai báo khi đăng ký Connector, và kiểm tra quyền view của bảng.
Xem data sample của bảng
Người dùng có thể bấm vào từng bảng để xem data sample của bảng đó. Giao diện chỉ hiển thị tối đa 1000 dòng data sample. Người dùng có thể kéo sang ngang, kéo lên/xuống để xem data sample.

Bấm Tiếp tục để chọn bảng.
Tại một thời điểm, chỉ được chọn 1 bảng/ 1 Connector. Các Connector khác nhau có thể chọn cùng 1 bảng dữ liệu.
Sau khi lưu cấu hình connector, người dùng không được phép sửa bảng đã chọn.
Đối với dữ liệu phi cấu trúc (JSON)
Paste dữ liệu JSON trên giao diện

JSON hợp lệ cần đáp ứng các tiêu chí sau:
- Giới hạn tối đa 2.097.152 ký tự (theo quy chuẩn của microsoft)
- Không có lỗi cú pháp
Trường hợp cần thay đổi JSON, người dùng cần kiểm tra tính hợp lệ của JSON và mapping lại dữ liệu.
Thêm JSON bằng cách upload file
Bấm chọn Tải file trên hệ thống

File JSON hợp lệ có dung lượng tối đa 1MB. Nếu file hợp lệ, hệ thống sẽ hiển thị preview nội dung file.

Nếu file không hợp lệ, hệ thống sẽ báo lỗi

Sau khi preview file, người dùng bấm Lưu để tải file lên Mobio. Dữ liệu file sẽ hiển thị trên JSON schema. Người dùng có thể trực tiếp sửa nội dung JSON trên giao diện schema.

Các phần trong JSON và lỗi JSON
Giao diện schema cũng hỗ trợ người dùng kiểm tra cú pháp JSON.
- Đối tượng (Object) nằm trong các cặp “key”:”value” được bao quanh bởi cặp dấu ngoặc nhọn.

2. Mảng (array) tập hợp các giá trị được bao quanh bởi cặp dấu ngoặc vuông []

3. Value chứa trong ” “: Chuỗi (string) các ký tự Unicode được bao quanh bởi cặp dấu ngoặc kép “”

4. Trong Mobio, có một số trường “base” như Địa chỉ, Giấy tờ định danh cho phép nested object, tức là value là 1 object.
Khi mapping dữ liệu nguồn, nếu bên nguồn đưa object bị sai cú pháp JSON (lỗi thừa dấu ngoặc { }), hệ thống Mobio sẽ báo lỗi như hình dưới.

5. Value chứa trong [{ }]:
Khi khai báo các trường dữ liệu dạng mảng (array) trên hệ thống Mobio, người dùng cần tuân thủ một số quy tắc để đảm bảo dữ liệu hợp lệ và hệ thống nhận dạng chính xác:
Nếu field dạng mảng , thì có ít nhất 1 phần tử có giá trị (khác null, undefined, empty) để hệ thống xác định mảng đó có kiểu dữ liệu là gì (object, string, hay number)
Ví dụ: array Sở thích (gồm nhiều giá trị) → Sở thích là string (ví dụ: bóng rổ) hoặc number (ví dụ: 1)



Mảng phải có ít nhất 1 giá trị rõ ràng: Nếu người dùng khai báo một mảng rỗng, hệ thống không thể nhận biết kiểu dữ liệu bên trong là gì.


Sau khi đã hoàn tất cấu hình đồng bộ Dynamic Event, người dùng sẽ được chuyển sang bước Mapping dữ liệu.