• 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

  • Track Views
  • Track Events
IOS OBJECTIVE C

Track

Learn about the methods for tracking user activity.

Track Views

Track screen views with the trackViewWithTitle() method. This is done in the viewDidAppear() method of any View Controller. This method accepts two parameters: the name of the screen and (optionally) contextual view data. 

The screen name value is set in the event attribute screen_title.

    // Retrieve instance
    let tealium = Tealium.instance(forKey: "INSTANCE")
    
    // Basic
    tealium?.trackViewWithTitle("SCREEN_NAME", dataSources: nil)
    
    // With optional data
    let optionalData = ["KEY1": "VALUE1"]
    tealium?.trackView(withTitle: "SCREEN_NAME", dataSources: optionalData)
    
    // With optional array data
    let optionalData = ["KEY1": ["STRING1", "STRING2"]]
    tealium?.trackView(withTitle: "SCREEN_NAME", dataSources: optionalData)
    // Retrieve instance
    Tealium *tealium = [Tealium instanceForKey:@"INSTANCE"];
    
    // Basic
    [tealium trackViewWithTitle:@"SCREEN_NAME" dataSources:nil];
    
    // With optional data
    NSDictionary *optionalData = @{@"KEY1" : @"VALUE1"};
    [tealium trackViewWithTitle:@"SCREEN_NAME" dataSources: optionalData];
    
    // With optional array data
    NSDictionary *optionalData = @{@"KEY1" : @[@"STRING1", "STRING2"]};
    [tealium trackViewWithTitle:@"SCREEN_NAME" dataSources: optionalData];

    Parameter Type Description Swift Example iOS Example
    title String Title of view "screenName" "screenName"
    customDataSources [String] (Optional) Custom datasources (key-value pairs) to be included in the event dispatch @{@"someKey": @"someValue"} ["someKey": "someValue"]

    Track Events

    Track non-view activity with the trackEventWithTitle() method. This method accepts two parameters: an event name and (optionally) contextual event data.

    The event name value is populated in the event attribute named tealium_event.

      // Retrieve instance
      let tealium = Tealium.instance(forKey: "INSTANCE")
      
      // Basic
      tealium?.trackEvent(withTitle: "EVENT_NAME", dataSources: nil)
      
      // With optional data
      let optionalData = ["KEY1": "VALUE1"]
      tealium?.trackEvent(withTitle: "EVENT_NAME", dataSources: optionalData)
      
      // With optional array data
      let optionalData = ["KEY1": ["STRING1", "STRING2"]]
      tealium?.trackEvent(withTitle: "EVENT_NAME", dataSources: optionalData)
      // Retrieve instance
      Tealium *tealium = [Tealium instanceForKey:@"INSTANCE"];
      
      // Basic
      [tealium trackEventWithTitle:@"EVENT_NAME" dataSources:nil];
      
      // With optional data
      NSDictionary *optionalData = @{@"KEY1" : @"VALUE1"};
      [tealium trackEventWithTitle:@"EVENT_NAME" dataSources:optionalData];
      
      // With optional array data
      NSDictionary *optionalData = @{@"KEY1" : @[@"STRING1", @"STRING2"]};
      [tealium trackEventWithTitle:@"EVENT_NAME" dataSources:optionalData];

      Parameter Type Description Swift Example iOS Example
      title String Title of event "someEvent" "someEvent"
      customDataSources [String] (Optional) Custom datasources (key-value pairs) to be included in the event dispatch @{@"someKey": @"someValue"} ["someKey": "someValue"]
      Install
      Data Layer

       
      • 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 24, 2019       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