Creating a New Data Library

Overview

The data library is the core component required to personalize a video. A data library stores the data fields and corresponding values that enable personalization across video scenes. In addition to personalization within scenes, data fields are also required for changing the default logo in a scene and applying a brand by audience.

In addition to holding the data fields and values, the data library is also the component to which you attach a data connector.

Finally, the data library is the entity in which you map the SundaySky data fields to the data source in your company.

The SundaySky Help Center includes comprehensive articles for personalizing a video, according to the data connector that you are using. In each of these end-to-end articles, you'll see that creating a data library—or selecting or duplicating an existing one—is the first step in the process. In this article, you will find instructions for creating a data library from scratch as well as guidelines for updating an existing library.

---

Key Points

Following are the key points on how a data library operates in the SundaySky platform:

• A SundaySky account can have multiple data libraries, all of which are available to all users of your account.
• Having the data libraries at the account level means that the same library can be used for multiple videos, saving you much time and effort. Reusing existing libraries instead of having to create a separate data library for each video also reduces reliance on IT resources.
• A data library can have only one data connector.
• A video can use only one data library.

---

Understanding Data Fields and Values

Before you create a new data library, you should have a good understanding of how you plan to personalize the video. See Video Personalization—How It Works to learn about the three methods of personalization that SundaySky supports: 1:1 personalization via a personalization token, Message by Audience, and show/skip scene.

Depending on the personalization method and content type, you'll create either just a data field or a data field along with its corresponding values. The table below displays the requirement for each combination:

Content Type	Personalization Method
	Personalization Token	Message by Audience	Show/Skip Scene
On-screen text	Data field only	Data field and values	Data field and values Content type is not relevant when using this personalization method
Narration	Data field and values	Data field and values
Media	Data field only	Data field and values
Button	Data field only	Data field and values

In the table below are examples of data fields and values created in the data library for various types of personalization:

Personalization Type	Data Field	Values
On-screen text using a Personalization Token	First Name	not required
Narration with Message by Audience	Card type	Gold Silver Platinum
Button with Message by Audience	Age group	Gen X Gen Y Gen Z Boomer
On-screen text with Message by Audience	Department	Marketing Finance HR

Before creating a data field, make sure that the corresponding data exists in your data source. For example: if you want to personalize a scene according to the viewer's department, that information needs to exist in your company records.

---

Creating a New Data Library

1.	Access the relevant video in the Studio.
2.	Select Data in the sidebar.
3.	Click + Create New Library.
4.	Enter a name for the new library.
5.	(Optional) Enter a description for the new library. ▶ A description helps users decide if a library is suitable for their personalization needs.
6.	Click Create.
	The new data library is displayed. Note that two data fields, Viewer Device and Viewer Mobile Device OS, are added automatically to the data library and can be used for personalization.
7.	Next, add the data fields.

---

Adding a Data Field

Before adding the data fields, note the following:

• We recommend that you not create data fields to hold sensitive information including, but not limited to, the following: passwords, financial account information, personal health information, ID and Social Security numbers.
  
  
• The instructions in this article apply to adding data fields and values manually. If you prefer, you can also set up your library by uploading a file with all the data fields and values. See Importing Data Fields and Values into the Data Library to learn how.
  
  
• There is a maximum limit of 2,000 values per data field. If there are more than 2,000, only the first 2,000 will be created.

---

1.	Click Create Data Field.
2.	Enter a name for the data field. ▶ Data field names are case-sensitive. For example: entering Department Name followed by department name creates two different data fields.
3.	(Optional) Mark the PII checkbox if the data field pertains to personally identifiable information (see recommendation above). ▶ If you mark this checkbox, the data field will not be included in any analytics and data related to this field will never be stored.* * If you are using the File Upload data connector, data related to this field will be stored on a highly secure SundaySky server.
4.	(Optional) If you need to add values to the data field based on the personalization that is required, toggle the switch to Use values.
5.	(Optional) Enter the name of the first value and then click + (or ENTER) to enter all the values that you need. ▶ Value names are case-sensitive. For example: entering Product followed by product creates two different values. Make sure that the value exactly matches the value in your company records.
6.	Click Save.
	The data field is added to the data library.
7.	Repeat steps 1-6 to add additional data fields.
8.	After adding all the data fields, click Done to close the data library.

---

Editing a Data Field or Value

1.	Hover over the data field that you want to edit and then click the Edit icon at the end of the row.
2.	Edit any of the following: a. Data field name b. PII status (mark or unmark) c. Value name
3.	(Optional) Add a new value to the data field.
4.	Click Save.
	The data library is updated accordingly. Any draft video that uses this data library will now include the updated data fields.
5.	Click Done to close the data library.

---

Deleting a Data Field

A data field can only be deleted if it is not being used for personalization, changing a scene's default logo, or applying a brand by audience. If it is, you'll need to remove the configuration before you can delete the data field. Refer to the Used in videos column in the data library to see in which videos the data field is being used.

1.	Hover over the data field that you want to delete and then click the Delete icon at the end of the row.
2.	If you are sure that you no longer need the data field, click Delete.
	The data field is deleted.

---

Deleting a Data Field Value

Before you can delete a value, you'll need to remove it from any configurations where it's being used. As a reminder, values are used in the following personalization methods:

•	Message by Audience
•	Show/Skip Scene
•	Narration using a personalization token
•	Changing the default logo in a scene
•	Applying a brand by audience

Refer to the Used in videos column in the data library to see in which videos the data field values are being used.

1.	Hover over the data field associated with the value you want to delete and then click the Edit icon at the end of the row.
2.	Click the trash icon by the value that you want to delete.
3.	Click Save.
	The data library is updated accordingly.

---

Related Articles

Selecting an Existing Data Library
Using "Duplicate and Switch" to Create a Data Library
Removing a Data Library