Tealium Integration

From ClickTale Wiki
(Redirected from Tealium integration)
Jump to: navigation, search
     Tealium logo.png

Tealium Integration

You can drop the ClickTale tracking code into your website via Tealium, along with numerous other tags. It's a quick and easy way to get started with ClickTale.

About Tealium

Tealium is a leading provider of tag management for enterprise websites. Through the Tealium Tag Management Console, marketers can add, edit or remove any web analytics or digital marketing tags instantly, without changing the page code or taxing their IT department. Tealium iQ provides business users with a point-and-click user interface for managing their page tags without any JavaScript knowledge.

About the integration

The integration allows you to add the ClickTale tracking code to your site along with many of your other tags, using just one piece of code on the pages to deploy any number of code tags.

How to Integrate

To deploy the ClickTale tracking code using Tealium, please follow these steps:

1. Login to the Tealium Tag Management Console.

2. Go to the “Tags” tab and click “Add More” to add a new Tag.
3. Select ClickTale from the list of turnkey vendors.
4. Configure ClickTale by entering your Project ID, Recording ratio and the server partition as defined in your ClickTale project.
5. Define where the ClickTale tag is to be added by selecting the Tealium load rule.
6. Save your profile and publish. Your ClickTale project is now live.

       If your project uses Atlas tracking code, the partition name and Project ID are shown in the bottom part of the code.

If your project uses Balkan tracking code, please follow the procedure in this article to get these parameters.

How can I find which code type my project is using?


If you need to deploy the XHTML-compliant version of the ClickTale code, you should contact your Account Manager or ClickTale support to enable this option.


Tealium new image.png

Key advantages of implementing via Tealium

  • Accuracy: Increase your overall analytics accuracy.
  • Efficiency: Add tags at any point in the website development cycle, quickly and cheaply, from a single application.
  • Freedom: Get support for any number of tags from multiple applications. Gain flexibility in adding and testing new tags, and reduce your reliance on a single supplier.
  • Ease-of-use: Manage the tags yourself with a user-friendly system, and free your IT department to focus on other issues.
  • Control: See all the tags on your site, and ensure that tags adhere to technical best practices and comply with privacy and other mandates.
  • Performance: Improve your page load time by consolidating the variables used םn your tags. Serve tags, only when needed.


Tealium and Integration Modules

The basic Tealium integration only allows you to record pages that are accessible via a simple GET request and do not depend on session cookies. For password protected pages, pages that depend on session elements, dynamic pages and POST processed pages you will need to use an Integration Module.

Instructions

There are essentially two methods of using an Integration Module on websites which utilize Tealium. The first involves disabling Tealium from injecting the ClickTale code altogether and the second involves an integration of the two.

Method 1 - Integration Module replaces Tealium

Method one requires you to remove the Tealium rule regarding the ClickTale code altogether and install the Integration Module based on the framework with which your site is built. The Module replaces Tealium insomuch as it injects the tracking code into the pages. For more information please see: Integration Modules

Method 2 - Integration Module alongside Tealium

In light of the fact that the Tealium integration already contains the tracking code, the only thing you need to inject into the HTML the visitor receives is the ClickTaleFetchFrom line.

Below are examples of the xml needed to be configured for each of the different modules:

ASP.NET Integration Module

Please see detailed instructions on the ASP.NET integration module page.

<?xml version="1.0" encoding="utf-8" ?>
 
<scripts>
  <script name="Top" DoNotReplaceCondition = "(&lt;!-- ClickTale Top part --&gt;)">
    <![CDATA[
    ]]>
  </script>
  <script name="Bottom" DoNotReplaceCondition = "(&lt;!-- ClickTale Bottom part --&gt;)">
    <![CDATA[
<script type="text/javascript">
    var ClickTaleFetchFrom = "http://%RootPath%/ClickTaleCache.ashx?t=%CacheToken%";
</script>
    ]]>
  </script>
</scripts>

PHP Integration Module

Please see detailed instructions on the PHP integration module page.

<?xml version="1.0" encoding="utf-8" ?>
<scripts>
  <script name="Top" DoNotReplaceCondition = "&lt;!-- ClickTale Top part --&gt;">
    <![CDATA[
    ]]>
  </script>
  <script name="Bottom" DoNotReplaceCondition="&lt;!-- No ClickTale --&gt;" InsertBefore="&lt;!-- ClickTale Bottom part Here --&gt;|&lt;/body&gt;">
    <![CDATA[
<script type="text/javascript">
    var ClickTaleFetchFrom="%FetchFromUrl%";
</script>
]]>
  </script>
</scripts>


J2EE Integration Module

Please see detailed instructions on the J2EE integration module page.

<?xml version="1.0" encoding="utf-8" ?>
<!-- Put this in the root of the web site -->
<scripts>
  <script name="Top" >
    <![CDATA[
    ]]>
  </script>
  <script name="Bottom" InsertBefore="&lt;!-- ClickTale Bottom part Here --&gt;|&lt;/body&gt;">
    <![CDATA[
<script type="text/javascript">
    var ClickTaleFetchFrom="http://%RootPath%/ClickTaleCache?h=%CacheToken%";
</script>
	]]>
  </script>
</scripts>


Please note: By default, the Tealium code loads after the DOMLoad event. However, it is possible to load it inline; in which case, the bottom part of the module’s xml file needs to be configured to inject the ClickTaleFetchFrom variable before the Tealium scripts.