Connector: Mailjet

The Mailjet connector allows you to synchronize data between Spotler Activate and the Email Service Provider (ESP) Mailjet. Audiences, profiles, triggers, product sets and email personalizations from Spotler Activate can be sent to Mailjet via the connector.

By completing the full implementation, email addresses and consent are synchronized once between Mailjet and Spotler Activate. In addition, profile fields are synchronized from Spotler Activate to Mailjet. After establishing the connection, the following data is synchronized:

  • Email addresses: new email addresses (with consent) are synchronized in real time from Spotler Activate to Mailjet.
  • Consent: changes to consent are synchronized in real time between Mailjet and Spotler Activate.
  • Profile fields: with each API call, the profile fields are sent from Spotler Activate and stored in Mailjet.

Activate the Mailjet connector

Implementing Mailjet consists of:

Establishing a link

Login to Mailjet and go to API Keys. Copy the values 'API Key' and 'Secret Key'. In Spotler Activate, go to Apps > Mailjet and paste the copied values into the 'API Key' and 'Secret Key' fields. Click on 'Save Channel' (the setting Non-Spotler Activate Mailjet account must remain checked). Next the following settings become visible:

  • Contact List: the contact lists in Mailjet for synchronizing the email addresses
  • From Name: the name of the desired sender of future emails
  • From Email: the email address of the sender of future emails

Enter the settings and save. The link has been completed. Spotler Activate imports the existing email addresses and possibly newsletter consent from Mailjet once. Through the link, new email addresses are synchronized daily between Spotler Activate and Mailjet.

Synchronizing profiles

For real-time synchronization of new profiles from Spotler Activate to Mailjet, the following is required. Create an Advanced audience with the following rules. New profiles that leave their email address will be synchronized to Mailjet in real time.

Mailjet1.png

Email hashing

For email hashing, a parameter can be added to emails. This increases the match rate. Add the following parameter to the URLs that refer to the website in the emails: 

?email=[[data:email_hash]]

For example, in Mailjet a URL will look like this:

Mailjet17.png

Synchronizing Consent

For real-time synchronization of consent from Spotler Activate to Mailjet, the following is required. Create an Advanced audience with the following rules. The profiles with email address and newsletterconsent will be synchronized to Mailjet. For synchronizing service consents the above can be repeated with permission = Email - service messages.

Mailjet3.png

Audiences & Profiles

In the Audience Builder, you can send audiences to Mailjet by checking Mailjet as Channel:

Mailjet4.png

For the audience, Spotler Activate updates the following information in Mailjet:

  • At profile level → contact properties: the profile fields and audiences of the profiles
  • At consent level → contacts: the contacts per consent level
  • At audience level → segmentation: the audience in Mailjet
How can I view the contact properties of a profile in Mailjet?

In Mailjet you can view the contact properties as follows: in Mailjet, go to All Contacts. Find the desired contact and click on it. Click on Contact properties. In this overview you can see the profile fields and audiences of the contact (under system_segments).

Mailjet5.png

How can I view the contacts in Mailjet?

In Mailjet you can view the contacts as follows: in Mailjet, go to Contacts. In this overview you can see the consent levels, where each level has a list of contacts that meet the consent level. The consent levels are as follows:

  • Newsletter
  • Marketing
  • Service

You can also find these consent levels in a 360 profile.

Mailjet6.png

How can I view the segmentation in Mailjet?

In Mailjet you can view the segmentation as follows: in Mailjet, go to Segmentation. In this overview you can see all audiences that are synchronized to Mailjet.

Mailjet7.png

How can I use the contacts and segmentation for a campaign?

In Mailjet, you can send campaigns to profiles that have a certain consent level and belong to an audience: in Mailjet, go to Campaigns. Click on ‘New campaign’. Enter the following settings:

  • Subject: the subject
  • From: the sender
  • Content: the content
  • Contact list:
    • List: the consent level of the recipients
    • Segment: the audience of the recipients

Mailjet8.png

Triggers & Productsets

In Journeys > Journey Builder you can send triggers to Mailjet with the action Email. In the E-mail trigger you can set the following:

Mailjet9.png

Template: the template in Mailjet. Note: The template must be published in the Transactional folder in Mailjet. Then there are two options for adding product sets to the template:

Option 1: Personalization

In the ‘Personalization’ field you can select an e-mail personalization, which will be sent to Mailjet. An email personalization is a product set that you can create in Spotler Activate

How do I create a email personalization in Mailjet?

Email personalizations are formatted product sets that you can use in Mailjet. If you are using ESP other than Mailjet, this option is not available. In Spotler Activate, you can format the product set as follows: go to Personalizations > New Personalization. Select 'Email templates' and click on the template. Select the Minimum and Maximum product amounts you want to show in the email personalization. Design the personalization according to your wishes.

Mailjet10.png

Incorporate email personalization in template In Mailjet, you can add personalization to templates as follows: Go to the appropriate template in Mailjet. Drag the HTML block to the desired location (where you want to show the email personalization) in the template. Double click on the HTML block Add the following HTML placeholder: {{ var:personalization_html }}. The email personalization will be inserted where {{var:personalization_html}} is.

Mailjet11.pngMailjet12.png

Option 2: Products

In the ‘Products’ field you can select a product set, which is sent to Mailjet. For the profiles that reach the Email trigger and meet the conditions, Spotler Activate sends an API Call to Mailjet:

  • Automation: with this API call a trigger is sent for the profile and possibly the product set or email personalization of the profile is sent along.
How do I process where the product set should be shown in the template?

In Mailjet you can add product sets to templates as follows: In Mailjet, go to the relevant template Drag the HTML block to the desired location (where you want to display the product set) in the template. Double-click on the HTML block Add Javascript to display the products.

Mailjet13.png

Mailjet14.png

Mailjet15.png

The following Javascript can be used as an example (please note: this is an example! Adjust it to your own wishes. Spotler Activate does not support this)

{% set position = 1 %}
{% set counter = 0 %}
{% for product in var:products %}
{% if counter > 11 %}
{% else %}
{% if position == 1 %}
<!--[if mso | IE]>
<table
align="center" border="0" cellpadding="0" cellspacing="0" class="" style="width:600px;" width="600"
>
<tr>
<td style="line-height:0px;font-size:0px;mso-line-height-rule:exactly;">
<![endif]-->
<div style="Margin:0px auto;max-width:600px;">
<table align="center" border="0" cellpadding="0" cellspacing="0" role="presentation" style="width:100%">
<tbody>
<tr>
<td style="direction:ltr;font-size:0px;padding:20px 0;padding-bottom:10px;padding-top:0px;text-align:center;vertical-align:top;">
<!--[if mso | IE]>
<table role="presentation" border="0" cellpadding="0" cellspacing="0">
<tr>
<td
class="" style="vertical-align:top;width:600px;"
>
<![endif]-->
<div class="mj-column-per-100 outlook-group-fix" style="font-size:0;line-height:0;text-align:left;display:inline-block;width:100%;direction:ltr;vertical-align:top;">
<!--[if mso | IE]>
<table role="presentation" border="0" cellpadding="0" cellspacing="0">
<tr>
<td
style="vertical-align:top;width:300px;"
>
<![endif]-->
{% endif %}
{% if position == 2 %}
<!--[if mso | IE]>
</td>
<td
style="vertical-align:top;width:300px;"
>
<![endif]-->
{% endif %}
<div class="mj-column-per-50 outlook-group-fix" style="font-size:13px;text-align:left;direction:ltr;display:inline-block;vertical-align:top;width:49%;">
<table border="0" cellpadding="0" cellspacing="0" role="presentation" style="vertical-align:top;" width="100%">
<tr>
<td align="right" style="font-size:0px;padding:10px 25px;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;word-break:break-word;">
<table border="0" cellpadding="0" cellspacing="0" role="presentation" style="border-collapse:collapse;border-spacing:0px;">
<tbody>
<tr>
<td style="width:295px;">
<a href="{{ product.url }}?email=[[data:email_hash]]">
<img alt height="auto" src="{{ product.image_square }}" style="border:none;display:block;outline:none;text-decoration:none;height:auto;width:100%;" title width="295">
</a>
</td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td align="left" style="font-size:0px;padding:10px 25px;padding-top:0px;padding-bottom:0px;word-break:break-word;">
<div style="font-family:Arial, sans-serif;font-size:13px;line-height:24px;text-align:left;color:#55575d; ">
<p style="line-height: 22px; margin: 10px 0; text-align: center;"><span style="font-size:14px"><a href="{{ product.url }}?email=[[data:email_hash]]" style="color: #32CD32; text-decoration: none;"><b>{{ product.brand }}</b></a><br><a href="{{ product.url }}?email=[[data:email_hash]]" style="color: #32CD32; text-decoration: none;"><span style="height: 20px; overflow: hidden; display: inline-block"> {{ product.title }}</span></a></span><br><span style="font-size:14px"><a href="{{ product.url }}?email=[[data:email_hash]]" style="color: #32CD32; text-decoration: none;"><b>{{ product.currency_sign }} {{ product.price }}</b></a></span></p>
</div>
</td>
</tr>
<tr>
<td align="center" vertical-align="middle" style="font-size:0px;padding:10px 25px;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:5px;word-break:break-word;">
<table border="0" cellpadding="0" cellspacing="0" role="presentation" style="border-collapse:separate;line-height:100%; width:100%;">
<tr>
<td align="center" bgcolor="#bee9eb" role="presentation" style="border:none;border-radius:0px;cursor:auto;padding:10px 25px;background:#32CD32;" valign="middle">
<p style="background:#32CD32;color:#ffffff;font-family:Arial, sans-serif;font-size:13px;font-weight:normal;line-height:120%;Margin:0;text-decoration:none;text-transform:none;"><a href="{{ product.url }}?email=[[data:email_hash]]" style="color: #3f3f3f; text-decoration: none;">
<span style="color:#3f3f3f"><b>SHOP HIER</b></span>
</a>
</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</div>
{% if position == 2 %}
<!--[if mso | IE]>
</td>
</tr>
</table>
<![endif]-->
</div>
<!--[if mso | IE]>
</td>
</tr>
</table>
<![endif]-->
</td>
</tr>
</tbody>
</table>
</div>
<!--[if mso | IE]>
</td>
</tr>
</table>
<![endif]-->
{% endif %}
{% if position == 2 %}
{% set position = 1 %}
{% else %}
{% set position = 2 %}
{% endif %}
{% endif %}
{% set counter = counter + 1 %}
{% endfor %}
How can I view the Automation in Mailjet?
In Mailjet you can view a sent email as follows: In Mailjet, go to All Contacts Find the desired contact and click on it Click on Statistics & email history. In this overview you can see the emails that have been sent to the profile. Mailjet16.png

How can I check if a trigger has been send to the connector?