Data Ingestion APIs

Tổng quan

API giúp các hệ thống giao tiếp với nhau một cách tự động, bảo mật và có kiểm soát. Tích hợp Data Ingestion API là cách để đưa dữ liệu vào, và có thể nhận thông báo trạng thái ghi nhận dữ liệu theo thời gian thực từ hệ thống.

Việc này giúp tự động hóa quy trình, giảm thao tác thủ công, và nâng cao trải nghiệm người dùng khi xây dựng các Use Case cần sử dụng dữ liệu trên đa nền tảng.

---

Ngữ cảnh sử dụng tích hợp

Một số Use Case cần sử dụng Data Ingestion API để triển khai:

👥 Đồng bộ danh sách khách hàng

• Sử dụng: Customer Ingestion API để đưa dữ liệu khách hàng từ hệ thống khác vào Pango.

• Ví dụ: đã có dữ liệu người dùng trước đó, có thể sử dụng Profile Info API để đưa thông tin Users (email, tên, số điện thoại, id,.v.v.) vào hệ thống của Pango. Điều này giúp giữ cho thông tin và danh sách Users luôn được cập nhật, đồng bộ trên tất cả các nền tảng.

• Một số System Model tương tự: Relationship, Membership, Lead.

📦 Gửi dữ liệu đơn hàng

• Sử dụng: Transaction Ingestion API để gửi thông tin giao dịch, đơn hàng.

• Ví dụ: khi đơn hàng được tạo trên hệ thống của Khách hàng, sử dụng Transaction API để đưa các thông tin đơn hàng (sản phẩm, số lượng, giá trị, phương thức thanh toán,.v.v.) vào Pango. Điều này giúp bạn theo dõi, thống kê và phân tích hành vi mua sắm của Users bằng các tính năng, dịch vụ khác.

• Một số System Model tương tự: Abandonded Cart, Purchase Order, Purchase History, Product.

📱 Ghi nhận hành vi Users

• Sử dụng: User Event API để ghi lại các hành vi của User khi tương tác với các hệ thống của Khách hàng.

• Ví dụ: khi User truy cập vào các nền tảng và thực hiện tương tác ⇒ hệ thống sẽ gửi hành vi này dưới dạng sự kiện cho Pango thông qua User Event API. Thông tin này giúp Brand có thể nhận ra hành động của Users và tạo các kịch bản cá nhân hóa một cách hiệu quả.

• Một số System Model tương tự: User Event, Call Log, User Activity.

---

Các thành phần chính trong tích hợp API

Đối với việc nhận dữ liệu từ 3rd System vào hệ thống Pango sẽ tuỳ thuộc vào từng ngữ cảnh tích hợp khác nhau, cơ bản bao gồm các phần sau:

1. Xác thực (Authentication)

Đây là quy trình đảm bảo an toàn và bảo mật khi nhận dữ liệu từ hệ thống bên ngoài vào hệ thống Pango. Xác thực giúp kiểm tra và xác minh tính hợp lệ của yêu cầu truyền dữ liệu từ các hệ thống khác theo API Key và Token.

2. Truyền dữ liệu qua API

Sau khi đã xác định được đúng Endpoint, Object cần truyền sẽ tiến hành thực hiện truyền dựa liệu theo cách thức thiết lập (thời gian định kỳ). Ví dụ: gửi thông tin khách hàng (Profile Info), hay đơn hàng (Purchase Order ).

3. Nhận phản hồi từ Pango

Sau khi dữ liệu được truyền thành công, hệ thống Pango sẽ trả về một phản hồi (Callback) để xác nhận rằng dữ liệu đã được nhận và lưu vào hệ thống.

4. Kiểm tra và xử lý lỗi

Nếu có sự cố trong quá trình truyền dữ liệu, hệ thống sẽ nhận được thông báo lỗi từ Pango để có thể xử lý kịp thời, như kiểm tra lại dữ liệu hoặc thử lại việc gửi dữ liệu. Ngoài ra, còn có tính năng kiểm thử Data Ingestion API để kiểm tra chi tiết của dữ liệu được tích hợp.

---

Chuẩn bị gì trước tích hợp

Giai đoạn chuẩn bị này càng rõ ràng, thì giai đoạn tích hợp thử và chạy thực tế càng nhanh chóng, tiết kiệm thời gian và công sức cả hai bên:

1

Xác định loại dữ liệu cần tích hợp

Nắm rõ nhu cầu tích hợp dữ liệu, để xác định rõ các yếu tố như Model tích hợp, Data Volume, thời gian và tần suất tích hợp,.v.v.

2

Kiểm tra tương thích trên hệ thống

Dựa vào tài liệu tích hợp của Pango, kiểm tra cấu trúc dữ liệu của hệ thống tích hợp xem có tương thích, đảm bảo cấu trúc hay không. Nếu không cần thực hiện chuyển đổi cấu trúc dữ liệu trước khi thực hiện tích hợp hoặc nhờ hỗ trợ Customize API nhận dữ liệu theo cấu hình riêng (liên hệ Pango Tech Team).

3

Chuẩn hóa định dạng dữ liệu

Đối với các trường dữ liệu truyền sang hệ thống Pango, tuỳ vào Object Type nhận mà sẽ có các trường bắt buộc phải có giá trị dữ liệu. Ngoài ra, cần kiểm tra định dạng giá trị của các trường dữ liệu tích hợp cho đúng cấu trúc yêu cầu. Ví dụ: Họ và tên - String, Thời gian - Timestamp, Danh sách sản phẩm - List, Giá trị đơn hàng - Number,.v.v.

4

Nhân sự phối hợp kiểm thử dữ liệu

Liên hệ nhân sự vận hành Organization nhận dữ liệu khi hệ thống tích hợp vào để kiểm tra sau khi tích hợp. Nếu tự vận hành, đảm bảo được Training để nắm được cách hoạt động đầy đủ.

Nên sử dụng Checklist để tránh bỏ sót các bước chuẩn bị. Việc chuẩn bị tốt các dữ liệu cần tích hợp sẽ giúp giảm đáng kể các lỗi phát sinh và thời gian thực hiện, kiểm tra.

---

Tài nguyên hỗ trợ

📘 Tài liệu kỹ thuật: cấu trúc API

Để tích hợp dữ liệu vào Pango bằng API

• Authentication used to authenticate a user who wants to access this organization's data

• Data Ingestion used to ingest data into PangoCDP and requires Authentication

• Object Type list of object types in PangoCDP

• Custom Field list of supported data types for Custom Fields

• Custom Model Iist of data fields in the custom model, including system default fields and custom fields.

• System Models: PangoCDP-defined data models allow adding Custom Fields

  • User Event

  • User Activity

  • Customer

  • Transaction

  • Lead

  • Call Log

  • Meta Data

Để nhận được phản hồi từ Pango sau khi Ingest Data

• Data Ingestion Callback để phản hồi kết quả lưu trữ dữ liệu thực tế khi đối tác sử dụng Data Ingestion API để đẩy dữ liệu vào PangoCDP

🧾 Biểu mẫu yêu cầu tích hợp

Hiện tại, Pango đã cung cấp biểu mẫu tích hợp, giúp hai bên tiết kiệm thời gian hơn khi thực hiện tích hợp giữa hai hệ thống.

Xem thêm về biểu mẫu yêu cầu tích hợp taị đây nhé: [Brand x PangoCDP] Data Ingestion Template

📞 Hỗ trợ từ team kỹ thuật/CS

Để nhận được sự hỗ trợ từ đội ngũ của Pango, vui lòng liên hệ theo địa chỉ email bên dưới:

• Team CS: [e-mail]

• Team kỹ thuật: [e-mail]