• 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

  • Requirements
  • Sample Apps
  • Install
  • Initialize
  • Track Views
  • Track Events
  • API Reference
IOS OBJECTIVE C

tvOS

Learn to install Tealium for tvOS.

tvOS is no longer supported. The Tealium iOS (Swift) library is recommended.

Requirements

  • Tealium Customer Data Hub account
  • Xcode 7+
  • tvOS 9.0+
  • 100KB available space in .ipa file size
  • Bitcode compliant framework 

Sample Apps

To help familiarize yourself with the Tealium library, tracking methods, and best practice implementation, it is recommended to download the tvOS sample apps.

To abstract the Tealium implementation from the rest of your app, we recommend the use of the sample helper class. This gives you a single entry point from which to initialize and make tracking calls. It also allows you to update the code in your helper file, and not in every single header/method file.

Install

Install and manage Tealium dependencies for tvOS with CocoaPods. 

  1. Add the following dependency to your Podfile:

    pod 'TealiumTVOS'
  2. Download and install Tealium for tvOS.

    We recommend cloning the library (instead of downloading) to make it easier to update to future releases.

  3. Add TealiumTVOS.framework to your project’s tvOS Extension target, and copy the framework to the project in the resulting dialog box.

  4. In the target’s General: Embedded Binaries section, add the framework:

    TealiumTVOS.framework

Initialize

In the Application Delegate, or within a helper class setup method, invoke a Tealium instance with the following code:

    let config = TEALConfiguration.init(account: "ACCOUNT",
                          profile: "PROFILE",
                          environment: "ENV",
                          datasource: "DATASOURCE")
    
    guard let tealium = Tealium.newInstanceForKey("uniqueInstanceKey", configuration: config) else {
        // Any additional failure response here
        return
    }
    TEALConfiguration *configuration = [TEALConfiguration
                          configurationWithAccount:@"ACCOUNT"
                          profile:@"PROFILE"
                          environment:@"ENV",
                          datasource:@"DATASOURCE"];
    
    Tealium *tealiumInstance1 = [Tealium newInstanceForKey:@"INSTANCE" configuration:configuration]; 

    Parameter Description Example
    account Tealium account name "companyXYZ"
    profile Tealium profile name "main"
    environment Tealium environment name ["dev", "qa", "prod"]
    datasource (Optional) data source key "abc123"
    instance Unique Tealium instance identifier (multiple instances are supported) "tealium_main"

    Track Views

    Track screen views by calling trackViewWithTitle() with two parameters: the name of the screen and (optionally) contextual view data.

    In any UIViewController’s viewDidAppear() method: 

      Tealium.instanceForKey("uniqueInstanceKey")?.trackViewWithTitle(NSStringFromClass(self.classForCoder), dataSources: [:])
      [[Tealium instanceForKey:@"INSTANCE"] trackViewWithTitle:NSStringFromClass([self class]) dataSources:nil];

      The screen name is populated in the event data as screen_title.

      Track Events

      Track non-view events by calling trackEventWithTitle() with two parameters: an event name and (optionally) contextual event data. 

        Tealium.instanceForKey("INSTANCE")?.trackEventWithTitle("EVENT_NAME", dataSources: [:])
        [[Tealium instanceForKey:@"INSTANCE"] trackEventWithTitle:@"EVENT_NAME" dataSources:nil];

        The event name is populated in the event data as tealium_event.

        API Reference

        See the TealiumTVOS Reference API for a complete list of classes and methods.

        Tag Management
        watchOS

         
        • 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: February 4, 2021       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