...
preezie integrates directly with the Emarsys APIs to automatically pass all of your preezie lead form information to your Emarsys account. This allows you to store and send preezie shoppers their product recommendations via email and add them to any marketing flows you have.
There are two three types of data available to do thissend to Emarsys,
(default) Pass Contact data only when submitting a journey lead form
Pass Contact and Product recommendations data when submitting a journey lead form, this requires an external event set up in your Emarsys account
(requires add-on) You can also use a hosted Emarsys relational database table to pass the questions & answer data in realtime
...
First, add your journey lead forms
The first step is to ensure you are capturing lead information at the end of your preezie journeys. If you haven’t already done this, see the Email Capture guide for more information. These are managed in your Journey Settings under the Signup Lead Form tab:
...
Contact and Recommendations data
1
...
.
...
Management > External Events > Create External Event
Give it a name of preezie recommendations
This gives you an ID that we’ll use in the next step.
https://help.emarsys.com/hc/en-us/articles/360010574114-Events-External-events
...
Connect your Emarsys account to preezie
You can now First, connect your Emarsys account to preezie.
First create Create a new API user in your Emarsys account with the correct permissions as below
Go to Admin > Security Settings > Create API user
Make sure you give it edit access to contact.create and externalevent.trigger as per: https://help.emarsys.com/hc/en-us/articles/4472770789649-Suite-API-endpoint-permissions
Now copy the
User name
andSecret
values and paste into your preezie CMS by going to Admin > Settings > Tenant settings > Emarsys IntegrationApi Key Name =
User name
Api Key Value =
Secret
...
- Change
If you only want to capture Contact data, change Data type to Contact data, you can ignore the Optional endpoint URL step below
If you want to capture Contact AND product recommendations data, change Data type to All data
In the Create Contact Endpoint Url paste this value:
2. Create an External Event for your Product Recommendations
Info |
---|
This step is optional, if you purely want to store Contacts only jump to step 2 below and ignore the use of the Optional endpoint URL field |
To store the production recommendations data you need to create an external event.
Management > External Events > Create External Event
Give it a name of preezie recommendations
This gives you an ID that we’ll use in the next step.
https://help.emarsys.com/hc/en-us/articles/360010574114-Events-External-events In the Optional endpoint URLfield paste this, but update the number 1234 to your External Event ID created above:
Make sure Data type is set to All data.
Check Active then Save Emarsys API integration.
3. Add a List ID (optional)
If you want your leads to go into a specific List, add the List ID into the List ID (Optional) field
...
Check Active then Save Emarsys API integration.
...
4. Testing your set up
Once active you can test your integration by using the Preview in the Journey edit menu:
...
Passing question and answer data
To store the question and answer data in realtime against your Contacts, you can use an Emarsys Relational Database. Please contact your Emarsys CSM to discuss this set up:
https://apihelp.emarsys.net/api/rds/…com/hc/en-us/articles/360002165413-Overview-Relational-Data-Overview
The fields passed in this API call are:
Field name | Format | Example |
---|---|---|
varchar (255) | test@preezie.com | |
page | int (11) | 1 (this is the question number that was answered) |
question | text | What is your budget? |
answer | text | Over $500 |
category | varchar (255) | TV finder (this is the journey name) |
submit_time | datetime | 2023-05-03 14:52:12 |
session_id | varchar (255) | c6c2ab7d-10c8-47c1-b3db (this is the user’s journey session ID) |
question_id | int (11) | 1 (also the question number that was answered) |
Once this has been set up you must add your custom RDS API url to the Custom Database Endpoint Urlfield field in the preezie CMS:
...
FAQs
I cannot see my test emails within Emarsys?
...