Data Layer
A full list of the data layer variables provided by each module.
AppData
The following variables are added to the data layer by the AppData module.
| Variable Name | Description | Example |
|---|---|---|
app_build |
Minor build version of the app | 2213 |
app_name |
Name of the app (typically the 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. |
t3aL...1uM |
app_version |
Version of the app bundle | 1.0 |
tealium_vid |
Persistent Tealium visitor ID | t3aL...1uM |
tealium_visitor_id |
Same as tealium_vid and included for legacy reasons |
t3aL...1uM |
Attribution
The following variables are added to the data layer by the Attribution module.
| Variable Name | Description | Example |
|---|---|---|
ad_campaign_id |
The corresponding ad’s campaign ID | 1234567890 |
ad_campaign_name |
The corresponding ad’s campaign name | CampaignName |
ad_creativeset_id |
The ID of the Creative Set which the corresponding ad was part of. | 456093 |
ad_creativeset_name |
The name of the Creative Set which the corresponding ad was part of. | Beast Images |
ad_group_id |
The corresponding ad’s campaign group ID | 1234567890 |
ad_group_name |
The corresponding ad’s campaign group name | AdGroupName |
ad_keyword |
The keyword that drove the ad impression which led to the corresponding ad click | Keyword |
ad_keyword_matchtype |
Either be Broad, Exact or Search Match. | Exact |
ad_org_id |
The corresponding ad’s campaign organization ID | OrgID |
ad_org_name |
The corresponding ad’s campaign organization name | OrgName |
ad_purchase_date |
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. |
2016-12-05T17:31:40Z |
ad_region |
Identifies the country or region associated with the campaign which drove this install. | US |
ad_user_clicked_last_30_days |
Boolean indicating if user clicked on a Search Ads impression within 30 days prior to app download | [true, false] |
ad_user_conversion _type |
Identifies new download or redownload of the app | Download |
ad_user_date_clicked |
Date and time the user clicked on a corresponding ad | 2016-12-05T17:31:40Z |
ad_user_date_converted |
Date and time the user downloaded the app | 2016-12-05T17:31:40Z |
device_advertising_enabled |
Boolean indicating if the user allowed ad tracking (if false, the advertising ID appears as a string of zeroes) |
[true, false] |
device_advertising_id |
User-resettable advertising identifier (IDFA) | 6D92078A-8246... |
device_advertising_vendor_id |
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) | 6D92078A-8246... |
Autotracking
The following variables are added to the data layer by the Autotracking module.
| Variable Name | Description | Example |
|---|---|---|
autotracked |
Set to true and added to each autotracked tracking call | [true, false] |
ConsentManager
The following variables are added to the data layer by the ConsentManager module.
| Variable Name | Description | Example |
|---|---|---|
consent_categories |
An array of the user’s selected consent categories | ["analytics", "cdp"] |
consent_status |
The user’s current consent status | [consented, notConsented] |
policy |
Consent Policy | "gdpr" |
Connectivity
The following variables are added to the data layer by the Connectivity module.
| Variable Name | Description | Example |
|---|---|---|
queue_reason |
Added to the track call if the tracking request was queued due to lack of connectivity. Only present for queued events; absent for all other events | connectivity |
was_queued |
Indicates whether a tracking call was queued due to no connectivity. Only present for queued events; absent for all other events | [true, false] |
Core
The following variables are added to the data layer by the Core module.
| Variable Name | Description | Example |
|---|---|---|
enabled_modules |
List of all currently-enabled modules | ["tagmanagement", "collect"] |
screen_title |
Screen title passed to trackView call | "homescreen" |
tealium_datasource |
Specifies the data source name (added to every dispatch) | "a1b2c3" |
tealium_event |
The name of the event being tracked | "checkout" |
Crash Reporter
The following variables are added to the data layer by the CrashReporter module.
| Variable Name | Description | Example |
|---|---|---|
app_memory_usage |
Current memory used by the app on the device at the time of the crash | 143.57MB |
crash_cause |
Cause of the crash | Crash Reason |
crash_name |
Friendly name of the crash, if available | Crash Name |
crash_libraries |
List of loaded libraries at the time of the crash | [{ "baseAddress": "0xa3e0000", "codeType": { "arch": 64, "typeEncoding": "Mach"}, "imageName": "/Applications/Xcode9.3.app/ Contents/Developer/Platforms/ iPhoneOS.platform/Developer/ Library/CoreSimulator/Profiles/ Runtimes/iOS.simruntime/ Contents/Resources/ RuntimeRoot/usr/lib/dyld_sim", "imageSize": 212992, "imageUuid": "4015e9b70bde" }] |
crash_process_id |
PID of the app at time of crash | 84351 |
crash_process_path |
Path the app was running under | /DemoApp.app/DemoApp |
crash_parent_process |
Parent process that launched the app | launchd_sim |
crash_parent_process_id |
Parent process PID | 83183 |
crash_signal_address |
Signal address of the crash | 4572945982 |
crash_signal_code |
Signal code causing the crash | #0 |
crash_signal_name |
Signal name causing the crash | SIGABRT |
crash_threads |
Returns all active threads at the time of the crash | {"crashed": 1,"registers": {"cs": "0x07"},"stack": {"instructionPointer": 4572945982,"symbolInfo": {"symbolName": "","symbolStartAddr": 0},"threadId": ""}} |
crash_uuid |
Unique identifier for this specific crash | CC2DA0E9-E544-429A-AC5E-A268FC62F02A |
device_memory_usage |
Current memory used by the app on the device at the time of the crash | 143.57MB |
device_memory_available |
Free memory on device at the time of the crash | 1068.88MB |
device_os_build |
Current OS build number | 15E217 |
memory_free |
Free memory on device at the time of the crash | 1068.88MB |
DeviceData
The following variables are added to the data layer by the DeviceData module.
| Variable Name | Description | Example |
|---|---|---|
app_memory_usage |
Memory being used by the current process/app in Megabytes | 35.75MB |
app_orientation |
Orientation of the app (from statusBarOrientation; may differ from device orientation if app is locked in a specific orientation) | Portrait |
app_orientation_extended |
Extended Orientation of the app (from statusBarOrientation; may differ from device orientation if app is locked in a specific orientation) | Portrait Upside Down |
carrier |
Mobile network carrier name | EE |
carrier_iso |
Mobile carrier ISO | gb |
carrier_mcc |
Carrier mobile country code | 234 |
carrier_mnc |
Carrier mobile network code | 34 |
cpu_architecture |
CPU architecture | 64 |
cpu_type |
CPU type | ARM64v8 |
device |
Consumer device name | iPhone 7 Plus |
device_architecture |
Device architecture | 64 |
device_battery_percent |
Current battery percentage at time of track call | 58 |
device_cputype |
Device CPU type | Intel |
device_ischarging |
Boolean to indicate if device is currently charging at time of track call | [true, false] |
device_language |
Current device language | en |
device_orientation |
Simple orientation | [Portrait, Landscape] |
device_orientation_extended |
Full orientation | Face Up |
device_os_version |
Operating system version | 11.1 |
device_resolution |
Screen resolution | 1080x1920 |
device_type |
Apple internal device identifier | iPhone8,4 |
memory_active* |
Total active memory on the device | 997.78MB |
memory_compressed* |
Total compressed memory on the device | 153.39MB |
memory_free* |
Total free memory on the device | 120.81MB |
memory_inactive* |
Total inactive memory on the device | 441.83MB |
memory_physical* |
Total physical memory on the device (RAM) in Megabytes | 2013.50MB |
memory_wired* |
Total wired memory on the device | 207.12MB |
model_name |
Model name | iPhone 7 Plus |
model_variant |
Model variant (generally indicates which radio technology is available on the device) | [CDMA, GSM, WiFi, Cellular] |
network_connection_type |
Current connection type | [wifi, cellular] |
_connection_type |
Current connection type | [wifi, cellular] |
network_iso_country_code |
Mobile network ISO country code | gb |
network_mcc |
Network mobile country code | 234 |
network_mnc |
Network mobile network code | 34 |
network_name |
Mobile network carrier name | EE |
os_build |
Operating System Build Version | 15J580 |
os_name |
Operating System Name | [iOS, tvOS, watchOS, macOS] |
os_version |
Operating system version | 11.1 |
platform |
Operating System Name | [iOS, tvOS, watchOS, macOS] |
user_locale |
Current device language | en |
DispatchQueue
The following variables are added to the data layer by the DispatchQueue module.
| Variable Name | Description | Example |
|---|---|---|
queue_reason |
Added to the track call if the tracking request was queued due to event batching. Only present for queued events; absent for all other events | batching_enabled |
was_queued |
Indicates whether a tracking call was queued due to no event batching. Only present for queued events; absent for all other events | [true, false] |
Lifecycle
The following variables are added to the data layer by the Lifecycle module.
| Variable Name | Description | Example |
|---|---|---|
lifecycle_dayofweek_local |
Local day of week that call was made, such as 1=Sunday, 2=Monday | 4 |
lifecycle_dayssincelastwake |
Days since last detected wake in integer increments | 1 |
lifecycle_dayssincelaunch |
Days since first launch in integer increments | 23 |
lifecycle_dayssinceupdate |
Days since the last detected app version update in integer increments | 46 |
lifecycle_diddetect_crash |
Was a crash detected during this launch/wake event (populated only if true) |
[true, false] |
lifecycle_firstlaunchdate |
GMT timestamp of the first detected launch/wake in ISO8601 format from Zulu time | 2013-07-11T17:55:04Z |
lifecycle_firstlaunchdate_MMDDYYYY |
GMT Timestamp formatted as MM/DD/YYYY | 01/17/2012 |
lifecycle_hourofday_local |
Local hour of day that call was made (24 hour format) | [true, false] |
lifecycle_isfirstlaunch |
Only present if call is the first launch/wake call | [true, false] |
lifecycle_isfirstlaunchupdate |
Only present if call is first launch/wake after a detected updated | [true, false] |
lifecycle_isfirstwakemonth |
Only present if call is first launch/wake of the month | [true, false] |
lifecycle_isfirstwaketoday |
Only present if call is first launch/wake of the day | [true, false] |
lifecycle_launchcount |
Total number of launches this version of your app (since the last update) | 3 |
lifecycle_priorsecondsawake |
Whole seconds app was awake since last launch only. Aggregates total from all wakes prior. Sent only with lifecycle_type:launch calls. |
126 |
lifecycle_secondsawake |
Whole seconds app was awake since most recent wake/launch | 30 |
lifecycle_sleepcount |
Total number of times your app has gone to sleep (resets if updated) | 5 |
lifecycle_totalcrashcount |
Total number of crashes counted since install (only reset if app deleted) | 21 |
lifecycle_totallaunchcount |
Total number of launches since install (only reset if app deleted) | 3 |
lifecycle_totalsecondsawake |
Total number of seconds your app has been in a woken/active state since app install (only reset if app deleted) | 36 |
lifecycle_totalsleepcount |
Total number of times your app has gone into the background since app install (only reset if app deleted) | "400" |
lifecycle_totalwakecount |
Total number of launches + wakes since install (only reset if app deleted) | "563" |
lifecycle_type |
Type of lifecycle call. | ["launch", "wake", "sleep" ] |
lifecycle_updatelaunchdate |
GMT timestamp of first wake/launch after a version update has been detected | 2014-09-08T18:10:01Z |
lifecycle_wakecount |
Total number of launches + wakes in this version of your app (resets if updated) | "29" |
Location
The following variables are added to the data layer by the Location module.
| Variable Name | Description | Example |
|---|---|---|
geofence_name |
The name of the geofence region | "Tealium_San_Diego" |
geofence_transition_type |
The type of geofence transition event | "entered" or "exited" |
latitude |
The latitude of the user’s most recently recorded location | "32.906119" |
location_timestamp |
The recorded date/time (GMT) the user entered/exited the geofence region | "2020-01-28 16:29:46 +0000" |
longitude |
The longitude of the user’s most recently recorded location | "-117.23791632509666" |
movement_speed |
The instantaneous speed of the device, measured in meters per second | "1.0" |
TagManagement
The following variables are added to the data layer by the TagManagement module.
| Variable Name | Description | Example |
|---|---|---|
dispatch_service |
Static string to indicate which module the tracking call came from | collect/tagmanagement |
VolatileData
The following variables are added to the data layer by the VolatileData module.
| Variable Name | Description | Example |
|---|---|---|
event_timestamp_iso |
Event timestamp in ISO8601 (Zulu Time), UTC | 2017-11-20T14:48:00Z |
event_timestamp_local_iso |
Event timestamp in ISO8601 local timezone | 2017-11-20T06:48:00 |
event_timestamp_offset_hours |
Current offset from UTC in hours | -8 |
event_timestamp_unix |
Current Unix timestamp (1970 epoch) in seconds | 1511189280 |
event_timestamp_unix_millis |
Current Unix timestamp (1970 epoch) in milliseconds | 1511189280337 |
tealium_account |
Current Tealium account (from TealiumConfig object) | tealium |
tealium_environment |
Current Tealium environment (from TealiumConfig object) | dev |
tealium_library_name |
Tealium library name | swift |
tealium_library_version |
Tealium library version | 1.8.0 |
tealium_profile |
Current Tealium profile (from TealiumConfig object) | mobile |
tealium_random |
Random number | 8449989974958830 |
tealium_session_id |
Tealium Session ID | 1511262829677 |
tealium_timestamp_epoch |
Current Unix timestamp (1970 epoch) in seconds | 1511262829 |
timestamp |
Event timestamp in ISO8601 (Zulu Time), UTC | 2017-11-20T14:48:00Z |
timestamp_local |
Event timestamp in ISO8601 local timezone | 2017-11-20T06:48:00 |
timestamp_offset |
Current offset from UTC in hours | -8 |
timestamp_unix |
Current Unix timestamp (1970 epoch) in seconds | 1511189280 |
timestamp_unix_milliseconds |
Current Unix timestamp (1970 epoch) in milliseconds | 1511189280337 |
This page was last updated: January 7, 2023