Liftoff Audiences
Overview
The Liftoff Audiences destination allows you to sync custom audience data to Liftoff for user targeting and suppression campaigns. You can either select an existing audience or create a new one directly from the platform.
Singular connects to Liftoff's Audiences API at https://analytics.liftoff.io/singular/v1/audiences.
Setup Guide
Prerequisites
To connect Liftoff Audiences, you'll need:
| Parameter | Required | Description |
|---|---|---|
api_key | Yes | Your Liftoff API key |
Contact your Liftoff account representative to obtain API credentials. For more details, see Liftoff's API Audiences documentation.
Stream Parameters
Each stream requires the following parameters:
| Parameter | Required | Description |
|---|---|---|
audience_selection | Yes | Select an existing audience or choose "Create new audience" |
audience_name | When creating | Name for the new audience |
platform | When creating | Target platform: android or ios |
How It Works
- Select an existing audience from your Liftoff account or create a new one
- The platform syncs device IDs to the selected audience
- Records marked as "Added" or "Changed" are added to the audience
- Records marked as "Removed" are removed from the audience
Device IDs are automatically normalized based on the platform:
- iOS: Device IDs (IDFA) are converted to uppercase
- Android: Device IDs (GAID) are converted to lowercase
Data Contract Information
Data contracts for Liftoff Audiences are coming soon. This destination supports device IDs (GAID/IDFA) for audience syncing with add/remove operations.