Run

The Run tab is your hub for generating and delivering personalised videos. From here, you can create videos via API or by importing a CSV file, and set up webhooks to automatically deliver them to your system once generated.

You can also track your output directly in this view by monitoring both the total number of videos generated and trends over a selected timeframe.

Create via API

In order to create videos programmatically via API, you'll need to send data to your project's API endpoint. You will get your project's API details by clicking on the Create via API button.

More information can be found in the API documentation.

Import CSV

In order to create videos manually using a CSV file, you can either drag and drop a CSV file to the Import CSV field, or click on the button to open a file explorer.

You will be prompted to map the fields from your CSV to the properties used in your Project.

Property and column names do not need to match in order to be mapped, but they will be mapped automatically in case they match.

More information about the import can be found in Data Import Best Practices.

Confirm and generate

Generation does not start until you confirm the import. Once videos start generating, they can't be stopped, so the confirmation step lets you catch a mis-mapped column or the wrong file first.

1. Upload your CSV and map its columns to your Project's properties.
2. Click Generate N Videos, where N is the number of rows in your file. A confirmation window opens.
3. Check the summary: the number of rows that will become videos, and the warning that generation can't be stopped once it starts.
4. Check the mapping list: each CSV column and the Project property it fills. A property marked New doesn't exist yet, and the import will create it.
5. Type the row count into the box. This turns on Confirm and Generate.
6. Click Confirm and Generate.

Check for unexpected New badges

The New badge is the main thing to check. An unexpected New usually means a column header is misspelt, so the column creates a new property instead of filling the one you meant.

If you refresh the page after you upload the CSV but before you confirm, the row count may not be known. The window then skips the typing check, so read the summary carefully before you confirm.

If the request fails, the confirmation window closes and you're back in the mapping window with the error shown. Nothing has started, so you can fix the mapping and try again.

Send videos to your system

Seen can automatically deliver generated videos to your own infrastructure via webhook. Click + Add webhook to open the configuration modal, which is split into two tabs: General and Security.

You can find more information about what is required by your system by referring to your system's API documentation.

General

• URL (required) – The endpoint URL where Seen will send the webhook payload upon video generation.
• Method (required) – The HTTP method to use for the request. Defaults to POST.
• Headers – Custom HTTP headers to include with each request. A Content-Type: application/json header is preconfigured by default. Additional headers can be added via + Add a header.
• Request content – The JSON body of the webhook request. Use this to define the payload structure sent to your endpoint on each trigger.

You'll be able to include any personalisations you've added to the project in the URL, Header and the Request content. You also get access to the output of the video generation: Seen video player link, email thumbnail, and the regular thumbnail link.

Security

Seen supports four authentication methods for securing your webhook endpoint:

• No Authentication – The request is sent without any auth credentials.
• Basic Auth – Authenticates using a username and password.
• OAuth – Authenticates via an OAuth token exchange.
• JWT to Token – Authenticates using a signed JWT, exchanged for an access token before the request is made.

View Videos

You can access more options by clicking on View Videos.

When clicking View Videos you will get additional options such as viewing data in your project, status of the data that has already been received by the Seen platform, view already generated videos and more.

Left sidebar

On the left sidebar, you can choose if you want to view all videos or filter based on which origin the data is from: API or import. You will also be able to view the data of each individual imported file.

You can also view your exports, as well as the quota left on your Workspace.

Export data

You are also able to export data from this view by clicking on Export data.

Within the export modal, you have the following options on what to export:

• Filter data – Here you can choose to filter based on the origin, which import the data was a part of, and any project field values.
• Columns – Here you can choose which project fields you'd like to include in the export. You can also rename them to match what your system expects right away.
• Video outputs & metrics – Here you can choose which outputs and/or metrics you would like to include in the export, e.g. Seen video player link, email thumbnail link, etc.

Next steps

When you have started the distribution of your videos, move to the Insights tab to see the statistics of your personalised video campaign.