Cấu trúc dữ liệu

Tài liệu giúp bạn hiểu về thông tin một cấu trúc Data được truyền từ hệ thống thứ ba ở phía nhà doanh nghiệp qua đường API vào hệ thống PangoCDP

Tài liệu này mô tả cấu trúc dữ liệu chuẩn được truyền từ hệ thống của doanh nghiệp (bên thứ ba) vào nền tảng PangoCDP thông qua kết nối API. Đây là một phần quan trọng trong quá trình tích hợp dữ liệu sự kiện (event data), giúp đảm bảo rằng mọi thông tin được đồng bộ chính xác, kịp thời và nhất quán giữa hai hệ thống.

Cụ thể, tài liệu sẽ tập trung vào định nghĩa và mô tả chi tiết các trường dữ liệu. Điều này nhằm hỗ trợ đội ngũ kỹ thuật doanh nghiệp thiết lập tích hợp một cách hiệu quả, giảm thiểu sai sót trong quá trình truyền nhận dữ liệu.

Cấu trúc của Data Journey Event được truyền từ API

Trường thông tin	Mô tả	Ví dụ
sourceId	Mã định danh cho một dòng dữ liệu event
eventName	Tên event dùng để phân biệt các loại event khác nhau; khi sử dụng DMA mỗi flow chỉ bắt được 1 loại eventName
eventAt	Thời gian event được sinh ra ở hệ thống của doanh nghiệp. Tuy nhiên, thời gian này không được chênh lệch quá nhiều với thời gian PangoCDP nhận được dữ liệu event này, vì nếu chênh lệch nhiều thì sẽ không sử dụng ở dữ liệu thời gian này ở DMA.
condition	Sẽ có 2 giá trị Changed (cập nhật) và Created (tạo mới). + Changed: Một event mới sẽ được tạo ra nếu doanh nghiệp cập nhật thông tin của một event mà thời gian eventAt thay đổi + Created: Tạo một event mới nếu chưa tồn tại sourceId
eventLabels, eventLabel2s, eventLabel3s	Đây là trường thông tin để doanh nghiệp có thể để các dữ liệu thông tin của một event vào. Các thông tin này có thể dùng để cho vào bộ lọc để rẻ nhánh trên DMA hay cá nhân hóa ở nội dung gửi ra cho người dùng cuối.	Cấu trúc: "Prefix: Value" Ví dụ: "eventLabel2s": [ "Name: Phương", "Campaign: Voucher_drop", "Gift: VC20K" ],
Event	cần ít nhất phải có một contact để gửi được một nội dung tương ứng như: phone, email, zaloUserId,...