Introduction
If you have decided to personalize your video, you'll need to connect your video to a data library. The data library, containing all the data fields that you can use for personalization, is the component that serves as a bridge between the video you're creating and your data source.
Data libraries are located on the account level, meaning that you can access any data library created by users of your account. Your account will most likely have a number of data libraries from which you can select the one that best suits your video. When deciding which data library to use, consider the following:
- Is the data library connected to the source in your company that holds the data set pertaining to your audience?
- Does the library have the data fields that I need to personalize my video?
If your account has a data library with the appropriate connector and the majority of data fields that you need, you can always add the additional fields that you need. We recommend that you not create redundant data libraries with the same data fields and connector. This will cause unnecessary bloat in your account.
You can edit the data fields in an existing library and, of course, create a new library from scratch when no existing library meets your needs.
When making any change to a data library—either to the data fields or to the data connector—always remember that any change will affect all the videos that have selected this data library. We recommend that you consider the implications carefully before making any change.
If this is the first time that you are selecting a data library, we recommend that you read Video Personalization—How It Works to familiarize yourself with the video personalization process from end to end.
Selecting a Data Library
1. |
Open the relevant video in the Studio. |
2. |
Select Data in the sidebar. |
|
|
A list of all the data libraries in your account is displayed. |
|
|
|
3. | As you scroll through the list to locate the library you want to use, note the following information displayed by each library: |
|
|
Data library name
Data connector attached to the library
The videos currently using this data library. If there are multiple videos, hover over the list to see all the names.
A description of the data library (if exists)
The data fields included in the library
|
|
4. | After you locate the data library that you want to use, select the library by clicking the circle in the upper right corner and then clicking Select at the bottom of the page. ▶ A video can be connected to only one data library. |
|
|
5. | Review the data fields in the library to make sure that they match your requirements. See Data Library Structure for detailed information. |
|
|
6. | (Optional) Create new data fields that you need for your video. |
7. | Click Done at the bottom of the page to confirm the selection. |
After you have used the data fields to personalize content in the video, the Data & Personalization section on the video page is updated with the name of the data library and data source type. |
|
Data Library Structure
Before deciding on the data library that you want to use, you can carefully review its components to make sure that it suits the personalization you are implementing.
Inside the data library, you can also add, edit, and remove data fields.
Warning:
A data library can be connected to more than one video. Before making any change, take into consideration how it will affect all the relevant videos and proceed with caution.
Status | |
The icons in this column indicate the status of the data field. | |
Data field is mapped. | |
Data field is in use but not mapped. | |
Data field is not in use and is not mapped. |
The name of the data field so that it can be identified easily.
When a data field has been defined to include values (for audience messaging or voice-over personalization), they are displayed here. The values in the data library and the values received from the data source must match exactly. Hovering over the content displays the full list of values.
Information regarding the videos currently using this data library can be accessed from this column. Clicking the link displays a window similar to the example below:
Inside the window, you can see the name of the video in which the data field is currently being used and in which scenes. Clicking the arrow in the center opens this video in a new tab.
If the data field has been designated as a field that contains personally identifiable information, it will be indicated here.
Clicking the three-dot menu provides access to the Edit and Delete actions.
Removing a Data Library
You will need to remove a data library if you want to switch to a different data library or if you decide that you no longer want to personalize the video.
A data library can only be removed if the data fields it contains are not used in any of the video's scenes. After removing all the data fields from the video, the data library can be removed.
For your convenience, you can refer to the Used in videos column inside the data library to see where the data field is being used.
To remove a data library:
1. |
Open the relevant video in the Studio. |
2. |
Select Data in the sidebar. |
3. |
Review the data library to make sure that it is not being used by any video. |
4. |
Click the three dots in the upper right and then click Remove library from video. |
|
|
5. |
If you are sure that you want to remove the library, click Remove Library From Video. |
|
|
If the data library is no longer being used in any video, you can delete the library completely. |
|
|