Чтобы отправить событие в Strimix с помощью server-side API необходимо:
выполнить HTTP-запрос методом POST на адрес Strimix server-side API:
https://api.strimix.io/collect
и в качестве тела запроса отправить туда JSON содержащий конфигурацию события
Пример конфигурации запроса:
URL запроса:
https://api.strimix.io/collect ?stream_id=S-MTTZG5XFT5 &api_key=rkNbsaheU44SbhwUgEdfRYeCC7oy9S9McWSq7vO1yhJbgGjGLzIcniyF5WM9caKw0NnrEnR0bWqjgX3kbDYRrw
JSON-тело запроса:
{ "timestamp": 1705360211599, "event":"custom_event_name", "event_params": { "custom_param_key_1": "string_value", "custom_param_key_2": 123.0, "custom_param_key_3": true }, "user_external_ids": { "crm_client_id": "655fd150deea972254b7b1d4" }, "strimix_avid": "7178bd4a-18f9-4e5d-8b72-228dad815bdc" }
Для успешной аутентификации запроса необходимо указать в URL следующие параметры:
stream_id - идентификатор потока данных отслеживаемого проекта
api_key - API-ключ для аутентификации server-side запросов
stream_id
Значение stream_id находится в разделе Project info:
api_key
Значение api_key находится в разделе Server-side tracking:
Для того чтобы сгенерировать новый ключ API, в разделе Server-side tracking нажмите кнопку “Generate new API key”:
Будьте осторожны во время генерации нового ключа API!
Генерация нового ключа приведет к тому что интеграции которые используют предыдущий ключ API перестанут работать.
В случае успешной отправки события сервер Strimix вернет ответ со статусом 200.
В случае неуспешной отрпавки события сервер Strimix вернет ответ со статусом 400 и описанием ошибки конфигурации события:
Спецификация событий и их атрибутов описана в этой статье.