MailChimp configuration

From GroupScript documentation

Jump to: navigation, search


Getting started

  1. First you need to create an account on MailChimp site.
  2. To send emails you need a list that contains all your subscribers.

MailChimp API does not allow automatic list creation, so you will have to do it manually.

List creation

  1. Go to lists => create list.
  2. If asked "lists or groups?" - press again - "create list".
  3. In list creation dialog enter your list data.
  4. Be sure to uncheck "people can pick email format (HTML, plain-text, or mobile)", because GroupScript will send html emails only.

List configuration

This is important - if you skip these steps your subscribers will receive global campaigns ONLY.

  1. Go to <your list> => settings => fields and merge tags.
    Fields and merge tags
  2. In next dialog press "add a field".
  3. Choose "text".
  4. For this new field enter "City" (without quotes) in "field name" and "CITY" (without quotes) in "Stick this tag in your content" text fields.
  5. Press "save" when done.
  6. If you did everything correctly, your fields and merge tags should look like this. (image on the right side)
    Merge tags for GroupScript
  7. This is all you need to do on MailChimp side, now you need to configure GroupScript side.

GroupScript configuration

Choose backend

  1. First go to backend => settings => reload options.
  2. Then settings => newsletter options.
  3. Newsletter settings => active newsletter backend - select "MailChimp" if not selected already. Press "save".
    Newsletter options

API keys

  1. Then Newsletter settings => newsletter mailchimp.
    MailChimp options
  2. Your MailChimp API key can be found in your MailChimp profile.
  3. Go to Account => API keys & info.
    API keys & info
  4. If there are no keys - you need to create one - press "add a key".
  5. Now copy and paste your API key to GroupScript settings.

List id and sync interval

  1. You can also change how often your subscriber list will be synchronized to MailChimp (to update changed cities) - change value of mailchimp sync interval.
  2. Next you need to enter your global list id (list that you created previously).
  3. Go to <your list> => settings => list settings and unique id.
    List settings and unique id
  4. On the bottom of the page there will be text box "unique id for list <your list>".
  5. Copy and paste its value to GroupScript settings.

Resync list

  1. Now you need to sync your local subscriber list to MailChimp.
  2. Go to Dashboard => Newsletter status.
  3. If you cannot see it - it is because you are using custom theme.
    1. Then copy ALL files from system/application/themes/default/views/backend to system/application/themes/<your theme>/views/backend and overwrite everything.
  4. In Newsletter status view you can see subscriber count, error log and resync button.
  5. Press "resync subscribers" button.
  6. Now local and remote subscriber count should be equal.
  7. If not - then look for errors below.

Resync button

If you, for some reason, switch from MailChimp to built-in backend or to another custom backend, GroupScript cannot update remote MailChimp list anymore.
If you switch back to MailChimp you need to update MailChimp list - synchronise with your local list. Be aware that this function first empties (Deletes ALL subscribers of) your MailChimp list, then repopulates it with local subscribers.
Only subscribers with confirmed email addresses are synchronised.
After version 4.1 newsletter backends were changed. If your site does not use double opt-in or uses it with MailChimp - you must execute this against your database.

 UPDATE `newsletter_subscribers` SET `email_confirmed`=1 WHERE 1;
Personal tools

Groupon Clone