Connecting CleverTap on Clarisights
CleverTap is a customer engagement platform for mobile and web push, in-app, email, and SMS campaigns. Connecting your CleverTap project to Clarisights brings campaign delivery and engagement metrics into your reporting alongside your paid acquisition spend, so you can measure full-funnel performance from acquisition through retention.
At a glance
| Authentication | Account ID + Account Passcode (CleverTap REST API headers) |
| Permissions needed | An account with access to the CleverTap project's API credentials. Passcode is generated by a CleverTap admin under Settings → Engage → API Keys |
| Account discovery | One CleverTap project = one Clarisights account. Add additional projects by creating a new connection |
| Data freshness | Every 6 hours |
| Lookback window | Per CleverTap's campaigns / reports endpoints |
| Backfill on connect | All campaign history exposed by CleverTap's API |
| Timezone | Set per account on connection (defaults to Asia/Kolkata; configurable) |
| Currency | Set per account on connection (defaults to USD; configurable) |
| Levels supported | Account · Campaign |
| Limited rollout | No |
Prerequisites
An active CleverTap project (any region: EU, US, India, Singapore, etc.)
The project's Account ID and a valid Account Passcode from Settings → Engage → API Keys in CleverTap
Permission to read campaign reports in CleverTap (the role attached to the passcode determines what the API can return)
Steps to Connect
Step 1 — Locate your CleverTap API credentials
Sign in to CleverTap. Open Settings → Engage → API Keys (also called Project Preferences) and copy:
Your Account ID
The Passcode (generate a new one if you don't have a passcode visible)
[TODO: Screenshot needed — CleverTap Settings page showing Account ID and Passcode]
Treat the passcode like a password. It grants read access to your CleverTap project's reporting API.
Step 2 — Add CleverTap in Clarisights
In Clarisights, go to Integrations → CleverTap and click Add Account.
[TODO: Screenshot needed — Integrations page CleverTap row]
Step 3 — Enter credentials and account details
Fill in the connection form:
Name — a friendly label for this connection
Account ID — from CleverTap
Account Passcode — from CleverTap
Currency — the currency to associate with this account in Clarisights (default
USD)Timezone — the timezone to associate with this account in Clarisights (default
Asia/Kolkata)
Click Save.
⚠ Common error: "Authentication failed" or "Invalid passcode" → Double-check that you copied the Account ID and Passcode without trailing whitespace, and that the passcode hasn't been rotated. If your CleverTap project is on a non-default region (EU/SG/IN), confirm with your CleverTap admin that the keys are valid.
Step 4 — Verify in Clarisights
The new account appears in the CleverTap source list with status Active.
Verify the connection
Go to Integrations → CleverTap. The account should be listed with its Account ID, timezone, and currency.
First campaign data appears within ~6 hours of the next scheduled sync.
Quick start: open a new report, add CleverTap as the data source, group by Campaign, and add Sent · Delivered · Opens · Conversions to validate.
Data available
Hierarchy
CleverTap's reporting is campaign-centric. Each campaign belongs to a project (account):
Native level (CleverTap) | Clarisights level |
Account / Project | Account |
Campaign | Campaign (also serves as Ad Group and Ad for cross-channel compatibility) |
Dimensions
Dimension | Level | Description |
Account / Account ID | Account | CleverTap project name and ID |
Campaign / Campaign ID | Campaign | Campaign name and CleverTap campaign identifier |
Channel Type | Campaign | Push, In-App, Email, SMS, WhatsApp, Web Push, etc. |
Campaign Type | Campaign | One-time, Scheduled, Triggered, Journey, etc. |
Campaign Status | Campaign | Active, Paused, Completed, Draft |
Created By / Created At | Campaign | User who created the campaign and timestamp |
Custom Tags | Campaign | Tags configured on the campaign in CleverTap (available as a tag group dimension) |
Metrics
Delivery
Metric | Description |
Sent | Total messages sent |
Delivered | Messages successfully delivered to the device / inbox |
Failed | Messages that failed delivery |
Bounced | Hard / soft bounces (email) |
Unsubscribes | Recipients who unsubscribed via the campaign |
Engagement
Metric | Description |
Opens / Views | Email opens or push/in-app views |
Unique Opens | Distinct recipients who opened |
Clicks | Total clicks on the message |
Unique Clicks | Distinct recipients who clicked |
CTR | Click-through rate |
Conversions
Metric | Description |
Conversions | Conversion events attributed to the campaign (per CleverTap's conversion event configuration) |
Conversion Value | Revenue / value associated with the conversions (in account currency) |
Conversion Rate | Conversions divided by sent or delivered |
Limitations & known constraints
Single project per account: each Clarisights CleverTap account corresponds to one CleverTap project. Connect each project separately.
Currency and timezone are configured at connect time: CleverTap's API doesn't expose project-level currency / timezone, so you set these in Clarisights when adding the account.
Cohort / segment metrics not available: per-segment breakdowns inside a campaign are not exposed via the public reporting API and aren't available in Clarisights.
Custom event metrics: only conversion events configured in CleverTap are pulled. Raw event-stream data is not synced.
Passcode rotation: if a CleverTap admin rotates the passcode, the integration starts failing. Update the passcode in Clarisights via Integrations → CleverTap → Edit.
Operating notes
Refresh schedule: every 6 hours.
Multi-account: each CleverTap project requires its own Account ID + Passcode pair. Add as many connections as you have projects.
Currency conversion: the currency you set at connect time is preserved and converted to your reporting currency by Clarisights.
Credential rotation: when the CleverTap passcode is rotated, update it under Integrations → CleverTap → Edit. The Account ID does not change.
Region: CleverTap projects in EU, IN, SG, and US regions all work as long as the Account ID + Passcode combination authenticates against CleverTap's API.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and Account ID (Integrations → CleverTap)
The exact error message or screenshot
The step where the issue occurred
When the issue started