Use Events for Behavioral Targeting

Events are activities that a contact engages in outside your emails that you want to track or monitor. Use our Events endpoint to transfer contact activity from another app into Mailchimp. Events are customizable, so you can create them to meet your needs. You can then use the behavioral data you collect to segment your audience and send marketing content.

In this article, you'll learn how to use custom events to segment your audience and send targeted marketing content.

Before you start

Here are some things to know before you begin this process.

• The Events API endpoint is available to all Mailchimp users for event-based segments and event property merge tags. Paid marketing plans have access to the Event API trigger for automation flows. To learn more, check out our pricing page. To change your plan type, visit the plans page in your account.
• Make sure the user data you collect conforms with Mailchimp’s Terms of Use and local privacy laws.
• Before you use this endpoint, you must add contacts to your audience.

About events

Custom events provide up-to-date insights about your audience. After you or your developer create a custom event, you can track interactions that help you market to each person’s specific needs. We recommend that you create custom events for the key events you want to track, then use event data to create segments or start an automation flow.

When you create and name your event, you can also add properties to that specific event to gather extra context. Properties provide more detail about how your contacts interact with an event, which makes the information you collect more valuable. For example, you could use properties to specify the account type that a user signed up for, or the physical location where they attended a conference.

Create an event with API or a merge tag

If you’re familiar with our API or have access to a developer, you can use our Events endpoint to create custom events and add properties as needed. You can also use the |EVENT:PROPERTY| merge tag to display a specific property value of an event. For example, let’s say you set up an automation triggered by the event meetup_registered, which has location properties for each city that hosts a meetup. If your content includes “Get ready, |EVENT:location|", recipients who registered for a meetup in Atlanta will see “Get ready, Atlanta.” To learn more about events, check out our Track Outside Activity with Events article.

Create an event with Zapier

If you aren’t familiar with our API and don’t have access to a developer, you can use a third-party integration like Zapier to connect another app to Mailchimp and create custom events for things that happen in that app.

When an activity occurs with one of your contacts in another app, Zapier will create a new event as long as an email address is collected. Use those events to create segments within your audience, or set up a flow template that adds contacts when events are created.

Keep in mind that Zapier is a third-party integration. For technical assistance, reach out to Zapier Support.

To create a custom event with Zapier, follow these steps.

1. Log in to Zapier and click Create Zap.
2. Choose the app you want to connect to Mailchimp and the event that you want to trigger a Zap.
3. Choose an existing account for the third-party app, or choose Connect a New Account to register a new one.
4. Click Continue.
5. Choose Mailchimp as your app and choose Create Custom Event as your action event. You may need to sign in to your Mailchimp account and allow Zapier access.
6. Click Continue.
7. Click the Mailchimp account drop-down to keep the default account, or click + Connect a new account to add a new account.
8. Click Continue.
9. Now you’ll customize your event. Choose the audience, the email address collected from the app, the custom event name, and any event properties you want added to the event.
10. Click Continue.
11. Click Test + Continue to send a test custom event, or click Skip Testing. When you’re done, click Done Editing.

Well done! After you configure your action settings and turn on the Zap, your connected app will create custom events in Mailchimp.

View events

When an event occurs for a contact, you can view it on the activity feed of their contact profile.

To view events, follow these steps.

1. Click Audience, then click All contacts.
2. If you have more than 1 audience, click the Current audience drop-down menu and choose the one you want to work with.
3. Click a contact's email address to open their contact profile.
4. On the Overview tab, use the drop-down menus to select the activity type and date range.
   

Create and send emails to a segment

Build a segment based on event data and use it to create targeted emails, text messages, or postcards. Custom event data can be used for segmenting up to 30 days after the event occurred for Free and Essentials accounts. Standard accounts keep event segment data for 3 months and Premium accounts for 18 months. Event property segmentation conditions are available for Standard and Premium accounts.

To create and send an email to a segment, follow these steps.

1. Click Audience, click All contacts.
2. If you have more than 1 audience, click the Current audience drop-down menu and choose the one you want to work with.
3. Click Create new segment.
4. In the conditions section, select the first drop-down to select your parameter. Use the second drop-down menu to select the event, or select No events. Use the third drop-down to choose the operator for the segment.
5. Click Preview Segment.
6. Click Save as segment.

Success! After you've saved your segment, click Send Campaign to send an email.

Create an event-based automation flow

Create a Marketing automation flow that kicks off for a contact when an API call with the event name posts. Accounts on the Standard marketing plan or higher can create multi-step flows with an Event API trigger. Accounts on the Essentials marketing plan can use the same trigger with a single-step flow.

To create an automation flow that adds contacts based on a specific API event, follow these steps.

1. Click Automations.
2. Click Build from scratch or Choose flow template and choose Add contacts to flows using the Mailchimp Event API.
3. Enter a name for your flow and select an audience from the drop-down.
4. Click Choose a trigger.
5. Click API & Integrations.
   
6. Click Event API.
7. In the trigger modal, enter your Event name. Make sure the event name matches the name field you entered when you created the event. The API endpoint example provided shows the information that you’ll need to supply in your API call to trigger this event.
8. Click Save trigger.

Compare marketing plan Event API permissions

Here are the custom event actions that are available with each Mailchimp plan.

Account Actions

Event Features	Free	Essentials	Standard	Premium
Events endpoint
Events in contact profile
Event-based segments
Event data availability (for segmenting)	30 days	30 days	3 months	18 months
Event-based single-step automation flow
Event-based multi-step automation flow
Event property merge tags in automation flows
Event property segments