Skip to main content
PNLight Remote Config доставляет типизированные настройки приложения из дашборда в SDK. Используйте его для несекретного поведения во время выполнения: флагов функций, вариантов текстов, лимитов и настроек пейвола. Remote Config отделён от Remote UI. Remote UI возвращает конфигурации экранов для отображения. Remote Config возвращает типизированные значения, которые приложение читает и применяет в своём коде.
Не храните секреты в Remote Config. Никогда не помещайте в Remote Config API-ключи, учётные данные, общие секреты и другие чувствительные значения.

Настройте значения в дашборде

Создайте базовую конфигурацию, добавьте целевые переопределения и опубликуйте черновик в разделе Remote Config. Рабочий процесс описан в разделе Настройка Remote Config в дашборде. Поддерживаемые типы значений верхнего уровня:
  • Boolean.
  • String.
  • Number.
  • String array.
  • JSON.
Ключи плоские. Если переопределение меняет JSON-значение, оно заменяет значение целиком и не выполняет глубокое слияние вложенных полей.

Инициализируйте SDK с локальными значениями по умолчанию

Задайте значения по умолчанию, принадлежащие приложению, во время инициализации SDK. Они остаются на устройстве и никогда не отправляются в PNLight. SDK использует их до первого успешного запроса, в офлайне или когда удалённое значение отсутствует либо имеет другой тип.

Получите и активируйте конфигурацию

Вызовите fetchAndActivate после инициализации, когда приложение готово обновить Remote Config. По умолчанию SDK:
  • Кратко ожидает атрибуцию AppsFlyer, чтобы PNLight мог применить переопределения на основе атрибуции.
  • Ограничивает успешные запросы интервалом 15 минут.
  • Сохраняет активную конфигурацию для токена SDK и пользователя PNLight.
  • Сохраняет ранее активную конфигурацию, если запрос не удался.
Используйте немедленный запрос только для разработки, QA или запуска, который не должен ждать атрибуцию.

Читайте типизированные значения

Используйте типизированные геттеры с резервными значениями. Если ключ отсутствует или активное значение имеет другой тип, SDK возвращает резервное значение.

Рекомендации

  • Храните критичные для приложения значения по умолчанию в приложении, чтобы первый запуск и офлайн-сессии работали.
  • Читайте Remote Config через типизированные геттеры, а не через приведение сырого JSON.
  • Используйте minimumFetchInterval: 0 только в разработке или QA.
  • Запрашивайте конфигурацию после передачи атрибуции, если важны переопределения для конкретных кампаний.
  • Согласуйте имена ключей и типы значений между владельцами дашборда и разработчиками приложения перед публикацией.