...
In the Request of the API, you will specify the countrylocale, respondent demographics, session ID and member ID, and psid (if available). In the response, you will receive a list of full-match and/or partial-match surveys that for which the respondent qualifies for.
The surveys will include fully formed “Fusion Entry Links”, specifically tailored with the correct CPI and maxLOI to target these survey opportunities. If the respondent fails to qualify, they will be sent to other relevant opportunities.
...
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
access-token | string | Yes | Token used to identify the authenticity of the user. | "access-token": "$accessToken" |
REQUEST
...
Query String
...
Parameters
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 |
...
One-time Entry Links - given the links in the API response are generated to provide a specific respondent an opportunity, they should be treated as a one-time use entry link.
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 Profiling - Appending Qualifications for further details.
...