Tag Management

This tag management feature allows you to integrate JavaScript based vendor tags into your app and manage them remotely using Tealium iQ, similarly to a website.

How It Works

Once you have created a mobile profile in Tealium iQ with Tag Management enabled, when you initialize the Tealium instance in your app, a non-rendered web view is created to load a simple HTML file from the Tealium mCDN network in which to load the Universal Tag utag.js. This web view is never rendered to the user.

• Versions 5.5.0 and newer, running iOS 11.0 and newer use WKWebView.
• Versions 5.4.x and older, running iOS 10.0 and older use UIWebView.

If you are supporting iOS versions lower than iOS 11.0 and would still like to use WKWebView, you can still upgrade to version 5.5.0 and newer. The caveat is that your visitor_id and other cookies will be reset. This is because the WKHTTPCookieStore is only supported in iOS 11.0

Sample

To better familiarize yourself with Tealium’s WKWebView, explore the WKWebView sample.

Usage

WKWebView is required to be attached to a UIView, even if it is not rendered. To accommodate this the Tealium SDK attempts to attach the non-rendered WKWebView to the rootViewController.view, the most common scenario when your window’s rootViewController is a subclass of UIViewController or one of Apple’s container view controllers (UINavigationController or UITabBarController).

If your app has a complex view hierarchy, set the TEALConfiguration instance with a view to attach to in viewDidLoad, viewWillAppear:, or viewDidAppear:.

TEALConfiguration *tealConfig = [TEALConfiguration configurationWithAccount:@"ACCOUNT"
                                              profile:@"PROFILE"
                                              environment:@"ENVIRONMENT"
                                              datasource:@"DATASOURCE"];
tealConfig.view = <UIVIEW>; // For example, self.view in a UIViewController subclass
// Initialize with a unique key for this instance
Tealium *tealium = [Tealium newInstanceForKey:@"INSTANCE" configuration:tealConfig]; 

Upon receiving a push notification, if your app jumps to a UIViewController and has a different view hierarchy than when Tealium was initialized, you must remove the old instance of Tealium and create a new one with the view to attach to. The sample app shows an example of this in GreenViewController.m and TealiumHelper.m.

Although the Objective-C SDK is currently closed source, to provide more context, this following code snippet shows how the web view is created.

- (UIView *_Nullable)webViewContainer {
    if (!_webViewContainer) {
        UIWindow *window = [[UIApplication sharedApplication] keyWindow];
        UIViewController *rootViewController = window.rootViewController;
        UIViewController *topViewController;

        if ([rootViewController isKindOfClass:[UINavigationController class]]) {
            topViewController = [((UINavigationController *)rootViewController).viewControllers lastObject];
        } else if ([rootViewController isKindOfClass:[UITabBarController class]]) {
            topViewController = ((UITabBarController *)rootViewController).selectedViewController;
        } else {
            topViewController = rootViewController;
        }

        UIView *view = topViewController.viewIfLoaded;
        if (view) {
            self.webViewContainer = view;
        }
    }
    return _webViewContainer;
}

The view is only used once to initialize the WKWebView.

UIWebView

Usage

If you encounter issues with WKWebView and want to force the use of UIWebView:

1. Set the webViewType in the TEALConfiguration instance:

   TEALConfiguration *tealConfig = [TEALConfiguration
           configurationWithAccount:@"ACCOUNT"
           profile:@"PROFILE"
           environment:@"prod"
           datasource:@"DATASOURCE"];

2. Set the web view type to use UIWebView:

   tealConfig.webViewType = TEALUIWebView;

3. Initialize with a unique key for this instance:

   Tealium *tealium = [Tealium newInstanceForKey:@"INSTANCE" configuration:tealConfig];