...
The Fusion Match API is reserved for top performing publisher partners. To use the Fusion Match API, you will need to request an Access-Token from our Supply Team, and must qualify based on reputation and expected send.
HEADER Parameters
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 |
| 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 |
...
| Code Block | ||
|---|---|---|
| ||
{
"respondentId": "FusionTestSessionId",
"memberId":"FusionTestMemberRespondentId"
"surveys": [
{
"surveyId": 470381,
"cpi": 1.35,
"estimatedLoi": 1,
"ir":47,
"fullOrPartialMatch": "full",
"entryLink":
"https://fusion.spectrumsurveys.com//start-session/1US0135?maxLoi=4&sessiontok
ensessiontoken=FusionTestSessionId&memberid=FusionTestMemberRespondentId&surveyId=470381"
},
{
"surveyId": 450501,
"cpi": 9.38,
"estimatedLoi": 2,
"ir": 33,
"fullOrPartialMatch": "full",
"entryLink":
"https://fusion.spectrumsurveys.com//start-session/1US0938?maxLoi=5sessiontok
en5sessiontoken=FusionTestSessionId&memberid=FusionTestMemberRespondentId&surveyId=450501"
}
]
} |
...
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.
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.
...