Similar Survey helps buyer to decided the best CPI based on previous study with common market and audience. The user will have the possibility to see the last three surveys with similar audience and check the AVG CPI that the study got complete.
...
User want the ability to compare the new survey with similar studies already closed and/or invoiced
Operator can change this range via Global Settings.
LOI range (in %)
IR range (in %)
Field Time Range (in days)
If the toggle is set to off then these ranges are not included in the search
If toggle Field Time, LOI, and IR value is set to 0, then it will search for an exact match, otherwise search in range as per the value
The API will return the 3 most similar projects in the last 3 / 6 or 9 months (as per the configurations).
Value of this should be Confgured from Global Settings.
Feature Flags:
Enable Similar Surveys (For search within the company)
Allow the search to all Marketplace inventory. ( For search Globally.)
...
Search Within The Company:-
{{url}}/buyers/v2/similar-projects
Search Globally:-
{{url}}/buyers/v2/similar-projects?global=1v2/similar-projects?global=1
NOTE: In this case the AVG CPI shown should be Supplier AVG CPI + the Margin of the account. We don’t want to show the price and the margin applied for another account.
...
| Code Block | ||
|---|---|---|
| ||
// Payload Structure
{
"survey_localization": string,
"completes_required": number,
"expected_loi": number,
"expected_ir": number,
"field_time": number,
"qualifications": [
{
"qualification_name": string
"qualification_code": number,
"condition_codes": [
string(number) // "111", "112" ....
],
"range_sets": [
{
"from": number,
"to": number,
"units": number
}
] // there will be one present either condition_codes or range_sets
},
],
"quotas": [
{
"required_count": number,
"criteria": [
{
"qualification_code": number,
"condition_codes": [
string(number) // "111", "112", "113"
],
"qualification_name": string
},
{
"qualification_code": 212,
"range_sets": [
{
"units": number,
"to": number,
"from": number
}
],
"qualification_name": string
}
],
"quota_category": "autoNested"
}
]
} |
Response:-
| Code Block |
|---|
// Response Structure [ // without qualification and quotas { { "ps_survey_idlocalization": number"US", "cmpcompletes_required": number100, "titleexpected_loi": string10, "currency": { "fxexpected_ir": number10, "symbolfield_time": string10, }, "epc": number, // with qualification { "cpisurvey_localization": number"US", "completes_required": number100, "expected_loi": 10, "expected_ir": 10, "field_time": number10, "fieldedqualifications": number,[ { "qualifications": [ { "qualification_codename": "$$item.qualification_codeGender", "qualification_namecode": "$$item.q_name"211, "condition_codes": "$$item.conditions", // [] [ "111", "112" ] }, { "qualification_name": "Age", "qualification_code": 212, "range_sets": [ { "from": 18, "to": 99, "units": 311 } ] }, ] } // With Qualification and Quotas (Layered and Nested Both) { "survey_localization": "US", "completes_required": 100, "expected_loi": 10, "expected_ir": 10, "field_time": 10, "qualifications": [ { "qualification_name": "Gender", "qualification_code": 211, "condition_codes": [ "111", "112", "113" ] }, { "qualification_name": "Age", "qualification_code": 212, "range_sets": [ { "from": 18, "to": 99, "units": 311 } ] }, { "qualification_name": "Hispanic Origin", "qualification_code": 245, "condition_codes": [ "111", "112" ] } ], "quotas": [ { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "111" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 24, "from": 18 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 6, "criteria": [ { "qualification_code": 211, "condition_codes": [ "111" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 34, "from": 25 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "111" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 44, "from": 35 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "111" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 54, "from": 45 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 6, "criteria": [ { "qualification_code": 211, "condition_codes": [ "111" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 64, "from": 55 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 7, "criteria": [ { "qualification_code": 211, "condition_codes": [ "111" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 99, "from": 65 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 4, "criteria": [ { "qualification_code": 211, "condition_codes": [ "112" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 24, "from": 18 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 6, "criteria": [ { "qualification_code": 211, "condition_codes": [ "112" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 34, "from": 25 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "112" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 44, "from": 35 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "112" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 54, "from": 45 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 6, "criteria": [ { "qualification_code": 211, "condition_codes": [ "112" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 64, "from": 55 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 7, "criteria": [ { "qualification_code": 211, "condition_codes": [ "112" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 99, "from": 65 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 4, "criteria": [ { "qualification_code": 211, "condition_codes": [ "113" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 24, "from": 18 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 6, "criteria": [ { "qualification_code": 211, "condition_codes": [ "113" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 34, "from": 25 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "113" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 44, "from": 35 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 5, "criteria": [ { "qualification_code": 211, "condition_codes": [ "113" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 54, "from": 45 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 6, "criteria": [ { "qualification_code": 211, "condition_codes": [ "113" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 64, "from": 55 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 7, "criteria": [ { "qualification_code": 211, "condition_codes": [ "113" ], "qualification_name": "Gender" }, { "qualification_code": 212, "range_sets": [ { "units": 311, "to": 99, "from": 65 } ], "qualification_name": "Age" } ], "quota_category": "autoNested" }, { "required_count": 50, "criteria": [ { "qualification_code": 245, "condition_codes": [ "111" ], "qualification_name": "Hispanic Origin" } ], "quota_category": "layered" }, { "required_count": 50, "criteria": [ { "qualification_code": 245, "condition_codes": [ "112" ], "qualification_name": "Hispanic Origin" } ], "quota_category": "layered" } ] } |
Response:-
| Code Block |
|---|
// Response Structure [ { "ps_survey_id": number, "cmp": number, "title": string, "currency": { "fx": number, "symbol": string, }, "epc": number, "cpi": number, "completes_required": number, "field_time": number, "fielded": number, "qualifications": [ { "qualification_code": "$$item.qualification_code", "qualification_name": "$$item.q_name", "condition_codes": "$$item.conditions", // [] "range_sets": "$$item.range_sets" // [] } ], } ] // Example [ { "ps_survey_id": 17737, "cmp": 145, "title": "TEST-5", "currency": { "fx": 321, "symbol": "$" }, "epc": 0, "cpi": 42, "completes_required": 100, "fielded": 0, "field_time": 10, "qualifications": [ { "qualification_code": 211, "qualification_name": "Gender", "condition_codes": [ { "id": "111", "name": "Male" }, { "id": "112", "name": "Female" }, { "id": "113", "name": "Prefer not to say" } ], "range_sets": [] }, { "qualification_code": 212, "qualification_name": "Age", "condition_codes": [], "range_sets": [ { "units": 311, "to": 99, "from": 18 } ] }, { "qualification_code": 245, "qualification_name": "Hispanic Origin", "condition_codes": [ { "id": "111", "name": "Yes" }, { "id": "112", "name": "No" } ], "range_sets": [] } ], "survey_closed_date": 1725972741642 }, { "ps_survey_id": 17736, "cmp": 145, "title": "TEST-4", "epc": 0, "cpi": 42, "currency": { "fx": 321, "symbol": "$" }, "completes_required": 100, "fielded": 0, "field_time": 10, "qualifications": [ { "qualification_code": 211, "qualification_name": "Gender", "condition_codes": [ { "id": "111", "name": "Male" }, { "id": "112", "name": "Female" }, { "id": "113", "name": "Prefer not to say" } ], "range_sets": [] }, { "qualification_code": 212, "qualification_name": "Age", "condition_codes": [], "range_sets": [ { "units": 311, "to": 99, "from": 18 } ] }, { "qualification_code": 245, "qualification_name": "Hispanic Origin", "condition_codes": [ { "id": "111", "name": "Yes" }, { "id": "112", "name": "No" } ], "range_sets": [] } ], "survey_closed_date": 1725972741641 }, { "ps_survey_id": 17735, "cmp": 145, "title": "TEST 3", "currency": { "fx": 321, "symbol": "$" }, "epc": 0, "cpi": 42, "completes_required": 100, "fielded": 0, "field_time": 10, "qualifications": [ { "qualification_code": 211, "qualification_name": "Gender", "condition_codes": [ { "id": "111", "name": "Male" }, { "id": "112", "name": "Female" }, { "id": "113", "name": "Prefer not to say" } ], "range_sets": [] }, { "qualification_code": 212, "qualification_name": "Age", "condition_codes": [], "range_sets": [ { "units": 311, "to": 99, "from": 18 } ] }, { "qualification_code": 245, "qualification_name": "Hispanic Origin", "condition_codes": [ { "id": "111", "name": "Yes" }, { "id": "112", "name": "No" } ], "range_sets": "$$item.range_sets" // [] }[] } ], "survey_closed_date": 1725972741639 } ] |