Pasar parámetros

5. Pasar parámetros a través de una encuesta

A veces necesitas que tus propios parámetros vuelvan junto con los resultados.

Por ejemplo, la página con la encuesta en tu sitio solo es accesible para usuarios registrados que han iniciado sesión, y conoces el user_id interno del participante. En ese caso puedes pasar ese user_id a la encuesta y volverá a tu script (o función JS) junto con los resultados. Además, el parámetro se guarda en el informe del encuestado en tu cuenta de Simpoll. Así sabrás a qué usuario pertenecen las respuestas recibidas.

Para pasar parámetros a una encuesta:

• inserta la encuesta en una página de tu sitio;
• añade en la misma página un campo oculto con los parámetros (como cadena de consulta codificada para URL);

Ejemplo de cómo pasar parámetros a una encuesta:

<?php
    // Array of parameters to be sent
    // to our site after passing the poll.
    // It can be formed dynamically, if necessary.
    $params_arr = array(
        'user_id' => 123,
        'user_login' => 'anonymous'
    );
    // Create URL-coded inquiry line
    $params_str = http_build_query($params_arr);
?>
<!—Create a field with inquiry line -->
<input type="hidden" id="simpoll_params" value="<?php echo $params_str; ?>" />
<!—Connect the poll -->
<script type="text/javascript" src="https://simpoll.com/es/embed/framejs/aa7ca07e"></script>

El campo oculto debe tener el ID simpoll_params.

El código de inserción de la encuesta debe ir después del campo oculto; si no, los parámetros no se envían.

Al completarse la encuesta, Simpoll envía estos parámetros con los resultados a la URL de resultados (o a la función callback).

Ejemplo de lo que envía 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] => Respondent No.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] => Italy
                )
            [2] => Array
                (
                    [0] => Pyramids
                    [1] => Kremlin
                    [2] => Colosseum
                    [3] => Eiffel Tower
                )
        )
)

Los demás parámetros son los mismos que se describen en 3.2.

Pasar parámetros en la URL de la encuesta

Si en lugar de insertar la encuesta compartes un enlace directo, también puedes pasar los parámetros en su URL.

Ejemplo de URL con parámetros:

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

Parámetros en el informe del encuestado

Todos los parámetros recibidos se guardan con los resultados de cada encuestado.

Los verás en la columna derecha del informe del encuestado en tu cuenta.