Client-Side Tags

Zaius empowers marketers to understand and act on customer behavioral data. This article describes how to configure Zaius in your Tealium iQ account.

Table of Contents Placeholder

Tag Configuration

First, go to Tealium's Tag Marketplace and add the Zaius tag to your profile (how to add a tag?).

After adding the tag, configure the below settings:

Tracker ID: Your Zaius-supplied Tracker ID.

Load Rules

Load Rules determine when and where to load an instance of this tag on your site.

Recommended Load Rule:

Data Mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see data mappings.

The destination variables for the Zaius tag are built into its Data Mapping tab. Available categories are:

Standard

Destination Name	Description
Tracker ID	Map to this destination to override or dynamically set the Tracker ID.

E-Commerce

Since the Zaius tag is e-commerce enabled, it will automatically use the default E-Commerce Extension mappings. Manually mapping in this category is generally not needed unless:

You want to override any extension mappings.
Your desired e-commerce variable is not offered in the extension.

Destination Name	Description
First Name (first_name)	Customer's first name on the order.
Last Name (last_name)	Customer's last name on the order.
Phone (phone)	Phone number associated with the order.
Shipping Address (order_ship_address)	Shipping address for the order in the following format: street1, street2, city, state, zip, country.
Billing Address (order_bill_address)	Billing address for the order in the following format: street1, street2, city, state, zip, country.
Order ID (order_id)	Unique identifier for this order. Use this to override the default e-commerce value `_corder`.
Order Total (order_total)	The total revenue for this order. Use this to override the default e-commerce value `_ctotal`.
Order Sub Total (order_subtotal)	The subtotal for the order. Use this to override the default e-commerce value `_csubtotal`.
Order Discount (order_discount)	The order level discount applied to the order.
Order Shipping Amount (order_shipping)	Shipping applied to the order. Use this to override the default e-commerce value `_cship`.
Order Tax Amount (order_tax)	The tax applied to the order. Use this to override the default e-commerce value `_ctax`.
Promo Code (order_coupon_code)	The coupon code used for the order. Use this to override the default e-commerce value `_cpromo`.
Custom Order Data Item (order_custom)	A custom data point applied to the order.
List of IDs (product_name)	The product identifier for each line item. Use this to override the default e-commerce value `_cprod`.
List of Names (product_name)	Use this to override the default e-commerce value `_cprodname`.
List of SKUs (product_sku)	The product SKU for each line item. Use this to override the default e-commerce value `_csku`.
List of Brands (product_brand)	The product brand for each line item. Use this to override the default e-commerce value `_cbrand`.
List of Categories (product_category)	The product category for each line item. Use this to override the default e-commerce value `_ccat`.
List of Quantities (product_quantity)	Quantity of product for each line item. Use this to override the default e-commerce value `_cquan`.
List of Prices (product_unit_price)	The price of each item at point of sale. Use this to override the default e-commerce value `_cprice`.
List of Discounts (product_discount)	The discount amount applied each line item. Use this to override the default e-commerce value `_cpdisc`.
List of UPCs (product_upc)	The product UPC for each line item.
List of Subtotals (product_subtotal)	The subtotal for each line item.
List of Custom Product Info (custom_product_info)	A custom product data point for each line item.

Events

Map to these destinations for triggering specific events on a page. To trigger an event:

Select an event from the dropdown list. You may choose from the predefined list or create a 'Custom' event. For a 'Custom' event, enter a name with which to identify it.
In the Trigger field, enter the value of the variable being mapped.
To map more events, click the + button and repeat steps #1 and #2.
Click Apply.

The event triggers when the supplied value is found in the data layer.

Destination Name	Description
Detail View (detail)	Visitor views an item detail page.
Add to Cart (add_to_cart)	Visitor adds an item to the cart.
Remove From Cart (remove_from_cart)	Visitor removes an item to the cart.
Purchase (purchase)	Visitor successfully completes the last step in the checkout process.
Return (return)	Visitor successfully completes a return on a previous order.
Refund (refund)	Visitor successfully completes a refund for a previous order.
Cancel (cancel)	Visitor successfully completes a cancelation on a previous order.
Identify (identify)	Add event association with visitor.
Anonymize (anonymize)	Remove event association with visitor.
Pageview (pageview)	Visitor views any page on your site.

Event Parameters

Map to these destinations if you wish to pass additional data with the event(s) you mapped earlier.

Note: Parameters are only used with pre-defined events. See Custom Event Data to learn how to pass a parameter with a custom event.

To pass a parameter with a pre-defined event:

Event: Select a Zaius event from the drop-down list.
Parameter: Select a Zaius Parameter from the dropdown list.
For a Custom parameter, enter a name with which to identify it.
Click +Add.

Destination Name	Description
Customer ID (customer_id)	The identifier of the customer associated with this event.
Email (email)	The email address of the customer associated with this event.
Category (category)	The category associated with this event. This can either be a flat category (Laptops) or hierarchical category using > as delimiters (Electronics > Computers > Laptops).
Search Term (search_term)	Search term for on-site search.
Paginate Result Count (paginate_result_count)	Number of results in a search pagination.
Paginate Page Number (paginate_page_number)	Page depth of search pagination.
Filter Field (filter_field)	Field name for search or navigation filter.
Filter Value (filter_value)	Field value for search or navigation filter.
Sort Direction (sort_direction)	Sort direction of results from search or navigation filter.
Sort Field (sort_field)	Sort field for results from search or navigation filter.
Carousel Page Number (carousel_page_number)	Page depth of carousel scroll.
Page (page)	The path of the URL requested.
Custom	Custom parameter to be passed with a predefined event.

Custom Event Data

Map to these destinations if you wish to pass a custom parameter with a custom Event that you mapped in the Events tab.

To map a Custom Event Data variable:

Event Action: Enter the name of the Custom Event exactly as specified in the Events tab.
Parameter: Enter the name of the parameter you wish to send.
Click +Add.

Vendor Documentation

JavaScript Reference