Transmettre des paramètres

5. Transmettre des paramètres via un sondage

Il arrive que vous ayez besoin de récupérer vos propres paramètres avec les résultats.

Par exemple, la page du sondage sur votre site n’est accessible qu’aux utilisateurs inscrits et connectés, et vous connaissez le user_id interne du participant. Vous pouvez alors transmettre ce user_id au sondage, et il reviendra à votre script (ou à votre fonction JS) avec les résultats. Le paramètre est aussi enregistré dans la fiche du répondant de votre compte Simpoll. Vous saurez ainsi à quel utilisateur appartiennent les réponses reçues.

Pour transmettre des paramètres à un sondage :

• intégrez le sondage dans une page de votre site ;
• ajoutez sur la même page un champ caché contenant les paramètres (sous forme de chaîne de requête encodée pour URL) ;

Exemple de transmission de paramètres à un sondage :

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

Le champ caché doit avoir l’identifiant simpoll_params.

Le code d’intégration du sondage doit se trouver après le champ caché, sinon les paramètres ne sont pas envoyés.

À la fin du sondage, Simpoll envoie ces paramètres avec les résultats à l’URL de résultats (ou à la fonction callback).

Exemple de ce qu’envoie 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
                )
        )
)

Les autres paramètres sont les mêmes que ceux décrits en 3.2.

Transmettre des paramètres dans l’URL du sondage

Si vous partagez un lien direct au lieu d’intégrer le sondage, vous pouvez quand même transmettre des paramètres dans son URL.

Exemple d’URL avec paramètres :

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

Paramètres dans la fiche du répondant

Tous les paramètres transmis sont enregistrés avec les résultats de chaque répondant.

Vous les voyez dans la colonne de droite de la fiche du répondant dans votre compte.