Details about A/B tests for primary email campaign activities.

To help maximize contact open rates for a draft primary email campaign, use A/B subject line testing to determine the best subject line to use.

Create an A/B Test

To create an A/B test activity for a primary email campaign activity, make a POST call to emails/activities/{campaign_activity_id}/abtest and set the following criteria:

  • alternative_subject: The alternate email subject line to use for A/B testing. Currently, A/B tests support subject line only.

  • test_size: The percentage of contact recipients in the A/B Test. For example, if the integer value is 30, then 30% of contacts will receive the email campaign with subject line A, and 30% of contacts will receive the email campaign with subject line B. Valid values include 5 to 50 percent, inclusively.

  • winner_wait_duration: The number of hours Constant Contact waits after the A/B test is sent before determining the winning subject line. The winner is the subject line with the highest number of contact opens. After determining the winner, Constant Contact automatically sends the email campaign with the winning subject line to all the remaining contacts that did not participate in the A/B test.

The following shows example A/B test request and response schema:

{
    "alternative_subject": "Biggest Sale of the Year Coming Soon!",
    "test_size": 5,
    "winner_wait_duration": 6
}

Creating an A/B test changes the primary email campaign type from Newsletter (code= 10) to A/B Test (code= 57).

A/B Test Endpoints

The following A/B test endpoints are currently available:

The following A/B test endpoints will become available in an upcoming release:

  • POST: To create an A/B test for a email campaign, make a POST call to emails/activities/{campaign_activity_id}/abtest.

  • PUT: To update A/B test details, make a PUT call to emails/activities/{campaign_activity_id}/abtest.