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:

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.

📞 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: [email protected]

• Team kỹ thuật: [email protected]