Skip to content

Add Mailmodo to Segment Doc #2747

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 15 commits into from
Apr 21, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/Vocab/Docs/accept.txt
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
(?:L|l)ookback
(?:P|p)ageviews?\b
(?:P|p)endo
(?:P|p)odfile
(?:P|p)ostgres
(?:R|r)emarketing
(?:U|u)nlinks?\b
Expand Down Expand Up @@ -49,6 +50,7 @@ Kameleoon
Kissmetrics
Lightbox
Littledata
Mailmodo
Marketo
measurability
middleware
Expand All @@ -69,6 +71,7 @@ upsert
US
utm
Vero
Vidora
viewability
WebKit
Wootric
Expand Down
68 changes: 64 additions & 4 deletions src/connections/destinations/catalog/mailmodo/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,67 @@
---
title: 'Mailmodo Destination'
hidden: true
title: Mailmodo Destination
rewrite: true
id: 623a07123d307e60f268a1c2
published: false
beta: true
---

[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.


Mailmodo maintains this destination. For any issues with the destination, [contact the Mailmodo Support team](mailto:help@mailmodo.com).


## Getting Started

{% include content/connection-modes.md %}

1. From the Destinations catalog page in the Segment App, click **Add Destination**.
2. Search for **Mailmodo** in the Destinations Catalog, and select the **Mailmodo** destination.
3. Choose which Source should send data to the Mailmodo destination.
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.
5. Enter the **API Key** in the Mailmodo destination settings in Segment.


## Supported methods

Mailmodo supports the following methods, as specified in the [Segment Spec](/docs/connections/spec).

### Identify

Take a look at the [Identify method documentation](/docs/connections/spec/identify) to learn about what it does.

```js
analytics.identify('userId12345', {
firstName: 'Bob',
lastName: 'Dole',
email: 'bob.dole@example.com',
company: 'Initech',
employees: 234
});
```

Every time you make an identify call with an email address included:
1. Mailmodo verifies that the email exists.
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.
3. If the email exists, Mailmodo updates the user properties for the Contact against the Segment `traits` sent in the identify call payload.

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.

> info "How Mailmodo handles incoming email addresses"
> * The email field is required. Mailmodo drops identify calls without an email.
> * If different email addresses are sent against the same user ID in identify call, Mailmodo treats them as two different contacts.

### Track
Take a look at the [Track method documentation](/docs/connections/spec/track) to learn about what it does. An example call looks like:

```js
analytics.track('Product Viewed', {
product_id: '507f1f77bcf86cd799439011',
name: 'Monopoly: 3rd Edition',
price: 18.99,
url: 'https://www.example.com/product/path',
image_url: 'https://www.example.com/product/path.jpg'
});
```
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.

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.
2 changes: 2 additions & 0 deletions vale-styles/Vocab/Docs/accept.txt
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ Kameleoon
Kissmetrics
Lightbox
Littledata
Mailmodo
Marketo
measurability
middleware
Expand All @@ -70,6 +71,7 @@ upsert
US
utm
Vero
Vidora
viewability
WebKit
Wootric
Expand Down