• 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
  • 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
    • Media Tracking
    • Deep Links
    • Timed Events
    • Trace
    • Hosted Data Layer
    • Adobe Visitor Service Module
    • Feature Comparison
    • Troubleshooting
  • Remote Commands
    • Overview
    • How It Works
    • Integrations
      • Adjust
      • AppsFlyer
      • Branch
      • 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
      • AutoTracking Module
      • AdobeVisitorService Module
      • Collect Module
      • Collectors Module
      • Crash Reporter Module
      • In-App Purchase Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Manager Module
      • Media Module
      • RemoteCommands Module
      • Tag Management Dispatcher Module
      • Visitor Service Module
    • Android TV
    • API Reference
      • ConsentCategory
      • ConsentManager
      • CurrentVisit
      • DataLayer
      • Lifecycle
      • LocationManager
      • Media
      • Tealium
      • TealiumConfig
      • VisitorProfile
      • VisitorService
    • Release Notes
  • Cordova 1.x
    • Overview
    • Install
    • Track
    • Data Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
    • API Reference
    • Release Notes
  • Cordova 2.x
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Flutter 1.x
    • Overview
    • Install
    • Track
    • Consent Management
    • Data Management
    • API Reference
    • Release Notes
  • Flutter 2.x
    • Overview
    • Install
    • Track
    • Consent Management
    • Data Management
    • API Reference
      • Tealium
      • TealiumConfig
      • VisitorProfile
    • 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
      • AdobeVisitorService Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DeviceData Module
      • In-App Purchase Module
      • Lifecycle Module
      • Location Module
      • Media Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
    • Working with Objective-C
    • API Reference
      • LocationModule
      • MediaSession
      • 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
    • Location Module
    • API Reference
    • Release Notes
  • Unity 1.x
    • Overview
    • Install
    • Track
    • API Reference
  • Unity 2.x
    • Overview
    • Install
    • Track
    • API Reference
  • Xamarin 1.x
    • Overview
    • Install
    • Track
    • Data Management
    • Consent Management
    • API Reference
    • Release Notes
  • Xamarin 2.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • API Reference
    • Release Notes
  • Web
  • Getting Started
    • Overview
    • Quick Start Guide
    • Web Concepts
    • Data Layer
      • An Introduction to the Data Layer
      • How the Data Layer Works for Websites
      • Data Layer Best Practices
      • Definitions
        • Retail
        • Publisher
        • Hotel
        • Travel
        • Basic Video Tracking
  • Adobe Launch
    • Overview
    • Install
    • Data Layer
  • AMP
    • Overview
    • Install
    • Track
    • Data Layer
  • Angular
    • Overview
    • Install
    • Track
    • API Reference
  • Google Tag Manager
    • Overview
    • Install
    • Data Layer
  • JavaScript (Web)
    • Overview
    • Install
    • Track
    • Data Layer
    • 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
IOS SWIFT V1

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
"Track "
Previous
Track
Next
Data Management
"Data Management"

 

Was this article helpful?

This page was last updated: July 23, 2020      

Thank you for your feedback!

Table of Contents

  • AppData
  • Attribution
  • Autotracking
  • ConsentManager
  • Connectivity
  • Core
  • Crash Reporter
  • DeviceData
  • DispatchQueue
  • Lifecycle
  • Location
  • TagManagement
  • VolatileData
  • Platforms
  • Partners
  • Forums
  • Mobile
  • Getting Started
  • Remote Commands
  • Android (Java)
  • Android (Kotlin)
  • Cordova 1.x
  • Cordova 2.x
  • Flutter 1.x
  • Flutter 2.x
  • iOS (Objective-C)
  • iOS (Swift) 1.x
  • iOS (Swift) 2.x
  • NativeScript
  • React Native 1.x
  • React Native 2.x
  • Unity 1.x
  • Unity 2.x
  • Xamarin 1.x
  • Xamarin 2.x
  • Web
  • Getting Started
  • Adobe Launch
  • AMP
  • Angular
  • Google Tag Manager
  • JavaScript (Web)
  • Server
  • C#
  • HTTP API
  • Java
  • Node
  • Python
  • Roku
  • Ruby