Cordial: Most-used fields#
The table below gives information about most-used fields that you can import from Cordial. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
_id Dimension
Unique identifier for the message.
action Dimension
Represents a specific interaction performed by a contact, such as opening a message, clicking a link, opting out, or a custom event.
aov Metric
The average order value generated from the message.
bounceRate Metric
The rate at which messages bounced, calculated as total bounced messages divided by total sent messages.
bouncedHard Metric
The total number of hard bounced messages, indicating a permanent delivery failure.
bouncedSoft Metric
The total number of soft bounced messages, indicating a temporary delivery issue.
cID Dimension
A unique identifier assigned to a contact within the Cordial platform. This ID is used to retrieve, update, and manage contact records and their associated activities. In the API response, this field is referred to as '_id'.
clicksTotal Metric
The total number of clicks on links within the message.
clicksUnique Metric
The total number of unique contacts who clicked on links within the message.
complaintRate Metric
The rate at which recipients marked the message as spam or complained.
complaintsTotal Metric
The total number of times recipients marked the message as spam or complained.
datetime.sendTime Dimension
The date and time when the message was sent.
delivered Metric
The total number of messages successfully delivered to recipients.
deliveryRate Metric
The rate at which messages were successfully delivered, calculated as total delivered messages divided by total sent messages.
email Dimension
The email address associated with a contact, serving as a primary identifier within the platform.
id Dimension
A unique identifier for various entities within the Cordial platform, such as an export job, a contact, a message, or an order.
link Dimension
Refers to the URL or identifier of a link within a message, used for tracking clicks and attributing revenue.
mcID Dimension
A unique identifier for a specific message sent to a specific contact at a specific time. It is a concatenated value that describes the sending account, the message, the recipient contact, and the message type. This identifier is crucial for tracking message events and attributing revenue to email campaigns.
name Dimension
The name of the message.
openRate Metric
The rate at which unique recipients opened the message.
opensTotal Metric
The total number of times the message was opened.
opensUnique Metric
The total number of unique contacts who opened the message.
optoutRate Metric
The rate at which recipients opted out or unsubscribed from communications after receiving the message.
properties Dimension
An object containing additional attributes or metadata associated with an event or other data entities.
revenue Metric
The total revenue generated from the message.
sendTime Dimension
The date and time when the message was sent.
subject Dimension
The subject line of the message.
tags Dimension
Tags associated with the message, used for categorization and filtering.
time Dimension
This field represents the time-related data associated with various marketing activities within the Cordial platform. Depending on the data stream, it can refer to the send time of a message in message analytics or the timestamp of a specific contact activity like an open, click, or opt-out event.
totalBounced Metric
The total number of messages that bounced (failed to deliver).
totalPurchases Metric
The total number of purchases attributed to the message.
totalSent Metric
The total number of messages sent.