dotdigital: Most-used fields#
The table below gives information about most-used fields that you can import from dotdigital. 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 |
|---|---|---|---|
Campaign ID |
Campaign ID |
The unique identifier for a marketing campaign. |
metric |
Campaign name |
Campaign name |
The name assigned to a specific marketing campaign. |
dimension |
Campaign status |
Campaign status |
The current operational status of the marketing campaign (e.g., sent, pending, cancelled). |
dimension |
Date |
Date |
The date for which the campaign activity or summary statistics are reported. |
dimension |
assistedRevenue |
assistedRevenue |
The revenue where the campaign played an influencing role in the customer journey but was not the direct conversion point. |
dimension |
clicks |
Clicks |
A summary metric representing the total clicks on links within the campaign messages. |
metric |
conversionRate |
conversionRate |
The percentage rate at which recipients completed a desired action (e.g., made a purchase) after engaging with the campaign. |
metric |
dateSent |
dateSent |
The date and time when the campaign was sent to recipients, provided in UTC. |
dimension |
numAssistedOrders |
numAssistedOrders |
The number of orders where the campaign contributed to the conversion, but was not the sole or last touchpoint. |
metric |
numClicks |
numClicks |
The total number of clicks on links within the main version of the campaign’s messages. |
metric |
numDelivered |
numDelivered |
The total number of messages successfully delivered to recipients for the campaign. |
metric |
numForwards |
numForwards |
The number of times the main version of the campaign’s messages were forwarded by recipients. |
metric |
numHardBounces |
numHardBounces |
The number of hard bounces, indicating permanent delivery failures for the campaign’s messages. |
metric |
numIspComplaints |
numIspComplaints |
The number of spam complaints received by Internet Service Providers (ISPs) regarding the campaign’s messages. |
metric |
numMailBlocks |
numMailBlocks |
The number of times the campaign’s messages were blocked by mail servers. |
metric |
numOpens |
numOpens |
The total number of times the main version of the campaign’s messages were opened by recipients. |
metric |
numOrders |
numOrders |
The total number of orders generated directly or indirectly as a result of the campaign. |
metric |
numPageViews |
numPageViews |
The total number of times pages associated with a campaign were viewed by recipients. |
metric |
numRecipientsClicked |
numRecipientsClicked |
The number of unique recipients who clicked on links within the campaign’s messages. |
metric |
numReplies |
numReplies |
The number of replies received in response to the main version of the campaign’s messages. |
metric |
numSent |
numSent |
The total number of messages sent for the campaign. |
metric |
numSoftBounces |
numSoftBounces |
The number of soft bounces, indicating temporary delivery failures for the campaign’s messages. |
metric |
numTextClicks |
numTextClicks |
The number of clicks on links within the text version of the campaign’s messages. |
metric |
numTextDelivered |
numTextDelivered |
The number of text messages successfully delivered to recipients for the campaign. |
metric |
numTextHardBounces |
numTextHardBounces |
The number of hard bounces specifically for the text version of the campaign’s messages. |
metric |
numTextIspComplaints |
numTextIspComplaints |
The number of spam complaints received by ISPs regarding the text version of the campaign’s messages. |
metric |
numTextMailBlocks |
numTextMailBlocks |
The number of times the text version of the campaign’s messages were blocked by mail servers. |
metric |
numTextOpens |
numTextOpens |
The number of times the text version of the campaign’s messages were opened. |
metric |
numTextPageViews |
numTextPageViews |
The number of times a contact has viewed a page associated with a specific campaign, available as ‘numPageViews’ in campaign activity reports. |
metric |
numTextReplies |
numTextReplies |
The number of replies received in response to the text version of the campaign’s messages. |
metric |
numTextSent |
numTextSent |
The total number of text messages sent for the campaign. |
metric |
numTextSoftBounces |
numTextSoftBounces |
The number of soft bounces specifically for the text version of the campaign’s messages. |
metric |
numTextUnsubscribes |
numTextUnsubscribes |
The number of recipients who unsubscribed after receiving the text version of the campaign. |
metric |
numTotalClicks |
numTotalClicks |
The total number of clicks on links within the campaign’s messages across all formats (e.g., HTML and Text). |
metric |
numTotalDelivered |
numTotalDelivered |
The total number of messages successfully delivered for the campaign across all message formats. |
metric |
numTotalHardBounces |
numTotalHardBounces |
The total number of hard bounces for the campaign across all message formats. |
metric |
numTotalIspComplaints |
numTotalIspComplaints |
The total number of spam complaints received by ISPs regarding the campaign’s messages across all message formats. |
metric |
numTotalMailBlocks |
numTotalMailBlocks |
The total number of times the campaign’s messages were blocked by mail servers across all message formats. |
metric |
numTotalOpens |
numTotalOpens |
The total number of times the campaign’s messages were opened across all formats (e.g., HTML and Text). |
metric |
numTotalPageViews |
numTotalPageViews |
The total number of page views associated with the campaign across all message formats. |
metric |
numTotalReplies |
numTotalReplies |
The total number of replies received in response to the campaign’s messages across all formats. |
metric |
numTotalSent |
numTotalSent |
The total number of messages sent for the campaign across all message formats. |
metric |
numTotalSoftBounces |
numTotalSoftBounces |
The total number of soft bounces for the campaign across all message formats. |
metric |
numTotalUniqueOpens |
numTotalUniqueOpens |
The total number of unique recipients who opened the campaign’s messages across all formats. |
metric |
numTotalUnsubscribes |
numTotalUnsubscribes |
The total number of recipients who unsubscribed from the mailing list after receiving the campaign across all message formats. |
metric |
numUniqueOpens |
numUniqueOpens |
The number of unique recipients who opened the main version of the campaign’s messages. |
metric |
numUniqueTextOpens |
numUniqueTextOpens |
The number of unique recipients who opened the text version of the campaign’s messages. |
metric |
numUnsubscribes |
numUnsubscribes |
The number of recipients who unsubscribed from the mailing list after receiving the main version of the campaign. |
metric |
opens |
Opens |
A summary metric representing the total opens of the campaign messages. |
metric |
percentageClicksToOpens |
percentageClicksToOpens |
The percentage of opened messages that resulted in a click-through. |
metric |
percentageDelivered |
percentageDelivered |
The percentage of sent messages that were successfully delivered. |
metric |
percentageHardBounces |
percentageHardBounces |
The percentage of sent messages that resulted in a permanent delivery failure (hard bounce). |
metric |
percentageOpens |
percentageOpens |
The percentage of delivered messages that were opened. |
metric |
percentageReplies |
percentageReplies |
The percentage of messages that received a reply. |
metric |
percentageSoftBounces |
percentageSoftBounces |
The percentage of sent messages that resulted in a temporary delivery failure (soft bounce). |
metric |
percentageUniqueOpens |
percentageUniqueOpens |
The percentage of delivered messages that were uniquely opened. |
metric |
percentageUnsubscribes |
percentageUnsubscribes |
The percentage of delivered messages that resulted in an unsubscribe. |
metric |
percentageUsersClicked |
percentageUsersClicked |
The percentage of unique recipients who clicked on links within the campaign’s messages, relative to the number delivered. |
metric |
revenue |
revenue |
The total revenue attributed to the campaign, based on conversion tracking. |
dimension |
unique clicks |
Unique clicks |
A summary metric representing the number of unique recipients who clicked on links within the campaign messages. |
metric |
unique opens |
Unique opens |
A summary metric representing the number of unique recipients who opened the campaign messages. |
metric |