Integrating Liftoff on Clarisights
Liftoff is a mobile growth platform for programmatic user acquisition and re-engagement. Connecting Liftoff to Clarisights lets you blend mobile install and post-install performance into your cross-channel reporting and analyse spend, installs, and ROAS alongside your other paid channels.
At a glance
| Authentication | API key + secret (HTTP Basic auth) |
| Permissions needed | API credentials with read access on /apps, /campaigns, /creatives, and /reports |
| Account discovery | Automatic — every app linked to the credentials is offered |
| Data freshness | Daily |
| Lookback window | 3+ days (rolling) |
| Backfill on connect | Configurable; default backfill is the recent rolling window. Longer history can be requested via support |
| Timezone | Account timezone (defaults to your company timezone) |
| Currency | USD (Liftoff reports in USD by default) |
| Levels supported | Account (App) · Campaign · Ad (Creative) · Publisher and Country segments |
| Limited rollout | Beta — connector is generally available, contact your CSM if you need help onboarding |
Prerequisites
An active Liftoff advertiser account
An API key and API secret with the required endpoint permissions — request these from your Liftoff Account Manager
The credentials must have access to all the apps you want to connect
Steps to Connect
Step 1 — Request API credentials from Liftoff
Contact your Liftoff Account Manager to issue an API key and secret with read access on the following endpoints:
For background, see Liftoff's Reporting API documentation.
Treat the API secret like a password. It grants read access on every app linked to it.
Step 2 — Add Liftoff in Clarisights
In Clarisights, go to Integrations → Liftoff and click Add User.
[TODO: Screenshot needed — Clarisights Integrations page Liftoff row]
Step 3 — Enter credentials
Provide a friendly Name for this user, then paste the API Key (Username) and API Secret (Password). Click Validate.
[TODO: Screenshot needed — Liftoff add-user form with Name, API Key, API Secret fields]
Clarisights authenticates with Liftoff by issuing a small test report request. If the credentials are valid, the test passes and account discovery starts.
⚠ "Invalid credentials" → Confirm the API key and secret are correct and have not been rotated. Re-issue from Liftoff if needed.
⚠ "Rate limit reached" → Liftoff enforces per-user rate limits (e.g., 30 report creations per hour). Wait a few minutes and retry, or stagger account additions.
Step 4 — Select apps to connect
After validation, Clarisights pulls the full list of apps linked to the credentials. Pick the ones you want to connect, optionally rename them, and click Create Accounts.
Verify the connection
Go to Integrations → Liftoff. Each connected app should show a "Connected" status.
First data appears within 24 hours of the next scheduled sync.
Quick start: create a new report, add Liftoff as the data source, and add Account · Campaign · Impressions · Clicks · Spend · Installs.
Data available
Hierarchy
How Liftoff's native levels map to the standard Clarisights levels:
Native level (Liftoff) | Clarisights level |
App | Account |
Campaign | Campaign and Ad Group (Liftoff has no native Ad Group; Ad Group fields alias to Campaign) |
Creative | Ad |
Publisher / Country (segments) | Available as breakdown segments under each campaign |
Dimensions
Dimension | Level | Description |
Account / Account ID | Account | App name and ID |
App Title | Account | App marketing title |
Platform | Account | iOS or Android |
Bundle ID / App Store ID | Account | Native app identifier and store ID |
Optimization Event | Account | Configured optimisation event for the app |
Campaign / Campaign ID | Campaign | Campaign name and ID |
Campaign Type | Campaign | e.g., user-acquisition, retargeting |
Tracker Type | Campaign | e.g., MMP |
Min OS Version / Max OS Version | Campaign | OS targeting bounds |
Ad / Ad ID | Ad | Creative name and ID |
Ad Width / Height | Ad | Creative dimensions in pixels |
Creative Type | Ad | e.g., image, video, playable |
Preview URL / Full HTML Preview URL | Ad | Visual preview of the creative |
Publisher | Segment | Publisher / placement breakdown |
Country | Segment | Country breakdown for installs and engagement |
Metrics
Core engagement
Metric | Description |
Impressions | Total ad impressions |
Clicks | Total clicks |
Spend | Total spend in account currency |
Installs & acquisitions
Metric | Description |
Installs | Attributed app installs |
SKAN Uncensored Installs | SKAdNetwork installs reported with conversion value |
SKAN Censored Installs | SKAdNetwork installs reported without conversion value |
Real Acquisition | Net new acquisitions per Liftoff's attribution |
Derived rates & costs
Metric | Description |
CPM | Cost per thousand impressions |
CPC | Cost per click |
CTR | Click-through rate |
CPI | Cost per install |
CPA | Cost per acquisition |
Limitations & known constraints
No native Ad Group level: Liftoff's API does not expose Ad Groups. Ad Group fields in Clarisights map to Campaign for cross-channel compatibility.
USD only by default: Liftoff reports spend in USD. If your reporting currency is different, Clarisights converts on the fly.
Per-user rate limits: Liftoff enforces hourly rate limits at the API user level (e.g., 30 report creations per hour, 60 report listings per hour). For very large advertisers, contact support to plan partitioning.
Async report generation: Liftoff generates reports asynchronously; very large reports can take time to complete. Clarisights polls until ready or surfaces a creation failure if the job is cancelled or stuck.
Country segment only: Currently only the country segment is enabled by default. Additional segments (e.g., device) can be requested via support.
Auto-account sync: Newly created apps in Liftoff with positive spend in the last month are auto-added daily.
Operating notes
Refresh schedule: data is pulled daily.
Lookback: rolling 3-day window is re-fetched on each run to capture late-arriving conversions.
Adding new apps: an auto-sync job runs daily at 05:30 UTC and adds any new apps with recent spend. You can also manually refresh from Integrations → Liftoff.
Currency conversion: USD spend is preserved on ingest and converted to your reporting currency by Clarisights.
Credential rotation: update the API key / secret any time from Integrations → Liftoff → Edit Credentials.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and account ID (Integrations → Liftoff)
The Liftoff app ID (visible in the Liftoff dashboard URL)
The exact error message or screenshot
The step where the issue occurred
When the issue started