gravity_sdk 0.26.0
gravity_sdk: ^0.26.0 copied to clipboard
Gravity SDK
Changelog #
Unreleased #
0.26.0 #
- Ошибки показа snackbar не включают текст HTTP-исключения в отчёт, сохраняя только endpoint и статус.
- Ошибка повторного запроса anchor-контента после смены пользователя обрабатывается внутри
fetchAnchorContent()и не передаётся в приложение. - При одинаковом priority порядок кампаний из ответа сервера сохраняется независимо от их количества, в том числе при переходе к следующей кампании без контента.
- Пока modal, bottom sheet или fullscreen кампании открыт, повторный показ той же кампании блокируется даже без URL visible_impression и после истечения 60 секунд; закрытие освобождает защиту, переходы open_step продолжают текущее открытие. Если следующий шаг не может быть показан, предыдущее открытие закрывается ровно один раз и защита освобождается для повторного показа.
- Цвет текста кнопки берётся из
style.textStyle.color, как в iOS; если цвет не задан или некорректен, используется основной цвет текста темы (colorScheme.onSurface) вместо белого цвета заполненной кнопки.style.textColorна кнопку не влияет, цвета остальных элементов не изменились. - Товарная строка и сетка без товаров ничего не отображают и не занимают места: при отсутствии объекта
products, поляslotsили пустом массивеslotsнастроенная высота, margin, padding и фон не применяются. - При смене контента или варианта кампании товарные слоты снова учитывают видимый показ; обычная перестройка сетки не дублирует события.
- Товарная сетка использует legacy
gridColumns, еслиgridSettings.columnsотсутствует или некорректен, сохраняя заданные интервалы. - Отчёты об ошибках используют серверный uid или идентификатор устройства; чтение личности ограничено по времени и учитывает незавершённые изменения. Учётные данные, query и fragment удаляются из URL с любыми схемами, в том числе вложенными, с сохранением конечной точки; очистка учитывает двойное экранирование и пароль вместо числового порта; тела HTTP-ответов не попадают в диагностику, повторные отчёты отбрасываются до чтения личности. После ошибки доставки повторная отправка разрешена; лимит попыток действует ровно 60 секунд. Учётные данные очищаются при трёх уровнях percent-кодирования; HTTP-логи сохраняют endpoint и статус без query, fragment, значений заголовков и тел ответов. Очистка URL выполняется линейно, распознаёт адреса после знаков и цифр и скрывает значения Authorization, Proxy-Authorization и x-authorization до конца строки в свободном тексте, сохраняя следующую строку.
- Snackbar отправляет callback impression на первом видимом кадре анимации независимо от onImpression и сохраняет visible_impression после одной секунды видимости не менее половины содержимого в активном приложении. Смена экрана и блокировка новых показов не прерывают учёт уже показанного snackbar; закрытие не учитывается до impression. Шаги OPEN_STEP используют одно открытие; автоматическое закрытие отправляет только настроенный onClose, текстовые элементы, кнопки и контейнер закрытия снимают snackbar и не дублируют tracking, а раннее закрытие снимает резерв показа. Пока snackbar прикреплён к экрану, повторный trackView не открывает ту же кампанию, в том числе до WRIMP и после его подтверждения. Все элементы snackbar закрывают его при close и cancel независимо от closeOnClick; остальные действия учитывают closeOnClick, кроме open_step, submit_form и unknown. Закрытие учитывается ровно один раз.
priorityиdelayTimeкампаний принимают числа и точные десятичные строки со знаком и экспонентой, обрезают дробную часть и ограничиваются диапазоном int64; в строках удаляются только краевые пробелы Unicode White_Space. Некорректные значения и бесконечные JSON-числа заменяются на0, не прерывая обработку остальных кампаний; отрицательныйdelayTimeвGravityDataResponseнормализуется до0.trackViewNoShow()иtriggerEventNoShow()прекращают выбор кампаний при отключенииisFetchContentOnTrackво время загрузки: возвращаютnullбезcontentLoaded,onLoadиgravityContentCallback.- Закрытие модального окна, bottom sheet и fullscreen отправляет одно событие закрытия и настроенный
onCloseнезависимо от наличия формы; URL кнопки закрытия не дублирует тот жеonClose. - Необязательные поля стандартных событий без значения больше не отправляются как JSON
null; явно заданные значения сохраняются. - Карточки товарной сетки всегда квадратные:
style.size.widthиstyle.size.heightбольше не меняют их пропорции; размер определяется доступной шириной и числом колонок. - Отрицательные и другие некорректные отступы товарной сетки заменяются стандартным значением 8, предотвращая ошибки разметки; нулевые отступы сохраняются.
trackViewNoShow()иtriggerEventNoShow()возвращают вGravityDataResponse.delayTimeзадержку выбранной кампании в миллисекундах (0, если её нет; отрицательное значение заменяется на0);gravityContentCallbackполучает то же значение. Методы по-прежнему возвращают ответ сразу после загрузки контента: выдержать задержку перед показом должно приложение.jsonостаётся исходным телом/choose.trackViewNoShow()иtriggerEventNoShow()отправляютcontentLoaded,onLoadиgravityContentCallbackтолько для возвращаемого ответа. Устаревший ответ возвращаетnull;staleContentTimeoutограничивает всё время трекинга и выбора кампании, включая каждый/choose.- Отрицательный
staleContentTimeoutзаменяется на ноль, в том числе при расчёте времени повторных запросов. - Публичные
getContent*возвращают пустой ответ при смене пользователя или повторномinitialize()во время загрузки, включая JSON вWithDetails, без уведомлений о загрузке. Автопоказ и NoShow прекращают выбор кампаний для прежнего пользователя. getUserId()и новые запросы получают согласованные uid и сессию, даже при задержке или отказе записи uid. Позднее завершение записи больше не отменяет более свежий ответ сервера; поток обновлений сессии не откладывает чтение uid бесконечно. Пустой uid из ответа сервера сохраняет ранее известного пользователя.- На холодном старте событие дожидается чтения сохранённого uid перед отправкой и помещением в офлайн-очередь. Если за это время вызван
resetUser(), событие сохраняет исходного пользователя. restoreUserId()обрезает пробелы вокруг uid; пустая строка или строка из пробелов отклоняется сArgumentErrorбез смены личности.- Размеры в серверных настройках принимаются как числа и строки (
"12px"и"12"). Число колонок товарной сетки ограничено диапазоном 1–12; при отсутствии корректныхgridSettings.columnsи legacygridColumnsиспользуется 2. Бесконечные размеры и NaN в числах и строках игнорируются. - В строке товаров внешние отступы margin находятся снаружи фона, а padding — внутри.
0.25.0 #
- Модальные in-app (bottom sheet, dialog/modal, fullscreen) отправляют visible_impression / WRIMP при первом подтверждённом кадре содержимого в активном приложении, без минимальной длительности; явное быстрое закрытие и OPEN_STEP используют один флаг события на открытие. При
inactiveещё не показанное окно ждётresumed; толькоpaused/hidden/detachedотменяют показ. После inactive → resumed уже нарисованное окно проверяется сразу, без ожидания следующего кадра. Отмена до появления не завершает форму как dismiss и не отправляет close-tracking. - WRIMP формируется по всем
eventsтипаvisible_impression, даже безvariables.onVisibleImpression. Шаги OPEN_STEP используют исходные URLs открытия;ContentVisibleImpressionEventприходит один раз на открытие сразу после сохранения события, до первой HTTP-попытки, а не на каждый шаг. Отсутствующий WRIMP URL отмечается warning в error-reporting; callback появления всё равно вызывается. - WRIMP сначала сохраняется в существующую устойчивую outbox с исходными URL, SHA-256 fingerprint ключа и хешем секции/личности для защиты повторного показа. API key, user snapshot, сессия и пользовательские attributes в эти записи не сохраняются. Смена пользователя не меняет tracking URL; повтор использует текущий ключ только при совпадении fingerprint. При смене ключа запись удаляется и защита снимается. Старые записи модального формата с plaintext ключом/user snapshot удаляются при загрузке, включая из хранилища.
- Первый WRIMP отправляется сразу после сохранения независимо от backoff других записей; ошибка хранилища не отменяет best-effort отправку и показ контента. Повторы WRIMP не блокируют остальные события очереди. Единая межплатформенная политика: сохранённый WRIMP доставляется до 7 дней независимо от срока защиты; локальная защита кампании действует до ack, permanent drop или максимум 24 часа от показа, включая после перезапуска. На границе 24 часов событие не удаляется. Permanent 4xx снимает резерв сразу, после HTTP 2xx частоту снова определяет сервер. При переполнении сначала вытесняются обычные записи, затем самые старые WRIMP.
- Модальный WRIMP сохраняется и доставляется даже при
OfflineQueueSettings(enabled: false); вместоmaxAgeдействует фиксированный срок доставки 7 дней. Эти записи учитываются вpendingDeliveries, отправляются черезflushQueue()при выключенной очереди и удаляются черезclearQueue(). - GravityAnchor и запросы inline/tooltip не меняют поколение экрана и не отменяют модальные кампании trackView/triggerEvent. Модальный результат anchor также не инвалидируется сменой автоматического screen generation; проверки маршрута, личности и секции сохраняются. Повторный
initialize()инвалидирует загружающийся in-app контент, а inline/anchor перезапрашивают его для текущей конфигурации. - Детекторы inline, товарный tracking, snackbar и tooltip не изменены. Ручной
sendContentEngagement(ContentVisibleImpressionEngagement)после*NoShowсохраняет прежнюю доставку без устойчивой модальной outbox.
0.24.1 #
- Исправлена ошибка компиляции на Flutter 3.38–3.41 (
SizeTransition.alignmentпоявился только во Flutter 3.44); версии 0.22.0–0.24.0 собирались только на Flutter 3.44 и новее - resetUser() и restoreUserId() теперь бросают исключение, если устройство отказалось стереть или записать uid, вместо того чтобы отрапортовать успех; текущая сессия и пользователь из setUser() сбрасываются и при таком отказе, а uid на устройстве остаётся прежним
- Сбой первого обращения к локальному хранилищу больше не отключает сохранение данных до перезапуска приложения: следующая операция пробует снова
- uid, который не удалось записать после успешного запроса, больше не теряется: запрос не падает, ошибка отправляется в отчёт, а запись повторяется со следующим ответом сервера; getUserId() и колбэк setUserIdListener() при этом сообщают об одном и том же uid
- clearQueue() больше не может быть обойдён: событие, ждавшее сессию, попавшее в паузу повторной отправки или в момент записи личности на диск, после очистки очереди не уходит на сервер
- Событие, поднятое при известной SDK личности — после успешного запроса, setUser(), restoreUserId() или уже прочитанного с устройства uid — теперь уходит от неё, даже если во время подготовки запроса произошёл resetUser() или restoreUserId(); та же личность сохраняется в очереди для повторной отправки
- getContentByGroup() и запросы контента с деталями теперь тоже выбирают одного владельца сессии: два вызова сразу после resetUser() открывают одну сессию, а не две
- Сбой запроса, владевшего инициализацией сессии, больше не роняет остальные запросы, которые его ждали — trackView*, triggerEvent*, getContent* и отправку событий из офлайн-очереди: они переизбирают владельца и получают сессию сами
- In-app контент больше не показывается, если за время его загрузки сменился пользователь (setUser(), resetUser(), restoreUserId() или присваивание GravitySDK.instance.user) или экран: кампания предыдущего экрана не открывается поверх нового маршрута, в том числе при вложенных Navigator. GravityAnchor, inline-виджеты и inline_list в таком случае запрашивают контент заново для нового пользователя
- Отчёты об ошибках SDK больше не содержат uid пользователя, тело ответа сервера и query-параметры, фрагменты и учётные данные в URL. Состав отчёта описан в README
- Повторяющиеся отчёты об ошибках больше не расходуют лимит отправки, а кэш повторов больше не сбрасывается целиком
- Повторный initialize() с LogLevel.none теперь отключает и HTTP-логи; заголовок Authorization в логах больше не выводится
0.24.0 #
- Добавлен доступ к серверному uid пользователя: getUserId(), setUserIdListener() и restoreUserId() для восстановления пользователя после переустановки приложения
- Запросы, дождавшиеся resetUser() или restoreUserId(), теперь заново выбирают владельца сессии, а не уходят параллельно без сессии
- Исправлено: запросы контента (getContent*, inline-виджеты, автопоказ in-app) теперь уходят от пользователя, заданного через setUser(); раньше это касалось только visit и event. Показы, лимиты частоты и A/B-варианты для такого контента теперь считаются для указанного пользователя, а не для анонимной сессии устройства
0.23.1 #
- Исправлена ошибка компиляции с dio 5.10.0 и новее (
DioExceptionType.transformTimeout)
0.23.0 #
- Добавлена поддержка офлайн-доставки событий: сохранение очереди на устройстве и повторная отправка при восстановлении соединения
- Добавлены настройки OfflineQueueSettings, методы flushQueue() и clearQueue(), а также pendingDeliveries для проверки размера очереди
- Добавлены повторные попытки запросов при временных ошибках и staleContentTimeout для ограничения показа устаревшего контента
- Добавлен доступ к исходным variables через CampaignContent.rawVariables
- Добавлен ContentClickEngagement для отслеживания кликов по контенту, отображаемому приложением
- У всех событий добавлены customProps и eventTime, у CustomEvent — cuid, cuidType и cart
- Исправлено дублирование ручки перетаскивания BottomSheet при включении её в теме приложения
- Обновлён example
0.22.2 #
- Доработана поддержка in-app форм
0.22.1 #
- Исправлено значение атрибута app_platform на iOS (iOS вместо ios)
0.22.0 #
- У события FollowUrlEvent добавлен тип открытия ссылки (browser/webview)
- Добавлена поддержка in-app форм
0.21.0 #
- Добавлена возможность временно блокировать автопоказ in-app контента (presentation lock)
0.20.0 #
- Добавлена поддержка multi-step кампаний
0.19.0 #
- Подняты минимальные требования: Flutter 3.38.1, Dart 3.10
- Обновлена зависимость package_info_plus до ^10.1.0
0.18.0 #
- Добавлена поддержка передачи recommendation rules при запросе контента
0.17.0 #
- Добавлен метод resetUser() для сброса идентификации пользователя
- Правки по батчингу
0.16.0 #
- Исправлено отображение SnackBar
- Скорректирована работа closeOnClick у BottomSheetContent, FullScreenContent, ModalContent и SnackBar
- Добавлена возможность отображать Tooltip
0.15.0 #
- Скорректирована работа SnackBar, GravityButton, BottomSheetContent, GravityCloseButtonWidget, GravityImageWidget, GravityText
- Добавлен backgroundColor для GravityInlineWidget
0.14.0 #
- Добавлен флаг isFetchContentOnTrack в setOptions для управления загрузкой контента в trackViewNoShow/triggerEventNoShow
- Добавлен метод triggerTrackingUrl
- Исправлен метод sendContentEngagement
- Оптимизация взаимодействия с бэкендом
0.13.1 #
- Правки по батчингу
0.13.0 #
- Обновлён api url
- Скорректирована конвертация цвета из web-формата
0.12.2 #
- Правки по батчингу
0.12.1 #
- Добавлен виджет GravityInlineListWidget
- Класс Container переименован в FrameContainer
- Скорректированы настройки width, margin и padding у InlineContent
- Скорректированы настройки padding у GravityButton
- Обновлена версия gradle у example
0.12.0 #
- Добавлена поддержка headless api
0.11.1 #
- Добавлена возможность указать свой индикатор загрузки у GravityInlineWidget
0.11.0 #
- Добавлена возможность добавления фона элементам через атрибут backgroundImage
- Добавлен новый тип элемента - webview
- Добавлена возможность вертикального выравнивания в FullScreenContent
- Исправлена отправка VisibleImpression у GravityInlineWidget
0.10.2 #
- Добавлена возможность управления уровнями логирования
0.10.1 #
- Обновлены версии пакетов
- Настроено отображение товаров во всплывающих окнах
- Добавлено отображение товаров в формате сетки
- Настроена корректная отправка engagement-запросов
0.10.0 #
- Оптимизация взаимодействия с бэкендом
- Удалены неиспользуемые зависимости
0.9.13 #
- Добавлена поддержка отображения контента в GravityInlineWidget в зависимости от placeholderId.
0.9.12 #
- Добавлены скругления углов для GravityImageWidget.
- Фикс выравнивания GravityText.
0.9.11 #
- Обновлён example.
0.9.10 #
- Фикс скругления углов у bottom sheet.
0.9.9 #
- Соответствие nullable и required полей API.
0.9.8 #
- Закрытие bottom sheet при нажатии на кнопку. Отключается через closeOnClick = false в классе OnClick.
- В поле attributes объекта PageContext подмешиваются app_version, sdk_version, app_platform
- ContentSettings перемещены в data.options
- InlineWidget не рендерится в случае ошибки получения данных.
0.9.6 #
- Фикс кеширования и отправки сессии.
- Скругление углов у кнопки.
0.9.5 #
- Удалена зависимость от пакета notification_permissions.
- Добавлена возможность задать статус разрешения уведомлений извне.
0.9.4 #
- Исправлены значения enum product_action
- Поле Item в объекте Slot теперь просто Map<String, dynamic>
0.9.3 #
- В объекте device передаются tracking и permission.
0.9.2 #
- Удалены последствия патча.
0.9.1 #
- Исправлена отправка ctx в event.
- Поле events в объекте Slot теперь nullable.
- Поля categories и keywords в объекте Item теперь nullable.
- Обработка клика по картинке.
- Отправка isBuildEngagementUrl в Options
- Поле name в Event переименовано в type.
0.9.0 #
- Поля pageNumber и countPage в Products теперь опциональные.
- Добавлена возможность передавать PageContext в GravityInlineWidget
- Добавлены CampaignContent и Campaign в ProductWidgetBuilder
0.8.10 #
- Поправлена ошибка с парсингом CampaignIdsResponse
0.8.9 #
- Отображение snackbar.
0.8.8 #
- Получение и отображение кампаний в ответ на trackView и triggerEvent
0.8.7 #
- Исправлены ошибки в методе event
0.8.6 #
- Исправлены ошибки в методе visit
0.8.5 #
- В качестве id устройства используется UUID
- UserAgent передаётся строкой.
0.8.4 #
- Добавлены поля data, location, lng, utm, attributes в класс PageContext.
- Поля hashedEmail, cuid, cuidType теперь не обязательные.
0.8.3 #
- Обновлён README.md. Исправлена навигация в Оглавлении.
0.8.2 #
- Обновлён README.md. Добавлено описание ProductWidgetBuilder.
0.8.1 #
- Initial release