CleverTap Attribution Integration

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".

mceclip1.png

The default API Region value is "API".

mceclip2.png

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.