AppData Module

Adds information about the app bundle to the data layer.

Usage

The AppData module gathers important information about the app bundle. Usage of this module is recommended, but not mandatory. If you choose to exclude it, the data layer variables are not included in tracking calls. The tealium_visitor_id is always transmitted, even if the module is disabled, as this is a required variable.

The following platforms are supported:

  • iOS
  • macOS
  • watchOS
  • tvOS

Install

This module is included as part of the Core library and does not require separate installation.

Initialize

To initialize the module, verify that it’s specified on the TealiumConfig collectors property:

config.collectors = [Collectors.AppData]

If you don’t specify any optional collectors on your TealiumConfig instance, then this module is automatically enabled.

Data Layer

The following variables are transmitted with each tracking call while the module is enabled:

Variable Description Example
app_build Minor build version of the app "2213"
app_name Name of the app (usually same as App Store name) "Digital Velocity"
app_rdns Fully-qualified name of the app bundle "com.tealium.digitalvelocity"
app_uuid Random uuid. Persists for the duration of the app install, so long as one of the persistent storage modules is also enabled. Resets if app is uninstalled. 123e4567-e89b-12d3-a456-"426655440000"
app_version Version of the app bundle "1.0"
tealium_visitor_id Persistent Tealium visitor ID "123e4567e89b12d3a456426655440000"

Was this page helpful?

This page was last updated: January 7, 2023