Liftoff Ads
API Documentation: Liftoff Ads API Documentation
High-Level Information: The Liftoff Ads API (powered by Vungle) enables access to advertising data and campaign management, including applications, campaigns, creatives, and performance reporting with various dimensional breakdowns (by country, platform, placement, site, and ad type).
Source Setup Guide
Prerequisites
You will need access to Liftoff’s:
- Management API (for metadata like applications, campaigns, creatives)
- Reporting API (for daily performance reports)
Some streams require specific permissions. If your account does not have access to Management and/or Reporting endpoints, those streams will not be available in the discovered catalog.
Step 1
Click the Connect button under Source Settings in the setup page.
Step 2
Enter your Liftoff API credentials:
- API Key: Your Liftoff Reporting API key
- Secret Key: Your Liftoff Management API secret key
- Refresh Token: Your Liftoff Management API refresh token
Step 3
Confirm that the source is Connected.
Connection Setup Guide
Once you connected Liftoff Ads to a destination, you will also need to configure:
- Connection Pull Schedule: Determines how frequently data is extracted from the source.
- Backfill (Days): Specifies the duration for which historical data will be retrieved during each connection run.
- Destination specific settings: different settings such as "Dataset Name" or "Target Schema" (depending on your destination)
- Schema Migration Policy: Controls how Extract will handle schema changes from the source.
Authentication
This connector uses token-based authentication:
- A short-lived access token is generated using your Secret Key and Refresh Token.
- The connector automatically refreshes the access token when it expires.
- Requests are rate-limited to help avoid API throttling.
Configuration Reference
Source settings
| Field | Type | Required | Description |
|---|---|---|---|
api_key | string | No* | Liftoff API key. Used for some endpoints and/or account access patterns. Provide it if available. |
secret_key | string | Yes | Liftoff Management API secret key. Used to generate an access token. |
refresh_token | string | Yes | Liftoff Management API refresh token. Used to generate an access token. |
backfill | integer | Yes | Number of days of historical data to fetch for report streams (e.g., daily_*). |
* The connector accepts api_key as optional, but your Liftoff account setup may require it to access certain data.
Connector Information
- Authentication: API Key / Token-based authentication
- The connector uses two separate APIs:
- Management API: For pulling applications, campaigns, and creatives metadata
- Reporting API: For pulling daily performance reports with various dimensional breakdowns
- Data streams availability depends on your account permissions (management vs reporting access)
Schema ERD
Explore the interactive entity relationship diagram for Liftoff Ads.
Data Streams
applications
Management API stream containing application metadata available to the authenticated account.
campaigns
Management API stream containing campaign metadata. This stream may be used as a parent for related campaign sub-resources.
campaigns_budget_daily_spend_limit_geos
Management API stream containing campaign daily spend limit geo configuration (where available).
campaigns_budget_publisher_rates
Management API stream containing campaign publisher rate configuration (where available).
campaigns_tracking_events
Management API stream containing campaign tracking event configuration (where available).
creatives
Management API stream containing creative metadata.
daily_campaign_by_country
Reporting API stream with daily campaign performance broken down by country.
daily_campaign_by_placement
Reporting API stream with daily campaign performance broken down by placement.
daily_campaign_by_platform
Reporting API stream with daily campaign performance broken down by platform.
daily_campaign_by_site
Reporting API stream with daily campaign performance broken down by site.
daily_creative_by_ad_type
Reporting API stream with daily creative performance broken down by ad type.
daily_creative_by_country
Reporting API stream with daily creative performance broken down by country.
daily_creative_by_placement
Reporting API stream with daily creative performance broken down by placement.
daily_creative_by_platform
Reporting API stream with daily creative performance broken down by platform.
daily_creative_by_site
Reporting API stream with daily creative performance broken down by site.