Campaigns

A summary of the campaigns within an account.

Table Specific Information

SELECT, UPDATE and DELETE are supported for Campaigns.

Update

\

UPDATE Campaigns Set Settings_Title="Test" WHERE Id="1234" UPDATE Campaigns set Recipients_SegmentOpts="{"match":"any","saved_segment_id":314699}" WHERE Id="cfb12c2228" UPDATE Campaigns Set Settings_Title="Test", Recipients_ListId="1234", RssOpts_FeedUrl="exampleUrl", Type="rss", RssOpts_Frequency="daily" WHERE Id="1234"

Note: UPDATE operation cannot be performed on already SENT campaigns. Also, the type of a campaign cannot be updated once it is set. Depending on the campaign type, specific options can be updateable only for specific campaign types. For example: If a campaign is of type "rss" then only the Rss Options fields can be updateable for this campaign. Variant and AbSplitOps settings will not be updateable in this case.

Columns

Name

Type

ReadOnly

Description

Id [KEY]

String

True

A string that uniquely identifies this campaign.

Type

String

False

The type of campaign (regular, plaintext, absplit, or rss).

CreateTime

Datetime

True

The date and time the campaign was created.

ArchiveUrl

String

True

The link to the campaign's archive version.

LongArchiveUrl

String

True

The original link to the campaign's archive version.

Status

String

True

The current status of the campaign ('save', 'paused', 'schedule', 'sending', 'sent').

EmailsSent

Integer

True

The total number of emails sent for this campaign.

SendTime

Datetime

True

The time and date a campaign was sent.

ContentType

String

True

How the campaign's content is put together ('template', 'drag_and_drop', 'html', 'url').

Recipients_ListId

String

False

The id of the list.

Recipients_ListName

String

True

The name of the list.

Recipients_SegmentText

String

False

A string marked-up with HTML explaining the segment used for the campaign in plain English.

Recipients_RecipientCount

Integer

True

Count of the recipients on the associated list. Formatted as an integer

Recipients_SegmentOpts

String

False

Segment options.

Settings_SubjectLine

String

False

The subject line for the campaign.

Settings_Title

String

False

The title of the campaign.

Settings_FromName

String

False

The 'from' name on the campaign (not an email address).

Settings_ReplyTo

String

False

The reply-to email address for the campaign.

Settings_UseConversation

Boolean

False

Use MailChimp Conversation feature to manage out of office replies.

Settings_ToName

String

False

The campaign's custom 'to' name. Typically something like the first name merge var.

Settings_FolderId

String

False

If the campaign is listed in a folder, the id for that folder.

Settings_Authenticate

Boolean

False

Whether or not the campaign was authenticated by MailChimp. Defaults to 'true'.

Settings_AutoFooter

Boolean

False

Automatically append MailChimp's default footer to the campaign.

Settings_InlineCss

Boolean

False

Automatically inline the CSS included with the campaign content.

Settings_AutoTweet

Boolean

False

Automatically tweet a link to the campaign archive page when the campaign is sent.

Settings_AutoFbPost

String

False

An array of Facebook page ids to auto-post to.

Settings_FbComments

Boolean

False

Allows Facebook comments on the campaign (also force-enables the Campaign Archive toolbar). Defaults to 'true'.

Settings_Timewarp

Boolean

True

Send this campaign using 'timewarp.' For more info, see the Knowledge Base article: http://eepurl.com/iAgs

Settings_TemplateId

Integer

False

The id for the template used in this campaign.

Settings_DragAndDrop

Boolean

True

Whether the campaign uses the drag-and-drop editor.

VariateSettings_WinningCombinationId

String

True

ID of the combination that was chosen as the winner

VariateSettings_WinningCampaignId

String

True

ID of the campaign that was sent to the remaining recipients based on the winning combination

VariateSettings_WinnerCriteria

String

False

How the winning campaign will be chosen

VariateSettings_WaitTime

Integer

False

The number of minutes to wait before the winning campaign is picked

VariateSettings_TestSize

Integer

False

The percentage of subscribers to send the test combinations to, from 10 to 100

VariateSettings_SubjectLines

String

False

Possible subject lines

VariateSettings_SendTimes

String

False

Possible send times

VariateSettings_FromNames

String

False

Possible from names

VariateSettings_ReplyToAddresses

String

False

Possible reply To addresses

VariateSettings_Contents

String

True

Descriptions of possible email contents

VariateSettings_Combinations

String

True

Combinations of possible variables that were used to build emails

Tracking_Opens

Boolean

False

Whether to track opens. Defaults to 'true'.

Tracking_HtmlClicks

Boolean

False

Whether to track clicks in the HTML version of the campaign. Defaults to 'true'.

Tracking_TextClicks

Boolean

False

Whether to track clicks in the plain-text version of the campaign. Defaults to 'true'.

Tracking_GoalTracking

Boolean

False

Whether to enable Goal tracking. For more information, see this Knowledge Base article: http://eepurl.com/GPMdH

Tracking_Ecomm360

Boolean

False

Whether to enable eCommerce360 tracking.

Tracking_GoogleAnalytics

String

False

The custom slug for Google Analytics tracking (max of 50 bytes).

Tracking_Clicktale

String

False

The custom slug for ClickTale Analytics tracking (max of 50 bytes).

Tracking_Salesforce

String

False

Salesforce tracking options for a campaign. Must be using MailChimp's built-in Salesforce integration.

Tracking_Highrise

String

False

Highrise tracking options for a campaign. Must be using MailChimp's built-in Highrise integration.

Tracking_Capsule

String

False

Capsule tracking option sfor a campaign. Must be using MailChimp's built-in Capsule integration.

RssOpts_FeedUrl

String

False

The URL for the RSS feed.

RssOpts_Frequency

String

False

The frequency of the RSS-to-Email campaign ('daily', 'weekly', 'monthly').

RssOpts_Schedule

String

False

The schedule for sending the RSS campaign.

RssOpts_LastSent

String

True

The date the campaign was last sent.

RssOpts_ConstrainRssImg

Boolean

False

If true we will add css to images in the rss feed to constrain their width in the campaign content.

AbSplitOpts_SplitTest

String

False

The type of AB split to run ('subject', 'from_name', or 'schedule').

AbSplitOpts_PickWinner

String

False

How we should evaluate a winner. Based on 'opens', 'clicks', or 'manual'.

AbSplitOpts_WaitUnits

String

False

How unit of time for measuring the winner ('hours' or 'days'). This cannot be changed after a campaign is sent.

AbSplitOpts_WaitTime

Integer

False

The amount of time to wait before picking a winner. This cannot be changed after a campaign is sent.

AbSplitOpts_SplitSize

Integer

False

The size of the split groups. Campaigns split based on 'schedule' are forced to have a 50/50 split. Valid split integers are between 1-50. Ex. A 10% split would result in two groups of 10% of the subscribers plus a winner sending to the remaining 80%.

AbSplitOpts_FromNameA

String

False

For campaigns split on 'From Name', the name for Group A.

AbSplitOpts_FromNameB

String

False

For campaigns split on 'From Name', the name for Group B.

AbSplitOpts_ReplyEmailA

String

False

For campaigns split on 'From Name', the reply-to address for Group A.

AbSplitOpts_ReplyEmailB

String

False

For campaigns split on 'From Name', the reply-to address for Group B.

AbSplitOpts_SubjectA

String

False

For campaings split on 'Subject Line', the subject line for Group A.

AbSplitOpts_SubjectB

String

False

For campaings split on 'Subject Line', the subject line for Group B.

AbSplitOpts_SendTimeA

Datetime

False

The send time for Group A.

AbSplitOpts_SendTimeB

Datetime

False

The send time for Group B.

AbSplitOpts_SendTimeWinner

Datetime

False

The send time for the winning version.

SocialCard_ImageUrl

String

False

The url for the header image for the card.

SocialCard_Description

String

False

A short summary of the campaign to display.

SocialCard_Title

String

False

The title for the card. Typically the subject line of the campaign.

ReportSummary

String

False

For sent campaigns, a summary of opens, clicks, and unsubscribes.

DeliveryStatus

String

False

Updates on campaigns in the process of sending.

Last updated