Learn about Singular's integration with CleverTap and how to configure sending in-app event and mobile attribution decision data* to CleverTap's platform. CleverTap is a customer engagement and retention platform that provides the functionality to integrate app analytics and marketing to increase user engagement with your brand through emails, SMS, push notifications, etc.

Integration Summary

(See Partner Integrations Glossary)

Partner	CleverTap
Partner Type	Marketing Automation
Creatives	Not Supported
Publisher	Not Supported
View-Through	Not Supported
Re-engagement	Not Supported
S2S	Not Supported
Click Tag	Not Supported
Receiving All Installs	Supported
Receiving All Events	Supported

Prerequisites

To complete the CleverTap integration you will need to update your Singular SDK integration and pass the CleverTap ID via Singular's Global Properties. See our SDK documentation regarding Global Properties (Android SDK documentation and iOS SDK documentation).

Android (Java)

In your Android app code, add the following code.

For SDK version 4.2.0 and above:

CleverTapInstance.getCleverTapID(new OnInitCleverTapIDListener() {
     @Override
     public void onInitCleverTapID(final String CleverTapID) {
         // Callback on main thread
         SingularSDK.setGlobalProperty("CLEVERTAPID", CleverTapID, true);
     }   
  });

For older SDK versions:

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

iOS (Obj-C)

Add the following code to your iOS app:

[CleverTap autoIntegrate];
    [Singular setGlobalProperty:@"CLEVERTAPID" value:[[CleverTap sharedInstance] profileGetCleverTapAttributionIdentifier] overrideExisting:YES];

Configuration Instructions

For general instructions on setting up a partner, see the Partner Configuration FAQ.

For CleverTap, you need to fill out the following fields:

Field	Description
CleverTap Account ID	Take these values from your CleverTap account.
CleverTap Account Passcode
CleverTap Account Token
API Region	Default is "API".

The default API Region value is "API".

Tracking Link Setup

If you would like Singular to measure the attribution of your email or SMS campaigns managed through CleverTap, please contact our support team to ensure we can set this up.

Special Considerations

You should not expect to compare unique users or unique event counts from CleverTap with any unique user or unique event counts in Singular's reporting. Singular only reports unique event counts in Cohort Reports which are calculated from the date a user installed your app. You also will only see unique event counts if you have chosen to set this up for an event within the Events page in your Singular account.

Singular does show ACTUAL event counts, but this does not represent unique users or unique event counts. It represents the actual event counts that happened during the reported date range.

*Singular will send the attributed media source name in postbacks to CleverTap if there are no data-sharing restrictions with the media source and third parties. Please see more details here for media sources that have data-sharing restrictions with third parties.