Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

REQUEST Query String Parameters

Parameter

Data Type

Required

Description

Example

respondentId

Query

String

Parameter

yes

Unique session ID

respondentId=TestSessionId

memberId

Query

String

Parameter

no

yes

Persistent member ID

memberId=TestMemberId

respondentLocalization

String

respondent localization (reference)

en_US

profile data

Query

String

Parameter

no

The information stored in your system related to the respondent profile. See “Passing in Demographics”

211=111&212=111&229=90403

ipAddress

String

no

respondent IP address

ipAddress=187.112.108.180

userAgent

String

no

respondent user agent

userAgent=Mozilla%2F5.0%20(X11%3B%20Linux%20x86_64)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F126.0.0.0%20Safari%2F537.36

maxNumberOfSurveysReturned

Query String Parameter

Integer

no

- defaults to 12

Set the max number of surveys to return in the response, sorted by internal score (defaults to 12)

maxNumberOfSurveysReturned=10

Code Block
GET
https://fusionapi.spectrumsurveys.com/surveys/fusionMatch?memberId=TestMemberId&respondentId=TestSessionId&respondentLocalization=en_US&211=111&212=28&215=114
Host: fusionapi.spectrumsurveys.com
access-token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

...

Time Difference between API request and session start - The delay between the API request being made and the session beginning should be at a minimum (less than 5 seconds). The longer the delay between the API response providing the entry link and the respondent receiving the entry link to enter Fusion, the more likely the opportunity is to be no longer available for them.

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.

...

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.

...