How to Edit a Tealium Deployer Data Layer

[#1]

This article covers how to edit the Data Layer Recommendation in the Tealium Deployer tool. The Data Layer Recommendation is typically created by a Implementation Engineer during the initial phases of a new deployment or a redeployment. Once created the recommendation can be edited by those with access. The final recommendation should be reviewed and approved by both the Implementation Engineer and the Client prior to importing the variables into Tealium iQ Tag Management. 

In this article:

Table of Contents Placeholder

Data Layer Recommendation

The Data Layer Recommendation is divided into four parts, the Data Layer, Pages, Events, and Summary.

• Data Layer Tab: This tab contains a list of the variables to be imported into Tealium iQ Tag Management. Each variable has a Variable Name*, Type*, Example, and Description. These are the variables that will be used in the Universal Data Object (UDO) coded on a client's site.
• Pages Tab: This tab contains a list of all pages types found on a site. Each page includes the Tealium Event*, Example URL, Description, and a Screenshot URL. Below the list of page types is the Assignments matrix which is where variables from the Data Layer are assigned to their respective page types. 
• Events Tab: This tab contains a list of all events to be tracked on a site. The tab is structured similarly to the Pages tab. Each event includes the Tealium Event*, Description, and Screenshot URL. 
• Summary Tab: This tab is an overview of the Data Layer recommendation. The summary contains a read only link that can be shared with users who do not need access to make updates to the recommendation. There is also a summary of the Data Layer variables. The summary is then followed by code examples for the utag.js file and then examples of the UDO for each page type and event. 

_{* Required fields}

The examples values for utag_data are pulled from the examples found on the Data Layer tab and are not per page. Therefore, they may not be representative of the exact data for the page, but will indicate the correct format of the data i.e. an array or string. 

A Read Only Link is available from the Summary Tab to allow sharing of the Data Layer to users who do not need to make updates. 

Editing the Data Layer Recommendation

All fields in the Data Layer, Pages, and Events tabs are editable. To change any value simply click into the field to be changed and update the field to the new value. The Save button will illuminate indicating that a change has been made. Once all changes have been completed, click save. If navigating away from the page prior to saving, a prompt will appear with a notification that changes made will be lost. 

Edits made to the Data Layer Recommendation are not automatically imported into Tealium iQ. This is done via a manual process. The Deployment Engineer will do the initial import of the variables. 

Adding New Fields

Similar to adding items in Tealium iQ Tag Management, adding new data in Tealium Deployer is handled via wizards. Each respective section has a wizard tailored to the data needed for that item. 

Data Layer Variables

1. Click the Data Layer tab.
2. Click the Add Data Layer Element button.
3. Enter the name of the new variable. Only letters, numbers, underscores, dollar signs, array brackets, and periods are allowed as part of a variable name. For example, my_variable is allowed but my variable is not an allowed value.
4. Choose a Type for the variable, most will be a UDO Variable, the default. 
5. Optionally, and recommended, enter an Example and a Description of the new variable. 
6. Click Add if only adding one variable, or Add Another if more variables need to be added. To discard, click Cancel.
7. Click Save.

_{The wizards for the below sections look similar to the one pictured above for adding a Data Layer Element.}

Pages

1. Click the Pages tab.
2. Click the Add Page button.
3. Enter the new Tealium Event. Letters, numbers, underscores, dollar signs, array brackets, and periods are allowed as part of a Tealium Event. It is recommended to follow the similar naming conventions as the variables. For example, my_page is preferred over my page.
4. Optionally enter a URL for the page.
5. Optionally enter a Description and Screenshot of the page. An image can be pasted into the Screenhot field. The image will be uploaded automatically. 
6. Click Add if only adding one page, or Add Another if more pages need to be added. To discard, click Cancel. 
7. Click Save.

Events

1. Click the Events tab.
2. Click the Add Event button.
3. Enter the new event Tealium Event. Letters, numbers, underscores, dollar signs, array brackets, and periods are allowed as part of a event name. It is recommended to follow the similar naming conventions as the variables. For example, my_event is preferred over my_event.
4. Select the Type of event. For click events, choose Link, for manually triggered page views, choose View.
5. Optionally enter a Description and Screenshot of the event. An image can be pasted into the Screenhot field. The image will be uploaded automatically. 
6. Click Add if only adding one event, or Add Another if more events need to be added. To discard, click Cancel.
7. Click Save.

Assignments

The Pages and Events tabs have an Assignements table at the bottom of the page. This is where variables from the Data Layer are assigned to their associated pages and/or events. Clicking an individual cell will cycle through Required/Suggested/Blank.  Clicking on a variable name will cycle all cells in the row.  Clicking on an page or event name will cycle all cells in the column.

Assigning a variable to a page or event will add that variable to the examples in the Summary tab.

The Summary is updated everytime the Summary tab is clicked.

Once the variables have been assigned to the correct pages and events, Save the Data Layer recommendation.