Managing the SundaySky Data Element Library

Introduction to the SundaySky Data Element Library

Once you have decided that you want to personalize your video, you're ready to set up the data element library.

The library is a collection of data elements that are used to personalize content. It helps to think of a data element as the entity by which you want to create personalization. The data element that you create in the SundaySky data element library correlates directly to the data field that exists in your source data record. When the video is published, the value that is in each record is passed to SundaySky and displayed according to viewer.
A data element can hold a value that is unique to each viewer such as first name, or it can represent an attribute—for example, department—that can hold several values (Finance, HR, Product).

SundaySky supports two methods of personalization: 1:1 Personalization and Audience Messaging. Following are descriptions of each method.

1:1 Personalization
How is it used?	Data from the source data record is inserted into the video.
Example	Hi {first name}!
How do I implement in the data element library?	In most cases, you'll only need to create a data element that represents the content that you want to personalize. For the example above, you would create a data element called First Name.
Special guidelines	If you are implementing 1:1 personalization in a voice-over narration, you'll need to create a data element and the possible values that the data element can have. For example: If you are narrating Thank you for purchasing the {plan name} plan you would create a data element called Plan Name together with the possible values that this data element can have (gold, silver, platinum).
Audience Messaging
How is it used?	The video is personalized for a specific audience segment according to a value that exists in the source data record.
Example	The on-screen text displayed to the viewer is based on the age group to which the viewer belongs.
How do I implement in the data element library?	You'll need to create a data element that represents the audience attribute, together with the values that this attribute can have. For the example above, you would create a data element called Age Group together with the possible values that this data element can have (Gen Y, Gen Z, Baby Boomer).

The data elements that you create need to represent actual data that exists in your company records. If you create a data element for a viewer's first name, the first name of your viewer needs to exist in the data source that you will connect to your video.

If you are creating a video using a Story Template, the library is populated automatically with the data elements relevant to the personalization that you chose. Nevertheless, you can add, edit, and remove data elements as you wish.

---

Adding a Data Element

1.	Access the relevant video.
2.	Select Data in the sidebar.

The data element library is opened. Note that id, a system data element, is added automatically. This data element, used for reporting purposes, cannot be deleted.

3.	Click +Add Element.

4.	Type the name of the data element.

5.a.	(Optional) If this data element is being used for audience messaging or in a voice-over narration, add all the values that this data element can have. To begin, position your cursor in the Type value field on the right side of the page.

5.b.	Type the name of the first value and then click +Add to enter all the values that you need. ▶ Data element and value names are case-sensitive. For example: entering Product followed by product creates two different values. ▶ If the data element requires many values, you may prefer adding them using a spreadsheet. See Importing a File into the Data Element Library to learn how.
	Note: There is a maximum limit of 2,000 values per data element. In regards to narration: a value that is not included in the value list will trigger the default narration sentence.

5.c.	Click Add.

The data element (with values, when relevant) is added to the library.

6.	Click Done to close the window.
You are now ready to begin personalizing your video. In the example below, the data element Department Name (as defined in the data element library with the relevant values) is ready to be used for audience messaging.

---

Editing a Data Element

1.	Select the data element that you want to edit.

2.	Click the pencil icon by the data element name.

3.	Edit the data element name as required.
4.	Click Save.
The data element name is updated.

5.	Click Done to close the window.

---

Editing Data Element Values

If a data element in your library includes values, you may need to edit them or add new ones.

1.	Select the data element whose values you want to edit.

The associated values are displayed on the right side of the page.

2.	Click Edit on the right side of the page.

3.	Edit the values using the following options: (a) Click +Add to add a new value; (b) Click the pencil icon to edit an existing value. ▶ If you need to make a lot of changes to the values, you may prefer adding a new list using a spreadsheet. See Importing a File into the Data Element Library to learn how.

4.	After you have finished making all the changes, click Save.

---

Deleting a Data Element

A data element can only be deleted if it is not being used in a scene. You'll need to remove the data element from the scene before you can delete it from the data library. For your convenience, you can refer to the data library to see in what scenes the specific data element is being used in.

1.	Select the data element that you want to delete.

2.	Click the trash icon at the end of the row.

3.	If you are sure that you no longer need the data element, click Delete.

The data element is deleted.

---

Deleting a Data Element Value

You can delete a value that you are no longer using. Note that there are two cases in which, when deleting values, you will need to keep at least one of them:
a) the data element is being used for audience messaging
b) the data element is being used for 1:1 personalization with narration

Just like for data elements, you can refer to the data library to see what values are being used in which scenes.

1.	Select the data element that is associated with the value that you want to delete.

2.	Click Edit on the right side of the page.

3.	Click the trash icon by the values that you want to delete.
4.	Click Save.
The list of values is updated.