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.