Tealium for iOS (Objective C) release notes (By Date)

Low Impact Changes

• Added the sessionCountingEnabled flag to TEALConfiguration to allow disabling of session counting for Tealium iQ accounts that use self-hosted JavaScript files.
• Fixed a crash that could happen for devices with no preferred language.

Low Impact Changes

• Fixed issue with Lifecycle XCFramework file that prevented successful archiving of the enclosing app’s .ipa file
• Carthage can now use XCFrameworks directly from the Github repo without requiring an intermediate JSON file (see Install). Any existing Cartfile references must be updated.
• CocoaPods now uses XCFramework files

High Impact Changes

• Added the option to set a WKProcessPool instance on the TealiumConfig object for the Tealium Tag Management webview to use to avoid cookie synchronization issues.

Medium Impact Changes

• Lower-cased the value of the platform variable to correct mobile session timer. Previously, sessions were measured similarly to web (30 minutes of consistent activity). By lower-casing the platform variable, the Customer Data Hub recognizes the incoming data as a mobile session and the session length is shortened to 2 minutes.

Update your load rules if you have Load or Attribute Rules configured checking for case sensitive platform values such as iOS vs ios.

Low Impact Changes

• Resolved build warnings and updated deprecated APIs

High Impact Changes

• Added support for native session counting in lieu of using the session counting logic within utag.js. This provides more accurate session counts, and fixes some edge cases where background activities triggered new sessions, resulting in higher than expected session counts.

⚠️ Important ⚠️ If Tag Management is enabled in the Mobile Publish Settings, you must also update the mobile.html template within the associated account. If this action isn’t performed, duplicate sessions are recorded in Tealium. Read more about how to update a template.

Low Impact Changes

• Bug Fix. Update log format on removeRemoteCommandID.

Low Impact Changes

• Fix to the captureTimeDataSourcesForType method to use the volatileDatasourcesCopy instead of the clientVolatileDataSources directly. This means that the addToVolatileDataSources method may now safely be called from a separate thread.

Low Impact Changes

• Added the tealium_session_id the volatile data variables so is easily retrieved and used.

High Impact Changes

• Removed the UIWebView entirely to now only support WKWebView as Apple has deprecated UIWebView since iOS 8.0. We kept the support for the UIWebView for convenience, and to ensure visitor sessions and analytics history was left intact. However, per ITMS-90809: Deprecated API Usage - Apple will stop accepting submissions of apps that use UIWebView APIs. Learn more about UIWebView. We do have the WKHTTPCookieStore in place that will migrate the cookies used in UIWebView over to the WKWebView. This will ensure that the user IDs/visitor cookies will seamlessly transition to the new implementation.

Medium Impact Changes

• Updated the device list to include the latest Apple devices (X, XR, XS, 11, etc). We also updated the implementation to load from a JSON file instead of hardcoding the device names. Lastly, we added two more variables with extra device detail: model_name (such as iPhone 8, iPhone XR Max, iPhone 11 Pro, etc) and model_variant" For example, "GSM", "WiFi", "model A1457, A1518, A1528", etc. If no extra model information is available, the standard device variable will read something like: "iPhone 10,0".

Low Impact Changes

• Added functionality to reattach to the view at each track call so that Tealium does not need to be reinitialized when view hierarchy changes. Validation in your own app is essential; verify that you see tracking calls leaving your app in a variety of different screens in your app, including any views that may be launched from push notifications, where the view hierarchy may have changed.

Low Impact Changes

• Removed trace ID cookie check on each call to the webview since this appeared to be causing crashes. This worked nicely with UIWebView but seemed to cause problems with WKWebView. Refer to Debugging Tealium Mobile Apps for other Tealium installation validation and debugging methods.

High Impact Changes

• Tag Management now uses WKWebView instead of UIWebView by default. Read Tag Management documentation carefully before upgrading.

Low Impact Changes

• New sample app added to showcase WKWebView updates/changes