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="http://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 с параметрами:

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

				

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

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

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