Versions Compared

Key

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

...

Parameter

Type

Required

Description

Example

access-token

string

Yes

Token used to identify the authenticity of the user.

"access-token": "$accessToken"

REQUEST Parameters (in Query String)

Parameter

Data Type

Required

Description

Example

respondentId

Query String Parameter

yes

Unique respondent ID

respondentId=TestSessionId

memberId

Query String Parameter

no

Persistent member ID

memberId=TestMemberId

respondentLocalization

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

maxNumberOfSurveysReturned

Query String Parameter

no - defaults to 12

Set the max number of surveys to return in the response, sorted by internal score

maxNumberOfSurveysReturned=10

...

Info

We will return a value “ir” which is the PureSpectrum after targeting Incidence (Conversion) Rate. This is either a measured statistic, or based off of a buyer’s prior performance in a country.

Best Practices

We highly encourage passing in a memberId of the respondent in the Request Params. Doing so allows us to retrieve the respondent profile if it exists in our system, and remove any attempted surveys from the response.

We recommend the delay between the API request being made and the session beginning be at a minimum (less than 5 seconds). The longer the delay between a respondent receiving their entry link and them clicking on it to enter Fusion, the more likely the opportunity is to no longer be available for them.

Passing in Demographics

To maximize the quality of matches for a respondent, we recommend passing in as many demographic variables as possible. At a minimum, please refer to Profiling - Appending Qualifications InfoWe highly encourage passing in a memberId of the respondent in the Request Params. Doing so allows us to retrieve the respondent profile, and remove any attempted surveys from the response.

...

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.

...