Cordial's power of real-time segmentation and personalization is inherently reliant on the data available in the platform. As the developer, it is your job to get relevant data flowing to the platform to enable the marketer to build dynamic, personalized messages for your customers.
API First and Developer Friendly
We built the Cordial platform with the developer in mind and provide a robust RESTful API that gives you access to practically all of our platform's functionality using industry standard GET, POST, PUT and DELETE calls.
About the Data
Cordial uses a document-based and search-based database to store all data in the following set of collections:
|Contact Collection||Stores data specific to a contact including channels, attributes, list membership and cart items.|
|Contact Activities Collection||Stores event data specific to messages (opens, clicks, etc.) or any custom named event.|
|Product Collection||Stores data from a product catalog. Typically developers will update this collection on a nightly or weekly basis. This data can be used to embellish an email, but is not used for audience search.|
|Orders Collection||Stores order data. This can hold specific order details and can be used for building a audience.|
|Supplements Collection||Stores additional data (store locations, coupon codes, message content, etc.) that doesn’t fit into one the above collections.|
Watch the Data Overview video to learn more:
Cordial's API gives you access to practically all of the platform's functionality such as importing and exporting contacts, event, order, product and message data, sending batch and triggered messages, and other job related activities. Below are some recommended links to get you started with the API:
In our documentation, we have grouped API calls according to the following resources:
For testing and documentation needs, we built a custom implementation of Swagger to test all available API calls.
Recommended Data Integrations
Depending on your industry and marketing strategy, you may have specific needs regarding data, but here are some suggestions to get you stated:
- Contact attribute data - Contact data is obviously crucial to any marketing strategy and can be passed to Cordial using the following methods:
- Contact Activity Events - Events, also referred to as contact activities, are essential to triggered messaging strategies such as cart abandon and browse abandon. They can be sent to Cordial:
- Cart Items - Cordial stores cart items in the contact collection and can be used for populating message content in cart abandonment messages. Cart items can be passed using the following:
- Order Data - Order data can be used in building an audience and in message content. It is used in replenishment campaigns, order surveys and order confirmation messages, etc., and can be sent using the API or JS. When using order data for sending order confirmation messages, we recommend using the API method.
- Product Data - Product data is used in message content and should be updated on a recurring basis to maintain an updated catalog.
Other Helpful Resources
- JSON validator - JSONLint is an awesome tool for checking your JSON for errors when making API calls. Sometimes it's just a comma causing the problem!
- HTML, JS and JSON beautifier - jsbeautifier.org will beautify your code and make it easier to read.
- DNS lookup - whatsmydns.net/#NS checks the current IP address of your domain name and DNS record information against multiple name servers located in different parts of the world.
- Postman - An alternative to Swagger for testing API calls is Postman.