Data Ingestion APIs
Overview
APIs help systems communicate with each other in an automated, secure, and controlled manner. Integrating the Data Ingestion API is a way to ingest data and receive real-time notifications about the data ingestion status from the system.
This helps automate processes, reduce manual operations, and enhance the user experience when building Use Cases that require data on the platform.
Integration use cases
Some use cases require the Data Ingestion API for implementation:
👥 Customer list synchronization
Use the Customer Ingestion API to ingest customer data from external systems into Pango.
For example, for existing user data, you can use the Profile Info API to ingest User information (email, name, phone number, ID, etc.) into Pango’s system. This helps ensure that user information and user lists are always updated and synchronized across all platforms.
Some similar system models include: Relationship, Membership, Lead.
📦 Order data ingestion
Usage: Use the Transaction Ingestion API to send transaction and order information.
Example: When an order is created in the customer’s system, use the Transaction API to send order information (order name, quantity, value, payment method, etc.) to Pango. This helps track, analyze, and gain insights into Users’ purchasing behavior through various features and services.
Some similar system models include: Abandonded Cart, Purchase Order, Purchase History, Product.
📱 User behavior tracking
Usage: Use the User Event API to record user behaviors when they interact with the customer’s systems.
For example: when a user accesses platforms and performs interactions ⇒ the system records these events and sends them to Pango via the User Event API. This data enables brands to recognize user actions and build personalized scenarios effectively.
Some similar system models include: User Event, Call Log, User Activity.
Main components in API Integration
When receiving data from third-party systems into the Pango system, the integration approach may vary depending on the use case. In general, it includes the following components:
1. Authentication
This is the process that ensures security and safety when receiving data from external systems into Pango. Authentication helps verify and validate the legitimacy of data transmission requests from other systems using an API Key and Token.
2. Data transmission via API
After identifying the correct Endpoint, Object to be transmitted, the system proceeds with data transmission based on the configured setup (scheduled timing). For example, sending customer information (Profile Info) or order data (Purchase Order).
3. Receiving responses from Pango
After the data is successfully transmitted, the Pango system returns a response (Callback) to confirm that the data has been received and stored in the system.
4. Error checking and handling
If an issue occurs during the data transmission process, the system will receive an error notification from Pango so it can be handled promptly, such as reviewing the data or retrying the data submission. In addition, the Data Ingestion API can be used to check the detailed status of the integrated data.
What to prepare before integration
The clearer the preparation phase is, the faster both the test integration and deployment will be, saving time and effort for both parties:
Check system compatibility
Based on Pango’s integration documentation, review the data structure of the integrating system to check whether it is compatible and structurally valid. If not, the data structure must be transformed before integration or support for a Customize API to receive data based on a specific configuration may be required (please contact the Pango Tech Team).
Standardize data formats
For data fields transmitted to the Pango system, depending on the receiving Object Type, there will be mandatory fields that require valid values. In addition, ensure that the data formats of all fields comply with the required structure. For example: Full name - String, Time - Timestamp, Product List - List, Order value - Number, etc.
It is recommended to use a Checklist to avoid missing preparation steps. Proper preparation of integration data helps significantly reduce errors and shortens execution and testing time.
Supporting Resources
📘 Technical Documentation: API Structure
To integrate data into Pango via 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
To Receive Feedback from Pango After Data Ingestion
Data Ingestion Callback to return results after data is actually stored when partners use the Data Ingestion API to push data into PangoCDP.
Important Note: Ensure that all declared keys use the correct UPPERCASE and lowercase character format (case-sensitive). The Pango system accepts keys that follow the format specified in the integration documentation.
All transmitted values must comply with the required declaration structure for each data field.
🧾 Integration Request Template
Currently, Pango provides an integration request template to help both parties save time when performing system integration.
View more details about the integration request template here: [Brand x PangoCDP] Data Ingestion Template
📞 Support from the Technical / CS Team
To receive support from the Pango team, please contact the following email addresses:
CS Team: [email protected]
Technical Team: [email protected]
Last updated
Was this helpful?