Amplitude Export

Analytics Partner

Overview

Amplitude, an analytics and business intelligence platform, helps make informed decisions for targeting users. Integration CleverTap with Amplitude allows you to export your CleverTap event data to your Amplitude dashboard. You can use this event data for further analysis.

Integrate Amplitude with CleverTap

This process involves the following two steps:

  1. Find Amplitude Project Details.
  2. Configure CleverTap Dashboard.

Find Amplitude Project Details

  1. Log in to your Amplitude account.
  2. Navigate to the Settings page.
  3. Navigate to Org Settings > Projects.
  4. Click on a project to find the API Key under the General tab.
3552

Finding API Key

Configure CleverTap Dashboard

To configure the CleverTap dashboard:

  1. Navigate to Settings > Partners from the CleverTap dashboard.
2700

Navigating to Partners Page

  1. Hover on the Amplitude icon and click Integrate. The Integrate analytics partner - Amplitude popup opens on the right side of the screen.
2214

Integrate Amplitude

  1. Enter the following details and click Integrate:

Field

Description

Partner Nickname

Enter the Nickname for your integration.

API key

The unique code for Amplitude to verify your credentials. For more information about obtaining the key, refer to Find Amplitude Details.

Data Residency

The Data Residency is the physical/geographical storage location of data for each project.

  • Select from the following available options:
    • Europe (default)
    • Standard
Device ID MappingThis field is mapped to Amplitude's device_id field for identification when sending data from CleverTap to Amplitude.
User ID MappingThis field is mapped to Amplitude's user_id field for identification when sending data from CleverTap to Amplitude.
2224

Enter Amplitude Project Details to Integrate

After successful integration, the Integrated tag displays against Amplitude on the Partner List page.

2224

Amplitude Integration Successful

Create New Export

This section lists steps to create a new export from the CleverTap dashboard. To do so:

  1. Navigate to Settings > Partners > Exports from the CleverTap dashboard.
  2. Click + Export and select Amplitude from the Partners dropdown.
2222

Create Export

The Export to Amplitude window displays on the right side of the screen.

2228

Enter Export Details

  1. Configure the following settings:
    • Type: Select the events to export from the available options. For more information, refer to Export Details.
    • Frequency: Select from one of the following options:
      • Once only: A single export for the selected export type. You can export data up to the last 60 days. You create an export for a specific day, date range, previous month, current month, and more.
      • Recurring: Set up a recurring export that exports all the new events/user profiles captured in the last window. You can export as frequently as every 4 hours and up to once every 24 hours.
  2. Click Export. The Export to Amplitude window closes, and the following message displays at the top of Exports page:
2150

Amplitude Export Initiated

CleverTap processes the export, and you can now see the newly created export for Amplitude.

2216

New Amplitude Export Displays on Exports Page

The status for each export is displayed as Pending as soon as the export is created. The status changes to Running after the processing starts. In the case of Once only export, the status changes to Done when the export is complete.

Stop Export

You can also stop the export that you have created. To do so, click the Stop export icon for the export request you want to stop and then click Stop to confirm your action.

2216

Stop Amplitude Export

You now return to the Exports page, and the Amplitude data export stopped message displays at the top. The status of the export is displayed as Stopped.

2216

Amplitude Export Stopped

Edit an Export

You might need to modify an export to meet specific business requirements or while waiting for the next run. This section describes editing a Live Data Streaming and Recurring export in the Running and Pending (awaiting next run) state.

📘

Points to Remember

  • In case of running exports, the new changes will apply to the next run.
  • You cannot edit a One-time export, regardless its status (running, pending, completed, or stopped).
  • You cannot change the export from User Profile to Event and vice-versa.
  • You cannot modify exports marked as Completed or Stopped.
  • Export changes for Live DataStreaming take 10-15 minutes to take effect.

To edit an export:

  1. On the CleverTap dashboard, go to Partners > Exports.
Ellipsis Icon to Edit the Export

Ellipsis Icon to Edit the Export

  1. Click the Ellipsis icon. The Edit and the Stop buttons appear.
Click the Edit Export Icon

Click the Edit Export Icon

  1. Click the Edit button. The Overview section appears.
Edit the Export

Edit the Export

  1. Edit the export details and click Update.

Export Details

Select from one of the following options to export events from CleverTap to the Amplitude dashboard:

All events

Export data for all defined events, including System and Custom events.

Selected events

Select the specific events you want to export from CleverTap to the Amplitude dashboard.

Engagement Events

Select this option to export the following engagement events:

CleverTap Event Name

Event Description

Notification Sent

The event is tracked when the notification is successfully sent from CleverTap to the communication channel you select for your campaign.

Notification Viewed

This event is tracked when a user views an email, in-app notification, or a web notification sent from CleverTap.

Notification Clicked

This event is tracked only when a user clicks on a notification sent via CleverTap. It is recorded when a user clicks on a mobile push, in-app, email, web popup, or web push message sent via the CleverTap dashboard or through the campaign API.

Push Impressions

This event is tracked when a Push notification sent from CleverTap is delivered on a user’s device.

Notification Replied

This event is tracked when a user replies to a WhatsApp message.

Push Unregistered

The event is raised when the user unregisters to receive Push Notifications.

Control Group

The event is raised when a campaign is activated with a Control group.

Channel Unsubscribed

The event is raised when a user unsubscribes to receive further communication through a channel.

Reachable By

  • The debug event is raised when the user becomes reachable by a communication channel such as SMS, email, or mobile push, or when there are changes to the existing communication channel.
  • Tracked for a profile when:
    • Push token is added/changed.
    • Email ID is added/changed.
    • Phone number is added/changed.
Push ImpressionsThis event is tracked when a push notification sent from CleverTap is delivered on a user’s device. The funnels on the Push campaign statistics page reflect the count for this event.
Notification DeliveredThis event is recorded when communication is delivered to the user's device
AB Experiment RenderedThis event is recorded when communication is delivered to the user who is part of an A/B experiment campaign
AB Experiment StoppedThis event is recorded when AB experiment is stopped.
AB Experiment Rolled OutThis event is recorded when AB experiment is started
Geocluster EnteredThis event is recorded to mark when a device enters a geofence.
Geocluster ExitedThis event is recorded to mark when a device exits a geofence.
Reply SentThis event is recorded when an agent (CleverTap user) replies to a message from the end-user.
App UninstalledThis event is recorded when a user uninstalls your application.
Webhook DeliveredThis event is recorded when a Webhook campaign is delivered successfully
State TransitionedThis event is recorded for Lifecycle Optimizer when a user transitions from one stage to another.
UTM VisitedThis event is tracked when a user clicks on a link from a marketing campaign that has a UTM parameter defined on it.