/
Fusion SDK

Fusion SDK

The Fusion SDK is a mobile-friendly integration of PureSpectrum surveys. With the SDK, you get a drop-in widget that handles everything - from fetching personalized surveys to displaying the full user flow in a polished, mobile-optimized WebView.

The benefits for our mobile app partners of the SDK include:

  1. Speed to Market - integrate and go live faster! No need to build UI or handle complex survey logic.

  2. Native-like UX - WebView popups provide a seamless, in-app experience tailored to mobile users.

  3. Lower Dev Effort - no need for designers or devs to build UI elements or manage edge cases.

  4. Consistency Across Devices - an SDK ensures design and behavior work uniformly for Android (the iOS and NativeReact SDKs are in the works).

  5. Less Ongoing Maintenance - SDK handles versioning, UI improvements, and behavioral updates behind the scenes.

Why choose an SDK integration vs. API integration for your mobile app?

Feature

SDK Integration

API Integration

Feature

SDK Integration

API Integration

Survey Fetching

Automatically handled within the SDK

You call the API manually and manage logic to retrieve & select surveys

UI Presentation

Comes with a pre-built widget to show available surveys

You must build the UI to show surveys from scratch

User Flow Display

Surveys open in a mobile-optimized WebView pop-up (handled by SDK)

You must implement WebView logic or navigate manually

Personalization & Logic

SDK handles user/session state and targeting logic

You must manage state, targeting, and personalization manually

Effort to Integrate

Plug-and-play, typically a few lines of code

Requires front-end and back-end development

Maintenance

Future updates handled in SDK updates

You’re responsible for adapting to API changes

Design Consistency

Guaranteed UX that matches other partners, optimized for conversion

Risk of inconsistent or broken experiences depending on implementation

Technical Details

Our SDK integration documentation is available here. For setting up postbacks, please access your Fusion Dashboard here.

Note: we currently support Android, with iOS and ReactNative in the pipeline.

Basic Workflow

  1. Insert the lines of code relevant to your app and integration from the documentation provided aboce

  2. Display the widget to your users, customized to your preferences

  3. Test the userflow and ensure you are receiving the postback information expected

Best Practices

memberId - Passing in a value for “memberId” in the Request Params is recommended as it allows us to retrieve the respondent profile if it exists in our system, and remove any attempted surveys from the response.

respondentId - Passing in a value for “respondentId” is a requirement so that we can properly generate an entry link to Fusion, however the value of this is determined on your end. If you would like to be able to track specific transactions on your end, you will want to ensure this value is unique before providing the entry link to the respondent.

Utilize S2S Postbacks - Given the payouts will likely be variable, it’s best to implement S2S postbacks to confirm the value of Completes as they occur in real time.

Passing in Profiling Demographics - To maximize the quality of matches for a respondent, we recommend passing in as many demographic variables as possible. At a minimum, we expect age, gender and zipcode. Please refer to https://purespectrum.atlassian.net/wiki/spaces/PID/pages/2576842769 for further details.

ipAddress and userAgent fields - To improve the identification of respondents' Research Defender (RD) device IDs, especially for new participants who have not previously been routed into Fusion, it is recommended to pass these values for all respondents. Providing these values, we can enhance the accuracy of deduplication and perform standard Research Defender checks more effectively. Note: in order for us to make this check, both fields are required to be passed in.

Self Service Setup

Setting up a Fusion account can be done in a matter of minutes if you have all of the required information. This section outlines what is needed to set up an account.

In order to get started, you will need to get login credentials from the PureSpectrum team.

Portal Access

Once you have you credentials, you can begin setting up your account by logging into the portal.

https://fusionadmin.spectrumsurveys.com/dashboard/redirect-settings

Next Step

The rest of the documentation will take you through your account setup.

https://purespectrum.atlassian.net/wiki/spaces/PID/pages/2507178031

https://purespectrum.atlassian.net/wiki/spaces/PID/pages/2507374618

https://purespectrum.atlassian.net/wiki/spaces/PID/pages/2506850360

Questions

If any questions come up during the account setup process, please reach out to globalsupply@purespectrum.com