Repassar parâmetros

5. Repassar parâmetros por meio de uma pesquisa

Às vezes você precisa que seus próprios parâmetros voltem junto com os resultados.

Por exemplo, a página com a pesquisa no seu site só está disponível para usuários cadastrados e logados, e você conhece o user_id interno do participante. Nesse caso, você pode passar esse user_id para a pesquisa, e ele voltará para o seu script (ou função JS) junto com os resultados. Além disso, o parâmetro fica salvo no relatório do respondente na sua conta do Simpoll. Assim você sabe a qual usuário pertencem as respostas recebidas.

Para passar parâmetros para uma pesquisa:

• incorpore a pesquisa em uma página do seu site;
• adicione na mesma página um campo oculto com os parâmetros (como string de consulta codificada para URL);

Exemplo de como passar parâmetros para uma pesquisa:

<?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/pt/embed/framejs/aa7ca07e"></script>

O campo oculto precisa ter o ID simpoll_params.

O código de incorporação da pesquisa deve vir depois do campo oculto; caso contrário, os parâmetros não são enviados.

Quando a pesquisa é concluída, o Simpoll envia esses parâmetros com os resultados para a URL de resultados (ou para a função callback).

Exemplo do que o Simpoll envia:

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
                )
        )
)

Os demais parâmetros são os mesmos descritos em 3.2.

Passar parâmetros na URL da pesquisa

Se você compartilhar um link direto em vez de incorporar a pesquisa, ainda pode passar os parâmetros na URL dele.

Exemplo de URL com parâmetros:

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

Parâmetros no relatório do respondente

Todos os parâmetros recebidos ficam salvos com os resultados de cada respondente.

Você os vê na coluna da direita do relatório do respondente na sua conta.