Руководство разработчика

5. Передача параметров через опрос

Иногда требуется вместе с результатами опроса передать собственные параметры.

Например, предположим, что страница с опросом на Вашем сайте доступна только для зарегистрированных и авторизованных пользователей и Вам известен внутренний user_id пользователя, который участвует в опросе. В таком случае Вы можете передать этот user_id опросу и он вернется Вашему скрипту (или JS-функции) вместе с результатами опроса. Плюс, этот параметр будет сохранен в отчете по респонденту который можно просматривать в личном кабинете Simpoll. Таким образом Вы сможете узнать какому из Ваших пользователей принадлежат полученные ответы.

Для того чтобы передать опросу любые параметры, Вы должны:

Встроить опрос на страницу Вашего сайта;
На этой же странице создать невидимое поле с перечислением параметров (в формате URL-кодированной строки запроса);

Пример передачи параметров опросу:

<?php
    // Массив параметров, которые нужно будет передать
    // нашему сайту после прохождения опроса.
    // Может формироваться динамически, при необходимости.
    $params_arr = array(
        'user_id' => 123,
        'user_login' => 'anonymous'
    );
    // Формируем URL-кодированную строку запроса
    $params_str = http_build_query($params_arr);
?>
<!-- Формируем поле со строкой запроса -->
<input type="hidden" id="simpoll_params" value="<?php echo $params_str; ?>" />
<!-- Подключаем опрос -->
<script type="text/javascript" src="https://simpoll.ru/embed/framejs/aa7ca07e"></script>

Скрытое поле должно иметь идентификатор simpoll_params.

Подключение опроса в теле страницы должно быть строго ниже скрытого поля, иначе параметры не будут переданы.

После прохождения опроса Simpoll отправит на Result URL (или в callback-функцию) переданные параметры вместе с результатами опроса

Пример ответа Simpoll:

POST:
(
    [user_id] => 123
    [user_login] => anonymous
    [sp_survey_id] => 551
    [sp_survey_key] => aa7ca07e
    [sp_resp] => Array
        (
            [id] => 172693
            [ip_addr] => 127.0.0.1
            [name] => Респондент #172693
            [time_start] => 2011-12-13 13:23:24
            [time_end] => 2011-12-13 13:23:45
            [time_delta] => 00:00:21
            [quiz_passed] => 0
            [quiz_percent] => 33
            [quiz_correct] => 3
            [quiz_wrong] => 2
        )
    [sp_result] => 1
    [sp_answers] => Array
        (
            [1] => Array
                (
                    [0] => Италия
                )
            [2] => Array
                (
                    [0] => Пирамиды
                    [1] => Кремль
                    [2] => Колизей
                    [3] => Эйфелева башня
                )
        )
)

Остальные параметры идентичны описанным в разделе 3.2.

Передача параметров через URL опроса

Если Вы не встраиваете опрос на страницу сайта, а даете респондентам прямую ссылку на него то Вы по прежнему можете передавать параметры опросу через его URL.

Пример URL с параметрами:

https://simpoll.ru/run/survey/aa7ca07e?userid=123&userlogin=anonymous

Просмотр параметров в отчете по респонденту

Все переданные параметры сохраняются в результатах опроса для каждого респондента отдельно.

При просмотре результатов по конкретному респонденту в личном кабинете Simpoll эти параметры будут выведены в колонке справа.

Передача параметров

Руководство по Simpoll API

Простое объяснение без кода

5. Передача параметров через опрос

Передача параметров через URL опроса

Просмотр параметров в отчете по респонденту