Skip to content

Just Words Integration Guide

Just Words hyper-personalizes messaging at scale on lifecycle marketing channels, empowering you to dynamically test hundreds of variations and auto-refresh underperforming content.

When you use Just Words with Braze Connected Content to personalize your existing Braze campaigns and Canvases, Just Words will use Braze Currents to optimize the content dynamically—so you don’t have to.

What are the benefits?

After your integration is complete, you can leverage the Just Works platform to:

  • See real-time experiment results
  • Dynamically edit copy
  • View performance insights

Prerequisites

Integrating Just Words with Braze

Step 1: Create a Just Words template

  1. Go to your Just Words console and create a new template.
  2. Choose an easy-to-remember ID that uses letters, numbers, and underscores only.
  3. Fill out basic campaign details.
  4. Use AI to generate personalized variations.

The Just Words template creation platform.

Step 2: Create a Just Words API key

  1. Go to Org Settings > API Keys > Generate API Key.
  2. Copy and save the API key in a secure location.

The Just Words API key form.

Step 3: Use Just Words in your Braze content

Just Words works with Canvases and campaigns by using Connected Content. If you’re creating a Canvas, each email step should correspond to a unique Just Words template.

Step 3.1: Set up your A/B test

  1. In a Canvas, select Add Variant > Add Variant until you have your desired number of variants, and add steps to each variant (like an email Message step).
  2. Split the audience traffic as desired. For example, if you have two variants, you might give each one 50%. Or, you could have two variants with 40% each and a control group with 20%. For more information about A/B tests for Canvases, refer to Creating a Canvas.
  3. In the composers for the Message steps that you want to use with Connected Content, paste in the Connected Content snippet from Just Words Console, such as the following snippet.
1
2
3
4
5
6
7
8
9
10

{% connected_content https://worker.justwords.ai/api/generate/just-words?template_id=<test_id>&user_id={{${user_id}}}
  :save jw
  :headers {
    "x-api-key": <jw_api_key>,
    "Content-Type": "application/json"
  }
%}

{{jw.copy.vars.cta}}
{% message_extras :key copy_id :value {{jw.copy.id }} %}

Braze A/B test Canvas setup.

  1. In the Compose Messages step of your campaign, create two variants.
  2. In the Target Audience step, go to the A/B Testing section and modify the percentages of users who will receive each of your variants (and your optional control group). You can further customize your test by selecting an optimization option. For more information about A/B tests for campaigns, refer to Creating multivariate and A/B tests.
  3. In the message composer, paste in the Connected Content snippet from Just Words Console, such as the following snippet.
1
2
3
4
5
6
7
8
9
10

{% connected_content https://worker.justwords.ai/api/generate/just-words?template_id=<test_id>&user_id={{${user_id}}}
  :save jw
  :headers {
    "x-api-key": <jw_api_key>,
    "Content-Type": "application/json"
  }
%}

{{jw.copy.vars.cta}}
{% message_extras :key copy_id :value {{jw.copy.id }} %}

Step 3.2: Add personalization with custom attributes (optional)

To personalize your messages with custom attributes (such as industry), use the following Liquid format:

1
2
3
4
5
6
7
8
9
10

{% connected_content https://worker.justwords.ai/api/generate/just-words?template_id=<test_id>&user_id={{${user_id}}}&attrs.industry={{ custom_attribute.industry }}
  :save jw
  :headers {
    "x-api-key": <jw_api_key>,
    "Content-Type": "application/json"
  }
%}

{{jw.copy.vars.cta}}
{% message_extras :key copy_id :value {{jw.copy.id }} %}

Note that the custom attribute of industry is indicated by &attrs.industry={{ custom_attribute.industry }}.

Braze Liquid logic in an HTML message composer.

Step 4: Preview the email

Make sure to preview the email in Braze to confirm that the personalized content correctly renders.

Braze message preview for a Just Words email.

Step 5: Set up Braze Currents

Braze Currents enables performance tracking and optimization over time.

  1. In Braze, go to Partner Integrations > Data Export.
  2. Select Create New Test Current and then select Test Amazon S3 Data Export.

"Create New Test Current" dropdown with the option of "Test Amazon S3 Data Export".

  1. Enter the S3 Access ID, AWS Secret Access Key, Bucket name, and folder that were provided by Just Words during onboarding.

"Credentials" section for the AWS secret access key.

  1. Select the events to track, such as sends, opens, clicks, unsubscribes, conversions, and others.

"Message Engagement Events" section with events to select.

  1. Launch the Braze Current.

You’re all set! Now you can use Just Words with Braze Connected Content.

Github   Edit this page on GitHub
HOW HELPFUL WAS THIS PAGE?
New Stuff!