Skip to content

Commit 62d0dbe

Browse files
authored
Merge pull request #2747 from segmentio/sneha-mailmodo
Add Mailmodo to Segment Doc
2 parents 3a01c97 + bc7cca4 commit 62d0dbe

File tree

3 files changed

+66
-4
lines changed

3 files changed

+66
-4
lines changed

.github/Vocab/Docs/accept.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ Kameleoon
5151
Kissmetrics
5252
Lightbox
5353
Littledata
54+
Mailmodo
5455
Marketo
5556
measurability
5657
middleware
Lines changed: 64 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,67 @@
11
---
2-
title: 'Mailmodo Destination'
3-
hidden: true
2+
title: Mailmodo Destination
3+
rewrite: true
44
id: 623a07123d307e60f268a1c2
5-
published: false
6-
beta: true
75
---
6+
7+
[Mailmodo](https://www.mailmodo.com/){:target="_blank"} is an email marketing tool that focuses on bringing the interactive experience of the AMP framework to emails. It allows businesses to create emails with web page-like interactivity right inside the user inbox, thereby increasing engagement and conversions multi-fold.
8+
9+
10+
Mailmodo maintains this destination. For any issues with the destination, [contact the Mailmodo Support team](mailto:[email protected]).
11+
12+
13+
## Getting Started
14+
15+
{% include content/connection-modes.md %}
16+
17+
1. From the Destinations catalog page in the Segment App, click **Add Destination**.
18+
2. Search for **Mailmodo** in the Destinations Catalog, and select the **Mailmodo** destination.
19+
3. Choose which Source should send data to the Mailmodo destination.
20+
4. Go to the [Mailmodo Dashboard](https://manage.mailmodo.com/app/dashboard){:target="_blank"} and navigate to **Settings > API Keys**, then create a new API Key and copy it.
21+
5. Enter the **API Key** in the Mailmodo destination settings in Segment.
22+
23+
24+
## Supported methods
25+
26+
Mailmodo supports the following methods, as specified in the [Segment Spec](/docs/connections/spec).
27+
28+
### Identify
29+
30+
Take a look at the [Identify method documentation](/docs/connections/spec/identify) to learn about what it does.
31+
32+
```js
33+
analytics.identify('userId12345', {
34+
firstName: 'Bob',
35+
lastName: 'Dole',
36+
37+
company: 'Initech',
38+
employees: 234
39+
});
40+
```
41+
42+
Every time you make an identify call with an email address included:
43+
1. Mailmodo verifies that the email exists.
44+
2. If the email doesn’t exist, Mailmodo adds the user as a contact to the Mailmodo database and matches user properties with the Segment `traits` sent in the identify call payload.
45+
3. If the email exists, Mailmodo updates the user properties for the Contact against the Segment `traits` sent in the identify call payload.
46+
47+
All the [special traits](/docs/connections/spec/identify#traits) recognized by Segment are translated and matched with the Mailmodo user properties for a Contact. These fields are automatically created or mapped for a Contact in Mailmodo and are available for personalization and advance segmentation.
48+
49+
> info "How Mailmodo handles incoming email addresses"
50+
> * The email field is required. Mailmodo drops identify calls without an email.
51+
> * If different email addresses are sent against the same user ID in identify call, Mailmodo treats them as two different contacts.
52+
53+
### Track
54+
Take a look at the [Track method documentation](/docs/connections/spec/track) to learn about what it does. An example call looks like:
55+
56+
```js
57+
analytics.track('Product Viewed', {
58+
product_id: '507f1f77bcf86cd799439011',
59+
name: 'Monopoly: 3rd Edition',
60+
price: 18.99,
61+
url: 'https://www.example.com/product/path',
62+
image_url: 'https://www.example.com/product/path.jpg'
63+
});
64+
```
65+
Segment sends `Track` calls to Mailmodo as a Custom Event. When you call track, Segment sends the event to Mailmodo with the event name and all properties that you specified.
66+
67+
Be sure you send an Identify call for any user who triggers Track calls. If Mailmodo receives a Track call for an unknown userId, the call drops.

vale-styles/Vocab/Docs/accept.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ Kameleoon
5151
Kissmetrics
5252
Lightbox
5353
Littledata
54+
Mailmodo
5455
Marketo
5556
measurability
5657
middleware

0 commit comments

Comments
 (0)