Parameter durchreichen

5. Parameter durch eine Umfrage durchreichen

Manchmal sollen Ihre eigenen Parameter zusammen mit den Ergebnissen zurückkommen.

Beispiel: Die Seite mit der Umfrage auf Ihrer Website ist nur für angemeldete Benutzer zugänglich, und Sie kennen die interne user_id des Teilnehmers. Dann können Sie diese user_id an die Umfrage übergeben, und sie kommt mit den Ergebnissen zu Ihrem Skript (oder Ihrer JS-Funktion) zurück. Außerdem wird der Parameter im Bericht über den Befragten in Ihrem Simpoll-Konto gespeichert. So wissen Sie, welchem Benutzer die erhaltenen Antworten gehören.

So übergeben Sie Parameter an eine Umfrage:

• betten Sie die Umfrage in eine Seite Ihrer Website ein;
• fügen Sie auf derselben Seite ein verstecktes Feld mit den Parametern hinzu (als URL-kodierte Abfragezeichenkette);

Beispiel für die Übergabe von Parametern an eine Umfrage:

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

Das versteckte Feld muss die ID simpoll_params haben.

Der Einbettungscode der Umfrage muss nach dem versteckten Feld stehen, sonst werden die Parameter nicht gesendet.

Nach Abschluss der Umfrage sendet Simpoll diese Parameter mit den Ergebnissen an die Ergebnis-URL (oder an die Callback-Funktion).

Beispiel dessen, was Simpoll sendet:

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

Die übrigen Parameter sind dieselben wie in 3.2 beschrieben.

Parameter in der Umfrage-URL übergeben

Wenn Sie statt einer Einbettung einen direkten Link teilen, können Sie die Parameter trotzdem in dessen URL übergeben.

Beispiel einer URL mit Parametern:

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

Parameter im Bericht über den Befragten

Alle übergebenen Parameter werden mit den Ergebnissen jedes Befragten gespeichert.

Sie sehen sie in der rechten Spalte des Berichts über den Befragten in Ihrem Konto.