Skip to main content

Mailchimp Integration

Written by Stefania
Image showing the Mailchimp logo with the monkey mascot and stylized

Using the Mailchimp integration, you will be able to build an audience of customers that complete a quiz.

Api keys

To get started, make sure you have a Mailchimp account.

  1. Log in to Mailchimp, go to your Profile -> Extras -> API Keys. You will need an API Key. You can use an existing API Key, but we recommend you create a new API Key specifically for integrating with Lantern. Under Your API keys click Create A key and label it for future reference, for example "Lantern Product Quiz Builder".
    ​

    GIF showing the Mailchimp account interface navigating to Profile > Extras > API Keys, clicking the 'Create A Key' button, entering 'Lantern Product Quiz Builder' as the API key name, and copying the generated key.

  2. Open the Lantern app from your Shopify store admin. Go to the Integrations tab, fill in the API Key from the previous step, and click Connect. You should get a success message.
    ​

    Image displaying the Lantern app's Integrations tab, with the Mailchimp integration section where the API key is entered and the 'Connect' button is clicked.

Quiz settings

You have now connected the app with Mailchimp. To make sure you are collecting data properly, make sure to do the following things for each quiz:

  1. Copy a Mailchimp Audience ID. This way you can collect all quiz takers in an audience. The Audience ID can be found in Mailchimp, under the appropriate audience by selecting Manage Audience -> Settings. Scroll to the bottom of the settings page and there you will find the Audience ID.

    Image showing the Mailchimp Audience Settings page, with the Audience ID located at the bottom of the settings page.

  2. In the quiz editor, open More Integrations > Email marketing, click Activate on the Mailchimp card, paste your copied Audience ID into the Audience ID field and click Save.

    Image displaying Lantern's quiz builder interface on the More Integrations tab, with the Mailchimp integration activated and the Audience ID pasted into the List ID input box.

  3. To save quiz answers on the contact, create a merge field in your Mailchimp audience. Then enter its merge tag (for example SLEEPPOSITION) in the question's Mailchimp ID field under Question Properties in the quiz editor.

Thats it! Quiz takers who agree to marketing are added to your audience as subscribed, so you can send them relevant newsletters and product updates.

Quiz takers who decline are added as transactional contacts, which are not mailable. Existing contacts keep their current status unless they opt in.

Customers can also leave their email through the optional sign-up on the Results Page, after they have seen their recommendations. This sign-up collects email addresses only and has no marketing consent checkbox. Learn how to set up both options in Collect customer emails.

Every quiz taker is also tagged lantern and with the quiz's URL handle, so you can use these tags to build segments.

Related Articles
Did this answer your question?