Versions Compared

Key

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

Overview

Traffic Channels refreshes the survey opportunity to suppliers in the PureSpectrum Marketplace by creating a new channel for respondents within the original survey, preserving all quota statistics.

Replica:

A replica will be an exact copy of the original audience of your survey. It will keep the quotas, price and suppliers the exact same.

Specific Audience:

The Specific Audience Traffic Channel will allow you to set up and adjust age, gender, race, occupation and relationship status, as well as the more specialized advanced targeting questions and/or geographic location.

Targeted List:

The Targeted List Traffic Channel will allow you to upload a list of PureSpectrum IDs (PSIDs) and target for specific respondents.

Request

Launching a “Replica”

Send a POST request to the endpoint /buyers/v2/surveys/{surveyId}/channels

Code Block
{
"survey_title": "example",
"type": "REP"
}

Launching a “Specific Audience“

Send a POST request to this endpoint: /buyers/v2/surveys/{surveyId}/channels

Code Block
{
survey_title: 'example',
type: 'SPA',
qualifications: [
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 211
}
],
quotas: [
{
"buyer_quota_id": "qb1",
"required_count": 40,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
}
]
},
{
"buyer_quota_id": "qb2",
"required_count": 60,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
}
]
}
]
}

Launching a “Targeted List”

Send a POST request to the endpoint /buyers/v2/surveys/{surveyId}/channels

Code Block
{ 
survey_title: 'example', 
type: 'TL', 
psids: [ 
'adb79238-3eee-9c21-f58c-d8c801483001', 
'adb79238-3eee-9c21-f58c-d8c801483002', 
'adb79238-3eee-9c21-f58c-d8c801483003' 
] 
}

Result

Status code 201 created

Code Block
{ message: 'Traffic channel survey creation request accepted'// Message can be update as per requirement }

Error Handling

If the Parent survey is not live a Traffic Channel can’t be launched

Code Block
{
    "ps_api_response_code": 9999,
    "ps_api_response_message": "Survey is not in live status"
}