Документация · Контракт данных
События и профили пользователей
Формат передачи профилей и серверных событий в Адопто: обязательные поля, идемпотентность по eventId и передача свойств.
Редакция Адопто ·
Стабильный идентификатор и профиль
Используйте стабильный идентификатор пользователя (userId), который не меняется при смене email или тарифа. Профиль хранит email, язык и свойства, нужные для персонализации цепочек.
Ключ проекта храните строго на сервере, отдельно от браузерного кода.
Структура события и идемпотентность
Каждое событие содержит уникальный eventId, идентификатор пользователя userId, название события name, время occurredAt и объект properties.
При повторной отправке того же события сохраняйте исходный eventId — повторная доставка не создаст дублирующую цепочку писем.
{
"eventId": "evt_example_01",
"userId": "usr_example",
"name": "setup.completed",
"occurredAt": "2026-11-02T09:00:00Z",
"properties": {
"step": "publish_project"
}
}