• Platforms
  • Partners
  • Forums
  • TLC Tealium Learning Center Tealium Learning
    Community
  • Discussions & Ideas Dicussions & Ideas
  • Product Guides Product Guides
  • Knowledge Base Knowledge Base
  • Developer Docs Developer Docs
  • Education Education
  • TLC Blog TLC Blog
  • Support Desk Support Desk
  • CDH Customer Data Hub Customer Data Hub

Table of Contents

  • App Data
  • Collect
  • Carrier Data
  • Consent Management
  • Device Data
  • Lifecycle Events
  • Offline Queuing
  • Tag Management
  • Tealium Data
GETTING STARTED

Data Layer

The list of data layer variables available on mobile installations.

Each mobile component adds variables to the data layer. The following sections list every variable in each module.

All values are converted to strings. However, numbers can be coerced back into a numeric type as needed using iQ extensions or Tealium EventStream enrichments.

All auto-tracked events set the attribute: autotracked="true"

App Data

Properties of the host application.

Event Attribute Type Description Example
app_name String Application name "Digital Velocity"
app_rdns String Reverse DNS Bundle id/package name "com.digitalvelocity.alpha"
app_version String Application version "1.2.0"

Collect

Dispatches tracking calls as network requests to Tealium’s Collect service using the platform’s native URL communications service.

Event Attribute Type Value
dispatch_service String "collect"

Carrier Data

Provides information regarding the mobile carrier. 

Event Attribute Type Description Example
carrier String Name of the Carrier "AT&T"
carrier_iso String Carrier ISO 3166-1 country code "us"
carrier_mcc String Mobile ITU-T E.212 country code "us"
carrier_mnc String Mobile Network Code "410"

Consent Management

Provides information about consent tracking preferences. 

Event Attribute Type Description Example
policy String The policy under which consent was collected "gdpr"
consent_status String The user’s current consent status "consented"
consent_categories [String] An array of the user’s selected consent categories  ["analytics", "cdp"]

Device Data

Provides information regarding the host device.

Event Attribute Type Description Example
device String Name of the device "iPhone 6s"
device_architecture Number Bit architecture of device (32, 64, etc.) 64
device_advertising_id String Optional Advertising identifier. Not automatically available for all devices "03402320-245A-4ED4-BEAE-A1F50E21C55E"
device_battery_percent Number Whole number percent representation of device’s remaining battery power 100
device_cputype String Central Processor Unit type (arm6, arm7, etc.) "ARM64"
device_ischarging  String Is the device actively charging (true/false) "false"
device_language  String Two-letter IOS-639-1 language identifier (en, ja, etc.) "en"
device_orientation String Orientation of device at time of event (portrait, landscape, etc.)  "Portrait"
device_resolution  String  Resolution of a device "750x1334"

Lifecycle Events

Provides automatic tracking for the following application lifecycle events: launch, wake, and sleep.

Event Attribute Type Description Example
lifecycle_ dayofweek_local Number Local day of week (1=Sunday, 2=Monday, etc) 3
lifecycle_ dayssincelaunch Number Days since first launch in whole number increments 0 (24 hours have not yet elapsed)
lifecycle_ dayssinceupdate String Days since the app was updated in whole number increments "1"
lifecycle_ diddetectcrash String Was there a crash was determined at time of launch? "true"
lifecycle_ firstlaunchdate String GMT timestamp of very first detected launch (ISO-8601format for Zulu time) "2016-05-16T16:32:04Z"
lifecycle_ firstlaunchdate_ MMDDYYYY String GMT timestamp of very first detected launch (MM/DD/YYYY format) "5/16/2016"
lifecycle_ hourofday_local Number Local hour of day (24 hour format) 13
lifecycle_ isfirstlaunch String "true" if launch is very first (otherwise not populated) "true"
lifecycle_ isfirstlaunchupdate String "true" if launch is very first after a detected app version update (otherwise not populated) "true"
lifecycle_ isfirstwakemonth String "true" if launch event is the first for the current month (otherwise not populated) "true"
lifecycle_ isfirstwaketoday  String "true" if launch/wake event is the first for current day (otherwise not populated) "true"
lifecycle_ lastlaunchdate  String GMT timestamp of prior recorded launch (ISO-8601 format for Zulu time) (Not populated if it is within the first session) "2013-07-11T17:55:04Z"
lifecycle_ lastsleepdate  String GMT timestamp of prior recorded sleep event (ISO-8601 format for Zulu time) "2013-07-11T17:55:04Z"
lifecycle_ lastwakedate  String GMT timestamp of prior recorded wake event (ISO-8601 format for Zulu time) "2013-07-11T17:55:04Z"
lifecycle_ launchcount  Number Total whole number of launches for application since most recent version update (restarts when a new version detected) 3
lifecycle_ priorsecondsawake Number Populated only during launch events. Whole seconds application was awake between wakes and sleeps. Aggregate of all these wakes & sleeps until a launch event. 148
lifecycle_ secondsawake  Number Populated only during sleep events. Whole seconds application has been awake from most recent wake to the sleep event. 480
lifecycle_ sleepcount  Number Total number of times app was detected to have gone to sleep/background. 3
lifecycle_ totallaunchcount Number Total number of launches since app was installed. Only resets if application deleted and reinstalled.  5
lifecycle_ totalsecondsawake  Number Total number of seconds application has been awake. Only resets if application deleted and reinstalled. 800
lifecycle_ totalsleepcount  Number Total number of times application was detected to have gone to sleep. Only resets if application deleted and reinstalled. 8
lifecycle_ totalcrashcount Number Total number of times an application failed to properly log a sleep event, resulting in a lifecycle sequence discrepancy caused by a crash. Only resets if application deleted and reinstalled. 2
lifecycle_ totalwakecount  Number Total number of launches and wakes. Only resets if application deleted and reinstalled. 7
lifecycle_type  String Lifecycle event type ["launch", "wake", "sleep"]
lifecycle_ updatelaunchdate String GMT timestamp of first launch/wake after an app version update detected. ISO8601 format for Zulu time. "2016-05-16T16:32:04Z"
lifecycle_ wakecount Number Total number of launches and wakes for this application version. Resets if a new host application version detected. 34

Offline Queuing

Preserves event dispatch data for later delivery when, for example, a device has momentarily lost network connectivity.

Populates the following Event Attribute within the dispatch data that was queued: 

Event Attribute Value
was_queued "true"

Tag Management

Runs vendor tags configured in Tealium iQ Tag Management in a hidden webview.

Event Attribute Value
dispatch_service "tagmanagement"

Tealium Data

Default event attributes that are present in all libraries.

Event Attribute Type Description Example
tealium_event String Title of the event. Value populated by the ‘title’ argument of the Tealium provided track calls. Does NOT need to be unique. "button_tapped"
tealium_random Number Random 16 digit number generated per event. Pre-padded with zeroes to maintain 16 digit length. 1234567890123456
tealium_account String Tealium account name used to initialize a Tealium integration library. "companyXYZ"
tealium_environment String Tealium TIQ environment used to initialize a Tealium integration library. ["dev", "qa", "prod"]
tealium_library_name String Name of the platform integration library. "swift"
tealium_library_version String Version of the platform integration library. "1.2.0"
tealium_profile String Tealium profile name used to initialize a Tealium integration library. "main"
tealium_datasource String 6 digit alphanumeric identifier provided by the Tealium Customer Data Hub "abc123"
tealium_session_id Number Unix epoch timestamp in milliseconds, no decimals, of first event. Resets after a new session starts, typically a new launch. 1496350751928
tealium_visitor_id String Unique app-device visitor id that differentiates users. Required by the Collect service. (32 character alpha-numeric)
tealium_timestamp_epoch Number Unix timestamp at UTC. 1496350751
Tracking Webviews
Consent Management

 
  • Mobile
  • Getting Started
    • Overview
    • Quick Start Guide
    • Mobile Concepts
    • Client-Side
    • Server-Side
    • Tracking Webviews
    • Data Layer
    • Consent Management
    • Event Batching
    • User Location and Geofencing
    • Deep Links
    • Timed Events
    • Trace
    • Hosted Data Layer
    • Feature Comparison
    • Troubleshooting
  • Remote Commands
    • Overview
    • How It Works
    • Integrations
      • AppsFlyer
      • Braze
      • Contentsquare
      • Facebook
      • Firebase
      • Kochava
      • Usabilla
  • Android (Java)
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • Consent Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Module
      • Optimizely X Tracking Module
    • Android TV
    • Android Wear
    • API Reference
      • ConsentManager
      • DataSources
      • Lifecycle
      • Tealium
      • Tealium.Config
      • TealiumLocation
    • Release Notes
  • Android (Kotlin)
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • Identity Resolution
    • Module List
      • Ad Identifier Module
      • Collect Module
      • Collectors Module
      • Crash Reporter Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Manager Module
      • RemoteCommands Module
      • Tag Management Dispatcher Module
      • Visitor Service Module
    • Android TV
    • API Reference
      • ConsentCategory
      • ConsentManager
      • CurrentVisit
      • DataLayer
      • Lifecycle
      • LocationManager
      • Tealium
      • TealiumConfig
      • VisitorProfile
      • VisitorService
    • Release Notes
  • Cordova
    • Overview
    • Install
    • Track
    • Data Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
    • API Reference
    • Release Notes
  • Flutter
    • Overview
    • Install
    • Track
    • Consent Management
    • Data Management
    • API Reference
    • Release Notes
  • iOS (Objective-C)
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • Consent Management
    • Tag Management
    • Module List
      • Lifecycle Tracking Module
    • tvOS
    • watchOS
    • API Reference
    • Release Notes
  • iOS (Swift) 1.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • App Extensions
    • Identity Resolution
    • Consent Management
    • Modules
    • Module List
      • AppData Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DataSource Module
      • DefaultStorage Module
      • Delegate Module
      • DeviceData Module
      • DispatchQueue Module
      • FileStorage Module
      • Lifecycle Module
      • Location Module
      • Logger Module
      • PersistentData Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
      • VolatileData Module
    • Feature Comparison
    • Working with Objective-C
    • API Reference
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManagerDelegate
      • TealiumConsentManager
      • TealiumInstanceManager
      • TealiumPersistentData
      • TealiumVolatileData
      • Tealium
    • Release Notes
  • iOS (Swift) 2.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • App Extensions
    • Identity Resolution
    • Modules
    • Module List
      • AppData Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DeviceData Module
      • Lifecycle Module
      • Location Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
    • Working with Objective-C
    • API Reference
      • Tealium
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManager
      • TealiumDataLayer
      • TealiumInstanceManager
    • Release Notes
  • NativeScript
    • Overview
    • Install
    • Track
    • API Reference
      • Tealium
      • TealiumConfig
    • Release Notes
  • React Native 1.x
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • React Native 2.x
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Unity
    • Overview
    • Install
    • Track
    • API Referencee
  • Xamarin
    • Overview
    • Install
    • Track
    • Data Management
    • Consent Management
    • API Reference
    • Release Notes
  • Web
  • Getting Started
    • Overview
    • Quick Start Guide
    • Web Concepts
  • Adobe Launch
    • Overview
    • Install
    • Data Layer
  • AMP
    • Install
    • Track
    • Data Layer
    • Overview
  • Angular
    • Install
    • Track
    • API Reference
    • Overview
  • Google Tag Manager
    • Overview
    • Data Layer
    • Install
  • JavaScript (Web)
    • Install
    • Track
    • Data Layer
    • Overview
    • Universal Data Object (utag_data)
    • Universal Tag (utag.js)
    • Data Layer Object (b)
    • Single-Page Applications
    • Settings
    • Debugging
    • API Reference
      • Cookie Functions
      • GDPR Functions
      • Tracking Functions
      • Utility Functions
    • Release Notes
  • Server
  • C#
    • Overview
    • Install
    • Track
    • Data Layer
    • API Reference
    • Release Notes
  • HTTP API
    • Overview
    • Endpoint
    • Data Layer
  • Java
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Node
    • Overview
    • Install
    • Track
    • API Reference
  • Python
    • Overview
    • Install
    • Track
    • API Reference
  • Roku
    • Overview
    • Install
    • Track
    • API Reference
  • Ruby
    • Overview
    • Install
    • Track
    • API Reference

Was this article helpful?

This page was last updated: October 20, 2020       Thank you for your feedback!
  • Platforms
  • Partners
  • Forums
  • Mobile
  • Getting Started
  • Remote Commands
  • Android (Java)
  • Android (Kotlin)
  • Cordova
  • Flutter
  • iOS (Objective-C)
  • iOS (Swift) 1.x
  • iOS (Swift) 2.x
  • NativeScript
  • React Native 1.x
  • React Native 2.x
  • Unity
  • Xamarin
  • Web
  • Getting Started
  • Adobe Launch
  • AMP
  • Angular
  • Google Tag Manager
  • JavaScript (Web)
  • Server
  • C#
  • HTTP API
  • Java
  • Node
  • Python
  • Roku
  • Ruby