• Android Mobile

• Android Tablets

• Android Smart TV’s

• Android Native

• Jetpack Compose

• Get Client ID:

ConvivaAppAnalytics.getClientId(context);

• Set Client ID:

ConvivaAppAnalytics.setClientId(context, "client-id");

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

// eventName - Name of the custom event
// eventData - Data in a JSONObject or a JSON-formatted String
// Set up the event properties JSONObject
JSONObject eventDataJSON = new JSONObject();
eventDataJSON.put("identifier1", intValue);
eventDataJSON.put("identifier2", boolValue);
eventDataJSON.put("identifier3", "stringValue");

String eventName = "your-event-name";

tracker.trackCustomEvent(eventName, eventDataJSON);

Add the following proguard rules to keep Conviva SDK classes from obfuscation.

-keepnames class * extends android.view.View
-keep, allowshrinking class com.conviva.** { *; }

Response and Request Body atributes are collected only when the:

• size is < 10kb and the content-length is available

• content-type is "json" or "text/plain"

• data is a JSONObject or Nested JSONObject or JSONArray

Response and Request Headers are collected only when the:

• data is a JSONObject, Nested JSONObject and JSONArray

  • server is provisioned with "Access-Control-Expose-Headers:"*

As the screen load times are not reliable and are inaccurate for Fragments/Compose, we will not be able to collect it in future as well.

• Apple iPhones (iOS)

• Apple TV (tvOS)

• Apple Native

• Swift UI

• Get Client ID:

//Swift:
let clientId = CATAppAnalytics.sharedInstance()?.getClientId();

//ObjC:
NSString *clid = [[CATAppAnalytics sharedInstance] getClientId];

• Set Client ID:

//Swift:
CATAppAnalytics.sharedInstance()?.setClientId(clientId);

//ObjC:
[[CATAppAnalytics sharedInstance] setClientId:clid];

Use the two APIs to track custom events:

/**
 * Track custom event.
 * @param name Name of the custom event.
 * @param data A JSON-formatted string.
 */
- (void)trackCustomEvent:(NSString *)name data:(nonnull NSString*)data;

/**
 * Track custom event.
 * @param name Name of the custom event.
 * @param eventData Dictionary/Array of dictionaries.
 */
- (void)trackCustomEvent:(NSString *)name eventData:(nonnull id)eventData;

Examples:

// 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];

No planned date as of now.

No planned date as of now.

• All Web Browsers

• Smart TV’s Web Apps

• HTML-based Web Apps

• React-based Web Apps

• Angular-based Web Apps

The definition of a page view event depends on the type of application:

• For Multi-Page Applications (MPAs), each full page load counts as a new view.

• For Single-Page Applications (SPAs), a page view may be triggered by a route or URL path change.

Optionally call trackPageView() based on how navigation is handled in the specific app, to enable the associated metric Average Largest Contentful Paint Time.

Call trackPageView() whenever a significant page navigation occurs, such as a full page load, route change, or in-app view transition, to track page views. You have complete control over when to trigger trackPageView(). Conviva recommends calling trackPageView() only after a page is ready, meaning the content is both visible and usable. Avoid invoking it during the initial DOM load.

Example:

trackPageView(); // Uses document.title
trackPageView({ title: "Custom Page Title" });

If you skip the trackPageView() call during a navigation event, that page view won’t be recorded. Hence, the associated metric (Average Largest Contentful Paint Time) will not be displayed correctly in the Pulse dashboard. Remember, Conviva does not auto-capture any missing page views.

• Get Client ID:

import {
    convivaAppTracker,
    getClientId,
} from '@convivainc/conviva-js-appanalytics';

convivaAppTracker({
    appId: 'YOUR_APP_NAME_AS_STRING',
    convivaCustomerKey: 'CONVIVA_ACCOUNT_CUSTOMER_KEY',
    appVersion: '1.1.0',
});

// Always call getClientId() after initializing convivaAppTracker()
clientId = getClientId();

• Set Client ID:

import {
    convivaAppTracker,
    getClientId,
} from '@convivainc/conviva-js-appanalytics';

// Always call setClientId() before initializing convivaAppTracker() to set a specific clientId
setClientId(clientId);

convivaAppTracker({
    appId: 'YOUR_APP_NAME_AS_STRING',
    convivaCustomerKey: 'CONVIVA_ACCOUNT_CUSTOMER_KEY',
    appVersion: '1.1.0',
});

Use the trackCustomEvent() API to track all kinds of events that are not auto-collected.

This API provides 2 fields to describe the tracked events:

name - Name of the custom event

data - Any type of data in JSON format.

import { trackCustomEvent } from '@convivainc/conviva-js-appanalytics';

let customData = {
    identifier1: 'test',
    identifier2: 1,
    identifier3: true,
};

trackCustomEvent({
    name: 'Custom Event Name',
    data: customData,
});

When you navigate within a single-page application, new pages are not loaded, so they will not be tracked as page views.

To track page views in single page applications, call the trackpageview API.

We support only :

• XMLHttpRequest

• fetch

Page Title can be passed as part of trackPageView api, if title is not set then page title is autodetected using api document.title when trackPageView api is called.

We support click on input element type button or if element tag name is button.

if customer application adds stopPropagation or preventDefault in there button click event listener then conviva will not be able to detect the click.

We support link click tracking on element if element tag name is <a>.

if customer application adds stopPropagation or preventDefault in there link click event listener then conviva will not be able to detect the click.