Passare parametri

5. Passare parametri attraverso un sondaggio

A volte ti serve che i tuoi parametri tornino indietro insieme ai risultati.

Per esempio, la pagina del sondaggio sul tuo sito è accessibile solo agli utenti registrati e collegati, e conosci lo user_id interno del partecipante. In questo caso puoi passare lo user_id al sondaggio e tornerà al tuo script (o alla tua funzione JS) insieme ai risultati. Inoltre il parametro viene salvato nel report del rispondente nel tuo account Simpoll. Così sai a quale utente appartengono le risposte ricevute.

Per passare parametri a un sondaggio:

• inserisci il sondaggio in una pagina del tuo sito;
• aggiungi nella stessa pagina un campo nascosto con i parametri (come stringa di query codificata per URL);

Esempio di passaggio di parametri a un sondaggio:

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

Il campo nascosto deve avere l’ID simpoll_params.

Il codice di inserimento del sondaggio deve trovarsi dopo il campo nascosto, altrimenti i parametri non vengono inviati.

Al termine del sondaggio, Simpoll invia questi parametri con i risultati all’URL dei risultati (o alla funzione callback).

Esempio di ciò che invia 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
                )
        )
)

Gli altri parametri sono gli stessi descritti in 3.2.

Passare parametri nell’URL del sondaggio

Se invece di inserire il sondaggio condividi un link diretto, puoi comunque passare i parametri nel suo URL.

Esempio di URL con parametri:

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

Parametri nel report del rispondente

Tutti i parametri ricevuti vengono salvati con i risultati di ogni rispondente.

Li vedi nella colonna di destra del report del rispondente nel tuo account.