Сеть и жизненный цикл iOS SDK

  • trackView(...) и triggerEvent(...) запускают работу в Task и возвращаются сразу; callback завершения запроса отсутствует.
  • HTTP-таймауты запроса и ресурса заданы в коде SDK: 5 секунд. Публичной настройки таймаутов нет.
  • При ошибке загрузки методы выбора контента возвращают nil; успешный ответ без подходящей кампании содержит пустой data. Обрабатывайте эти состояния отдельно.
  • Общей постоянной очереди для triggerEvent, покупок, просмотров и кликов, общего автоматического повтора API-запросов и публичного flush нет. Отдельно сохраняются модальные показы WRIMP: см. ниже.
  • У SDK нет публичного dispose. Инициализируйте его один раз; trackView(...) вызывайте при фактическом открытии экрана, а не при каждом пересчёте SwiftUI body.

Ошибка и пустой ответ

Возвращаемое nil означает сбой получения/разбора контента; пустой 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-блоки и товары сохраняют прежние пороги видимости. С 1.3.0 SnackBar фиксирует visible impression, когда не менее 50% содержимого видно одну секунду в активном приложении, и сохраняет его до отправки в той же очереди. Для собственного UI приложение по-прежнему отправляет engagement самостоятельно.

SDK сохраняет исходные tracking URL и привязку к кампании/пользователю до отправки. При временной ошибке доставка повторяется при восстановлении сети и после нового запуска SDK. Завершённое приложение само запросы не отправляет.

Механизм Срок и завершение
Локальная защита от повторного автопоказа До HTTP 2xx, постоянной ошибки или максимум 24 часов от показа; сохраняется после закрытия и перезапуска
Доставка сохранённого WRIMP До 7 дней от показа; истечение 24 часов защиты не удаляет ожидающий показ

После успешной доставки частоту снова определяет сервер. Постоянная ошибка или удаление записи не означают, что сервер учёл показ. Смена пользователя не меняет исходные tracking URL и не переносит защиту кампании на другой профиль. С 1.3.0 уже сохранённые WRIMP доставляются и после resetUser или restoreUserId, а показ, открытый для прежнего пользователя и ещё не подтверждённый, после смены пользователя не учитывается.

ContentVisibleImpressionEvent и действие onVisible у модального окна выполняются один раз для начального шага после результата сохранения, а не после HTTP-подтверждения. Callback может прийти после закрытия UI; не используйте его как подтверждение доставки.

В iOS очередь ограничена 256 открытиями и 1 МиБ на API key/section. При переполнении удаляются старейшие записи. Истечение 7 дней, постоянная ошибка, переполнение или сбой хранилища могут привести к недоставке. Отдельной гарантии exactly-once нет: если сервер обработал запрос, но ответ потерялся, повтор возможен. При отсутствии WRIMP URL или сбое сохранения проверяйте диагностику SDK.

Ожидающая подготовка in-app

inAppPreparation имеет собственный таймаут — по умолчанию 5 секунд. Ошибка, таймаут или возврат пустого результата пропускают показ. После смены пользователя или включения presentation lock прежний результат не показывается, даже если затем восстановить пользователя или снять блокировку. Для новой попытки нужен новый просмотр или событие. Настройка подготовки.

Повторное создание экрана

В SwiftUI не отправляйте просмотр из body. Используйте событие появления экрана. При смене контекста создайте новый inline view; правила загрузки описаны в Кампаниях.

Проверка без сети

  1. Откройте экран без сети и убедитесь, что приложение показывает свой обычный UI.
  2. Восстановите соединение: бизнес-события сами не досылаются; для них действует очередь приложения, если она реализована.
  3. Выполните новое действие и новую загрузку; проверьте запросы по логам.

Проверка модальных показов

  1. Загрузите тестовый in-app и отключите сеть перед его появлением.
  2. Дождитесь первого кадра содержимого и сразу закройте окно: должен создаться один WRIMP.
  3. Повторите с переходом OPEN_STEP: дополнительного модального WRIMP на шаг быть не должно.
  4. Перезапустите приложение без сети с теми же ключом, секцией и пользователем: локальная защита кампании сохраняется в пределах 24 часов.
  5. Восстановите сеть и проверьте доставку исходного tracking URL на сервере; callback сам по себе её не подтверждает.
  6. Отдельно отмените показ до первого кадра: модальный WRIMP создаваться не должен.