Client-Side | Getting Started |Tealium Developer Docs

Web

iQ Tag Management is a client-side solution that, without an application server, provides all the tag configuration logic from a static JavaScript file that can be processed solely by the browser.

In iQ Tag Management, your vendor tag configuration and business logic is represented in JavaScript code that resides inside the main client-side library called Universal Tag (utag.js). As visitors browse your site, this file is loaded and, within the browser itself, determines which additional vendor tags to load and how to send their data. Once these files have been retrieved by the browser they are cached for subsequent page views to optimize network traffic and page performance.

Learn more about how iQ Tag Management works.

Mobile

The client-side solution uses a hidden webview to load a special HTML file for mobile devices. This HTML file contains settings to control SDK behavior and it loads the Universal Tag (utag.js) to execute the configuration of the corresponding mobile iQ profile.

When you activate a mobile profile in Tealium iQ, a file named mobile.html is published to the following path on the CDN:

http://tags.tiqcdn.com/utag/ACCOUNT/PROFILE/ENVIRONMENT/mobile.html

Sample contents:

<!DOCTYPE html>
<!--tealium tag management - mobile.webview ut4.0.201905291649, Copyright 2019 Tealium.com Inc. All Rights Reserved.-->
<html>
<head><title>Tealium Mobile Webview</title></head>
<body>
<script type="text/javascript">
var utag_cfg_ovrd={noview:true};
var mps = {
    "5": {
        "_is_enabled":"true",
        "battery_saver":"true",
        "dispatch_expiration":"-1",
        "enable_collect":"false",
        "enable_s2s_legacy":"false",
        "enable_tag_management":"true",
        "event_batch_size":"1",
        "minutes_between_refresh":"15.0",
        "offline_dispatch_limit":"100",
        "override_log":"",
        "wifi_only_sending":"false"
    },
    "_firstpublish":"true"
}
</script>
<script type="text/javascript" src="//tags.tiqcdn.com/utag/ACCOUNT/PROFILE/ENVIRONMENT/utag.js"></script>
</body>
</html>

This file is used by the native mobile library to receive mobile settings and to load the Universal Tag (utag.js). This allows you to follow the traditional tag management workflow to deploy tags to your app and to adjust mobile settings related to tracking behavior.

Benefits

The client-side approach has the following benefits:

Tag Vendor Support
Since the client-side solution is deployed using iQ Tag Management, you have access to the existing Tag Marketplace integrations.
Data Layer Customization
More options for data layer customization using extensions.

Considerations

Keep in mind the following considerations:

WebView Behavior
The native webviews are provided by the iOS/Android API’s and may exhibit behavior beyond the control of Tealium.
Memory Usage
The native webview results in slightly more memory usage in the app.
Network Traffic
The more tags you deploy to your app, the more network traffic is generated due to the loading of vendor JavaScript tags and their resulting tracking pixels.

Use Cases

The client-side solution is best for the following scenarios.

iQ Tag Management Only

You are only subscribed to Tealium iQ Tag Management and do not have access to EventStream.

Complex Analytics

You have a complex analytics implementation and either do not have the resources to add the required data layer or have a short timeline to deploy. The ability to run extension using the client-side Tag Management solution allows you to manipulate the built-in data layer for your analytics needs and offload costly development time on your native app to the rapid configuration effort in iQ Tag Management.

Required Vendor SDK

You require mobile-specific features from a third-party vendor SDK, such as Firebase, push notifications, content modification, or attribution fingerprinting. The client-side solution offers remote commands, a way to trigger native code blocks from within the hidden webview and configured within iQ Tag Management.

Supported Libraries

The following platforms support the Tag Management client-side solution:

Tealium Collect Tag

The Tealium Collect Tag sends data to the Universal Data Hub server-side product EventStream. This tag is the client-side solution for the native Collect Module. Using both in your app doubles your usage volume and result in additional charges on your account.

The primary benefit of the client-side Tealium Collect tag is the ability to use extensions to customize the data layer prior to collection.