К содержанию
ActionPulse

Быстрый старт

Полный путь от нового проекта до первого события, которое видно в ActionPulse: где взять ключи, какой способ подключения выбрать и как убедиться, что данные дошли.

Кому
Тому, кто подключает ActionPulse впервые
Проверено
На этой странице

Что вы получите в конце

Проект, в который приходят события, и экран, где видно, что интеграция работает. После этого можно строить воронки, смотреть удержание и собирать сегменты. Весь путь — шесть шагов.

Шаг 1. Создайте проект

Зарегистрируйтесь и создайте организацию. Мастер подключения предложит завести первый проект. Проект — это отдельный поток данных, обычно один продукт или один сайт: у него свои события, свои ключи и свои отчёты.

Шаг 2. Возьмите нужный ключ

У ActionPulse два разных ключа, и это главное различие, которое стоит понять до начала работы.

Браузерный токен Серверный ключ
Префикс pp_bt_… pp_sk_…
Секретность Публичный, виден любому посетителю Секрет, живёт только на сервере
Где размещается HTML, фронтенд-бандл, тег-менеджер Переменные окружения бэкенда
Ограничение Работает только с разрешённых origin Работает откуда угодно
Для чего Просмотры, клики, действия в браузере Оплаты, заказы, возвраты, выдача доступа

Оба ключа выдаются на экране Настройки → Установка внутри проекта.

Шаг 3. Разрешите свои домены

Браузерный токен принимается только с тех адресов, которые вы перечислили в разрешённых origin. Это защита от использования вашего публичного токена на чужом сайте: запрос с неразрешённого адреса получит отказ.

Origin указывается точно — схема, хост и порт, без пути и без масок:

https://example.com
https://www.example.com
https://staging.example.com

https://example.com/app, https://*.example.com и example.com будут отклонены при сохранении. Перечислите все поддомены и стенды, с которых будете проверять интеграцию — каждый адрес отдельной строкой.

Серверному ключу список origin не нужен: запросы идут не из браузера.

Шаг 4. Подключите сбор

Выберите способ по тому, откуда приходят события.

Способ Когда подходит Ключ
Browser script Сайт, лендинг, магазин, тег-менеджер pp_bt_…
Browser SDK Приложение со своей сборкой pp_bt_…
Self-hosted Строгая CSP, весь код со своего домена pp_bt_…
Server HTTP Достоверные события с бэкенда pp_sk_…

Большинству продуктов нужны оба контура: браузер — для поведения, сервер — для денег и подтверждённых действий. Начать можно с любого.

Минимальный вариант для сайта — один тег в <head>:

<script
  src="https://YOUR_ACTIONPULSE_HOST/v1/t.js"
  data-token="YOUR_BROWSER_TOKEN"
  data-consent="required"
></script>

YOUR_ACTIONPULSE_HOST — адрес вашей установки ActionPulse, он показан на экране установки. YOUR_BROWSER_TOKEN — ваш токен pp_bt_…. Рекомендуемый production-вариант с фиксированной версией и проверкой целостности описан на странице Browser script.

Шаг 5. Передайте решение по согласию

С data-consent="required" сбор не начинается сам. До явного решения посетителя SDK не создаёт идентификаторов, не пишет в хранилище браузера, не ставит обработчики и не отправляет запросы.

Вызовите нужный метод из колбэков вашего CMP:

// посетитель согласился
pp.setConsent('granted');

// посетитель отказался
pp.setConsent('denied');

// посетитель отозвал согласие позже
pp.setConsent('revoked');

Полное поведение каждого состояния — в руководстве по согласию.

Шаг 6. Отправьте первое событие и проверьте его

Из браузера:

pp.track('signup_completed', { plan: 'pro' });

С сервера:

curl -X POST https://YOUR_ACTIONPULSE_HOST/v1/track \
  -H "Authorization: Bearer $ACTIONPULSE_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch":[{
    "event_id":"8b0d3f2e-1c4a-4f0e-9b1d-2a3c4d5e6f70",
    "schema_version":1,
    "event":"order_created",
    "user_id":"YOUR_USER_ID",
    "time":"2026-07-27T12:00:00Z"
  }]}'

Успешный ответ — 202 Accepted с телом вида {"accepted":1,"n":1,"rejected":[]}. Если массив rejected не пуст, каждый его элемент содержит индекс события в батче и код причины отказа.

Теперь откройте в ActionPulse раздел Данные и сбор → События: свежие события появляются в списке. Экран Проверка интеграции покажет, дошли ли данные и нет ли типовых ошибок.

Что делать дальше

  1. Проверьте интеграцию — убедитесь, что события приходят с обоих контуров.
  2. Опишите схему событий, чтобы имена и типы свойств не расползлись между командами.
  3. Соберите первую воронку и посмотрите, где пользователи уходят.
  4. Посмотрите удержание — возвращаются ли люди.
  5. Сохраните сегмент или отчёт, чтобы вернуться к нему одним кликом.