Skip to Content

InMobi

Sync audience segments to InMobi DSP for mobile advertising, retargeting, and prospecting campaigns. Upload your warehouse segments to InMobi’s audience platform using device identifiers (IDFA, GAID).

Prerequisites

  • An InMobi advertiser account with API access enabled
  • An API key (Secret Key) generated from your InMobi account settings
  • Your InMobi Account ID
  • Your Property ID (Advertiser ID)

Permissions

Your InMobi account must have:

  • API access enabled (contact your InMobi account manager if not available)
  • Permission to create and manage audience segments
  • Access to the advertiser property you want to sync segments to

Authentication

InMobi uses API key-based authentication with session tokens.

  1. In InMobi, go to My Account > Account Settings
  2. Navigate to the API Key tab
  3. Click Generate API Key to create your secret key
  4. Copy the API Key and your Account ID
  5. Enter both values in Zeotap

Zeotap automatically generates and refreshes session tokens using your API key. Sessions are valid for 24 hours and are refreshed proactively.

Configuration

FieldTypeRequiredDescription
Property ID (Advertiser ID)TextYesYour InMobi advertiser property ID. Found in My Account > Account Settings. Example: 1234567890

Target Settings

FieldTypeRequiredDescription
Segment NameTextYesName of the InMobi audience segment. Must be uppercase with no spaces or special characters. Example: MY_CDP_AUDIENCE
Segment IDTextNoExisting segment ID to update. Leave blank to create a new segment automatically.
Membership TTL (Days)TextNoNumber of days a user remains in the segment. Default: 30

Supported Operations

Sync Modes

This destination is audience-only and does not support standard data sync modes.

Audience Sync Modes

ModeSupported
AddYes
RemoveYes
MirrorYes
Upsert

Features

  • Field Mapping: No
  • Schema Introspection: No

Required Mapping Fields

InMobi requires mobile device identifiers for audience matching. Your data must include at least one of:

FieldDescription
idfaApple Identifier for Advertisers (iOS devices)
gaidGoogle Advertising ID (Android devices)
device_idGeneric mobile advertising identifier

How It Works

  1. Session Generation: Zeotap authenticates with InMobi using your API key and account ID to generate a session token (valid 24 hours)
  2. Segment Creation: If no segment ID is provided, Zeotap creates a new audience segment using the InMobi segment API
  3. Batch Upload: Device identifiers are compiled into a gzip-compressed CSV file and uploaded via the InMobi batch ingestion endpoint
  4. Processing: InMobi processes uploaded data asynchronously. It may take up to 24 hours for audience data to reflect in the DSP

Batch Details

  • Upload format: Gzip-compressed CSV (.csv.gz)
  • Max file size: 10 MB per upload
  • Chunk size: Up to 100,000 device IDs per request
  • Identifier types: IDFA (iOS), GAID (Android)

Rate Limits

InMobi enforces the following limits:

  • Session tokens expire after 24 hours from generation
  • Batch upload files must not exceed 10 MB (compressed)
  • Contact your InMobi account manager for specific API rate limit details for your account tier

Best Practices

  • Use uppercase segment names without spaces or special characters (e.g., HIGH_VALUE_USERS instead of High Value Users)
  • Set appropriate TTL values based on your campaign lifecycle. Shorter TTLs ensure fresher audiences
  • Map both IDFA and GAID fields when available to maximize audience match rates across iOS and Android
  • Monitor processing status in the InMobi DSP console. Uploads may take up to 24 hours to process
  • Use Mirror mode for ongoing syncs to keep your InMobi audience in sync with warehouse segments, automatically adding new members and removing departed ones
  • Reuse the Segment ID after the first run — the InMobi segment API has no name-based lookup, so leaving Segment ID blank on subsequent runs creates a new segment each time. After the first successful sync, copy the returned segment ID into the target settings to keep reusing the same segment

Troubleshooting

Authentication failed: invalid API key or account ID

Verify your API key and account ID in the InMobi portal under My Account > Account Settings > API Key. Regenerate the API key if needed. Ensure your account has API access enabled.

Segment creation failed

Segment names must be uppercase with no spaces or special characters. Check that your Property ID is correct and that your account has permission to create segments.

Upload returned HTTP 400 or 413

The upload file may exceed the 10 MB size limit. Reduce the batch size or ensure device IDs are not duplicated. Verify that the segment ID and property ID are valid.

No device IDs found in batch

InMobi requires mobile device identifiers (IDFA or GAID). Ensure your source data includes columns named idfa, gaid, or device_id with valid advertising identifiers.

Audience data not appearing in DSP

InMobi processes audience uploads asynchronously. Allow up to 24 hours for data to appear. Check the upload job status in the InMobi DSP console.

Duplicate segments created on each sync

If you leave Segment ID blank, Zeotap creates a new InMobi segment on every sync run because InMobi does not expose a lookup-by-name endpoint. After the first successful run, check the InMobi DSP console for the created segment ID and paste it into the Segment ID target setting so subsequent runs update the same segment.

Session expired errors

Sessions are valid for 24 hours. Zeotap automatically refreshes sessions, but if you see session errors, verify that your API key has not been rotated in the InMobi portal.

Last updated on