Что это и зачем нужно
Многие фарм-исследования рекрутируют врачей через профессиональные панельные агентства — Opinion Team, M3 Global Research, Sermo и аналогичные. Агентство присваивает каждому врачу уникальный сессионный ID, отправляет на ваш опрос с этим ID в URL (?qid=ABCD1234) и ожидает получить врача обратно с информацией: прошёл ли он опрос полностью, был ли отсеян скринером, заполнена ли квота.
Без этой интеграции данные о результате опроса остаются у вас, а агентство не понимает, кому начислить вознаграждение и кого считать завершившим опрос. Платформа решает эту задачу через 4 типа исходов и редиректы на URL агентства с подстановкой qid.
Четыре исхода
| Исход | Когда срабатывает | Код статуса (пример Opinion Team) |
|---|---|---|
| Complete | Врач дошёл до маркера полного интервью | 91 |
| Screenout | Врач отсеян на этапе скринера (попал в graph_end без маркера) | 92 |
| Quotafull | Квота закрыта на момент входа врача | 93 |
| Bad Quality | Врач прошёл опрос слишком быстро (ниже заданного порога) | 94 |
Как настроить
- Откройте опрос → нажмите «Настройки опроса» (кнопка в правой панели графа) → раскройте секцию «Интеграция с панелью».
- Параметр панели — имя параметра в URL опроса, которое будет хранить ID сессии врача. Обычно
qid, но агентство может задать своё имя. - Complete URL / Screenout URL / Quotafull URL — куда редиректить врача с соответствующим исходом. Каждый URL должен содержать плейсхолдер
{QueryID}, который мы заменим на реальное значение из URL опроса. - (Опционально) В «Дополнительно» — Bad Quality URL + Мин. время прохождения для отсеивания недобросовестных респондентов. Если врач прошёл опрос быстрее заданного порога, ему засчитается Bad Quality вместо Complete.
Пример URL для Opinion Team:
https://h.opinion.team/urlaction/sessionfinished?status=91&token={QueryID}
Иконка 📋 рядом с каждым полем скопирует такой пример в буфер обмена — отредактируйте под свой URL агентства.
Конфликт с финальным экраном
Если в финальном экране опроса настроен redirectUrl (обычная «после опроса перейти на сайт»), он игнорируется при активной панельной интеграции — приоритет у панельного редиректа. В настройках финального экрана появится жёлтое предупреждение со ссылкой «Перейти к настройкам интеграции».
Это сделано осознанно: панель ожидает врача обратно, и редирект на сторонний сайт сломает цепочку отчётности.
Как протестировать
В секции «Интеграция с панелью» есть кнопка «Сгенерировать тестовый URL» — создаст ссылку вида /survey/<slug>?qid=TEST_1747560123, скопирует её в буфер и откроет в новой вкладке. Пройдите опрос — qid вернётся в URL агентства, проверите как агентство получит данные.
Для проверки всех 4 исходов:
- Complete: пройти опрос до маркера интервью.
- Screenout: пройти ветку скринера, ведущую в
graph_endбез маркера. - Quotafull: сначала заполнить квоту (пройти опрос N раз), затем зайти с qid — должен сразу редиректить на quotafullUrl.
- Bad Quality: установить мин. время 120 сек, пройти опрос за 10 сек — после маркера должен пойти на Bad Quality URL.
Для отладки замените URL агентства на https://httpbin.org/get?status=91&token={QueryID} — httpbin покажет все переданные параметры в JSON-ответе, удобно проверить что qid корректно подставился.
Что важно знать
- Если врач зашёл без qid в URL — панельная интеграция не сработает, опрос ведёт себя как обычно (с финальным экраном).
- Если URL без
{QueryID}— мы покажем предупреждение в форме, но сохранить такое значение можно. Просто агентство не сможет идентифицировать врача в редиректе — большинство панелей это не примет. - Bad Quality URL можно не заполнять — тогда быстрые врачи получат Complete по основной логике.
- В одном опросе может быть только одна панельная конфигурация. Для работы с несколькими панелями одновременно создавайте копии опроса.
- Панельная интеграция доступна только в graph-редакторе (там, где есть маркер интервью и квоты — без них смысл интеграции теряется).
Связанные статьи
- Маркер полного интервью — определяет границу между Complete и Screenout.
- Квоты — определяет момент Quotafull.