This guide will show you how to embed your Flowbox Email Assets in your emails to enhance your personalized, product-specific email campaigns in Voyado's Design Studio.

First of all, if you're not familiar with how to set up an Email Asset, it's a good idea to read this general article first.

What are Flowbox Email Assets?

Email Assets are a set of dynamic images and links that enable you to create more authentic emails that incorporate the freshest user generated content (UGC) you have collected and moderated in Flowbox.

Email Assets is offered as an add-on service. If you want to activate this feature, please contact your CSM to discuss your plan.

Creating an Email Asset for Voyado

To create a new Email Asset, go to the "Visual Marketing tab" in Flowbox and under "Distribution" you will find the Email Assets section.

Click on the "New Asset" button and select your Asset type.

If you want to create an Asset that fetches any kind UGC from any Flow, choose "Dynamic Asset".
If you want to create an Asset that fetches UGC content from a specific product, choose "Dynamic Product Asset". This option is meant to be used for "abandoned cart" emails or to showcase UGC that matches the products that the user might have purchased.

Finish the setup and the Email Asset links will be generated.

Add your Product identifier

When creating a Dynamic Product Asset, you will be asked to type the variable that contains your product identifier in Voyado. You will only need to find and add this information once. You can also manually add this identifier directly into the links if you want. One such example could look like the following one:

[[cart.Items(0).ProductData.Id]]

Creating a Custom Data Source in Voyado

Once your Dynamic Asset is created in Flowbox, you can now log into Voyado.

The full process is detailed in Voyado's documentation:
https://help.engage.voyado.com/hc/en-gb/articles/23601359145628-Flowbox

In there, you can create a new custom data source in the "Configure Engage" section. This data source requires the following parameters:

Name: You can use any name you prefer, such as "Flowbox". This will be used for the module generated in Design Studio.
ID: It's mandatory to use "flowboxdynamic"

Then, you will need to enable the "Parameters" section. Copy & paste the following JSON code under the "Input JSON schema" field:

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "title": "Parameters",
    "properties": {
        "flowboxId": {
        "title": "Email asset ID",
            "type": "string"
        },
        "flowboxEndpoint": {
        "title": "URL endpoint",
            "type": "string"
        }
    },
    "required": [
        "flowboxEndpoint", 
        "flowboxId"
    ]
}

Next, drag and drop an image placeholder into your email template, and then insert the image and URL links in the fields on the right, as shown below.

Once done, you can save the changes.

Set up the Flowbox module in Design Studio

Access Design Studio. From there:

You will need to find your automation (i.e.: "abandoned cart") and edit the email template.
Go to "Starter library".
You will see your previously created module under the "Partner" category.
Drag this module onto your email canvas

Click on "Settings". You will need to fill in the following fields:

Email asset id: UUID meant to identify your Email Asset.
Url endpoint: In here, copy and paste the first image link available in your Email Asset

To get your Email asset ID, you will need to open your Email Asset in Flowbox and check the "Embed" tab. In there, you should be able to see this kind of URL:

https://wuhg3bmvk0.execute-api.eu-west-1.amazonaws.com/Prod/email_asset/6afr4c6e-2ba9-4bea-8969-8f642673de6f/image/0

You can use this link for the "Url endpoint" option. Once added, copy the long ID in the middle. In the example above, that means the 6afr4c6e-2ba9-4bea-8969-8f642673de6f part. Then, add it into the "Email Asset id" field. This ID will be the link between the selected Flowbox Email asset and your email.

Preview and test

After adding this, the images should appear when when you use Preview with data in Design Studio. Now the module can be styled as any other module and saved in your team library for use in sendouts. We also strongly recommend testing your abandoned cart email.

When creating a sendout, use your Flowbox module from the team library. If necessary, change the Email Asset ID parameter to the value you need.

Flowbox Email Assets work well in abandoned cart emails, but can also be used to enrich other campaigns including order confirmation, complete the look, etc.