SpyMagic - аналитика для веб и мобильных игр

Описание

Интеграция SDK

Unity Defold JS

доступ через API

События

a/b тесты Платежи Реклама Игроки Ресурсы Прогресс игрока

Внешние данные

API данных

Если по каким-либо причинам вы не можете использовать одну из готовы SDK, вы можете отправлять данные в аналитику используя наше API.

URL для отправки данных

https://spymagic.pro/track/

Верификация данных

Handshake авторизации происходит через заголовки (headers). Секретный ключ игры (token, api_key) для проверки подлиности данных. Получить его вы можете обратившись к администратору консоли вашей компании в разделе настройки

Пример реализации на JS

Отправка данных

Все данные на сервер отправляются в формате POST. Полный перечень параметров вы можете найти в таблице ниже.

параметр	обязательность	тип данных	описание
uuid	да	string	uuid вашего игрока. Он генерируется в рамках вашего движка (Unity, Defold, Phaser, Vue.JS и т.п.) используя штатные методы вашего движка. По-сути это уникальный хэш устройства. Пример uuid: b2ce6279-cb36-45a1-b26c-ad40d4004e44
user_id	нет	int	user_id вашего игрока (если есть на вашей стороне уникальный числовой код игрока). Пример user_id: 10455
event	да	string	Запрашиваемое действие. Может принимать одно из четырех допустипых значений: init, register, auth, event
detail	нет	array	payload события (параметры события). Например, вы передаете event = 'tutorial' и хотите указать номер шага. Тогда event: tutorial, detail: {step: 1}
sid	нет	int	session action id - автоинкрементируемый id действия. Обычно мы закладываем в рамках движка некий счетчик, который после каждого действия игрока увеличивается на +1. Тем самым аналитика сможет более точно выстраивать логический порядок событий, учитывая проблемы со связью пользователя (например, когда пропадает связь, и события приходят в аналитику в разном порядке).

пример POST запроса:

{
    uuid: "CgFDgWdG/C2NlQE2Db6rAg==",
    event: "init",
    sid: 1,
}

Ответ сервера

HTTP-код	статус
204	OK - данные получены успешно
400	Ошибка - неизвестный метод
401	Ошибка авторизации (неверный токен)
409	Недопустимый event (нет такого в документации)