Acoustic Digital Analytics Tag: Mapping Toolbox

[#1]

Learn about the available data mapping options in the Acoustic Digital Analytics tag in Tealium iQ.

In this article:

• Overview
• Data Tags and Mappings
• Mapping Toolbox
• Data Mapping Sections
• Events
• Page View
• Product View
• Cart View (ShopAction5)
• Order (ShopAction9)
• Registration
• Conversion Event
• Element
• Manual
• Config

Overview

Before you begin mapping data layer variables, be sure to add the E-Commerce Extension. This automatically maps the required e-commerce variables for events such as Product View, ShopAction5, and ShopAction9.

Data Tags and Mappings

Acoustic Digital Analytics' Data Tags are functions that organize the data it receives. Custom metrics called "Attributes" are available for each function call. Attributes are stored in numbered variables (generally between 1-100) for most functions and will have a nomenclature of something like pv_a1…pv_a100 (Page View Attributes 1-100) in the tracking call.

Related: Acoustic Digital Analytics Pixel Parameters QA Cheatsheet

Use the tealium_event variable from your data layer to identify which Acoustic Digital Analytics events to associate with your Tealium tracked events.

Mapping Toolbox

The mapping toolbox is organized according to Acoustic Digital Analytics Data Tags, making it easy to select the destination to which you want to send data. Below is a full list of the variables available in each section.

Data Mapping Sections

Events

Begin by configuring the Events tab. These mappings control when to fire the various Acoustic Digital Analytics Data Tag functions.  Use the tealium_event variable (or another event variable) to determine which Data Tag function to fire.

To map events:

1. Select the Events category.
2. In the Value field, enter the value of the Tealium tracked event.
3. From the Trigger drop-down, select the matching event.
4. Click +Add. Repeat these steps to add addition event mappings.

Order

No mapping tab is available for this Data Tag. However, you must configure the E-commerce extension to fire this function on a page. The extension, if configured, automatically maps the _corder variable.

Data Tag: Order
Tagging Function: cmCreateOrderTag()
Description: This Data Tag captures the final order information such as Registration ID, order ID, order subtotal as well as shipping and handling. The function call should be sent on the purhase confirmation page. Only one Order function should be called per order. When the E-Commerce extension variable Order ID ( _corder ) is populated, this function will run automatically.

Page View

Acoustic Data Tag: Page View
Tagging Function: cmCreatePageViewTag()
Description: This Data Tag captures page information as the visitor navigates the site. The function should be called on every page where you want to measure a page view.
Mappings: Use the Mapping toolkit to map the below destination variables:

• Page ID (pi) - alphanumeric identifier of the page
• Page Category (cg) - category to which the page belongs
• Search String(si) - search keyword used to generate the search results page
• Search Results (sr) - Number of results returned by the keyword search
• Attribute variables pv_a1 through pv_a10
• Extra Field variables pv1 through pv10

Product View

Data Tag: Product View
Tagging Function: cmCreateProductViewTag()
Description: This Data Tag captures information about the views received by the product. To track views of multiple related product details, more than 1 ‘Product View’ function call may be sent from a single page.
Mappings: Use the Mapping toolkit to map the Product Virtual Category (cm_vc) and all Attribute variables ('pr_a1' through 'pr_a10').

The E-Commerce Extension, if configured, automatically maps:

• _cprod to Product ID (pr), unique identifier of the product
• _cprodname to Product Name (pm), name of the product being viewed
• _ccat to Product Category (cg), category to which the product belongs

Cart View (ShopAction5)

Data Tag: ShopAction5 (Cart View)
Tagging Function: cmCreateShopAction5Tag()
Description: This Data Tag captures data about the selected products and which products are present in the shopping cart. The function should be called for each product in the cart (3 items in the cart = 3 Shop Action 5 function calls).
Mappings: Use the Mapping toolkit to map all Attribute (s_a1 through s_a10) and Extra Field (sx1 through sx10) variables.

The E-Commerce Extension, if configured, automatically maps:

• _cprod to Product ID (pr) - unique identifier of the product
• _cprodname to Product Name (pm) - name of the product viewed in the cart
• _cquan to Product Quantity (qt) - quantity of the product viewed in the cart
• _cprice to Product Price (bp) - unit price of the product
• _ccat to Product Category (cg) - category to which the product belongs

Order (ShopAction9)

Data Tag: Shop Action 9 (Products Ordered)
Tagging Function: cmCreateShopAction9Tag()
Description: This Data Tag captures information about the product purchased by the visitor. The function call should be made on the Receipt or the Confirmation page for each line item in the order. Anytime the Tealium E-Commerce Extension Order ID variable (_corder) is populated, this function will automatically run.
Mappings: Use the Mapping toolkit to map all Attribute (o_a1 through o_a10) and Extra Field (or1 through sx10) variables.

The E-Commerce Extension, if configured, automatically maps these ShopAction 9 variables:

• _ccustid to ShopAction9 Registration ID (cd), unique registration code. If you do not map anything to this destination either through the E-Commerce Extension or manually through the Mapping Toolbox, then Tealium maps the session ID from the utag_main cookie to this destination automatically.
• _corder to ShopAction9 Order Number (on)
• _csubtotal to ShopAction9 Order Subtotal (tr)
• _cprod to ShopAction9 Product ID (pr)
• _cprodname to ShopAction9 Product Name (pm)
• _cquan to ShopAction9 Quantity (qt)
• _cprice to ShopAction9 Product Price (bp)
• _ccat to ShopAction9 Product Category (cg)

and these Order variables,

• _cship to Order Shipping Amount (sg)
• _ccity to Order City (ct)
• _cstate to Order State (sa)
• _czip to Order Zip/Postcode (zp)

Registration

Data Tag: Registration
Tagging Function: cmCreateRegistrationTag()
Description: This Data Tag tracks registration events on the site and collects the visitor's demographic information (zipcode, city, state, etc.) and email address provided as part of the registration. If you don't use the E-Commerce Extension, Tealium uses either the value mapped to ShopAction9 Registration ID or the session ID from the utag_main cookie.
Mappings: Use the Mapping toolkit to map the Registration Email (em) and all Extra Field (rg1 through rg10) variables.

The E-Commerce Extension, if configured, automatically maps:

• _ccustid to Registration ID (cd). If you don't use the E-Commerce Extension, then Tealium uses either the value mapped to ShopAction9 Registration ID or the session ID from the utag_main cookie.
• _ccity to Registration City (ct)
• _cstate to Registration State (sa)
• _czip to Registartion Zip/Postcode (zp)
• _ccountry to Registration Country (cy)

Conversion Event

Data Tag: Conversion Event
Tagging Function: cmCreateConversionEventTag ()
Description: This Data Tag collects the non-monetary details of a conversion event. It is important to note that adding Conversion Event tags on load of high volume pages could inflate Server Call charges.
Mappings: Use the Mapping toolkit to map these variables:

• Conversion Event ID (cid) - unique identifier for the type of conversion
• Conversion Event Action Type (cat) - conversion event's initiation or successful completed
• Conversion Event category ID (ccid) - category of Event IDs
• Conversion Event Points (cpt) - points assigned to the conversion to measure its value
• Attribute variables c_a1 through c_a10
• Extra Field variables cx1 through cx5

Element

Data Tag: Element
Tagging Function: cmCreateElementTag
Description: This Data Tag tracks visitors' interaction with dynamic elements on your site. Examples of dynamic element include videos, hover-overs, error messages, feature selectors, etc.
Mappings: Use the Mapping toolkit to map these variables:

• Element ID (eid) - unique identifier of the element being tracked
• Element Category (ecat) - category to which the element belongs

Make certain that you map a different data source to Conversion Event ID (cid) than you do to Element ID (eid).

Manual

This section applies to three different Data Tag functions: Manual Link Click, Manual Page View, and Manual Impression.

Data Tag: Manual Link Click
Tagging Function: cmCreateManualLinkClickTag()
Description: This Data Tag captures links clicks which are not automatically tracked. Examples include,

• Links without HREF="" attributes or which otherwise use JavaScript to create navigation at time of click.
• Flash, Silverlight or other interactive application elements without HTML anchors.

Mappings: Use the Mapping toolkit to map the Manual Link Click/Page View/Impression destination variables:

• Manual Link HREF (hr) - href value of the link clicked
• Manual Link Name (nm) - name of the link clicked
• Manual Link Page ID (pi) - unique alphanumeric value identifying the page

Data Tag: Manual Page View
Tagging Function: cmCreateManualPageviewTag()
Description: This Data Tag captures page view events that don't have a page load event (e.g. modal pop-ups, etc.).

• Manual Page View Destination URL (ul) - the destination URL
• Manual Page View Referring URL (rf) - the referring URL

Data Tag: Manual Impression
Tagging Function: cmCreateManualImpressionTag ()
Description: This Data Tag captures ad impressions from a certain feature like a display ad tag.

• Manual Impression Page ID (pi) - the impression's Page ID matching the Link Page ID(pi)
• Manual Impression Track Real Estate (cm_re) - Real Estate Impression with a valid cm_re= value: “version-_-area-_-link”
• Manual Impression Track Site Promotion (cm_sp) - Site Promotion Impression with a valid cm_sp= value: “group-_-promotion-_-link”

Config

This tab does not correspond to any Data Tag function. Instead, you can use it to dynamically set the Acoustic Digital Analytics Tag configuration settings connected to a Test site/environment.

• Client ID (ClientID) - Acoustic Digital Analytics-assigned ID
• Test Client ID (TestClientID) - test site's Client ID
• Test Data Collection Method (TestDataCollectionMethod) - test site's Data Collection Method
• Test Data Collection Domain (TestDataCollectionDomain) - test site's data collection domain