Singular (formerly known as Apsalar)
Introduction
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.
Warning
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
- To track attribution and events data in your Android app, perform the steps listed in Singular Android SDK Integration Guide.
- 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() {
@Override
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
- To track attribution and events data in your iOS app, perform the steps listed in Singular iOS SDK Integration Guide.
- 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:
- From the CleverTap dashboard, navigate to Analytics > Events.
- 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.


Note
Revenue and Custom events received from Singular are prefixed with AP in CleverTap.
Updated 6 months ago