Follow these steps to connect your Mailchimp data to Supermetrics and use your data in any of our data destinations — Google Sheets, Looker Studio, Excel, and data warehouses, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.
You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.
Before you begin
To connect Supermetrics to Mailchimp, you need a Mailchimp user account with either of these user roles:
- Owner
- Admin
Learn how to grant access to a user account in Mailchimp's documentation.
Multi-account login
It's not possible to log into Mailchimp in Supermetrics with multiple accounts.
If you've authenticated with Mailchimp credentials that have access to multiple Mailchimp accounts, there's a risk that future refreshes will show unpredictable combinations of data from any of the accounts that the original account has access to. Learn more about how to navigate multiple Mailchimp accounts.
Incompatible fields
You might encounter this error when pulling data from Mailchimp in Supermetrics with either Google Sheets or Looker Studio:
- Incompatible fields: IllegalDimensionMetricCombinationException
Query types
Set up your Mailchimp queries using any of the query types described below.
- Automations: Returns automations. Does not include customer journeys.
- Automation emails: Returns individual emails in a classic automation workflow.
- Lists: Returns Mailchimp lists, also known as "audience".
- Campaigns: Returns campaigns from your Mailchimp account.
- List activity: Returns daily aggregated activity stats for your list. For example, view unsubscribes, signups, total emails sent, opens, clicks, and more, for up to 180 days.
- List growth history: Returns a summary of the month-by-month growth activity for a specific list.
- List locations: Returns locations (countries) of subscriber lists.
- List members: Returns members of a specific Mailchimp list, including currently subscribed, unsubscribed, and bounced members.
Instructions
Make sure you've installed the Supermetrics add-on before you connect.
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch sidebar to open Supermetrics.
- Click Create new query.
- Under Data source, select Mailchimp.
- Choose to make this connection shared or private.
- Click Start.
- Log in to Mailchimp.
- Select an account, and click Allow.
- Navigate to Select campaigns/lists to choose the data you'd like to connect.
- Select a query type.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.
Make sure you've connected Supermetrics to Looker Studio before following the steps below.
- Open the Supermetrics Looker Studio data source gallery.
- Navigate to Mailchimp and click Start free trial.
- You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
- Once that's done, or if you've done it before, click the right-hand Authorize button (under "Mailchimp requires authorization to connect to data").
- Select a team that has access to the account you want to connect.
- Choose to make this connection shared or private.
- Click Start.
- Log in to Mailchimp.
- Select an account, and click Allow.
- In the Select campaigns/lists dropdown, select the data you'd like to connect.
- Select a query type, and click Next.
- In the pane's top right, click Connect.
- Click Create report.
- Click Add to report.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.
Make sure you've installed the Supermetrics add-on before you connect.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Mailchimp.
- Choose to make this connection shared or private.
- Click Start.
- Log in to Mailchimp.
- Select an account, and click Allow.
- Navigate to Select campaigns/lists to choose the data you'd like to connect.
- Select a query type.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.
Follow these instructions to set up a transfer with Supermetrics for BigQuery (marketplace). See the instructions below for other data warehouse destinations.
Set up transfer for BigQuery (marketplace)
Make sure you've enrolled the data source before you connect.
- Log in to the Google Cloud Platform.
- Navigate to BigQuery → Data transfers.
- Click + Create transfer.
- Select the Mailchimp data source.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- Under Third-party connection, click Connect source.
- Accept the agreement.
- Click Authorize with Mailchimp.
- Log in to Mailchimp.
- Select an account, and click Allow.
- Select the campaigns or lists you'd like to include in your reporting and define the transfer settings.
- Click Submit.
- Click Save.
Set up data warehouse transfer on the Supermetrics Hub
Make sure you've set up a data warehouse destination before you connect.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Export, go to Data warehousing → Transfers.
- Click Create new.
- Select the Mailchimp data source, and click OK.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- In the Connections section, click Add new connection.
- Log in to Mailchimp.
- Select an account, and click Allow.
- In the transfer setup view, select the campaigns or lists you'd like to include in your reporting.
- Click Create transfer.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Transform, click Query Manager (API).
- Select for Supermetrics API from the dropdown menu next to the page title.
- Click Select data source.
- Select the Mailchimp data source.
- Log in to Mailchimp.
- Select an account, and click Allow.
- In the Select accounts section, select the campaigns or lists you'd like to include in your reporting.
- Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
- Click Run to test your query.
- Log in to the Supermetrics Hub.
- In the left-side menu, select Connect → Data sources.
- Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
- Hover over the Mailchimp data source, and click Connect.
- Log in to Mailchimp.
- Select an account, and click Allow.
More resources
- Mailchimp report building guide
- Mailchimp: Permissions troubleshooting guide
- About incompatible fields errors in Mailchimp
- How to reauthenticate a data source in Looker Studio, Google Sheets, or Excel
- How to reauthenticate a data source in data warehouse, API, or cloud storage platform
- How to manage data source connections on the Supermetrics Hub