Testing

All apps created in the Publisher Dashboard are set to test mode by default.

Test mode limitations:

• Survey wall is not available
• Interactions are limited
• Only test devices can access content

Purpose: Verify the integration is properly configured before going live.

Applies to every integration

Test mode, test devices, and going live apply to all integration paths. The verification walkthrough below uses the SDK survey wall as the example; with the Hosted Link, Eligibility API, or Survey Feed API, you verify through that path's own survey flow.

Steps to Go Live

1. Add a test device
2. Complete test mode verification
3. Promote the app to live mode

Once you set up a new app, select the Testing link in "App Overview" to navigate to the app checklist.

Add a Test Device

Only test devices can access apps in test mode.

To add a test device:

1. Go to the Publisher Dashboard
2. Click New Device
3. Enter:
   • Device test name - A descriptive name for the device
   • Device identifier - Use one of:
     • iOS: IDFA
     • Android: Advertising ID
     • Or a unique user identifier

The identifier you send must be the one you register

Test mode keys off the identifier your integration actually sends — there's no separate "test account." Whatever value you pass as the user identifier (the userIdentifier in the SDK, or the uid / user_identifier in a Hosted Link URL or API request) has to be registered here as a test device. If it isn't, that user sees "no surveys available" (SDK / Hosted Link) or gets has_offer: false / is_eligible: false (Eligibility API / Survey Feed API) — which looks like a broken integration but is really just test mode doing its job.

Firing a test callback/postback on its own does not exercise this — a real session from a registered test device is what's required.

Test Mode

Once the SDK is initialized, open the survey wall to enter test view.

Note: If you're testing from an unsupported country, you'll default to the US and see US surveys. However, you may encounter issues taking surveys due to IP location restrictions.

Complete the test: Click the Complete button to generate a test survey completion. This will trigger a callback.

QA Checklist

Once your test device is added:

1. Complete a test survey
2. Complete all other test tasks shown in the UI

Live Mode

To go live:

1. Navigate to App Overview → Testing
2. Click Go Live

Testing After Going Live

When your app is live but you're still using a test device:

If you haven't completed the prescreener:

If you've completed the prescreener:

Normal live mode (non-test device):