Singular (formerly known as Apsalar)


CleverTap can track the following information from Singular:

  • Install Events
  • Revenue Events
  • Custom Events
  • Fraud Data

Integrating Singular

To enable Singular integration with CleverTap dashboard:

Step 1: Add CleverTap Credentials to Singular Dashboard

To activate integration with CleverTap from the Singular dashboard, follow the steps listed under Partner Configuration in Singular documentation.

Step 2: Integrate Singular

Singular SDK's implementation requires CleverTap ID configured as a Singular custom userId.



Events without the clevertapId parameter in the postback will not be processed.

The integration steps vary for Android and iOS. The steps for both are listed below.

For Android App

  1. To track attribution and events data in your Android app, perform the steps listed in Singular Android SDK Integration Guide.
  2. Set the value of CleverTap ID as the Singular Global Property. To do so, add the following code to your Android app code. For more information, click here.

For SDK version 4.2.0 and above
The getCleverTapAttributionIdentifier method is deprecated for CleverTap Android SDKs version 4.2.0 and above. Use the new getCleverTapID method to get the CleverTap ID on the OnInitCleverTapIDListener to set GlobalProperty of Singular.

cleverTapInstance.getCleverTapID(new OnInitCleverTapIDListener() {
   public void onInitCleverTapID(final String cleverTapID) {
       // Callback on main thread
      SingularSDK.setGlobalProperty("CLEVERTAPID", cleverTapID, true);

For SDK version 4.1.1 and below

String attributionID = cleverTapInstance.getCleverTapAttributionIdentifier();
SingularSDK.setGlobalProperty("CLEVERTAPID", attributionID, true);

For iOS App

  1. To track attribution and events data in your iOS app, perform the steps listed in Singular iOS SDK Integration Guide.
  2. Add the below code to your iOS app code. For more information about setting Singular Global Property, refer to Singular documentation.
[CleverTap autoIntegrate];
[Singular setGlobalProperty:@"CLEVERTAPID" value:[[CleverTap sharedInstance] profileGetCleverTapAttributionIdentifier] overrideExisting:YES];

Step 3: Enable the Attribution Partner

After successful integration, Singular starts to push install event data to CleverTap. To receive the remaining events in CleverTap from Singular, you need to enable the same in CleverTap dashboards. For more information about enabling this advanced setup, refer to CleverTap Attribution Partner Settings.

Viewing Data in Dashboard

You can now view the event data in the CleverTap dashboard. To do so, proceed as follows:

  1. From the CleverTap dashboard, navigate to Analytics > Events.
  2. Apply the required filters for the selected event. The filters vary depending upon the type of event.

For Install Events: All the install events are tracked under the UTM Visited event.




Revenue and Custom events received from Singular are prefixed with AP in CleverTap.