Filters

CleverTap

Connect Branch and CleverTap to unlock a more holistic picture of the customer journey for your app.

1328

Overview

Accurately attribute impressions, ad clicks, app installs, and in-app events to evaluate campaign performance for each of your partners.

How does it work?

Once the Branch SDK is integrated into an app, Branch can detect which Branch Links are leading to installs, re-opens, and users' actions. Enabling this integration and providing your relevant IDs will result in Branch automatically forwarding events to CleverTap, in the exact format Clevertap expects.

Branch Events Sent to CleverTap

The events Branch sends to third party data tools varies based on the events the partner supports as well as whether or not you've implemented the Branch SDK to measure said events.

CleverTap supports the following events:

  • Installs
  • Lifecycle Events
  • Commerce Events
  • Content Events
  • Custom Events

Non-referred events, clicks, web session starts, and pageviews will be excluded. Branch also sends all the data that is attached to the link that drove the referred event. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users.

Viewing Branch Data in CleverTap

In order to view Branch data in CleverTap, you can find people by Behavior or view events where your provider contains "Branch". For more information on Clevertap's reporting, please refer to their Behavioral Analytics documentation.

Prerequisites

In order to enable CleverTap, you need to have completed the following:

  1. Admin access to your Branch Dashboard.
  2. Enabled Data Feeds for your Branch account.
  3. Implemented the Branch SDK into your mobile app (iOS | Android)
  4. Implement the Clevertap SDK
  5. Admin access to your CleverTap account.

Enable CleverTap

1. Retrieve your CleverTap Information

Before you can enable the integration in your Branch dashboard, you need to retrieve your credentials from your CleverTap account.

Branch requires these credentials to not only authenticate, but to ensure your Branch data is being sent to the correct account.

Branch requires the following credentials:

  • Account ID
  • Account Token
  • Account Passcode

To find your CleverTap Account Credentials:

  1. Log in to your CleverTap account and navigate to Settings by clicking the cog at the top of the screen, then Settings Dashboard.

  1. Ensure you're looking at the correct app for your integration, then click the eye icon to show your account credentials.

  1. Copy these account credentials into the Branch dashboard as instructed below.

2. Connect CleverTap in Branch

In the Branch Dashboard in Data Feeds → Data Integrations tab, find and search for CleverTap. Then enter your CleverTap information

3. Pass CleverTap IDs to Branch

Clevertap requires you to pass through the correct identifiers to the Branch SDKs. In order to do so, retrieve the ID from the Clevertap SDK and pass this value to Branch using the following method:

  • setRequestMetadataKey() method of the Branch SDKs:
///Inside `didFinishLaunchingWithOptions`

Branch *branch = [Branch getInstance];
[CleverTap autoIntegrate];
[[Branch getInstance] setRequestMetadataKey:@"$clevertap_attribution_id"
value:[[CleverTap sharedInstance] profileGetCleverTapAttributionIdentifier]];
///Before you initialize in your Application `#onCreate` or Deep Link Activity’s `#onCreate`

Branch branch = Branch.getInstance();
branch.setRequestMetadata("$clevertap_attribution_id",
cleverTapInstance.getCleverTapAttributionIdentifier());
cleverTapInstance.getCleverTapID(new OnInitCleverTapIDListener() {
    @Override
    public void onInitCleverTapID(final String cleverTapID) {
       // Call before Branch SDK initialization
        Branch.getInstance().setRequestMetadata("$clevertap_attribution_id",
            cleverTapID);

    }
});

5. Verify Data Sent

Once the above steps are complete, you are now ready to start launching campaigns. Branch-attributed conversions will be sent to CleverTap. To verify data is being sent from Branch to CleverTap, you can look at the Branch Dashboard's Liveview Webhook Records and apply the following filter:

FilterOperatorValue
webhook partner keyequalsdi_clevertap

Troubleshooting

Testing your CleverTap integration

The simplest way to test your integration is working end to end is to open your app from a Branch link then verify the data appears in CleverTap. After doing this, you will know how you to test more advanced scenarios.

  1. Create a Branch Quick Link at https://dashboard.branch.io/quick-links.
  2. Click that Branch link to open your app.
  3. In your Branch dashboard, verify you see the open event show as a "referred session" with a "session referring link URL" in your Branch dashboard under "Liveview > Events"