CISAnalyticsProtocol

@protocol CISAnalyticsProtocol <NSObject>

/**
* Returns client id.
* @return clientid.
*/
- (NSString*) getClientId;

/**
* Creates video analytics objects.
* @return CISVideoAnalytics instance.
*/
- (CISVideoAnalytics) createVideoAnalytics;

/**
* Applicable only incase of  Conviva Module case. Creates video analytics objects.
* @param options Refer USER OPTIONS section defined in CSSConstants.h
* @return CISVideoAnalytics instance.
*/
- (CISVideoAnalytics) createVideoAnalytics:(NSDictionary*)options;

/**
* Creates ad analytics objects.
* @return CISAdAnalytics instance.
*/
- (CISAdAnalytics) createAdAnalytics;

/**
* Creates ad analytics object by linking already created video analytics object.
* @param videoAnalytics Video analytcis object.
* @return CISAdAnalytics instance.
*/
- (CISAdAnalytics) createAdAnalyticsWithVideoAnalytics:(CISVideoAnalytics) videoAnalytics;

/**
* Reports app level event.
* @param event Event name.
* @param details Event details.
*/
- (void) reportAppEvent:(NSString*)event details:(NSDictionary*)details;

/**
* Reports app background event useful to initiate cleanup.
*/
- (void) reportAppBackgrounded;

/**
* Reports app forground event useful to resume the analytics session.
*/
- (void) reportAppForegrounded;

/**
* @brief Set user preferences for data collection.
* @param userPrefs pass key value pair as user preferences.
* Currently Supported keys: "idfa", "idfv".
* Expected Values:
* YES - Will collect id for mentioned key.
* NO - Will stop collecting id for mentioned key.
* Sample Usage:
* [clientSettings setUserPreferenceForDataCollection:[NSDictionary dictionaryWithObjectsAndKeys: @YES, @"idfa", @NO, @"idfv", nil]];
*/
- (void) setUserPrefsForDataCollection:(NSDictionary *)userPrefs;

/**
 * @brief Set user preferences for data collection.
 * @param userPrefs pass key value pair as user preferences.
 * Currently Supported keys: "idfa", "idfv".
 * Expected Values:
 * YES - Will stop collecting id for mentioned key and delete previously collected data.
 * NO - Will not have any effect.
 * Sample Usage:
 * [clientSettings setUserPreferenceForDataDeletion:[NSDictionary dictionaryWithObjectsAndKeys: @NO, @"idfa", @YES, @"idfv", nil]];
*/
- (void) setUserPrefsForDataDeletion:(NSDictionary *)userPrefs;

/**
* Performs required cleanup.
*/
- (void) cleanup;

@end

Undocumented

  • Returns client id.

    Declaration

    Objective-C

    - (nonnull NSString *)getClientId;

    Swift

    func getClientId() -> String

    Return Value

    clientid.

  • Creates video analytics objects.

    Declaration

    Objective-C

    - (nonnull CISVideoAnalytics)createVideoAnalytics;

    Swift

    func createVideoAnalytics() -> CISVideoAnalytics

    Return Value

    CISVideoAnalytics instance.

  • Applicable only incase of Conviva Module case. Creates video analytics objects.

    Declaration

    Objective-C

    - (nonnull CISVideoAnalytics)createVideoAnalytics:
        (nonnull NSDictionary *)options;

    Swift

    func createVideoAnalytics(_ options: [AnyHashable : Any]) -> CISVideoAnalytics

    Parameters

    options

    Refer USER OPTIONS section defined in CSSConstants.h

    Return Value

    CISVideoAnalytics instance.

  • Creates ad analytics objects.

    Declaration

    Objective-C

    - (nonnull CISAdAnalytics)createAdAnalytics;

    Swift

    func createAdAnalytics() -> CISAdAnalytics

    Return Value

    CISAdAnalytics instance.

  • Creates ad analytics object by linking already created video analytics object.

    Declaration

    Objective-C

    - (nonnull CISAdAnalytics)createAdAnalyticsWithVideoAnalytics:
        (nonnull CISVideoAnalytics)videoAnalytics;

    Swift

    func createAdAnalytics(withVideoAnalytics videoAnalytics: CISVideoAnalytics) -> CISAdAnalytics

    Parameters

    videoAnalytics

    Video analytcis object.

    Return Value

    CISAdAnalytics instance.

  • Reports app level event.

    Declaration

    Objective-C

    - (void)reportAppEvent:(nonnull NSString *)event
                   details:(nonnull NSDictionary *)details;

    Swift

    func reportAppEvent(_ event: String, details: [AnyHashable : Any])

    Parameters

    event

    Event name.

    details

    Event details.

  • Reports app background event useful to initiate cleanup.

    Declaration

    Objective-C

    - (void)reportAppBackgrounded;

    Swift

    func reportAppBackgrounded()
  • Reports app forground event useful to resume the analytics session.

    Declaration

    Objective-C

    - (void)reportAppForegrounded;

    Swift

    func reportAppForegrounded()
  • @brief Set user preferences for data collection.

    Declaration

    Objective-C

    - (void)setUserPrefsForDataCollection:(nonnull NSDictionary *)userPrefs;

    Swift

    func setUserPrefsForDataCollection(_ userPrefs: [AnyHashable : Any])

    Parameters

    userPrefs

    pass key value pair as user preferences. Currently Supported keys: “idfa”, “idfv”. Expected Values: YES - Will collect id for mentioned key. NO - Will stop collecting id for mentioned key. Sample Usage: [clientSettings setUserPreferenceForDataCollection:[NSDictionary dictionaryWithObjectsAndKeys: @YES, @“idfa”, @NO, @“idfv”, nil]];

  • @brief Set user preferences for data collection.

    Declaration

    Objective-C

    - (void)setUserPrefsForDataDeletion:(nonnull NSDictionary *)userPrefs;

    Swift

    func setUserPrefsForDataDeletion(_ userPrefs: [AnyHashable : Any])

    Parameters

    userPrefs

    pass key value pair as user preferences. Currently Supported keys: “idfa”, “idfv”. Expected Values: YES - Will stop collecting id for mentioned key and delete previously collected data. NO - Will not have any effect. Sample Usage: [clientSettings setUserPreferenceForDataDeletion:[NSDictionary dictionaryWithObjectsAndKeys: @NO, @“idfa”, @YES, @“idfv”, nil]];

  • Performs required cleanup.

    Declaration

    Objective-C

    - (void)cleanup;

    Swift

    func cleanup()