It’s common to need general data layer values on every event. To avoid having to add these values to every tracking call, use the tealium.dataLayer methods to persist data layer values that apply to all tracking calls. Once values are stored, they are automatically included in every tracked event.
Methods provided by tealium.dataLayer are able to read or write custom values, but do not have access to module data.
Data layer values have an expiration and are removed from the data layer when they expire. When you set a custom data layer value you can optionally set the expiration time for the value. The default expiration length is the current session.
The following variables are added to the data layer by the AppData module.
Minor build version of the app
Name of the app (typically the App Store name)
Fully-qualified name of the app bundle
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.
Version of the app bundle
Persistent Tealium visitor ID
Same as tealium_vid and included for legacy reasons
The following variables are added to the data layer by the Attribution module.
The corresponding ad’s campaign ID
The corresponding ad’s campaign name
The ID of the Creative Set which the corresponding ad was part of.
The name of the Creative Set which the corresponding ad was part of.
The corresponding ad’s campaign group ID
The corresponding ad’s campaign group name
The keyword that drove the ad impression which led to the corresponding ad click
Either be Broad, Exact or Search Match.
The corresponding ad’s campaign organization ID
The corresponding ad’s campaign organization name
Date and time the user first downloaded your app. In the case where iadconversion-type = “Redownload”, this represents the original purchase date. This may or may not have been associated with an Apple Search Ad.
Identifies the country or region associated with the campaign which drove this install.
Boolean indicating if user clicked on a Search Ads impression within 30 days prior to app download
Identifies new download or redownload of the app
Date and time the user clicked on a corresponding ad
Date and time the user downloaded the app
Boolean indicating if the user allowed ad tracking (if false, the advertising ID appears as a string of zeroes)
User-resettable advertising identifier (IDFA)
Unique ID guaranteed to be the same across all apps on the same device from a single vendor (apps with the same 1st 2 parts of the RDNS bundle identifier. For example, com.tealium or com.acme)