Сеть и жизненный цикл Android SDK
trackView(...)иtriggerEvent(...)запускают корутины в SDK и сразу возвращаются. В Compose вызывайте просмотр черезLaunchedEffectпри входе на экран, а не при каждой рекомпозиции.- Connect/request timeout задан в SDK: 5 секунд. Публичной настройки таймаутов нет.
- Общей постоянной очереди для
triggerEvent, покупок, просмотров и кликов, общего автоматического повтора API-запросов и публичногоflushнет. Отдельно сохраняются модальные показы WRIMP: см. ниже. - С 1.3.0 неуспешный HTTP-статус ответа
/choose,/visitи/eventсчитается ошибкой: SDK не принимает из такого ответа идентификатор пользователя, не обрабатывает кампании и не отправляет callback загрузки контента. Успешный пустой ответ остаётся допустимым. dispose()отменяет coroutine scopes SDK и снимает listener presentation lock. Это завершение работы экземпляра SDK; после негоtrackView,triggerEventи доставка callbacks через отменённые scopes не возобновятся автоматически. Не вызывайтеdispose()при закрытии каждой Activity/Fragment — используйте методы сброса inline-кэша.
Ошибка и пустой ответ
Возвращаемое null означает сбой получения/разбора контента, включая неуспешный HTTP-статус, или ответ для уже сменившегося пользователя; пустой data в успешном ответе — отсутствие подходящей кампании. Для UI предусмотрите стандартное состояние приложения и возможность новой загрузки по пользовательскому действию.
trackView/triggerEvent не возвращают подтверждение доставки. Tracking callbacks отражают события контента и не заменяют callback успешного HTTP-запроса.
Повторная отправка
Бизнес-события из triggerEvent(...) не сохраняются для следующего запуска. Если приложению нужна их очередь, реализуйте её с собственной политикой повторов и идентификации. Офлайн-очередь Flutter охватывает больше типов запросов, чем отдельная очередь модальных показов native SDK.
Не повторяйте purchase автоматически по каждому открытию экрана. Отправляйте событие после завершения заказа с устойчивым uniqueTransactionId; сценарий повторной доставки согласуйте с backend интеграции.
Учёт модальных показов
С версии 1.2.0 модальное окно, bottom sheet и полноэкранный in-app фиксируют visible impression (WRIMP) при первом подтверждённом кадре содержимого в активном приложении. Минимальной длительности просмотра нет: быстрое явное закрытие после появления окна не отменяет показ. Отмена до появления содержимого показом не считается.
Открытие учитывается один раз: переходы OPEN_STEP и закрытие используют тот же показ. Inline-блоки и товары сохраняют прежние пороги видимости. Для собственного UI приложение по-прежнему отправляет engagement самостоятельно.
С 1.3.0 SnackBar учитывает impression после фактического появления, а visible impression — по прежнему правилу видимости в течение секунды. Засчитанный visible impression сохраняется и доставляется через ту же очередь WRIMP, что модальные показы. Потеря фокуса или переход в фон перезапускает отсчёт непрерывной видимости. Программное закрытие до появления не отправляет impression и close, после появления — отправляет один close.
SDK сохраняет исходные tracking URL и привязку к кампании/пользователю до отправки. При временной ошибке доставка повторяется при восстановлении сети и после нового запуска SDK. Завершённое приложение само запросы не отправляет.
После успешной доставки частоту снова определяет сервер. Постоянная ошибка или удаление записи не означают, что сервер учёл показ. Смена пользователя не меняет исходные tracking URL и не переносит защиту кампании на другой профиль. С 1.3.0 пользователи без custom ID и серверного UID разделяют одну защиту: кампания, ожидающая доставки WRIMP, защищена для любого анонимного пользователя на 24 часа, доставка по-прежнему ожидает до 7 дней. resetUser() не удаляет ожидающие WRIMP.
ContentVisibleImpressionEvent и действие onVisible у модального окна выполняются один раз для начального шага после результата сохранения, а не после HTTP-подтверждения. Callback может прийти после закрытия UI; не используйте его как подтверждение доставки.
В Android очередь ограничена 512 открытиями на API key/section. Разрешение android.permission.ACCESS_NETWORK_STATE добавлено в manifest SDK для возобновления доставки при восстановлении сети; runtime-запроса разрешения нет. При переполнении удаляются старейшие записи. Истечение 7 дней, постоянная ошибка, переполнение или сбой хранилища могут привести к недоставке. Отдельной гарантии exactly-once нет: если сервер обработал запрос, но ответ потерялся, повтор возможен. При отсутствии WRIMP URL или сбое сохранения проверяйте диагностику SDK.
Ожидающая подготовка in-app
inAppPreparation имеет собственный таймаут — по умолчанию 5 секунд. Ошибка, таймаут или возврат пустого результата пропускают показ. После смены пользователя или включения presentation lock прежний результат не показывается, даже если затем восстановить пользователя или снять блокировку. Для новой попытки нужен новый просмотр или событие. Настройка подготовки.
Повторное создание экрана
В Compose отправляйте просмотр через LaunchedEffect, привязанный к открытию экрана. GravityInlineCompose запускает загрузку по selector: изменение только PageContext на том же экземпляре не запускает новый эффект. При смене товара/контекста пересоздайте блок через key(pageContext), сохранив обычный selector кампании. Кэш inline-блоков.
С 1.3.0 открытые modal, bottom sheet, fullscreen и snackbar переживают пересоздание Activity при смене конфигурации, например повороте: SDK переносит показ в новую Activity без новых impression, visible impression и close.
Проверка без сети
- Откройте экран без сети и убедитесь, что приложение показывает свой обычный UI.
- Восстановите соединение: бизнес-события сами не досылаются; для них действует очередь приложения, если она реализована.
- Выполните новое действие и новую загрузку; проверьте запросы по логам.
Проверка модальных показов
- Загрузите тестовый in-app и отключите сеть перед его появлением.
- Дождитесь первого кадра содержимого и сразу закройте окно: должен создаться один WRIMP.
- Повторите с переходом
OPEN_STEP: дополнительного модального WRIMP на шаг быть не должно. - Перезапустите приложение без сети с теми же ключом, секцией и пользователем: локальная защита кампании сохраняется в пределах 24 часов.
- Восстановите сеть и проверьте доставку исходного tracking URL на сервере; callback сам по себе её не подтверждает.
- Отдельно отмените показ до первого кадра: модальный WRIMP создаваться не должен.