SEEN
SEEN’s personalized videos has helped companies reach unmatched attention and engagement, throughout their customer journey. Personalize videos with SEEN in three simple steps:
1. Design a video around your data.
2. Personalize it at scale in the cloud.
3. Distribute it where it works best.
Use cases
SEEN offers automated video personalization across the entire the customer journey. Common uses include Onboarding, Loyalty, Sign-ups/Conversion, and Win-back/Anti-churn.
Prerequisites
Before you start, you’ll need the following:
Prerequisite | Description |
---|---|
A SEEN campaign | A SEEN campaign is required to take advantage of this partnership. |
Data source | You’ll need to send data to SEEN to personalize your videos. Make sure you have all relevant data available in Braze, and that you pass data with braze_id as the identifier. |
Braze Data Transformation Webhook URL | Braze Data Transformation will be used to reformat the incoming data from SEEN so it can be accepted by Braze’s /users/track endpoint. |
Rate limit
The SEEN API currently accepts 1000 calls per hour.
Integrating SEEN with Braze
In the following example, we will be sending users data to SEEN for video generation, and receiving a unique landing page link and a unique, personalized thumbnail back to Braze for distribution. This example uses a POST webhook to send data to SEEN, and data transformation to receive the data back to Braze. If you have multiple video campaigns with SEEN, repeat the process to connect Braze with all video campaigns.
If you experience any issues, you can reach out to your Customer Success Manager at SEEN for assistance.
Step 1: Create a webhook campaign
Create a new Webhook Campaign in Braze. Give your campaign a name, then refer to the following table to compose your webhook:
Field | Details |
---|---|
Webhook URL | Use the following webhook URL. You will receive your campaign_slug from SEEN to call the correct endpoint.https://api.seen.io/v1/campaigns/{campaign_slug}/receivers/ |
HTTP Method | Use the POST method. |
Request body | Enter your request body in raw text similar to the following.
For more information, see SEEN API. |
Request headers | Use the following information to fill out your request headers: - Authorization: Token {token} - Content-Type: application/json You will receive your Authentication Token from SEEN. |
You can now test the webhook with a user by switching to the Test tab.
If everything works as intended, go to Braze and set the rate at which the campaign sends to 10 messages per minute. This ensures that you won’t exceed the SEEN’s rate limit of 1000 calls per hour.
Step 2: Create data transformation
- Create new Custom Attribute fields for
landing_page_url
andemail_thumbnail_url
. These are the two attributes we will be using in this example. - Open Data Transformation tool under Data Settings, and select Create transformation.
- Give your transformation a name, then choose Start from scratch and set Destination to POST: Track users.
- Select Share your Webhook URL with SEEN.
- You can use the code below as the starting point for the transformation:
1
2
3
4
5
6
7
8
9
10
11
let brazecall = {
"attributes": [
{
"braze_id": payload.customer_id,
"_update_existing_only": true,
"landing_page_url": payload.landing_page_url,
"email_thumbnail_url": payload.email_thumbnail_url
}
]
};
return brazecall;
If you want to include other data, make sure to include those as well. Remember to discuss with SEEN as well so that the callback payload includes all needed fields.
- Send a test payload to the provided endpoint. If you want to use the callback payload defined in the SEEN documentation, you can send this yourself via Postman or another similar service:
1
2
3
4
5
6
7
8
9
{
"customer_id": "101",
"campaign_slug": "onboarding",
"landing_page_url": "your.subdomain.com/v/12345",
"video_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/output.m3u8",
"thumbnail_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/thumbnail.jpg",
"email_thumbnail_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/email_thumbnail.jpg"
}
- Select Validate to make sure everything works as intended.
- If everything worked as intended, select Save and Activate.