Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Mailchimp: Most-used fields

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

FieldAdverity UI nameType
DateDimension

The Date field is used to filter Mailchimp data based on specific timestamps. Depending on the report type, it can represent the date a campaign was sent, an automation was created, or an audience's growth history for a particular month. For example, it allows users to specify a start or end date to retrieve campaign performance summaries, audience member activity, or automation workflow metrics.

ab_split.a.abuse_reportsMetric

The number of abuse reports for variation A of an A/B split campaign.

ab_split.a.bouncesMetric

The number of bounces for variation A of an A/B split campaign.

ab_split.a.forwards_opensMetric

The number of times campaign A was forwarded and then opened.

ab_split.a.last_openDimension

The date and time of the last open for variation A of an A/B split campaign.

ab_split.a.opensAB Split A: Total OpensMetric

The total number of opens for variation A of an A/B split campaign.

ab_split.a.recipient_clicksAB Split A: Recipient ClicksMetric

The total number of clicks by recipients for variation A of an A/B split campaign.

ab_split.a.unique_opensAB Split A: Unique OpensMetric

The number of unique opens for variation A of an A/B split campaign.

ab_split.a.unsubsAB Split A: Unsubscribe CountMetric

The number of unsubscribes for variation A of an A/B split campaign.

ab_split.b.abuse_reportsMetric

The number of abuse reports for variation B of an A/B split campaign.

ab_split.b.bouncesMetric

The number of bounces for variation B of an A/B split campaign.

ab_split.b.forwards_opensMetric

The number of times campaign B was forwarded and then opened.

ab_split.b.last_openDimension

The date and time of the last open for variation B of an A/B split campaign.

ab_split.b.opensAB Split B: Total OpensMetric

The total number of opens for variation B of an A/B split campaign.

ab_split.b.recipient_clicksAB Split B: Recipient ClicksMetric

The total number of clicks by recipients for variation B of an A/B split campaign.

ab_split.b.unique_opensAB Split B: Unique OpensMetric

The number of unique opens for variation B of an A/B split campaign.

ab_split.b.unsubsAB Split B: Unsubscribe CountMetric

The number of unsubscribes for variation B of an A/B split campaign.

abuse_reportsAbuse ReportsMetric

The total count of abuse reports received for a specific campaign.

activity.actionActivity ActionDimension

The type of action performed by a subscriber, such as 'open', 'click', or 'bounce'.

activity.ipActivity IPDimension

The IP address associated with the subscriber's activity.

activity.timestampActivity TimestampDimension

The date and time when a specific subscriber activity occurred.

activity.typeActivity TypeDimension

The general category of activity, such as 'email-activity'.

activity.urlActivity URLDimension

The URL that was clicked by the subscriber in an email campaign.

bounces.hard_bouncesHard BouncesMetric

The count of hard bounces, indicating permanent delivery failures for email campaigns.

bounces.soft_bouncesSoft BouncesMetric

The count of soft bounces, indicating temporary delivery failures for email campaigns.

bounces.syntax_errorsSyntax ErrorsMetric

The count of bounces due to syntax errors in email addresses.

campaign_idDimension

The unique identifier for a campaign.

campaign_titleCampaign TitleDimension

The descriptive title of an email marketing campaign.

cleanedMetric

Indicates if a list member's email address has been cleaned due to being invalid or undeliverable.

clicks.click_rateMetric

The rate at which recipients clicked links within a campaign.

clicks.clicks_totalTotal ClicksMetric

The total number of times links within a campaign were clicked.

clicks.last_clickLast ClickDimension

The date and time of the most recent click recorded for a campaign.

clicks.unique_clicksUnique ClicksMetric

The number of unique individuals who clicked a link in a campaign.

clicks.unique_subscriber_clicksUnique Subscriber ClicksMetric

The number of unique subscribers who clicked a link in a campaign.

create_timeDimension

The date and time a resource was created, in ISO 8601 format.

date_createdDimension

The date and time a resource was created.

deletedMetric

Indicates whether a contact or member has been deleted from an audience. This can refer to a soft delete (archived) or a hard delete (permanently removed). Permanently deleted contacts cannot be re-added via the API and are effectively "banned" from the list unless they resubscribe through a Mailchimp signup form.

delivery_status.can_cancelDimension

Indicates if a campaign's delivery can be canceled.

delivery_status.emails_canceledMetric

The number of emails that were prevented from being delivered to recipients because a campaign was canceled while it was still in the process of sending.

delivery_status.emails_sentDelivery Status Emails SentMetric

The total number of emails sent for a campaign.

delivery_status.enabledDimension

A boolean indicator that specifies whether delivery status tracking, such as open and click tracking, is enabled for a campaign or for an account's email settings.

delivery_status.statusDimension

The current delivery status of a campaign (e.g., sending, sent, canceled).

ecommerce.currency_codeEcommerce Currency CodeDimension

The currency code for the e-commerce store or transaction.

ecommerce.total_ordersEcommerce Total OrdersMetric

The total number of orders placed in an e-commerce store.

ecommerce.total_revenueEcommerce Total RevenueMetric

The total revenue generated from an e-commerce store.

ecommerce.total_spentEcommerce Total SpentMetric

The total amount spent by a customer in an e-commerce store.

email_addressEmail AddressDimension

The email address of a subscriber or recipient.

email_clientDimension

The email client used by a subscriber to open a campaign.

email_idEmail IDDimension

The unique identifier for a specific email within a campaign, often used for tracking individual email activity.

emails_sentEmails SentMetric

The total number of emails successfully sent for a campaign.

facebook_likes.facebook_likesFacebook LikesMetric

The total number of Facebook Likes associated with a campaign.

facebook_likes.recipient_likesRecipient LikesMetric

The number of recipients who 'liked' the campaign on Facebook.

facebook_likes.unique_likesUnique LikesMetric

The number of unique users who 'liked' the campaign on Facebook.

forwards.forwards_countTotal ForwardsMetric

The total number of times a campaign was forwarded.

forwards.forwards_opensForward OpensMetric

The total number of times a forwarded campaign was opened.

idCampaign IDDimension

The unique identifier for a specific marketing campaign or automation.

industry_stats.abuse_rateMetric

The average abuse rate for the industry type associated with the list.

industry_stats.bounce_rateMetric

The average bounce rate for the industry type associated with the list.

industry_stats.click_rateMetric

The average click rate for the industry type associated with the list.

industry_stats.open_rateMetric

The average open rate for the industry type associated with the list.

industry_stats.typeDimension

The industry type associated with the list.

industry_stats.unopen_rateMetric

The average unopen rate for the industry type associated with the list, representing recipients who did not open the email.

industry_stats.unsub_rateMetric

The average unsubscribe rate for the industry type associated with the list.

ip_optDimension

The IP address recorded when a subscriber opted into the list.

ip_signupDimension

The IP address recorded when a subscriber signed up for the list.

languageDimension

The language code for the campaign content or subscriber preference.

last_changedDimension

The date and time a resource was last changed, in ISO 8601 format.

list_idList IDDimension

The unique identifier for an audience list.

list_is_activeDimension

Indicates if the list is currently active.

list_nameDimension

The name of the Mailchimp list.

list_stats.click_rateMetric

The average click rate across all campaigns for a specific list.

list_stats.open_rateMetric

The average open rate across all campaigns for a specific list.

list_stats.sub_rateMetric

The average subscription rate for a list.

list_stats.unsub.rateMetric

The average unsubscribe rate for a list.

list_stats.unsub_rateMetric

The rate at which subscribers unsubscribed from a list.

location.country_codeDimension

The country code of the subscriber's location based on IP address geocoding.

location.dstoffDimension

Daylight Saving Time offset for the subscriber's location.

location.gmtoffDimension

Greenwich Mean Time offset for the subscriber's location.

location.latitudeDimension

The latitude coordinate of the subscriber's location.

location.longitudeDimension

The longitude coordinate of the subscriber's location.

location.timezoneDimension

The timezone of the subscriber's location.

member_ratingMetric

The subscriber's engagement rating, from 1 to 5 stars, where 5 is the highest.

merge_fields.ADDRESSDimension

The physical address merge field for a list member.

merge_fields.COMPANYDimension

The company merge field for a list member.

merge_fields.FNAMEDimension

The first name merge field for a list member.

merge_fields.LNAMEDimension

The last name merge field for a list member.

merge_fields.PHONEDimension

The phone number merge field for a list member.

monthDimension

The month for which growth history data is reported.

nameDimension

The name of the campaign, list, or other Mailchimp resource.

opens.last_openLast OpenDimension

The date and time of the most recent open recorded for a campaign.

opens.open_rateMetric

The rate at which recipients opened a campaign.

opens.opens_totalTotal OpensMetric

The total number of times a campaign was opened.

opens.unique_opensUnique OpensMetric

The number of unique individuals who opened a campaign.

optinsMetric

Represents the marketing consent preferences of a contact, indicating the types of marketing communications they have opted in to receive (e.g., email, direct mail, customized online advertising). This can also reflect the opt-in status (single or double opt-in) for a contact.

parent_campaign_idDimension

The unique identifier of the parent campaign for a child campaign (e.g., A/B test variations, RSS campaigns).

pendingMetric

Indicates if a subscriber's status is pending (e.g., awaiting confirmation).

preview_textDimension

The text that appears in the inbox after the subject line.

recipients.list_idDimension

The unique identifier for the list of recipients for a campaign.

recipients.list_is_activeDimension

Indicates if the recipient list for the campaign is active.

recipients.list_nameDimension

The name of the list that received the campaign.

reconfirmMetric

Refers to the process where a subscriber is asked to confirm their continued interest in receiving marketing communications, often after a period of inactivity or an unsubscribe. This helps maintain list hygiene and compliance by ensuring explicit consent.

report_summary.click_rateClick RateMetric

The overall click rate for a campaign, representing how many recipients clicked links.

report_summary.clicksMetric

The total number of clicks for a campaign.

report_summary.open_rateOpen RateMetric

The overall open rate for a campaign, representing how many recipients opened the email.

report_summary.opensMetric

The total number of opens for a campaign.

report_summary.subscriber_clicksMetric

The number of unique subscribers who clicked a link in a campaign.

report_summary.unique_opensMetric

The number of unique opens for a campaign.

rss_last_sendDimension

The date and time the last RSS campaign was sent.

send_timeSend TimeDimension

The date and time when a campaign was sent.

settings.authenticateDimension

Indicates if Mailchimp authentication is enabled for the campaign.

settings.auto_footerDimension

Indicates if the Mailchimp default footer is automatically included in the campaign.

settings.from_nameDimension

The 'from' name for the campaign, as seen by recipients.

settings.inline_cssDimension

Indicates if CSS is inlined in the campaign HTML.

settings.reply_toDimension

The reply-to email address for the campaign.

settings.titleDimension

The title of the campaign.

settings.to_nameDimension

The 'to' name for the campaign, often a merge tag for the recipient's name.

settings.use_conversationDimension

Indicates if conversation tracking is enabled for the campaign.

share_report.share_passwordDimension

The password required to access the campaign's shareable report.

share_report.share_urlDimension

The URL for the campaign's shareable report.

sourceDimension

Indicates the origin or method by which a contact was added to an audience, such as through a hosted signup form, an embedded form, a manual administrator add, or an API integration.

start_timeDimension

The date and time a campaign started sending or an automation workflow began.

stats.avg_click_rateMetric

The average click rate across all campaigns for a list.

stats.avg_open_rateMetric

The average open rate across all campaigns for a list.

stats.avg_sub_rateMetric

The average subscription rate for a list.

stats.avg_unsub_rateMetric

The average unsubscription rate for a list.

stats.campaign_countMetric

The total number of campaigns sent to a list.

stats.campaign_last_sentDimension

The date and time the last campaign was sent to a list.

stats.cleaned_countMetric

The number of cleaned email addresses on a list.

stats.cleaned_count_since_sendMetric

The number of cleaned email addresses on a list since the last campaign send.

stats.click_rateMetric

The overall click rate for a campaign or list, representing how many recipients clicked links.

stats.last_sub_dateDimension

The date of the last subscription to a list.

stats.last_unsub_dateDimension

The date of the last unsubscription from a list.

stats.member_countMetric

The total number of members in a list.

stats.member_count_since_sendMetric

The number of members added to a list since the last campaign send.

stats.merge_field_countMetric

The number of merge fields configured for a list.

stats.unsubscribe_countMetric

The total number of unsubscribes for a list.

stats.unsubscribe_count_since_sendMetric

The number of unsubscribes from a list since the last campaign send.

statusDimension

The current status of a campaign (e.g., draft, sent, scheduled) or list member (e.g., subscribed, unsubscribed).

status_enabledDimension

Indicates if the campaign delivery status is enabled.

subject_lineSubject LineDimension

The subject line of the campaign email.

subscribedMetric

Indicates if a member is currently subscribed to a list.

tagsDimension

A list of tags applied to a campaign or subscriber.

tags_countMetric

The number of tags applied to a campaign or subscriber.

timestamp_optDimension

The date and time a subscriber opted into a list.

timestamp_signupDimension

The date and time a subscriber signed up for a list.

tracking.ecomm360Dimension

Indicates if e-commerce360 tracking is enabled for the campaign.

tracking.goal_trackingDimension

Indicates if goal tracking is enabled for the campaign.

tracking.google_analyticsDimension

The Google Analytics tracking code for the campaign.

tracking.html_clicksDimension

Indicates if HTML click tracking is enabled for the campaign.

tracking.opensDimension

Indicates if open tracking is enabled for the campaign.

tracking.text_clicksDimension

Indicates if plain-text click tracking is enabled for the campaign.

transactionalMetric

Indicates whether an email or message is a transactional email, meaning it is an automated, event-driven, one-to-one communication (e.g., order confirmations, password resets) sent via the Mailchimp Transactional API, as opposed to a bulk marketing campaign.

trigger_settings.runtime.daysDimension

The days of the week when an automation workflow is active.

trigger_settings.runtime.hoursDimension

The specific hours when an automation workflow is active.

trigger_settings.workflow_emails_countMetric

The total number of emails in an automation workflow.

trigger_settings.workflow_titleDimension

The title of the automation workflow.

trigger_settings.workflow_typeDimension

The type of automation workflow (e.g., welcome, abandonedCart).

typeCampaign TypeDimension

The type of marketing campaign, e.g., 'regular', 'plaintext', 'rss', 'variate', or 'automation'.

unsubscribedUnsubscribe CountMetric

The total number of subscribers who unsubscribed from a campaign or list.

vipDimension

Indicates if a subscriber is marked as a VIP.