События сайта

После установки виджета и нужного согласия вызовите track в момент действия пользователя:

await window.FlowtomateWidget.ready();
window.FlowtomateWidget.track('report_created', {
  report_type: 'sales',
  rows: 120,
  shared: false
});

Метод возвращает void. Вызов не подтверждает запись в очередь, отправку или доставку. Проверяйте итог в «Событиях» и профиле аудитории.

Имя и свойства

Виджет убирает пробелы по краям имени события и приводит его к нижнему регистру. После этого имя должно начинаться с латинской буквы, содержать только латинские буквы, цифры и _ и иметь не более 100 знаков. Не используйте системные имена и префиксы flowtomate_, popup_, checklist_, tour_, page_, session_, survey_, feedback_ и hint_.

У события может быть до 50 свойств. Имя свойства начинается с латинской буквы; дальше допустимы латинские буквы обоих регистров, цифры и _. Длина имени не больше 100 знаков. Значением может быть:

• строка до 2 000 знаков;
• конечное число, true, false или null;
• массив до 50 строк или до 50 конечных чисел; строки в массиве также ограничены 2 000 знаками.

Вложенные объекты и смешанные массивы не подходят. Браузер принимает JSON.stringify(properties).length не больше 32 768 знаков JavaScript; сервер также ограничивает сериализованное событие 32 768 знаками с учётом контекста. Держите свойства заметно меньше этого порога. Если имя или свойства нарушают правило, виджет может отбросить событие без ошибки вызова track.

Не передавайте пароли, токены, данные карт и другие секреты. Свойства с именами password, passwd, secret, token, authorization, card_number, cvv и cvc запрещены. Email и имя передавайте через identify или setTraits, когда у вас есть основание и согласие на это. Правила идентификации есть в основной инструкции.

Согласие и доставка

При denied виджет очищает очередь и не добавляет новые события. В режиме «Только после согласия» вызов до granted не сохраняется для будущей отправки. После согласия вызовите track снова для нового действия; старое событие не появится само.

При разрешённом сборе виджет отправляет до 20 событий в пакете размером до 128 КиБ. Локальная очередь ограничена 1 000 событиями, 5 МиБ и семью днями; при временной сетевой ошибке виджет повторяет отправку с задержкой от одной секунды до пяти минут. Это не журнал с гарантированной доставкой: не используйте track для платежей или команд с необратимым эффектом.

Событийный контекст содержит адрес страницы без значений query-параметров, имена query-параметров и часть сведений об устройстве. Значения cookie не входят в событие. При загрузке настроек виджет может передать значения query и доступных JavaScript cookie для условий показа. Этот отдельный запрос описан в правилах конфиденциальности.

Для проверки откройте DevTools → Network на тестовом сайте, вызовите событие после согласия и дождитесь обычной отправки. Затем найдите его в «Событиях». Если записи нет, проверьте диагностику.