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.
_idDimension
Unique identifier for the message.
actionDimension
Represents a specific interaction performed by a contact, such as opening a message, clicking a link, opting out, or a custom event.
aovMetric
The average order value generated from the message.
bounceRateMetric
The rate at which messages bounced, calculated as total bounced messages divided by total sent messages.
bouncedHardMetric
The total number of hard bounced messages, indicating a permanent delivery failure.
bouncedSoftMetric
The total number of soft bounced messages, indicating a temporary delivery issue.
cIDDimension
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'.
clicksTotalMetric
The total number of clicks on links within the message.
clicksUniqueMetric
The total number of unique contacts who clicked on links within the message.
complaintRateMetric
The rate at which recipients marked the message as spam or complained.
complaintsTotalMetric
The total number of times recipients marked the message as spam or complained.
datetime.sendTimeDimension
The date and time when the message was sent.
deliveredMetric
The total number of messages successfully delivered to recipients.
deliveryRateMetric
The rate at which messages were successfully delivered, calculated as total delivered messages divided by total sent messages.
emailDimension
The email address associated with a contact, serving as a primary identifier within the platform.
idDimension
A unique identifier for various entities within the Cordial platform, such as an export job, a contact, a message, or an order.
linkDimension
Refers to the URL or identifier of a link within a message, used for tracking clicks and attributing revenue.
mcIDDimension
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.
nameDimension
The name of the message.
openRateMetric
The rate at which unique recipients opened the message.
opensTotalMetric
The total number of times the message was opened.
opensUniqueMetric
The total number of unique contacts who opened the message.
optoutRateMetric
The rate at which recipients opted out or unsubscribed from communications after receiving the message.
propertiesDimension
An object containing additional attributes or metadata associated with an event or other data entities.
revenueMetric
The total revenue generated from the message.
sendTimeDimension
The date and time when the message was sent.
subjectDimension
The subject line of the message.
tagsDimension
Tags associated with the message, used for categorization and filtering.
timeDimension
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.
totalBouncedMetric
The total number of messages that bounced (failed to deliver).
totalPurchasesMetric
The total number of purchases attributed to the message.
totalSentMetric
The total number of messages sent.