JustAI + Iterable Integration

With the JustAI + Iterable integration, you can use JustAI to generate message variants, test them with your audience, and automatically shift traffic to the best-performing variants. JustAI content is inserted into your message templates at send time.

# In this article

# How the integration works

• Iterable calls JustAI through a data feed when it renders a message. JustAI returns the copy variant for that recipient.
• Your message template references the values that the data feed returns.
• An Iterable system webhook sends engagement events back to JustAI, such as sends, opens, clicks, and unsubscribes.
• JustAI uses events from Iterable to learn which variants perform best.

# What you can do with the integration

Use the integration to:

• Generate and test message variants, such as subject lines, body copy, and calls to action.
• Personalize generated content with fields from your Iterable user profiles and triggering events.
• Include your own conversion events, such as purchases or signups, in experiment results.
• Review performance in the JustAI console.

This article shows how to set up the integration and walks through one example. For the full list of capabilities, see the JustAI documentation.

# Set up the integration

You set up the integration once per Iterable project. JustAI maintains the data feed URL and the system webhook URL for your organization, so this article links to the JustAI documentation instead of repeating them.

# Before you start

Make sure you have the following:

• Permission to create API keys, data feeds, and system webhooks in your Iterable project.
• Your JustAI organization slug. If you're not sure what it is, contact JustAI.
• A JustAI API key, which you create in JustAI.

# Step 1: Set up Iterable

1. Create an Iterable server-side API key. Copy the key, and have it ready to enter in JustAI in the next step.

2. Create a data feed with the following settings:

   • Name: A name for the data feed.
   • URL: The data feed URL from the JustAI documentation for Iterable.
   • Template Handlebars Alias: jw
   • Format: JSON
   • Custom Headers: Add a header named X-Api-Key with your JustAI API key as the value.
   • Rate Limit (beta feature): Custom Rate, set to 1000 messages per second (or whatever rate limit you need for JustAI to process your messages).
     • If this setting is not available, talk to your customer success manager to enable this beta feature for your account. (For more information on this beta feature, see Data feed rate limit.)

3. Create a system webhook with the webhook URL from the JustAI documentation for Iterable. Select the engagement events you want JustAI to process (sends, opens, clicks, and unsubscribes) for all channels you intend to use with JustAI. Save and enable the webhook.

# Step 2: Finish setup in JustAI

JustAI needs the following to connect to your Iterable project:

• The Iterable server-side API key from Step 1.
• The ID of the data feed from Step 1. You can find the data feed ID on the Data Feeds page in Iterable.

Enter these values in the JustAI integration settings for Iterable. For the current steps, see the JustAI documentation for Iterable.

# Example: Test JustAI copy in an email campaign

This example shows one way to use the integration: testing JustAI copy against your existing copy in an email campaign.

To test JustAI copy against your existing copy, add an A/B Split tile to a journey. Connect two Email tiles to the split: one for the test campaign that uses JustAI copy and one for the control campaign that keeps your existing copy.

1. Double-click each Email tile to view its campaign ID. Copy the campaign IDs of the test and control campaigns.

2. In the template for the test campaign, connect the JustAI data feed:

   • Check Connect data feeds for dynamic template creation, and select the JustAI data feed.
   • Uncheck Cache Data Feed Response. This allows each recipient to receive different copy.
   • Check Use Data Feed Alias. This allows you to reference the data feed with the jw alias.

   

   For more information about these settings, see Using Data Feeds in Templates.

3. Reference JustAI values with double square brackets and the alias. For example, use [[ jw.copy.vars.subject ]] in the subject line and [[ jw.copy.vars.preheader ]] in the preheader. You can use JustAI variables in the subject, preheader, and body of the email. To learn how to pass JustAI values into snippets, see Using Data Feeds in Snippets.

4. In JustAI, create a template for the experiment. In the template's Iterable settings, enter the campaign IDs of your test and control campaigns. For the current steps, see the JustAI documentation for Iterable.

5. Save and publish the journey.

After the journey sends messages, go to the JustAI console to view results, edit your copy variants, and view performance insights.