Clevertap

Jeongwon KimWritten by Jeongwon Kim,

Airbridge supports integration with CleverTap - a retention cloud that empowers digital brands to increase customer retention and lifetime value. By enabling the integration, you can leverage the attribution data from Airbridge and the AI/ML-powered insights from CleverTap to deliver hyper-personalized engagement campaigns to customers.

After the integration setup, the install events, in-app events, and attribution data can be sent to CleverTap. Follow the below steps for the setup.

 

 

Pre-setup for Integration

The CleverTap ID, which is the CleverTap SDK’s device ID, must be set as a device alias in Airbridge SDK by adding codes to the Airbridge SDK.

Without this pre-setup, the Airbridge data may be dropped by CleverTap even if the integration is completed successfully. See the Developer Guide for CleverTap integration for more details.

 

 

Integration with CleverTap

Submit CleverTap credentials

Attention

Before you follow the steps listed below, the CleverTap ID must be set as a device alias in the Airbridge SDK. If the codes are not added to the Airbridge SDK, the Airbridge data may not be sent to CleverTap. Make sure to read the Developer Guide for CleverTap integration and complete the pre-setup first.

 

1. Log in to your CleverTap dashboard.

CleverTap Dashboard URL by Region

To log in to the CleverTap dashboard(dashboard.clevertap.com), you must access the URL assigned to the region your account is registered in. Go to the CleverTap guide to find the CleverTap Dashboard URL by region.

 

2. Select the [Settings] icon on the left menu bar, and select the [Project] menu. The credentials, which are the Project ID, Project Token, Passcode, and Region information, can be found under the project title. The actual values are shown when you click the [Eye] icon.

The Project ID, Project Token, and Region are assigned when creating a CleverTap account and can’t be changed. The Passcode can be generated and managed for different purposes. Click the “+Passcode” and generate a new Passcode for the integration with Airbridge.

 

3. Copy the newly generated Passcode by clicking the [Copy] icon at the right end of the Passcode field. If you don’t copy the Passcode, you can’t close the window even if you click the “Done” button. The Passcode is not shown again, so save the copied Passcode somewhere safe.

 

4. Log in to your Airbridge dashboard, go to [Integrations]>[Third-party Integrations] and select “CleverTap.”

 

5. Enter the CleverTap credentials to the respective fields and click the “Submit” button. The Project ID, Project Token, and Passcode consist of alphabet letters, numbers, and hyphens (-). 

 

6. The entered values are displayed as asterisks (*). You can see the actual value by clicking the asterisks.

Automatic Event Sending

Once the credentials are successfully submitted, the Attributed Install Events are automatically sent to CleverTap. You can’t stop the automatic sending of the Attributed Install Events. Please give enough consideration before the integration setup.

 

Select events

After submitting the CleverTap credentials, you can select the Events you want to send to CleverTap by checking the checkboxes. Events that occur after the credentials are submitted will be sent to CleverTap. If you uncheck the checkboxes, Airbridge will stop sending the unchecked Events. If you check the checkboxes again, Airbridge will resume sending the checked Events.

The following events can be sent to CleverTap: 

Attributed Install Events

Attributed Install Events are Inorganic Install Events in CleverTap and are automatically sent to CleverTap when the credentials for integration are submitted. Attributed Install Events are sent to CleverTap as default at all times and can’t be unchecked.

 

Unattributed Install Events

Unattributed Install Events are Organic Install Events in CleverTap. If you want to send Unattributed Install Events to CleverTap, check the checkbox and make sure to enable the tracking of event data on CleverTap Settings.

 

In-app Events

In-app Events are Custom Events in CleverTap. If you want to send In-app Events to CleverTap, check the checkbox and make sure to enable the tracking of event data on CleverTap Settings.

When you select In-app Events, all types of in-app events are sent to CleverTap. You can not pick and choose particular in-app event types to be sent to CleverTap.

Attention

All types of in-app events will be sent to CleverTap when you select In-app Events to be sent to CleverTap. If you are using CleverTap based on data point plan, this may result in an unexpectedly high count of data points. Please be reminded that any event sent to CleverTap is counted as one data point under the data point plan.

Accept event data from Airbridge

To accept the Unattributed Install Events and In-app Events in CleverTap, you must enable the tracking of event data from Airbridge. Without this step, the Events can’t be sent to CleverTap.

 

1. Select the [Settings] icon on the left menu bar, and select [Partners] in the CleverTap dashboard.

 

2. Click the [Edit] icon, and check the checkboxes next to the events you want to enable tracking under ‘Accept data from.’

 

Update credentials

If you need to update the credentials, click on the respective fields, enter a new value, and click the “Done” button.

Passcode Refresh after Integration

The Passcode can be refreshed in CleverTap. If you refresh the Passcode after submitting the CleverTap credentials to Airbridge, you must update the refreshed Passcode. If you don’t update the refreshed Passcode, the integration is disabled from the point of time you refresh the Passcode.

 

Delete credentials

If you want to disable integration, click the “Delete” button to delete the credentials. Please note that all events sent to CleverTap before you delete the credentials remain in CleverTap. If you want to re-enable the integration, all credentials must be submitted again.

Make changes to what events to send

You can decide anytime whether to send or not to send Unattributed Install Events and In-app Events to CleverTap. If you uncheck the checkboxes, Airbridge will stop sending the unchecked Events. If you check the checkboxes again, Airbridge will resume sending the checked Events.

 

 

How to view data

When Airbridge is successfully integrated with CleverTap, you can leverage Airbridge attribution data on CleverTap to glean actionable insights.

CleverTap stores the Attributed Install Events and Unattributed Install Events data received from Airbridge under [UTM Visited]. In the CleverTap dashboard, go to [Analytics]>[Events] and find the [UTM Visited] option in the [Select event] drop-down list to use it as a filter option. In-app Events can be found under the ‘Custom events’ category in the drop-down list. Event names remain unmodified and can be selected as filter options.

 

UTM

The attribution data and events sent to CleverTap can be used to build granular user segments. The following table shows the attribution data types that can be selected as the first filter option.

Attribution data types

Description

Example

UTM source

Attributed channel name

moloco

UTM medium

Attributed publisher name

UNITY

UTM campaign

Attributed campaign name

happynewyear_festival

Event property

The following event property types can be selected as the second filter option.

#{"width":"100px"}

Event Property types

#{"width":"180px"}

Description

#{"width":"100px"}

Example

Note

event_type

Event type

inorganic_install

 

device_identifier

CleverTap device ID

__gf5b0260118ba4a

User Alias for Clever device ID

platform

OS

Android

 

abr_ad_group

Attributed ad target group

2030_male

 

abr_ad_creative

Attributed ad creative

image

 

abr_content

Attributed ad type

banner

 

abr_term

Attributed ad keyword

jeans

 

abr_action

Additional Event info

pants

Sent with In-App Events only

abr_label

Additional Event info

black

Sent with In-App Events only

abr_value

Additional Event info(numeric)

100000

Sent with In-App Events onl

 

Use case

After the integration, you can build user segments by events using the Airbride event data as filter options.

  • Attributed channel name (UTM source): moloco

  • OS (platform): Android

  • Ad target group (abr_ad_group): Males in their 20s to 30s (2030_male)

  • Ad keyword (abr_term): jeans (jeans)

If you want to create a user segment in CleverTap that matches the above factors, the filters should be selected as shown in the image below.

Was this page helpful?

Have any questions or suggestions?