Challenger Video: Configuring Adobe Analytics in Tealium iQ

[#1]

In this video, Jason Paddock, Deployment Engineering Manager at Tealium, demonstrates how to configure the complex Adobe Analytics tag in four (4) easy steps. The example scenario uses a basic e-commerce site running on Magento.

For a full overview of this tag, see Adobe AppMeasurement for JavaScript Setup Guide for Tealium iQ Tag Management.

---

This article covers the following topics:

Table of Contents Placeholder

---

Step 1: Adding the Adobe Analytics Tag from the Tag Marketplace

Use the following steps to add the Adobe Analytics tag from the TiQ Marketplace:

1. Log into TiQ.
   
2. Click the Tags tab.
   
3. Click + Add Tag.
   
4. In the Search field, type Adobe.
   
5. Click + Add to select the Adobe Analytics AppMeasurement for JS tag.
   

   

Step 2: Adding Vendor Information for the Tag

Use the following steps to fill out the vendor information about the tag:

1. From the Tag Configuration tab, in the Report Suite field, type in or copy the value for the Report Suite.
   
2. In the Server field, enter the server address.
   
3. In the Server Secure field, reenter the secure server address.
   
4. In the Internal Link Filters field, enter a comma-separated list of internal domains into the field.
   

   

5. In the Namespace field, enter the visitor namespace.
   
6. Click Next to advance to the Load Rules tab.
   
7. Retain the default setting for Load All Pages.
8. Click Next to advance to the Data Mappings tab.

Step 3: Performing Data Mappings

In this step, data in the existing data layer is sent to the Adobe tag. In additon, you will configure the system to send search results and search keyword variables to specific destination properties, which is recommended for e-commerce sites with search capabilities.

Use the following steps to perform any necessary data mappings:

1. From the Data Mappings tab, in the Variables field, enter page_name and select this variable from the drop-down list.
   
2. Click + Select Destination.
   This step maps the page_name field to the appropriate Adobe field.
   
3. Select the pageName checkbox.
   The variable page_name is now mapped to the Adobe variable pageName .
   

   

4. Repeat these steps to map search_keyword to prop2 and search_results to prop3.
   
5. Click Finish.

Mapping Page Views to Events

In the next steps, you will trigger an event for when a user loads a certain type of page, such as a category page, search page, or product details page.

1. In the Variables field, enter page_type and select it from the drop-down list.
   
2. Click + Select Destination.
3. Under Category in the left navigation pane, click Events.
   The Event Triggers dialog displays in the right panel.
   
4. In the Value field, enter category.
   
5. In the Trigger field, select event1 from the drop-down list.
6. Click + Add.
   

   

7. Return to the Value field and repeat the steps to add search for event2 and product for ProdView.
8. Click Close.
   Your results now display as shown in the following example.
   

   

9. Click Finish.
   The update Adobe Analytics tag displays as follows:
   

   

Step 4: Adding doPlugins and Plugins and Modules as Extensions

In the final step, you will use the Adobe Analytics interface to add doPlugins and add plugins as modules.

Adding doPlugins as an Extension

Use the following steps to add the doPlugins received from Adobe Analytics as an extension within TiQ:

1. From the Adobe Analytics interface, click Admin > Code Manager.
   The Code Manager dialog displays a list of marketing cloud client libraries.
2. To download, click JavaScript (new).
   The JavaScript file displays in an editor.
3. Copy the entire code string starting with the following line:
   

   s.usePlugins = true

   to this line:
   

   s.doPlugins = s_doPlugins

   The example includes lines 25 through 182.
   

   

4. Return to the TiQ interface.
5. Click the Extensions tab.
6. Click + Add Extension.
7. From the Extensions dialog, click the Advanced tab.
8. To the left of Javascript Code, click + Add.
9. In the Title field, enter Do Plugins.
10. In the Scope field, select Adobe Analytics AppMeasurement for JS.
11. In the Configuration field, paste the code into the container text box.

Adding Plugins and Modules as an Extension

Use the following steps to add the Plugins and Modules received from Adobe Analytics as an extension within TiQ:

1. From the TiQ interface, click the Extensions tab.
2. Click + Add Extension.
3. From the Extensions dialog, click the Advanced tab.
4. To the left of Javascript Code, click + Add.
5. In the Title field, enter Plugins and Modules.
6. In the Scope field, select Adobe Analytics AppMeasurement for JS.
7. Return to the JavaScript editor window.
8. Copy the entire plugins section, starting with the following line:
   

   /**************** PLUGINS SECTION ****************/

   to this line:
   

   2019: '3/10,11/3/)

   The example includes lines 186 through 505.
   

   

9. Return to the TiQ interface.
10. In the Configuration field, paste the code into the container text box.

Modifying the Order of Extension Execution

For optimal results, use the following steps to change the order in which the extensions execute on your site:

1. From the TiQ interface, click the Extensions tab.
2. From the list of extensions, click, hold, and then drag and drop Plugins and Modules to display after E-Commerce and before Do Plugins.
   

   

   The E-Commerce extension allows you to predefine order values and product values and is based on your data layer. Tealium tags automatically ingest the data and than map the data accordingly. For example, in Adobe Analytics, the product string will automatically be populated based on the product variables that are defined on the page.

3. Click Save/Publish.
4. Click Save As.
5. In the Publish To field, click Dev and QA.
6. Click Publish.

Testing the Changes on Your Website

Use the following steps to validate that your updates are working as intended:

1. Return to your e-commerce site with the Adobe Marketing Cloud Debugger on.
2. Refresh the page to ensure that the most recent version of Tealium is applied.
3. From the debugger, check that props and evars are being populated to validate that the doPlugins are running.
   

   

4. From your e-commerce site, click the Category page and select a category.
5. Perform a search by typing a word or phrase into the search field on your site.
   In the example, the category is Mens and the search word is pants.
6. The debugger view reveals success by displaying the selected category, search term, and number of search returns.
   

   

7. From the debugger page, click the prodView event to expand the details and confirm that the product string is populated.