Iterable

Introduction

Miso supports personalized email marketing by integrating with Iterable. For more information, see our Personalized Email Campaigns recipe.

How to integrate

1. Set up a Data Feed in Iterable

• Go to Content -> Data Feeds from the menu bar
• Create a data feed with URL = https://api.askmiso.com/v1/recommendation/user_to_products?user_id={{#urlEncode}}{{user_id}}{{/urlEncode}}&fl=*&rows=10
• Use the {{#urlEncode}}{{myParam}}{{/urlEncode}} syntax to assign query parameters based on the Iterable subscriber profiles. Usually you only need to assign user_id parameter dynamically.
• The remaining query parameters are usually fixed per each data feed, and you can specify common Miso parameter like fq, boost_fq, or fl as the query parameters to achieve the desired recommendation results.
• Create a HTTP Customer Header x-api-key and fill in your Secret API Key

2. Use data feeds in templates

• Enable a data feed in the Advanced Options of your email templates. We also suggest enabling Merge the Data Feed and User Contexts to make the syntax more consistent.

• Refer to the recommendations in the template using Handlebars syntax. For example:

  • {{data.products.[0].title}}: Title of the first recommendation
  • {{data.products.[1].cover_image}}: Cover image of the second recommendation
  • {{data.products.[2].url}}: URL of the third recommendation

3. Preview email with data.

• Use the Preview with Data functionality to preview the email with the real Miso recommendation results.