Apple TV Integration with CleverTap iOS SDK

Learn how to integrate CleverTap iOS SDK for Apple TV.


CleverTap iOS SDK integration with tvOS enables you to improve user engagement and personalize the experience for your Apple TV viewers. You can gain insights into user behavior, preferences, and interactions.

This guide will walk you through the step-by-step process of installing and integrating CleverTap's Web SDK with tvOS.

Integrate CleverTap iOS SDK with Apple TV

This integration involves the following two major steps:

  1. Install CleverTap iOS SDK
  2. Integrate CleverTap iOS SDK

Install CleverTap iOS SDK

For your tvOS app, add the CleverTap iOS SDK to your Podfile:

target 'YOUR_TARGET_NAME' do  
    pod 'CleverTap-iOS-SDK'  

After you add the code, run thepod install.

Integrate CleverTap iOS SDK

To integrate CleverTap iOS SDK with your Apple TV app:

  1. Add your CleverTap account credentials.

  2. Update the .plist file:

    • Create a key called CleverTapAccountID with a string value.
    • Create a key called CleverTapToken with a string value.
    • Insert the values from your CleverTap Dashboard. Go to CleverTap Dashboard > Settings > Integration Details.
  3. Integrate CleverTap iOS SDK in AppDelegate.swift file:

    • Import CleverTapSDK to the AppDelegate.swift file.
    • Add the following method calls to the AppDelegate.swift file.
      func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
              // Configure and init the default shared CleverTap instance (add CleverTap Account ID and Account Token in your .plist file)
  4. Integrate CleverTap iOS SDK in the ViewController file:

    • Import CleverTapSDK in ViewController class file.

    • Call the following methods to identify users and to raise events:

      // onUserLogin to identify users
      let profile: Dictionary<String, Any> = [
                  "Name": "Test User",
                  "Email": "[email protected]",
                  "Plan type": "Silver",
                  "Favorite Food": "Pizza"
      // recordEvent to record an event with name
      // recordEventwithProps for recording an event with name and properties
      let props = [
                  "Product name": "Apple TV",
                  "Category": "Digital",
                  "Price": 167.00,
                  "Date": NSDate()
              ] as [String : Any]
      CleverTap.sharedInstance()?.recordEvent("RecordWithPropsButtonForTVOS_Pressed", withProps: props)