You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/mailchimp/index.md
+12-11Lines changed: 12 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,9 +11,10 @@ id: 54521fd925e721e32a72eed3
11
11
12
12
{% include content/connection-modes.md %}
13
13
14
-
1. From the Segment web app, click **Catalog**.
15
-
2. Search for "Mailchimp" in the Catalog, select it, and choose which of your sources to connect the destination to.
16
-
3. In the destination settings, enter your Mailchimp "API key" into the connection settings.
14
+
1. From the Segment web app, navigate to **Connections > Catalog** and go to the **Destinations** tab of the catalog.
15
+
2. Search for *Mailchimp*, select it, and click **Configure Mailchimp**.
16
+
3. Choose the source to connect the destination to.
17
+
4. In the destination settings, enter your Mailchimp "API key" into the connection settings.
17
18
You should create a new API key for the Segment destination. Mailchimp restricts each API key to a maximum of 10 concurrent requests, so creating a dedicated one for Segment ensures maximum throughput for outgoing calls. You can read more about API keys on [Mailchimp's docs](http://kb.mailchimp.com/integrations/api-integrations/about-api-keys){:target="_blank"}.
18
19
4. Enter your Mailchimp "[Audience ID](#audience-id)" into the connection settings.
19
20
5. Enter your Mailchimp "[Datacenter ID](#datacenter-id)" into the connection settings.
Every time you call [identify](/docs/connections/spec/identify/) with an email address included, Segment will:
34
+
Every time you call [identify](/docs/connections/spec/identify/) with an email address included, Segment:
34
35
35
-
1. First ask Mailchimp if that email exists and what their subscriber status is for the `listId` you've provided in the destination settings.
36
+
1. First asks Mailchimp if that email exists and what their subscriber status is for the `listId` you've provided in the destination settings.
36
37
37
-
2. If they don't exist, Segment will **subscribe** that user to the list immediately. If you have `doubleOptIn` setting enabled, it will send a confirmation email to that user before subscribing them and that email won't be tagged with a subscriber status of `pending`.
38
+
2. If they don't exist, Segment **subscribes** that user to the list immediately. If you enabled the `doubleOptIn` setting, it sends a confirmation email to that user before subscribing them, and that email won't be tagged with a subscriber status of `pending`.
38
39
39
-
3. If they already have a subscriber status such as `pending`, `subscribed`, `unsubscribed`, or `cleaned`, Segment will **NOT**resubscribe them but simply update their user `traits`.
40
+
3. If they already have a subscriber status such as `pending`, `subscribed`, `unsubscribed`, or `cleaned`, Segment doesn't resubscribe them, but updates their user `traits`.
40
41
41
42
So you no longer have to worry about the `identify` call resubscribing users unintentionally!
42
43
@@ -50,10 +51,10 @@ If you want to view any other custom user traits in the Mailchimp list dashboard
50
51
> **IMPORTANT:** Mailchimp only supports merge tags that are 10 characters or shorter. For every user `trait` you send inside the `.identify()` call, Segment will trim it to be the first 10 characters and will send it in **uppercase** form to Mailchimp.
51
52
52
53

53
-
It's very important that when you set up your merge tags in Mailchimp, your `Merge Tags` are the first 10 characters (excluding whitespace or special characters) of its `Field Label` (if it's over 10 characters).
54
+
It's important that when you set up your merge tags in Mailchimp, your `Merge Tags` are the first 10 characters (excluding whitespace or special characters) of its `Field Label` (if it's over 10 characters).
55
+
56
+
For example, if your `Field Label` was `Way Too-Long123`, your `Merge Tag` should be `WAYTOOLONG`. And the `user.trait` inside your `.identify()` call would be `Way Too-Long123` since Segment converts that to `WAYTOOLONG` before sending it to Mailchimp.
54
57
55
-
For example, if your `Field Label` was `Way Too-Long123`, your `Merge Tag` should be `WAYTOOLONG`. And the `user.trait` inside your `.identify()` call would be `Way Too-Long123` since Segment will convert that to `WAYTOOLONG` before sending it to Mailchimp.
56
-
57
58
If you're going to send either a `boolean` or `null` object as a `user.trait` value, when creating the custom merge field for that trait inside Mailchimp, make sure to set the data type as `TEXT` since Segment will stringify all `boolean` or `null` objects to strings.
58
59
59
60
Also note that fields you specify in Mailchimp as date fields must receive dates. Passing non-date values will cause issues.
For any other custom `traits` just add a Mailchimp custom merge field inside of Mailchimp with a tag that matches the key you are using in your `identify` call. In the example these `traits` are **company** and **employees**. They will be shown as **COMPANY** and **EMPLOYEES** in Mailchimp, but you can record them in lower-case to `identify` and they will still be populated.
82
+
For any other custom `traits`, add a Mailchimp custom merge field inside of Mailchimp with a tag that matches the key you're using in your `identify` call. In the example, these `traits` are **company** and **employees**. They will be shown as **COMPANY** and **EMPLOYEES** in Mailchimp, but you can record them in lower-case to `identify` and they will still populate.
82
83
83
84
> success ""
84
85
> Don't use underscores in your custom merge field names. When Segment maps to Mailchimp merge fields, Segment removes the underscores and capitalizes the entire field.
0 commit comments