If you have been using Mailchimp to send out email newsletters, you can now import event data about the people who saw, opened, and clicked through your emails.



This integration works best if you’re already using visitors’ email addresses to identify them.

Integration Details

Event NamePropertiesIdentity
Received Campaign E-mailmailchimp receive campaign title: (campaign title)Email address, according to Mailchimp
Opened Campaign E-mailmailchimp open campaign title: (campaign title)Email address, according to Mailchimp
Clicked Campaign E-mailmailchimp click campaign title: (campaign title)Email address, according to Mailchimp
mailchimp_click_url: (URL clicked)

Frequency of Import

  • We will import data from your existing campaigns from the last 100 campaigns, starting with the most recent ones.
  • We will check for activity on a campaign up to 60 days after the campaign was sent.


1. Obtain a Mailchimp API Key

  • While logged into your Mailchimp account, open your Account Settings and navigate to API Keys (under Extras):
  • Click “Create A Key”
  • Now let’s add this API key to your Kissmetrics account in the next step.

2. Register the API Key with Kissmetrics

  • Click Add Data from Mailchimp
  • Enter your Mailchimp API Key from above.
  • One more step to go! You can come back to this page and check the status of the import.

3. Unifying Mailchimp Data to the JavaScript Library

In connecting Mailchimp to Kissmetrics, you’ll see events attributed directly to the user’s email address.


Sample Data

  1. [email protected] has Received Campaign E-mail.
  2. [email protected] has Viewed Campaign E-mail.
  3. [email protected] has Clicked Campaign E-mail.

However, our JavaScript library should also recognize these visitors by their email address. Let’s pass the email address from Mailchimp to our JavaScript Library, so that we can connect the user’s path, starting from the email and continuing through their browsing session:



  1. [email protected] has Visited Site.
  2. [email protected] has Signed Up.

Here’s how to do so.

Using Mailchimp’s Merge Tags with the URL API

Mailchimp provides a merge tag *|URL:EMAIL|*, which is replaced by each recipient’s email address for their particular email. We’ll use that in conjunction with our URL API to send our JavaScript library the person’s email.

Todo: for any links to your site, if you want to record campaign-specific events or properties, use our URL API to tag the links. Then add the parameter kmi=*|URL:EMAIL|*, to use the recipient’s email address as their KM identity.


So for example, if your Mailchimp campaign links to, use this link to pass the email address to our JavaScript:*|URL:EMAIL|*