Publisher data layer specification
This article provides the data layer definition for publishers.
Data layer attributes
| Variable | Description | Example | Type |
|---|---|---|---|
click_category |
During click tracking events, the category of the element clicked | footer |
String |
click_label |
During click tracking events, the name of the element clicked | Submit |
String |
click_type |
During click tracking events, distinguish between different elements clicked | button |
String |
content_author |
The name of the author of the content | John Smith |
String |
content_id |
The unique ID of the page content | 38121 |
String |
content_publish_date |
The publish date of the page content, in format YYYY/MM/DD | 2015/02/09 |
String |
content_title |
The title of the content on the page | Top 7 Outdoor Sleeping Bags |
String |
country_code |
The two-character country code of the site | us |
String |
customer_city |
The customer’s city of residence | San Diego |
String |
customer_country |
The customer’s country of residence | United States |
String |
customer_email |
The customer’s email address | johnsmith@example.com |
String |
customer_first_name |
The first name of the customer | John |
String |
customer_id |
The unique customer ID (if not customer_email) |
8237572 |
String |
customer_is_logged_in |
A flag to indicate if the current user is logged in | 1 |
String |
customer_last_name |
The last name of the customer | Smith |
String |
customer_postal_code |
The customer’s postal code | 92101 |
String |
customer_state |
The customer’s state/province of residence | CA |
String |
customer_type |
Distinguishes between registered users and guests | guest |
String |
language_code |
The two-character language code of the site | en |
String |
page_friendly_url |
The canonical URL of the page, might be different than the URL in the browser location bar | /travel/national_parks |
String |
page_name |
The user-friendly name of the page | Homepage |
String |
page_number |
For paginated content or galleries, the current page number in view | 2 |
String |
page_type |
The Tealium variable to identify the type of page or template | content |
String |
search_keyword |
The search text entered by the user | Napa valley |
String |
search_results |
The number of search results returned | 42 |
String |
site_display_format |
The display format of the site in view | mobile |
String |
site_section |
The top-level section of your site | Travel |
String |
site_subsection1 |
The first level category of the page hierarchy | National Parks |
String |
site_subsection2 |
The second level category of the page hierarchy | California |
String |
site_subsection3 |
The third level category of the page hierarchy | Yosemite |
String |
site_subsection4 |
The fourth level category of the page hierarchy | Camping |
String |
slide_title |
On a gallery page, the title of the current slide in view | #2 Yellowstone |
String |
social_network |
During social share events, the name of the social network used | facebook |
String |
Tracked pages
Home Page
| Event Name | Description | Sample URL |
|---|---|---|
page_view |
The home page. | http://www.example.com/ |
Sample:
{
"country_code" : "us",
"customer_email" : "johnsmith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_is_logged_in" : "1",
"customer_last_name" : "Smith",
"customer_type" : "registered",
"language_code" : "en",
"page_friendly_url" : "/home",
"page_name" : "Homepage",
"page_type" : "home",
"site_display_format" : "desktop",
"site_section" : "Home",
"tealium_event" : "page_view"
}
Section Page
| Event Name | Description | Sample URL |
|---|---|---|
page_view |
A parent-category or top-level section page. | http://www.example.com/top-level/ |
Sample:
{
"country_code" : "us",
"customer_email" : "johnsmith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_is_logged_in" : "1",
"customer_last_name" : "Smith",
"customer_type" : "registered",
"language_code" : "en",
"page_friendly_url" : "/travel",
"page_name" : "Travel Home",
"page_type" : "section",
"site_display_format" : "desktop",
"site_section" : "Travel",
"tealium_event" : "page_view"
}
Category Page
| Event Name | Description | Sample URL |
|---|---|---|
category_view |
A category page, usually displaying a list of products. | http://www.example.com/top-level/sub-level/ |
Sample:
{
"country_code" : "us",
"customer_email" : "johnsmith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_is_logged_in" : "1",
"customer_last_name" : "Smith",
"customer_type" : "registered",
"language_code" : "en",
"page_friendly_url" : "/travel/national_parks/yosemite_camping",
"page_name" : "Homepage",
"page_number" : "2",
"page_type" : "category",
"site_display_format" : "desktop",
"site_section" : "Travel",
"site_subsection1" : "National Parks",
"site_subsection2" : "California",
"site_subsection3" : "Yosemite",
"site_subsection4" : "Camping",
"tealium_event" : "category_view"
}
Content Page
| Event Name | Description | Sample URL |
|---|---|---|
content_view |
A content page. | http://www.example.com/section/category/content.html |
Sample:
{
"content_author" : "Sue Smith",
"content_id" : "38121",
"content_publish_date" : "2015/02/09",
"content_title" : "Top 7 Outdoor Sleeping Bags",
"country_code" : "us",
"customer_email" : "johnsmith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_is_logged_in" : "1",
"customer_last_name" : "Smith",
"customer_type" : "registered",
"language_code" : "en",
"page_friendly_url" : "/travel/parks/ca/gear/bags.html",
"page_name" : "Camping Gear: Top Sleeping Bags",
"page_type" : "content",
"site_display_format" : "desktop",
"site_section" : "Travel",
"site_subsection1" : "National Parks",
"site_subsection2" : "California",
"site_subsection3" : "Yosemite",
"site_subsection4" : "Camping",
"tealium_event" : "content_view"
}
Gallery Page
| Event Name | Description | Sample URL |
|---|---|---|
content_view |
A page of content displayed as a gallery of slides. | http://www.example.com/section/category/gallery.html |
Sample:
{
"country_code" : "us",
"customer_email" : "johnsmith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_is_logged_in" : "1",
"customer_last_name" : "Smith",
"customer_type" : "registered",
"language_code" : "en",
"page_friendly_url" : "/travel/national_parks",
"page_name" : "Top Parks Gallery",
"page_number" : "2",
"page_type" : "gallery",
"site_display_format" : "desktop",
"site_section" : "Travel",
"site_subsection1" : "National Parks",
"slide_title" : "#2 Yellowstone",
"tealium_event" : "content_view"
}
Search Page
| Event Name | Description | Sample URL |
|---|---|---|
search |
A search results page. | http://www.example.com/search?query=term |
Sample:
{
"country_code" : "us",
"customer_email" : "johnsmith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_is_logged_in" : "1",
"customer_last_name" : "Smith",
"customer_type" : "registered",
"language_code" : "en",
"page_friendly_url" : "/search/napa_valley/",
"page_name" : "Search results for: napa valley",
"page_number" : "1",
"page_type" : "search",
"search_keyword" : "napa valley",
"search_results" : "42",
"site_display_format" : "desktop",
"site_section" : "Travel",
"tealium_event" : "search"
}
Tracked events
User Login
| Event Name | Description |
|---|---|
user_login |
Upon successful user login. |
Sample:
{
"customer_city" : "San Diego",
"customer_country" : "United States",
"customer_email" : "john.smith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_last_name" : "Smith",
"customer_postal_code" : "92101",
"customer_state" : "CA",
"tealium_event" : "user_login"
}
User Logout
| Event Name | Description |
|---|---|
user_logout |
Upon successful user logout. |
Sample:
{
"customer_city" : "San Diego",
"customer_country" : "United States",
"customer_email" : "john.smith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_last_name" : "Smith",
"customer_postal_code" : "92101",
"customer_state" : "CA",
"tealium_event" : "user_logout"
}
User Registration
| Event Name | Description |
|---|---|
user_register |
Upon successful user registration. |
Sample:
{
"customer_city" : "San Diego",
"customer_country" : "United States",
"customer_email" : "john.smith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_last_name" : "Smith",
"customer_postal_code" : "92101",
"customer_state" : "CA",
"tealium_event" : "user_register"
}
User Update
| Event Name | Description |
|---|---|
user_update |
Upon successful update of user profile information. |
Sample:
{
"customer_city" : "San Diego",
"customer_country" : "United States",
"customer_email" : "john.smith@example.com",
"customer_first_name" : "John",
"customer_id" : "8237572",
"customer_last_name" : "Smith",
"customer_postal_code" : "92101",
"customer_state" : "CA",
"tealium_event" : "user_update"
}
Email Signup
| Event Name | Description |
|---|---|
email_signup |
Upon successful signup for email newsletter. |
Sample:
{
"customer_email" : "john.smith@example.com",
"tealium_event" : "email_signup"
}
Custom Click
| Event Name | Description |
|---|---|
custom_click |
Tracking of specific click interactions with the page. |
Sample:
{
"link_category" : "Header",
"link_name" : "Login",
"tealium_event" : "custom_click"
}
Social Share
| Event Name | Description |
|---|---|
social_share |
Tracking of social media sharing actions. |
Sample:
{
"content_id" : "38121",
"page_friendly_url" : "/travel/national_parks",
"page_name" : "Travel: National Parks",
"social_network" : "facebook",
"tealium_event" : "social_share"
}
This page was last updated: March 5, 2026