Проверка интеграции iOS SDK
Чеклист перед выпуском
- SDK инициализирован до первого обращения; API key и section относятся к нужному проекту.
- Просмотр отправляется при открытии экрана, событие — после фактического действия.
- SKU, категории и lng совпадают с товарным фидом, включая регистр.
- LoginEvent связывает профиль по согласованному CUID; пользователь из setUser совпадает в просмотрах, событиях и запросах контента; при выходе из аккаунта вызывается
resetUser(). - In-app кампания опубликована, UI доступен, presentation lock снята.
- Inline selector совпадает с кампанией; блок получает место в вёрстке и ProductViewBuilder для товаров.
- Навигация по URL/deeplink обработана, tracking встроенного UI не дублируется.
- Проверены ошибка сети, пустой ответ и возврат на экран; UI приложения сохраняет работоспособность.
Проверка запросов
На время диагностики включите .debug. С 1.3.0 debug-лог показывает только метод, endpoint без query и статус ответа, без тел и заголовков. Содержимое ответа проверяйте через getContentBySelectorWithDetails(...) или json headless-ответа; PageContext и пользователя — по значениям, которые передаёт приложение. Настройка логирования.
Вызов SDK до GravitySDK.initialize(...)
Если публичный метод SDK вызван до GravitySDK.initialize(...), приложение не падает. SDK игнорирует вызов и пишет error-лог:
called before GravitySDK.initialize() — call ignored
Что делать:
- Инициализируйте SDK на раннем этапе старта приложения.
- Проверьте порядок вызовов по логам SDK или через
setLogListener(...).
Кампании не показываются после trackView(...) или triggerEvent(...)
Проверьте:
- корректность
apiKeyиsection; - корректность
PageContext; - наличие доступного
UIViewControllerдля показа; - активность кампаний в Gravity Field для этого контекста.
getContentBySelector(...) возвращает пустой data
Проверьте:
- верный
selector; - активность кампании;
- соответствие
PageContextусловиям таргетинга; - сетевые ограничения и
proxyUrl, если он используется. - SDK-логи через
logLevel: .debugилиsetLogListener(...), если метод вернулnil; - не сменился ли пользователь во время запроса: с 1.3.0 после
setUser,resetUserилиrestoreUserIdметод возвращаетnilвместо контента прежнего пользователя.
trackViewNoShow(...) или triggerEventNoShow(...) возвращает nil
Проверьте наличие подходящей кампании с корневым контентом, isFetchContentOnTrack, staleContentTimeout (по умолчанию 10 секунд с момента вызова), смену пользователя во время запроса и SDK-логи. Метод не показывает UI и не ждёт delayTime: задержку и показ выполняет приложение. Headless-режим.
Почему кнопка с URL или deeplink внутри in-app ничего не делает?
Скорее всего, в приложении не обработаны FollowUrlEvent или FollowDeeplinkEvent в gravityEventCallback. iOS SDK передает эти события в callback, но сам переход не выполняет.
Почему inline-кампания не отображается автоматически?
Проверьте selector, соответствие PageContext условиям таргетинга, активность кампании и наличие контента в response. Для GravityInlineView дополнительно проверьте constraints, высоту ячейки/контейнера и то, что initialize(pageContext:) был вызван после установки selector.
Почему не получается вручную отправить content/product engagement?
Проверьте, что вы используете публичные типы ContentEngagement / ProductEngagement и передаете в них корректные content, campaign и slot из ответа getContentBySelector(...). Для content click отдельного публичного типа в iOS SDK сейчас нет.
Можно ли использовать pageNumber и referrer для таргетинга?
pageNumber и referrer передаются в запросах. Для проверки конкретного правила таргетинга сопоставьте ctx в debug-логе с настройками кампании.
Почему in-app пропущен после проверки товаров?
Проверьте, вернул ли inAppPreparation контент за отведённое время. Ошибка API, таймаут, отсутствие подходящих товаров, смена пользователя, неактивный экран или presentation lock пропускают показ. Для другой кампании обработчик должен возвращать исходный контент. После снятия блокировки нужен новый просмотр или событие. Условия подготовки контента.
Почему повторный триггер не открывает второе сообщение?
С 1.2.0 SDK защищает одну кампанию от повторного автопоказа во время подготовки, показа и ожидания подтверждения visible impression. С 1.3.0 кампания, чей in-app ещё открыт, не открывается повторно. Защита модального показа сохраняется после закрытия и перезапуска максимум 24 часа, доставка WRIMP — до 7 дней. Правила и проверка. Проверьте tracking URL и сеть, затем серверные ограничения частоты. Повторные триггеры не должны использоваться для обхода этой защиты.
Почему dismissInApp вернул false?
Метод закрывает только in-app, показанный SDK с тем же contentId. Для inline, собственного UI, отсутствующего или уже закрывающегося in-app результат будет false. Открывайте форму после true; не отправляйте close повторно. При ручном превью навигацию реализует приложение без ожидания закрытия SDK.
После обновления SDK
Сопоставьте установленную версию со справочником API, повторно проверьте события, выбор контента, navigation callbacks и показ рекомендаций. Полная интеграционная проверка требует реальной кампании и устройства/эмулятора.
При переходе с 1.2.0 на 1.3.1 обновите зависимость до exact: "1.3.1" и проверьте:
- headless-режим, если приложение рисует кампании само: ожидание
delayTime, отправку impression, visible impression и кликов приложением, значенияisFetchContentOnTrackиstaleContentTimeout; - ID пользователя:
resetUser()при выходе,restoreUserId(_:)после переустановки и обработкуGravityUserIdError; nilизgetContentBy*после смены пользователя во время запроса;- правила рекомендаций
rulesи перезагрузку inline-блока при их изменении; - кампании с
grid: раньше встроенный рендерер их не показывал, теперь рисует товарную сетку с квадратными карточками изProductViewBuilder; - пустые ряды и сетки товаров: они больше не занимают место;
- многошаговые кампании:
open_stepзаменяет текущий шаг независимо отcloseOnClick, close отправляется один раз при закрытии последнего шага; - close и impression модальных форматов при перекрытии окна своим контроллером, при закрытии кнопкой с действием
onCloseи при удалении окна средствами UIKit; - visible impression SnackBar: 50% в течение одной секунды;
- задержку и приоритет кампаний со строковыми или дробными значениями, отрицательную задержку;
- диагностику: debug-логи больше не содержат тела запросов и ответов. Логирование.
История релизов: CHANGELOG 1.3.1.
Почему callback видимости пришёл после закрытия окна?
С 1.2.0 модальный показ сохраняется вне UI-потока. ContentVisibleImpressionEvent может прийти после закрытия; он не подтверждает успешный HTTP-запрос. Проверьте доставку WRIMP на сервере и повторите сценарии без сети.