Проверка интеграции Android SDK

Чеклист перед выпуском

  1. SDK инициализирован до первого обращения; API key и section относятся к нужному проекту.
  2. Просмотр отправляется при открытии экрана, событие — после фактического действия.
  3. SKU, категории и lng совпадают с товарным фидом, включая регистр.
  4. LoginEvent связывает профиль по согласованному CUID; пользователь из setUser совпадает в просмотрах, событиях и запросах контента.
  5. In-app кампания опубликована, UI доступен, presentation lock снята.
  6. Inline selector совпадает с кампанией и передаётся обычной строкой без JSON-кавычек; блок получает место в вёрстке и ProductViewBuilder для товаров, включая сетки.
  7. Навигация по URL/deeplink обработана, tracking встроенного UI не дублируется.
  8. Проверены ошибка сети, пустой ответ и возврат на экран; UI приложения сохраняет работоспособность.

Проверка запросов

На время диагностики включите LogLevel.DEBUG. С 1.3.0 HTTP-лог показывает метод, endpoint и статус ответа, но не тела запросов и ответов. Поля sec, user, ctx, selector и rules проверяйте через прокси или на backend. Настройка логирования.

Формат selector в /choose проверяйте по правилу Android 1.3.0: в запросе должна быть строка без лишних экранированных кавычек.

Почему GravityInlineView не отображается?

Проверьте два условия: в XML задан app:selector, а после инфлейта вызван init(pageContext). Без init(...) SDK не получит контекст для загрузки кампании.

Почему GravityInlineCompose не показывает контент?

Проверьте selector, pageContext и то, что composable действительно получает место на экране. Для отладки удобно временно передать loader, чтобы различать состояние загрузки и отсутствие кампании.

Почему кампания не показывается после trackView(...) или triggerEvent(...)?

Проверьте PageContext, актуальность section, наличие подходящей кампании и то, что в activityContext передается контекст текущего экрана. Если SDK не сможет определить Activity, in-app-показ не произойдет.

Почему после обновления до 1.3.0 inline-блок или getContentBySelector(...) не находят кампанию?

Скорее всего, selector всё ещё обёрнут в JSONObject.quote(...) или " в XML. С 1.3.0 SDK отправляет значение буквально, и selector с кавычками не совпадает с кампанией. Передавайте обычную строку: формат selector. То же относится к groupSelector, campaignId и методам сброса inline-кэша.

Почему trackViewNoShow(...) возвращает null?

Проверьте, что isFetchContentOnTrack не выключен, ответ пришёл быстрее staleContentTimeoutMillis, пользователь не сменился во время запроса, а у кампании есть корневой контент без step. Просмотр при этом отправляется. Правила headless-режима.

Почему приложение не падает, даже если сеть недоступна?

Android SDK обрабатывает сетевые ошибки внутри себя. В этом случае контент просто не будет показан или не будет загружен.

Нужно ли передавать lng, utm и attributes всегда?

Нет. lng нужен только если проект использует мультирегиональность и региональные варианты данных в фиде. utm и attributes нужны только если на них завязаны правила таргетинга или аналитика.

Нужно ли отдельно передавать decisionId в engagement?

Нет. В публичных Android-методах engagement он не передается отдельным параметром. Используйте объекты slot, content и campaign, полученные из ответа SDK.

Почему in-app пропущен после проверки товаров?

Проверьте, вернул ли inAppPreparation контент за отведённое время. Ошибка API, таймаут, отсутствие подходящих товаров, смена пользователя, неактивный экран или presentation lock пропускают показ. Для другой кампании обработчик должен возвращать исходный контент. После снятия блокировки нужен новый просмотр или событие. Условия подготовки контента.

Почему повторный триггер не открывает второе сообщение?

С 1.2.0 SDK защищает одну кампанию от повторного автопоказа во время подготовки, показа и ожидания подтверждения visible impression. Защита модального показа сохраняется после закрытия и перезапуска максимум 24 часа, доставка WRIMP — до 7 дней. Правила и проверка. Проверьте tracking URL и сеть, затем серверные ограничения частоты. Повторные триггеры не должны использоваться для обхода этой защиты. С 1.3.0 кампания, которая уже показана, не открывается повторно до закрытия, даже после подтверждения visible impression.

Почему dismissInApp вернул false?

Метод закрывает только in-app, показанный SDK с тем же contentId. Для inline, собственного UI, отсутствующего или уже закрывающегося in-app результат будет false. Открывайте форму после true; не отправляйте close повторно. При ручном превью навигацию реализует приложение без ожидания закрытия SDK.

После обновления SDK

Сопоставьте установленную версию со справочником API, повторно проверьте события, выбор контента, navigation callbacks и показ рекомендаций. Полная интеграционная проверка требует реальной кампании и устройства/эмулятора.

При переходе с 1.2.0 на 1.3.1

Обновите зависимость ai.gravityfield:gravity-sdk:1.3.1 и проверьте:

  • selector без кавычек — первым делом: уберите JSONObject.quote(...) и " у selector, groupSelector и campaignId, включая собственные helper-функции и вызовы resetInlineViewCache/resetInlineListViewCache. Значения с кавычками отправляются буквально и не совпадают с кампанией. Формат selector;
  • зависимости: SDK больше не подключает multiplatform-settings-no-arg. Если код приложения использовал эту библиотеку, подключите её явно. При сборке из исходников задайте SDK_VERSION=1.3.1;
  • цвет текста кнопок без textStyle.color: теперь он чёрный, в тёмной теме белый, а не белый Material. Проверьте контраст с фоном кнопки;
  • товарные сетки: gridSettings и gridColumns, квадратные карточки, отступы и ProductViewBuilder — без билдера ячейки сетки пустые. Проверьте также высоту товарных строк: size.height теперь включает padding, карточки обрезаются по высоте блока;
  • GravitySDK.instance до initialize больше не выбрасывает исключение; если код полагался на это, используйте GravitySDK.isInitialized;
  • поворот экрана с открытым in-app: окно остаётся открытым без новых событий; close отправляется один раз и только после появления;
  • OPEN_STEP заменяет текущий шаг вместо открытия поверх;
  • выход из аккаунта через resetUser() и восстановление через restoreUserId(...), если это нужно сценарию: серверный UID;
  • debug-логи: тела запросов больше не выводятся, используйте прокси или backend для проверки запросов.

Почему callback видимости пришёл после закрытия окна?

С 1.2.0 модальный показ сохраняется вне UI-потока. ContentVisibleImpressionEvent может прийти после закрытия; он не подтверждает успешный HTTP-запрос. Проверьте доставку WRIMP на сервере и повторите сценарии без сети.