Maileon: Most-used fields

The table below gives information about most-used fields that you can import from Maileon. 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.

API name	Adverity UI name	Description	Use in Adverity
Contact ID	Contact ID	A unique identifier assigned by Maileon to each contact.	metric
Contact created	Contact created	Indicates the event of a contact being created in the Maileon system. This field itself reflects the occurrence, with a corresponding date field providing the exact time.	dimension
Contact created date	Contact created date	The date and time when a contact was initially created in the Maileon system.	dimension
Contact custom fields	Contact custom fields	User-defined fields that store additional, personalized information about a contact.	dimension
Contact email	Contact email	The primary email address of the contact.	dimension
Contact external ID	Contact external ID	An identifier for the contact used in an external system, allowing for cross-referencing.	dimension
Contact permission status	Contact permission status	The current consent level of a contact to receive mailings. Possible statuses include “None”, “Single opt-in”, “Confirmed opt-in”, “Double opt-in”, “Double opt-in plus”, or “Other”.	dimension
Contact permission type	Contact permission type	The specific category or method by which a contact granted their permission, such as Double Opt-In (DOI), Single Opt-In, or Confirmed Opt-In.	dimension
Contact standard fields	Contact standard fields	Predefined fields that store common information about a contact, such as first name, last name, or gender.	dimension
Contact updated	Contact updated	Indicates the event of a contact’s information being updated in the Maileon system. This field itself reflects the occurrence, with a corresponding date field providing the exact time.	dimension
Contact updated date	Contact updated date	The date and time when a contact’s information was last updated in the Maileon system.	dimension
Date	Date	The date when an event, such as an email open or click, occurred. This field represents a specific point in time.	dimension
End date	End date	The end date for a specified reporting or data retrieval period.	dimension
Engagement type	Engagement type	The category of interaction a recipient had with a mailing, such as ‘opens’ for email opens or ‘clicks’ for link clicks.	dimension
Link ID	Link ID	A unique identifier for a clicked link within an email.	metric
Link type	Link type	The type of link that was clicked within an email, categorizing different actions or destinations such as a standard link, online version link, or a download link.	dimension
Link url	Link url	The URL associated with the clicked link in the email.	dimension
Mailing ID	Mailing ID	A unique identifier for a specific email marketing campaign or mailing.	metric
Mailing name	Mailing name	The human-readable name of the email marketing campaign or mailing.	dimension
Mailing schedule time	Mailing schedule time	The planned date and time for an email marketing campaign to be sent out.	dimension
Msg ID	Msg ID	The unique identifier assigned to a specific email mailing within Maileon.	metric
Start date	Start date	The start date for a specified reporting or data retrieval period.	dimension
State	State	The current status of an email marketing campaign (e.g., draft, scheduled, sent, archived).	dimension
Status code	Status code	A numerical code indicating the outcome or status of an API request or an email delivery attempt (e.g., a bounce code).	dimension
Timestamp	Timestamp	A numerical value representing the precise date and time of an event, typically expressed in milliseconds since January 1, 1970 (Unix epoch).	dimension
Timestamp date	Timestamp date	The date component of the timestamp when an event occurred. This provides the calendar date without the time details.	dimension
Total bounces	Total bounces	The aggregate count of emails that could not be successfully delivered to recipients, often due to invalid email addresses or server issues.	metric
Total clicks	Total clicks	The total number of times links within an email marketing campaign were clicked.	metric
Total conversions	Total conversions	The total number of desired actions completed by recipients after interacting with an email, such as purchases or sign-ups.	metric
Total opens	Total opens	The total number of times an email marketing campaign was opened by recipients.	metric
Total recipients	Total recipients	The total number of contacts to whom an email marketing campaign was sent.	metric
Total unique clicks	Total unique clicks	The number of distinct recipients who clicked at least one link in an email marketing campaign.	metric
Total unique opens	Total unique opens	The number of distinct recipients who opened an email marketing campaign at least once.	metric
Total unsubscriptions	Total unsubscriptions	The total number of recipients who unsubscribed from an email marketing list.	metric
Type	Type	The classification or category of the mailing (e.g., newsletter, transactional, trigger mailing).	dimension