Skip to main content
Version: 3.x

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.

Application 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:
Application Checklist
Application Checklist

Test Mode

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

Application Checklist

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.

Application Checklist

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

Application Checklist

QA Checklist

Once your test device is added:

  1. Complete a test survey
  2. Complete all other test tasks shown in the UI
Test mode RX screen

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:

Application Checklist

If you've completed the prescreener:

Application Checklist

Normal live mode (non-test device):

Application Checklist