Personalized Email Campaigns

Email marketing is an essential tool for driving sales and unlocking revenue. Personalized Email Campaigns can take your marketing to the next level by letting you tailor the content of your emails to each individual customer.

Example for Personalized Email Campaigns


According to a 2018 study, email is the primary customer acquisition and retention channel for more than 80% of online businesses. Email marketing campaigns are used to drive reengagement and awareness around products and promotions. Campaigns can let customers know about new and trending items, special deals, or seasonal/holiday collections.

With Miso's Personalized Email Campaigns, you can highlight just those items that a user will be likely to engage with — while still maintaining your merchandizing around a certain theme, promotion, or collection of items. Miso APIs are designed to support modern email campaign automation tools like Iterable, Klaviyo, or Braze that support third-party data feed integration via HTTP API calls. How it works is as follow:

  • You train the Miso engine
  • You set up the desired Miso APIs (e.g. User to Products API) as data feeds in your campaign automation tool
  • The campaign automation tool makes API calls to Miso with the user_id while sending out emails
  • Miso returns recommendations for the user_id
  • The campaign automation tool populates the template with the recommendations Miso returned

Before You Start

Integration: Iterable

Set up a Data Feed in Iterable

  • Go to Content -> Data Feeds from the menu bar
  • Create a data feed with URL ={{#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

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

Preview email with data

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

Don't forget: there are many parameters you can use to optimize and filter the results that Miso returns, such as fq , boost_fq , and diversification .
Read more in the deep dive

Integration: Braze

Set up a connected content tag

  • Add the following tag to your Liquid script:
{% connected_content{{${user_id}}}&fl=*
     :method post
     :headers {
       "x-api-key": "YOUR_SECRET_API_KEY"
     :save miso

Use recommendations in templates

  • Use Handlebars syntax to access recommendation results. For example:

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

Before You Launch

Using this API recipe as a starting point, test API calls to your engine in development.
If you haven't already, build pipelines to stream your real-time data updates to Miso via API. Your Miso solutions engineer is here to help with the integration.
Start using this API recipe to power the UX on your site in staging. If you need UX recommendations, ask your Miso solutions engineer about Bento .
Run an A/B test with Miso on simulated website traffic. If desired, your Miso solutions engineer can perform this test and provide a report.
If this is your first time launching with Miso, ask your Miso solutions engineer to unlock your production environment.
Replicate your Data and Engine API calls on production and set up the same engine in your production environment in Dojo.
Review your data and engine performance in Dojo.
Turn on this recipe for a percentage of your users and scale up to a full rollout. Notify your Miso solutions engineer who will monitor the launch metrics.

API Reference


Need more info on the API? Check out our dedicated API page with all the info you could ever want.

Read API Reference
Icon/Activity Icon/Add Icon/API Icon/Arrow/Down Icon/Arrow/Left Icon/Arrow/Right Icon/Arrow/TopRight Icon/Arrow/Up Icon/Bento Icon/Billing Icon/Bin Icon/Book Icon/Bookmark/Default Icon/Bookmark/Filled Icon/Calendar Icon/Caret/Down Icon/Caret/Up Icon/Chavron/DownIcon/Chavron/LeftIcon/Chavron/RightIcon/Chavron/UpIcon/Checknox/CheckedIcon/Checknox/Unchecked Icon/Checklist Icon/Chip Icon/Clipboard / Copied Icon/Clipboard/Default Icon/Clock/Stopwatch Icon/CMD Icon/Data/Catalog Icon/Data/Engine Icon/Data/Group Icon/Data/Interact Icon/Data/Users Icon/Dive Icon/Docs/Key Icon/Dojo Icon/Email Icon/Env/Development Icon/Env/Playground Icon/Env/Prod Icon/Folder Icon/Fullscreen/Collapse Icon/Fullscreen/Expand Icon/Guides/Multiple Icon/Guides/Single Icon/Hashtag Icon/Heart/Outline Icon/Heart/Solid Icon / Cart z Icon / Click Icon / Clock Icon / Data Icon / Doc Icon / EmptyCart z Icon/Social/Facebook Icon / Genome Incognito Icon / Money Icon/Social/ProductHunt Icon / Search Icon/Social/Twitter Icon / User Icon/Info/Error Icon/Info/Info Icon/Info/Question Icon/Info/Warning Icon/Interact/Download Icon/Interact/Edit Icon/Interact/External v2 Icon/Interact/External Icon/Interact/Filter Icon/Interact/Logout Icon/Interact/Options Icon/Interact/Re-order Icon/Interact/Reload Icon/Interact/Remove Icon/Interact/Replace Icon/Interact/Search Icon/Interact/Shuffle Icon/Interact/Undo Icon/Interact/Upload Icon/Interact/Video Icon/Invoice Icon/Loading Icon/Loading Icon/Lock/Locked Icon/Lock/Unlocked Icon/Lock Icon/Mapping Menu Icon/Notification Icon/Overview Icon/Person/Team Icon/Person/User Icon/Plan/Enterprise Icon/Plan/Growth Icon/Plan/Startup Icon/Plan/Trial Icon/Recipe Icon/Rocket Icon/Settings/App Icon/Settings/User Icon/Settings Icon/Shrine Icon/Sidebar/Close Icon/Sidebar/Open Icon/Slideout Icon/Sort/Ascending Icon/Sort/Default Icon/Sort/Descending Icon/Star/Filled Icon/Star/Outlined Stopwatch Icon/Support Icon/Tag Icon/Interact/Thumb/Dislike Icon/Interact/Thumb/Like Icon/Tick Icon/Trend/New Icon/Trend/Trending Icon/Tutorial Icon/Lock/Unlocked Icon/View/Grid Icon/View/List Icon/Watchlist/Add