Use Application Analytics to autocollect events and track application specific events and state changes.

• iOS(9.0 and above)
• iPadOS(13.0 and above)
• tvOS(9.0 and above)
• watchOS(TBD)

• SPM
  • https://github.com/conviva/conviva-ios-appanalytics
• Cocoapods
  • Add below line in pods file
    • pod 'ConvivaAppAnalytics', '1.0.1'

NOTE: During pod installation, if you are facing any issues with FMDB, Please update your file as below and do pod installation.

• Add below line in pods file

  • pod 'ConvivaAppAnalytics', '1.0.1'

• Manual Download

  • Download and unzip the package from Downloads. During the build phase, add ConvivaAppAnalytics.xcframework to Link Binary with Libraries section in xcode. This package contains the frameworks for both, iOS and tvOS.

• Link the following system frameworks to Link Binary with Libraries section in xcode:

  • UIKit
  • Foundation
  • CoreTelephony (iOS only)
  • In Other Linker Flags section in Xcode, add "-ObjC".
  • To refer to the Conviva classes from your source code, add the following import statements:

* Swift:
import ConvivaAppAnalytics

* ObjC:
@import ConvivaAppAnalytics;

It is recommended to initialize the Conviva Tracker at the earliest possible stage in the application's launch lifecycle. Ideally, this should be done in the app's entry point method, before any other application functionalities are executed.

func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool

// Initialization
* Swift:
let tracker = CATAppAnalytics.createTracker(customerKey: customerKey, appName: appName)

// The tracker object can be fetched using the following API in the other classes than the place where createTracker is invoked using following API:
let tracker = CATAppAnalytics.defaultTracker();

// Initialization
* ObjC:
id<CATTrackerController> tracker = [CATAppAnalytics createTrackerWithCustomerKey:customerKey appName:appName];

// The tracker object can be fetched using the following API in the other classes than the place where createTracker is invoked using following API:
id<CATTrackerController> tracker = [CATAppAnalytics defaultTracker];

customerKey - a string to identify specific customer account. Different keys shall be used for development / debug versus production environment. Find your keys on the account info page in Pulse.

appName - a string value used to distinguish your applications. Simple values that are unique across all of your integrated platforms work best here.

* Swift:
tracker?.subject?.userId = "user_id"

* ObjC:
tracker.subject.userId = @"user_id";

Use trackCustomEvent(name:data:) to track all kinds of events. This API provides 2 fields to describe the tracked events.

• eventName - Name of the custom event.
• data – Any type of data in string format.

The following example shows the implementation of the trackCustomEvent.

* Swift:
let data = "{\"identifier1\": \"test\",\"identifier2\": 1,\"identifier3\":true}"
tracker?.trackCustomEvent("your-event-name", data: data)

* ObjC:
NSString *data = @"{\"identifier1\": \"test\",\"identifier2\": 1,\"identifier3\":true}";
[tracker trackCustomEvent:@"your-event-name" data:data];

Use trackCustomEvent(name:eventData) to track all kinds of events. This API provides 2 fields to describe the tracked events.

• eventName - Name of the custom event.
• eventData – Dictionary/Array of dictionaries

The following example shows the implementation of the trackCustomEvent.

* Swift:
var eventData = ["identifier1":"test","identifier2":1,"identifier3":true] as [String : Any]
tracker?.trackCustomEvent("your-event-name", eventData: eventData)

* ObjC:
NSDictionary *data = @{@"identifier1":@"test",@"identifier2":@(1),@"identifier3":@(true)};
[self trackCustomEvent:@"your-event-name" eventData:data];

When user navigates between screens, user journey is tracked by reading the class names of UIViewController classes. Name of the screens can be customized using below code as per the bussiness needs.

* Swift:
* //Add below property in view controller
* @objc var catViewId:String = "App Analytics View"

* ObjC:
* //Declare property like below
* @property(copy, nonatomic)NSString *catViewId;
* //Add below line in viewDidLoad method
* self.catViewId = @"Customizable name";

Support is added to pass custom data as key-val pairs which are available in each event triggered by sdk and passed to backend. Below are the new api additions to support Custom Tags.

* ObjC:
// Setter API

/**
 * Set custom tags.
 * Pass custom tags
 * @param tags Dictionary of Key-Val pairs.
 */
- (void)setCustomTags:(NSDictionary *)tags;

//Usage
NSDictionary* tags = @{
    @"Key1": @"Value1",
    @"Key2": @"Value2",
};
[tracker setCustomTags:tags];

// Clear API
/**
 * Clears all custom tags.
 */
- (void)clearCustomTags;

//Usage
[tracker clearCustomTags];

/**
 * Clears custom tags which are matching keys as passed in.
 * Keys of tags to be cleared
 * @param tagKeys tagKeys.
 */
- (void)clearCustomTags:(NSArray *)tagKeys;

//Usage
NSArray* keys = @[ @"Key1", @"Key2", @"Key3" ];
[tracker clearCustomTags:keys];

* Swift:
//Usage: Set custom tags
let tags = ["Key1": "Value1", "Key2": "Value2"]
tracker?.setCustomTags(tags)

//Usage: Clear all custom tags
tracker?.clearCustomTags()

//Usage: Clear custom tags
let keys = ["Key1", "Key2", "Key3"]
tracker?.clearCustomTags(keys)