Ноябрь '26. Обновление SDK: headless-режим и исправления показа in-app
Вышли iOS SDK 1.3.1, Android SDK 1.3.1 и Flutter SDK 0.26.1. Исправили наложение in-app окон. Если одно модальное сообщение уже открыто, SDK пропускает автопоказ второго.
Для iOS и Android добавили headless-режим, управление ID пользователя и фильтры каталога в рекомендациях. На всех трёх платформах исправили учёт закрытий и отображение товарных блоков и кнопок.
Как SDK показывает in-app, если окно уже открыто
Если на экране уже открыто модальное окно, bottom sheet или полноэкранное сообщение SDK, автопоказ ещё одного такого окна пропускается.
Показ нового Snackbar пропускается, пока открыт любой in-app SDK, включая другой Snackbar. При этом открытый Snackbar не мешает показу модального окна, bottom sheet или полноэкранного сообщения. На iOS автопоказ всех четырёх форматов также пропускается, если поверх текущего экрана открыт другой контроллер приложения. Переходы между шагами открытой кампании работают как прежде.
Кампании в iOS · Кампании в Android · Кампании во Flutter
iOS и Android 1.3.1
Android: перед обновлением проверьте selector
Если вы оборачивали selector, группу или ID кампании в JSONObject.quote(...) или " в XML, уберите кавычки, в том числе в GravityInlineCompose, GravityInlineView и GravityInlineListView. С версии 1.3.0 SDK отправляет строку как есть, и значение с кавычками не совпадёт с кампанией. Формат selector
Новые возможности
Headless-режим для in-app. trackViewNoShow(...) и triggerEventNoShow(...) отправляют просмотр или событие и возвращают выбранную кампанию — контент и исходный JSON — без открытия окна SDK. Приложение отрисовывает сообщение своими компонентами там, где нужно. Например, после добавления в корзину выводит допродажу в своей панели корзины, а не во всплывающем окне.
Если у самой приоритетной кампании нет контента, SDK возвращает следующую. В ответе есть delayTime — задержка показа из настроек кампании в миллисекундах: приложение выдерживает её и показывает сообщение. Показ и видимость в headless-режиме приложение отправляет само. Headless-режим: iOS · Android
Параметр isFetchContentOnTrack управляет загрузкой контента, а staleContentTimeout в iOS и staleContentTimeoutMillis в Android ограничивают ожидание ответа. SDK отбрасывает устаревший контент и ответы для предыдущего пользователя.
Управление ID пользователя. Новые методы:
getUserId()— получить ID пользователя в Gravity Field;setUserIdListener(...)— узнать, что ID изменился;resetUser()— сбросить пользователя, например при выходе из аккаунта;restoreUserId(...)— вернуть сохранённый ID, например после переустановки приложения.
Например, приложение хранит ID на своём сервере вместе с аккаунтом. После переустановки и входа вызывает restoreUserId(...), и Gravity Field продолжает историю того же пользователя, а не заводит нового. После смены пользователя SDK не показывает контент, загруженный для предыдущего. ID пользователя: iOS · Android
Фильтры каталога в рекомендациях. Методы получения контента и inline-блоки принимают параметр rules. В нём приложение передаёт условия, например фильтры, которые пользователь выбрал в каталоге, и рекомендации их учитывают. При изменении rules inline-блок загружает контент заново. Правила рекомендаций: iOS · Android
iOS: товарная сетка в in-app. iOS SDK отображает товары сеткой от 1 до 12 колонок. Показ товара засчитывается, когда видна хотя бы половина карточки. Товарная сетка
Исправленные ошибки
В iOS и Android:
- Закрытие засчитывалось для in-app, который пользователь так и не увидел. Теперь — только после появления окна.
- Когда кнопка закрытия и
onCloseсрабатывали вместе, закрытие засчитывалось дважды. Теперь — один раз. - Если приложение убирало in-app с экрана, например при переходе на другой экран, закрытие терялось. Теперь оно учитывается.
- Шаг
open_stepпри выключенномcloseOnClickоткрывался поверх предыдущего. Теперь он заменяет текущий шаг. - Snackbar засчитывал показ до фактического появления. Теперь показ считается по первому видимому кадру, видимый показ — после секунды видимости хотя бы половины содержимого, и он досылается при ошибке сети.
- Товарная строка или сетка без товаров занимала место на экране. Теперь пустой блок не отображается.
- Размеры элементов принимаются как числа и строки, например
16и"16px". Некорректные значения SDK игнорирует, чтобы отрисовка не ломалась. - Ошибочный приоритет или задержка в одной кампании ломали обработку всего ответа. Теперь некорректное значение пропускается, остальные кампании показываются.
Только в iOS:
- Отрицательная или очень большая задержка кампании приводила к падению автопоказа. Исправлено.
- Модальное окно засчитывало повторный показ, если его перекрывал другой экран, а потом оно снова становилось видно. Теперь — один показ за открытие.
- Длинный контент прокручивается в границах полноэкранного сообщения и bottom sheet. Bottom sheet можно закрыть свайпом вниз, если контент прокручен до начала.
- Настройки контента во всех запросах
/chooseпередаются в полеoption.
Только в Android:
- При повороте экрана in-app закрывался. Теперь он остаётся на экране и не создаёт новых показов.
- Та же кампания могла открыться повторно поверх своего открытого in-app. Теперь нет.
- Ответ сервера с ошибкой мог обрабатываться как успешный. Теперь это ошибка, контент не показывается.
- Кампании без приоритета выбирались в непредсказуемом порядке. Теперь их приоритет — 0, при равенстве сохраняется порядок с сервера.
- Товары в строке могли выходить за границы блока, а фон не совпадал с отступами. Теперь товары помещаются в заданную высоту.
- Перестроение товарной сетки, в том числе при смене числа колонок, больше не дублирует события видимости товаров. Высокий bottom sheet с сеткой помещается под строкой состояния.
- При смене пользователя SDK повторяет незавершённую загрузку inline-контента для нового пользователя. События, уже поставленные в очередь, сохраняют исходного пользователя.
- Если цвет текста кнопки не задан, текст на залитой кнопке был белым. Теперь SDK берёт
textStyle.color, а без него — основной цвет текста: чёрный, в тёмной теме — белый.
Об ошибках HTTP-запросов SDK теперь сообщает только метод, адрес без параметров и статус. Тела запросов и ответов, заголовки и данные авторизации в отчёты и логи не попадают.
Что проверить при обновлении
- Android: SDK больше не подключает
multiplatform-settings-no-arg. Если приложение использует эту библиотеку само, добавьте зависимость. - Android: до
initialize(...)обращение кGravitySDK.instanceбольше не вызывает исключение. Проверить инициализацию можно черезGravitySDK.isInitialized. - Android: откройте кампании с залитыми кнопками без цвета текста. Чтобы оставить белый текст, задайте цвет в кампании.
- Android: без
ProductViewBuilderячейки товарной сетки остаются пустыми. Если in-app показывает сетку, задайте свой builder. - Android: повторный
initialize(...)сбрасывает пользователя изsetUser(...). ВызывайтеsetUser(...)снова после повторной инициализации. - Отчёты: число закрытий изменится. SDK больше не считает закрытия до появления окна и повторные, но учитывает закрытия при уходе с экрана. Учитывайте это при сравнении периодов.
Flutter 0.26.1
Новые возможности
Задержка кампании в headless-режиме. trackViewNoShow() и triggerEventNoShow() возвращают delayTime — задержку показа из настроек кампании в миллисекундах. Приложение выдерживает её перед показом, и отложенный показ из кабинета работает так же, как при автоматическом показе. Задержка кампании в headless-режиме
Исправленные ошибки
- Пока окно кампании было на экране, та же кампания могла открыться повторно — например, через минуту или если у кампании нет видимого показа. Теперь повторный показ заблокирован до закрытия.
- Если в окне не было формы, закрытие свайпом, кнопкой «Назад» или нажатием на фон не засчитывалось. Теперь модальное окно, bottom sheet и полноэкранный in-app отправляют одно закрытие и один
onCloseпри любом способе закрытия. - Snackbar засчитывал события закрытия и показа не всегда корректно. Теперь показ считается по первому видимому кадру, видимый показ — после секунды видимости хотя бы половины содержимого, закрытие — ровно один раз.
- Если цвет текста кнопки не задан, текст на залитой кнопке был белым. Теперь SDK берёт
textStyle.color, а без него — основной цвет текста темы. - В строке товаров отступы и фон отображались неверно. Теперь margin снаружи фона, padding внутри.
- Пустая товарная сетка и строка теперь скрыты. Карточки сетки остаются квадратными, а
gridColumnsиспользуется, если вgridSettingsнет корректного числа колонок. Смена контента или A/B-варианта запускает новый учёт видимости товаров, обычная перестройка сетки его не дублирует. - Кампании с одинаковым приоритетом могли выбираться не в порядке сервера. Теперь порядок сохраняется.
- Ошибка повторной загрузки контента для якоря после смены пользователя попадала в приложение. Теперь её обрабатывает SDK.
- Некорректный приоритет или задержка в одной кампании прерывали обработку ответа. Теперь значение заменяется на 0.
- Пустые поля стандартных событий отправлялись как
null. Теперь они не отправляются. - При смене пользователя или повторном
initialize()во время загрузкиgetContent*возвращает пустой ответ. При холодном запуске событие ждёт чтения сохранённого UID и сохраняет исходного пользователя, даже если за это время вызвалиresetUser(). - Если во время загрузки отключить
isFetchContentOnTrackили превыситьstaleContentTimeout, headless-методы возвращаютnull. SDK отправляет события загрузки и вызывает callback только для результата, который возвращает приложению.
Об ошибках HTTP-запросов SDK теперь сообщает только адрес без параметров и статус. Тела ответов, заголовки и данные авторизации в отчёты и логи не попадают.
Что проверить при обновлении
- Откройте кампании с залитыми кнопками без цвета текста. Чтобы оставить белый текст, задайте цвет в кампании.
- Проверьте товарные сетки: карточки всегда квадратные,
sizeна них не влияет. restoreUserId()с пустой строкой теперь выбрасываетArgumentError.GravityTextStyle.colorтеперь может бытьnull. Если приложение читает это поле, обработайте пустое значение.- Отчёты: закрытий может стать больше — теперь учитываются закрытия окон без формы свайпом, кнопкой «Назад» и нажатием на фон. Учитывайте это при сравнении периодов.
Как обновить
История изменений: iOS · Android · Flutter