Server-side трекинг

Server-side трекинг - это трекинг событий выполняемый на удаленном сервере или цифровой платформе.

Чтобы отправить событие в 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-ключ для аутентификации запроса

Значение stream_id находится в разделе Project info:

Значение api_key находится в разделе Server-side tracking:

Для того чтобы сгенерировать новый ключ API, в разделе Server-side tracking нажмите кнопку “Generate new API key”:

Будьте осторожны во время генерации нового ключа API!

Генерация нового ключа приведет к тому что интеграции которые используют предыдущий ключ API перестанут работать.

Ответы сервера Strimix

В случае успешной отправки события сервер Strimix вернет ответ со статусом 200.

В случае неуспешной отрпавки события сервер Strimix вернет ответ со статусом 400 и описанием ошибки конфигурации события:

Спецификация событий и их атрибутов описана в этой статье.