3.1. Ricevere i risultati via POST o GET
Per ricevere i risultati nel tuo script:
- attiva l’API nelle impostazioni del sondaggio;
- scegli POST o GET come metodo;
- inserisci l’URL completo del tuo script come URL dei risultati
(per esempio https://example.org/result.php).
Da quel momento Simpoll invia una richiesta POST (o GET) a quell’URL ogni volta che qualcuno completa il sondaggio.
Esempio dei dati inviati:
POST:
(
[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
)
)
)
3.2. Parametri
- sp_survey_id — ID del sondaggio in Simpoll
- sp_survey_key — la chiave usata nell’URL del sondaggio
- sp_resp — informazioni sul rispondente:
- id — ID del rispondente in Simpoll
- ip_addr — indirizzo IP del rispondente
- name — nome del rispondente
- time_start — quando è iniziato il sondaggio
- time_end — quando è terminato il sondaggio
- time_delta — tempo impiegato per il sondaggio
Questi campi vengono inviati solo per i quiz:- quiz_passed — se il quiz è stato superato (1 = sì, 0 = no)
- quiz_percent — percentuale di risposte corrette (0–100)
- quiz_correct — numero di risposte corrette
- quiz_wrong — numero di risposte sbagliate
- sp_result — il sondaggio è stato completato (sempre 1)
- sp_answers — le risposte: le chiavi sono i numeri delle domande, i valori sono array con le risposte a ciascuna domanda