Руководство разработчика

4. Получение результатов опроса через JS-callback

Данный функционал не доступен для браузеров Internet Explorer ниже 8-й версии и некоторых мобильных браузеров

Для того чтобы Ваша JavaScript-функция могла получать результаты опроса от Simpoll API должно быть выполнено несколько условий:

В настройках опроса включена опция «Включить отправку результатов»;
В поле «Метод передачи» выбран JS;
Опрос должен быть встроен на страницу Вашего сайта (код вставки можно получить в разделе «Распространение» на вкладке «Вставка на сайт»);
На этой же странице должна быть определена функция simpollCallback() с одним входящим параметром.

Аргументом функции simpollCallback() будет являться объект, свойства которого содержат информацию о результатах опроса.

Пример функции simpollCallback():

function simpollCallback(result){
    alert('ID опроса: ' + result.sp_survey_id);
    alert('Имя респондента: ' + result.sp_resp.name);
    if (result.sp_resp.quiz_passed == 1){
        alert('Респондент сдал тест');
    } else {
        alert('Респондент провалил тест');
    }
}

Пример аргумента функции simpollCallback():

{
    "sp_survey_id": "551",
    "sp_survey_key": "aa7ca07e",
    "sp_resp": {
        "id": "172712",
        "ip_addr": "127.0.0.1",
        "name": "Респондент #172712",
        "time_start": "2011-12-13 16:17:00",
        "time_end": "2011-12-13 16:17:13",
        "time_delta": "00:00:13",
        "quiz_passed": "0",
        "quiz_percent": "0",
        "quiz_correct": "1",
        "quiz_wrong": "3"
    },
    "sp_result": "1",
    "sp_answers": {
        "1": ["Испания"],
        "2": ["Пирамиды", "Кремль", "Колизей"]
    }
}

Названия, состав и значения свойств передаваемого объекта полностью идентичны описанным в разделе 3.2.

Если на странице встроено несколько опросов Simpoll, то функция simpollCallback() все равно должна существовать в одном экземпляре. Проверку того, какой из опросов прислал результаты нужно проводить внутри функции, на основании поля sp_survey_id в получаемом объекте.

JavaScript callback

Руководство по Simpoll API

Простое объяснение без кода

4. Получение результатов опроса через JS-callback