Braze

JustAI can ingest engagement and custom event data exported from your Braze instance via a shared S3 bucket. This connection can contain all relevant custom metrics that you may want to track.

If you already have a Braze Current set up, you can forward some or all of the events back to JustAI to avoid setting up a new Braze Current.

Before You Start

• Identify your JustAI org slug (usually your company name in all lower case - feel free to ask us).

Template Setup (Braze Canvas)

1. In Braze, create a Canvas with an A/B split:
   • Control path uses your existing message.
   • Treatment path uses JustAI content via Connected Content.
2. In the treatment message, add a Connected Content call to JustAI:
   • Endpoint: https://worker.justwords.ai/api/generate/<org_slug>?template_id=<template_id>
   • Headers: X-Api-Key: <JUSTAI_API_KEY>
3. Use the JustAI response values in your message (for example, result.copy.vars.subject, result.copy.vars.preheader, result.copy.vars.body).
4. Record the Canvas ID, Step IDs, and Message IDs for control and treatment steps.

Configure the Template in JustAI

1. In JustAI, open the template and go to Integration Settings.
2. Select Braze and set:
   • Template type (Email, Push, In-App, Webhook)
   • Canvas ID
   • Control step/message IDs
   • Treatment step/message IDs
3. Save changes.
4. In Settings → Integrations, set your Braze API key and cluster so JustAI can sync metadata.

S3 Integration Steps

1. Create an IAM role for the export:
   1. Recommended Permissions: s3:PutObject, s3:ListBucket, s3:GetBucketLocation
   2. Share the ARN role with JustAI. JustAI team will grant read/write permissions to a shared S3 bucket.
2. Create a daily data export that writes data to this S3 bucket: s3://justwords-metrics-ingest/<org_slug> (be sure to replace the org_slug with your actual org name)

Proposed Data Schema

Here are the recommended Braze Currents configurations:

We can just re-export the Braze Current data as-is (Avro) back to JustAI, but in general, as long as we can partition the data by time (hourly) and use some common serialization format (gzip, parquet, etc), it should be fine. Braze Currents data are already partitioned by event type, so it should be straightforward to only sync a subset of events back to JustAI.

We are not prescriptive on what you use to export data to our S3 bucket, but common patterns are Spark jobs, Redshift queries, Databricks jobs, etc.